bnomei / kirby3-dotenv
Kirby 3 环境变量插件,从 .env 文件读取
2.2.0
2023-02-23 11:39 UTC
Requires
- php: >=8.0
- getkirby/composer-installer: ^1.1
- vlucas/phpdotenv: ^5.3
Requires (Dev)
- getkirby/cms: ^3.5
- php-coveralls/php-coveralls: ^2.1
- phpunit/phpunit: ^9.5
Suggests
- bnomei/kirby3-janitor: Use a Panel Button or PHP code to clear the cache
- bnomei/kirby3-lapse: For faster and automatic caching based on modification of Kirby Objects
- bnomei/kirby3-security-headers: CPS headers to make the the web a saver place. Sensible defaults with zero configuration.
- robinscholz/better-rest: Allows you to send authenticated GET requests querying the Kirby API
README
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
设置
依赖项
免责声明
本插件提供“现状”且没有任何保证。自行承担使用风险,并在将其用于生产环境之前自行测试。如果您发现任何问题,请创建新问题。
许可
不建议在任何宣传种族主义、性别歧视、恐同、动物虐待、暴力或其他任何形式仇恨言论的项目中使用此插件。
致谢
基于 K2 版本的