设置环境变量配置的简单方法.env
来源:互联网 发布:淘宝上的算命准吗 编辑:程序博客网 时间:2024/06/02 11:39
什么是.env
.env
文件位于项目根目录下,作为全局环境配置文件。
通过 .env文件 加载环境变量并且能够自动的通过 getenv()
, $_ENV
和 $_SERVER
自动调用.
这是一个PHP版本 Ruby dotenv.
示例
// 运行环境名称APP_ENV=local// 调试模式,开发阶段启用,上线状态禁用。APP_DEBUG=true// 敏感信息加密密钥,可使用 php artisan key:generate 重新生成。APP_KEY=// 项目根目录APP_URL=http://localhost// 缓存驱动,默认使用文件作为缓存。CACHE_DRIVER=file// 回话驱动,默认使用文件存储SESSION。SESSION_DRIVER=file// 队列驱动,默认使用同步模式。QUEUE_DRIVER=sync// Redis高性能key-value数据库,使用内存存储,用于数据持久化。REDIS_HOST=127.0.0.1REDIS_PASSWORD=nullREDIS_PORT=6379// 数据库配置项DB_HOST=127.0.0.1//数据库主机名DB_PORT=3306//数据库端口DB_DATABASE=homestead//数据库名称DB_USERNAME=homestead//数据库登录账户DB_PASSWORD=secret//数据库登录密码
优势
- 把.env加入GIT的
.gitignore
文件中,可以避免.env
文件中的敏感信息泄露 - 可以不用修改Apache/nginx配置文件,就可以设置环境变量
- 无需在
.htaccess
中添加 php_value 值 - 方便移植和共享 ENV 环境变量值
- 兼容服务器内置的服务器和 CLI 运行器
使用 composer 安装
curl -s http://getcomposer.org/installer | phpphp composer.phar require vlucas/phpdotenv
使用方法
.env
文件通常不包含在版本控制内, 它可能包含敏感的 API Key 或者 密码. 所有需要环境变量定义(不敏感的定义)的项目都需要创建一个.env.example
文件, 这个环境变量包含他们自己定义的环境变量或者联合开发包含的环境变量. 项目合作开发者可以独立的复制 .env.example 并且重命名为 .env
, 并且修改为正确的本地环境配置, 存储密码key或者提供他们必要的值. 在这个使用方法中.env
文件应该添加到.gitignore
文件中并且永远不会被项目的合作者签入/签出. 这个方法确保里边没有敏感的 API Key 或者 密码在版本控制中出现从而减少了安全风险. 并且开发环境中的配置永远不会告知合作开发者.
添加配置到根目录下的.env
文件, 确保.env
文件添加到.gitignore
从而不会签入到 CVS
S3_BUCKET=dotenvSECRET_KEY=souper_seekret_key
现在创建一个 .env.example 文件, 并且签入到项目中. 这里配置和环境变量你需要设置的可以留空或者设置一些无关紧要的数据. 这个方法告知人们这些数据是必须的, 但是不会提供真正环境中的数据.
S3_BUCKET=devbucketSECRET_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-rootCACHE_DIR={$BASE_DIR}/cacheTMP_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 commentVAR="value" # commentVAR=value # comment
使用注释
当一个开发者克隆你的代码库. 他们会收到一个额外的手册 一次性步骤 来手动的复制 .env.example 并且重命名为 .env 并且追加上他们自己的值(或者从其他开发者哪里获取到其他敏感值).
phpdotenv 被用来建立开发者环境但是不应该用在生产环境下. 在生产环境下, 需要设置真实的变量而不必每次使用请求的时候都使用 .env 文件进行重载.
这个可以通过自动化部署工具来实现, 例如: Vagrant, chef, Puppet, 或者手动的通过云主机来实现, 例如: Pagodabox, Heroku.
参考
https://segmentfault.com/a/1190000010886175
- 设置环境变量配置的简单方法.env
- linux-java env setup(linux下java环境变量的设置)
- JAVA中配置环境变量的设置方法
- CGI的环境变量(env)
- 设置环境变量的方法
- Java jdk1.6+ 最简单的环境变量设置方法
- linux设置环境变量的4种方法和简单比较
- Ubuntu_设置Ubuntu环境变量 PATH 的方法 及配置备份
- 设置Ubuntu环境变量 PATH 的方法 及配置备份
- 设置Ubuntu环境变量 PATH 的方法 及配置备份
- 设置Ubuntu环境变量 PATH 的方法 及配置备份
- 环境变量的配置方法
- 环境变量env
- Java的环境变量简单配置,
- 关于linux操作系统的环境变量(env)
- 关于linux操作系统的环境变量(env)
- Linux env --显示当前用户的环境变量
- JDK环境变量的设置方法
- unity射线检测的小例子
- 不会编程也能爬数据!3个爬虫小工具教你实现~
- Gcc 和 gdb 习题
- RM装甲识别程序分析(一)
- SPOJ
- 设置环境变量配置的简单方法.env
- centos 7 安装 hadoop 2.7.1
- 算法导论20.2-2
- 安装cocoapods遇到error: RPC failed; curl 56 SSLRead() return error -36问题
- IOS -UISearchController UISearchBar
- 5-LTE Security I: LTE Security Concept and LTE Authentication
- 基础练习 FJ的字符串
- Activity的四种启动模式
- AVL_tree