资讯专栏INFORMATION COLUMN

上云采购季！| 2核2G4M爆款云服务器低至59元/年，更有多台、长期优惠，快来选购！

立即前往
首页/文章专栏/[译] dotenv - PHP版本的 .env

[译] dotenv - PHP版本的 .env

Eric / 3564人阅读

摘要：原文地址通过加载环境变量并且能够自动的通过和自动调用这是一个版本为什么是你不能在代码中存储任何的敏感账号数据存储在环境中存储配置是的一项规则在部署中可能变化的所有的内容诸如数据库认证或者第三方服务的认证应该从代码中剥离出来也就是环境变量的

原文地址:PHP dotenv

通过 .env 加载环境变量并且能够自动的通过 getenv(), $_ENV 和 $_SERVER 自动调用.

这是一个PHP版本 Ruby dotenv.

为什么是 .env?

你不能在代码中存储任何的 敏感/账号 数据. 存储 在环境中存储配置 是 12-factors的一项规则. 在部署中可能变化的所有的内容 – 诸如数据库认证或者第三方服务的认证应该从代码中剥离出来.也就是环境变量的概念.

广义上来说, 一个 .env 文件是加载自定义配置的一个简单的方法, 这样你的应用不需要修改 .htaccess 文件或者 Apache/nginx 虚拟主机. 这意味着你不需要编辑项目之外的任何文件,并且所有的环境变量都配置完整了, 无论你运行在 Apache, Nginx, CLI 还是 PHP 5.4 上内建的web服务器上. 这是一个所知的设置环境变量最简单的方法, 你会喜欢上它的.

无需在 Apache 或者 Nginx上额外配置虚拟主机配置

无需在 .htaccess 中添加 php_value 值

方便移植和共享 ENV 环境变量值

兼容服务器内置的服务器和 CLI 运行器

使用 composer 安装 
curl -s http://getcomposer.org/installer | php
php composer.phar require vlucas/phpdotenv
使用方法

.env 文件通常不包含在版本控制内, 它可能包含敏感的 API Key 或者 密码. 所有需要环境变量定义(不敏感的定义)的项目都需要创建一个 .env.example 文件, 这个环境变量包含他们自己定义的环境变量或者联合开发包含的环境变量. 项目合作开发者可以独立的复制 .env.example 并且重命名为 .env , 并且修改为正确的本地环境配置, 存储密码key或者提供他们必要的值. 在这个使用方法中 .env 文件应该添加到 .gitignore 文件中并且永远不会被项目的合作者签入/签出. 这个方法确保里边没有敏感的 API Key 或者 密码在版本控制中出现从而减少了安全风险. 并且开发环境中的配置永远不会告知合作开发者.

添加配置到根目录下的 .env 文件, 确保 .env 文件添加到 .gitignore 从而不会签入到 CVS 

S3_BUCKET=dotenv
SECRET_KEY=souper_seekret_key

现在创建一个 .env.example 文件, 并且签入到项目中. 这里配置和环境变量你需要设置的可以留空或者设置一些无关紧要的数据. 这个方法告知人们这些数据是必须的, 但是不会提供真正环境中的数据.

S3_BUCKET=devbucket
SECRET_KEY=abc123

你可以使用以下一行代码加载应用中的 .env 文件:

Dotenv::load(__DIR__);

所有定义的变量都可以通过 getenv 方法访问到, 并且也可以使用超全局变量$_ENV 和 $_SERVER访问到.

$s3_bucket = getenv("S3_BUCKET");
$s3_bucket = $_ENV["S3_BUCKET"];
$s3_bucket = $_SERVER["S3_BUCKET"];

你同样可以使用框架的 Request 类来访问这些变量(如果你使用框架)

$s3_bucket = $request->env("S3_BUCKET");
$s3_bucket = $request->getEnv("S3_BUCKET");
$s3_bucket = $request->server->get("S3_BUCKET");
嵌入变量

在一个变量中嵌入一个环境变量是可以的, 这样对于减少重复很有用.

使用 {$…} 来包裹环境变量 e.g.

BASE_DIR=/var/webroot/project-root
CACHE_DIR={$BASE_DIR}/cache
TMP_DIR={$BASE_DIR}/tmp
不可变

默认来说, Dotenv 认为环境变量是不变的. 这就是说一旦设置就不能变更.

你可以用以下函数将环境变量设置为可变的

Dotenv::makeMutable();

… 同样你也可以使用以下函数让其不再可变

Dotenv::makeImmutable();
要求变量必须设置

使用 Dotenv, 你可以指定这个 ENV 变量必须设置, 如没有设置则会抛出异常. 这对于人们是非常有用的, 如果程序缺少这个变量就不能运行.

