TP5.1 预定义环境变量
在 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 布局文件即可.
