## 环境配置
环境配置通常使用在 HTTP 开发中,框架根目录的 `.env` 文件为环境配置文件,环境配置通常配置一些在不同环境中参数值不同的配置信息,如:数据库账号密码等。
>[success] 正确的使用方式:环境配置应该只在应用配置文件中使用,而程序代码中只使用应用配置。
可配置多个环境配置文件,如:`.env.dev` 、`.env.test` 、`.env.pro`,然后在入口文件中切换使用,以适应不同的环境,修改入口文件中 `loadEnvironmentFrom` 方法传入的文件路径即可切换。
~~~php
Mix::loadEnvironmentFrom(__DIR__ . '/../../../.env');
~~~
>[info] .env 文件,需要 ls -a 才能在服务器上显示出来。
## 应用配置
MixPHP 的 App 类实例化时需要传入一些配置信息,配置信息是一个数组,这些信息就是应用配置,通常应用配置会单独存放在一个文件中,这个文件就叫应用配置文件,一个 App 可以有多个配置文件来适应不同环境,但只能使用其中一个。
下面是一个入口文件的源码,能看到配置信息是如何导入 App 类的:
~~~php
$config = require __DIR__ . '/../config/main.php';
(new mix\web\Application($config))->run();
~~~
## 配置详情
一个典型的应用配置文件内容如下:
~~~php
return [
// 基础路径
'basePath' => dirname(__DIR__),
// 控制器命名空间
'controllerNamespace' => 'Http\Controllers',
// 中间件命名空间
'middlewareNamespace' => 'Http\Middleware',
// 全局中间件
'middleware' => [],
// 组件配置
'components' => [
],
// 依赖配置
'beans' => [
],
];
~~~
- 控制器命名空间需要根据实际情况而作修改
~~~
// Console应用
'commandNamespace' => '模块名称\Commands',
// HTTP应用
'controllerNamespace' => '模块名称\Controllers',
~~~
- `components` 字段内是组件配置信息,详情请查看 "Component" 章节。
- `beans` 字段内是依赖配置信息,详情请查看 "Bean" 章节。
## 自定义配置
>[danger] MixPHP 并不建议这样直接获取配置,因为我们提供了非常好用的依赖注入功能,用户可直接将配置注入到对应的类中。
配置文件内的全部 `key`,都将变为 App 对象的属性名称,`value` 会成为该属性的值,该方式是 MixPHP 的核心思想,可查看 "Bean" 章节了解更多。
因此,我们可以这样获取到配置信息:
~~~
// 方法1
echo app()->basePath;
// 方法2
echo app()->config('components.error');
~~~
也就是说,你如果想增加自己的配置信息,在配置文件内增加一个新的字段,然后使用上面的方法即可获取。
- 欢迎使用 MixPHP
- 安装说明
- 全量安装
- Phar 命令行
- 入门须知
- 增改应用
- 命名空间
- 自动加载
- 入口文件
- 配置文件
- 服务开发
- 核心基础
- Bean
- Component
- Application
- 命令行
- 简介
- 命令行开发常识
- 命令行开发
- 创建命令
- 命令参数
- 打印与颜色
- 控制台程序
- 守护程序
- HTTP 服务
- 简介
- 服务器
- 路由
- 请求
- 响应
- 控制器
- 视图
- Auth
- Session
- 文件上传
- 其他组件
- 分页
- 验证码
- 图片处理
- 客户端
- GuzzleHttp
- 杂项
- Apache/PHP-FPM部署
- 调试与错误
- 安全建议
- WebSocket 服务
- 简介
- 服务器
- 注册器
- 连接
- 客户端
- 测试
- 杂项
- nginx代理
- 60s无消息断线
- TCP 服务
- 简介
- 服务器
- 客户端
- 测试
- UDP 服务
- 简介
- 服务器
- 客户端
- 测试
- 协程
- 简介
- 开启协程
- PHP Stream Hook
- xgo + Channel
- WaitGroup + xdefer
- 连接池
- 协程池
- 定时器
- 公共组件
- 中间件
- 验证器
- 验证器定义
- 验证规则
- 静态调用
- 模型
- 日志
- 缓存
- 数据库
- Database
- QueryBuilder
- PDOConnection
- Persistent\PDOConnection
- Coroutine\PDOConnection
- MasterSlave\PDOConnection
- ExecuteListener
- Redis
- RedisConnection
- Persistent\RedisConnection
- Coroutine\RedisConnection
- ExecuteListener
- 常见问题
- 同一台服务器部署多个服务
- 连接多个数据库
- 如何设置跨域
- form-data 上传文件失败
- 开发工具
- 版本更新
- 不兼容改动
- 升级指南
- 文档历史