使用以下语法:

Dotenv::required("DATABASE_DSN");

或者数组来定义:

Dotenv::required(array("DB_HOST", "DB_NAME", "DB_USER", "DB_PASS"));

如果 ENV 变量缺少, Dotenv 将抛出一个 RuntimeException :

Required environment variable missing or value not allowed: "DB_USER", "DB_PASS"
允许的值

你可能看到了上边的异常信息, 你可以设定一个可能范围值, 让你的环境变量遵守这个规则

Dotenv::required("SESSION_STORE", array("Filesystem", "Memcached"));

同样的, 如果环境变量不在这个列表里, 你会收到一个相似的异常信息:

Required environment variable missing or value not allowed: "SESSION_STORE"
注释

可以使用 # 来注释字符. E.g.

# this is a comment
VAR="value" # comment
VAR=value # comment
使用注释

当一个开发者克隆你的代码库. 他们会收到一个额外的手册 一次性步骤 来手动的复制 .env.example 并且重命名为 .env 并且追加上他们自己的值(或者从其他开发者哪里获取到其他敏感值).

phpdotenv 被用来建立开发者环境但是不应该用在生产环境下. 在生产环境下, 需要设置真实的变量而不必每次使用请求的时候都使用 .env 文件进行重载.

这个可以通过自动化部署工具来实现, 例如: Vagrant, chef, Puppet, 或者手动的通过云主机来实现, 例如: Pagodabox, Heroku.

贡献

Fork it

创建分支(git checkout -b my-new-feature)

改动

运行测试, 如果需要, 添加新配置 (phpunit)

提交 (git commit -am "Added some feature")

推送到分支 (git push origin my-new-feature)

创建新的拉取请求

GPU云服务器 云服务器 切换php版本的面板 dotenv envs env

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/25734.html

相关文章

  • python 批量生成唯一优惠券码(供php调用)

    摘要：批量生成优惠券码并写入数据表说明这篇文章主要讲的是个人工作中遇到的解决问题的方法而非程序写的多优美。 python 批量生成优惠券码并写入数据表 说明:这篇文章主要讲的是个人工作中遇到的解决问题的方法,而非程序写的多优美。要完善的地方太多了，大家嘴下留情 why do this 为什么要这么做？优惠券码直接在用的时候用程序直接生成不就OK了吗? 好,那么问题来了,我们的系统需要一次性发...

    objc94 评论0 收藏0

  • python 批量生成唯一优惠券码(供php调用)

    摘要：批量生成优惠券码并写入数据表说明这篇文章主要讲的是个人工作中遇到的解决问题的方法而非程序写的多优美。 python 批量生成优惠券码并写入数据表 说明:这篇文章主要讲的是个人工作中遇到的解决问题的方法,而非程序写的多优美。要完善的地方太多了，大家嘴下留情 why do this 为什么要这么做？优惠券码直接在用的时候用程序直接生成不就OK了吗? 好,那么问题来了,我们的系统需要一次性发...

    Jeff 评论0 收藏0

  • PHP如何实现.env 文件灵活应用在项目中

    首先composer安装 composer require vlucas/phpdotenv 接着看phpdotenv官方文档 https://packagist.org/package... 示例 $dotenv = DotenvDotenv::create(__DIR__, .env); $my_env = $dotenv->load(); var_dump($my_env);

    468122151 评论0 收藏0

  • 教练，我想写 laravel 第一章

    摘要：前言作为一个爱好者让我写我本来是拒绝的，但是呢，拒绝了谁给你工资啊那怎么办呢，既然是基于的组件化开发的，那么能不能把中的功能引入到中呢环境问题测试版和正式版的数据库一般是不同的那么如何方便的切换呢之前我才用的方法是看当前运行的文件夹是哪个就 前言 作为一个 laravel 爱好者让我写 tp3.2 我本来是拒绝的，但是呢，拒绝了谁给你工资啊那怎么办呢，既然 laravel 是基于 co...

    jerry 评论0 收藏0

  • Laravel 5.8 前瞻

    摘要：发布于年月，从那时起大约每六个月会发布一次的新版本。将会支持相对较新的来管理项目中的环境文件。弃用和辅助函数所有的和全局辅助函数都已弃用，将在中删除。将返回更干净的相同值。和通知和通知已从主项目中删除，并提取到第三方软件包中。 showImg(https://segmentfault.com/img/remote/1460000018269419?w=585&h=400); 无论是从零...

    tianhang 评论0 收藏0

发表评论

登陆后可评论

0条评论

Eric

男|高级讲师
我要私信

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<