bnomei/kirby3-dotenv

Kirby 3 环境变量插件,从 .env 文件读取

2.2.0 2023-02-23 11:39 UTC

README

Release Downloads Build Status Coverage Status Maintainability
Twitter

Kirby 3 环境变量插件,从 .env 文件读取

商业使用


支持开源!

此插件免费,但如果您将其用于商业项目,请考虑赞助我或捐款。
如果我的工作帮助您赚了钱,那么我认为我也应该得到一点回报,对吧?

请善良。分享一点。谢谢。

—— Bruno
 

类似插件

安装

  • 解压master.zip为文件夹site/plugins/kirby3-dotenv
  • git submodule add https://github.com/bnomei/kirby3-dotenv.git site/plugins/kirby3-dotenv
  • composer require bnomei/kirby3-dotenv

设置

.env 文件示例

/.env

APP_MODE=production
APP_DEBUG=false
ALGOLIA_APIKEY=12d7331a21d8a28b3069c49830f463e833e30f6d
KIRBY_API_USER=bnomei
KIRBY_API_PW=52d3a0edcc78be6c5645fdb7568f94d3d83d1c2a

/.env.staging

APP_MODE=staging
APP_DEBUG=true
ALGOLIA_APIKEY=950306d052ec893b467f2ca088daf2964b9f9530
KIRBY_API_USER=notBnomei
KIRBY_API_PW=37e30ad867ff3a427317dcd1852abbd692b39ffc

在所有地方使用,但在配置文件中除外

⚠️ 注意:自 v2 版本起,此插件不支持全局 PHP 函数 getenv()putenv()。以下方法将工作...

  • 使用全局变量 $_ENV[]$_SERVER[]
  • 插件的全局辅助函数 env()
  • ->getenv()->env() 页面和站点方法

在服务器上

echo $_ENV['APP_MODE']; // production
echo env('APP_DEBUG'); // false
// or
echo $page->getenv('ALGOLIA_APIKEY'); // 12d7331a21d8a28b3069c49830f463e833e30f6d
echo $page->env('ALGOLIA_APIKEY'); // 12d7331a21d8a28b3069c49830f463e833e30f6d
echo site()->getenv('ALGOLIA_APIKEY'); // 12d7331a21d8a28b3069c49830f463e833e30f6d
echo site()->env('ALGOLIA_APIKEY'); // 12d7331a21d8a28b3069c49830f463e833e30f6d

在预发布服务器上

echo $_ENV['APP_MODE']; // staging
echo env('APP_DEBUG'); // true
// or
echo $page->getenv('ALGOLIA_APIKEY'); // 37e30ad867ff3a427317dcd1852abbd692b39ffc
echo $page->env('ALGOLIA_APIKEY'); // 37e30ad867ff3a427317dcd1852abbd692b39ffc
echo site()->getenv('ALGOLIA_APIKEY'); // 37e30ad867ff3a427317dcd1852abbd692b39ffc
echo site()->env('ALGOLIA_APIKEY'); // 37e30ad867ff3a427317dcd1852abbd692b39ffc

在配置文件中使用

请参阅配置示例,了解如何将此插件与 kirby 的配置文件结合使用。自 v2 版本起,此插件支持 kirby 的多环境设置,用于合并多个配置文件。

默认值

如果您希望在环境变量未设置时提供默认值作为后备,可以在每个辅助函数的第二个参数中这样做。

 // `true` as default value
echo env('ALGOLIA_ENABLED', true);

感谢您的 PR @teichsta

设置

依赖项

免责声明

本插件提供“现状”且没有任何保证。自行承担使用风险,并在将其用于生产环境之前自行测试。如果您发现任何问题,请创建新问题

许可

MIT

不建议在任何宣传种族主义、性别歧视、恐同、动物虐待、暴力或其他任何形式仇恨言论的项目中使用此插件。

致谢

基于 K2 版本的