在 TP5.1 中部分之前版本的预定义常量如 APP_PATH、ROOT_PATH 等被定义为了 项目的环境变量.

目前预定义的环境变量包括 (以项目路径 E:\wamp64\www\project_name 为例):

think_path: 系统框架目录路径, 如 E:\wamp64\www\project_name \thinkphp\

root_path: 项目路径, 如 E:\wamp64\www\project_name

app_path: 应用路径, 如 E:\wamp64\www\project_name\application\

config_path: 配置文件目录路径, 如: E:\wamp64\www\project_name\config\

route_path: 路由文件路径: 如: E:\wamp64\www\project_name\route\

runtime_path: 运行时目录路径: 如: E:\wamp64\www\project_name\runtime\

extend_path: 扩展类库路径, 如: E:\wamp64\www\project_name\extend\

vendor_path: 第三方类库目录路径, 如: E:\wamp64\www\project_name\vendor\

module_path: 当前模块的路径

管理环境变量

think\Env对象负责项目环境变量的存取.

设置环境变量

通过Env对象的set方法设置项目环境变量.

Env::set('name', 'value');

读取环境变量

通过助手函数env()可以快速获取预定义的环境变量. 该函数最终调用Env对象中的get方法.

env('name'); // 参数为空时, 获取所有的项目环境变量
Env::get('name');

获取环境变量, 会先获取预定义的项目环境变量, 如果没有找到, 则会获取 PHP 的环境变量. 都没有找到时, 返回 null. 但是在获取 PHP 内置环境变量时, TP 框架会默认为变量名追加PHP_前缀, 需要取消自动追加变量名前缀:

env('document_root', null, false); // 第三个参数指定为false, 获取$_SERVER['DOCUMENT_ROOT']

应用: 为各个模块配置通用的模板布局文件

在 template.php 中配置:

'layout_name' => env('app_path') . 'common/view/layout.html', // 以绝对路径的方式指定通用的布局文件

然后在 common 目录下的 view 目录建立 layout.html 布局文件即可.