杂项一章收纳开发中的支撑性知识:系统路径常量、路径助手、环境变量、类库导入与自动加载、常用助手函数。本文逐一整理,结尾附综合小实例。参考:ThinkPHP 8 杂项。
一、系统路径常量
框架预定义了一组路径常量,拼路径不用手写相对目录:
| 常量 | 含义 |
|---|---|
ROOT_PATH | 项目根目录(以目录分隔符结尾) |
APP_PATH | 应用目录(app/) |
CORE_PATH | 框架核心目录 |
CONFIG_PATH | 配置目录(config/) |
RUNTIME_PATH | 运行时目录(runtime/) |
LOG_PATH / CACHE_PATH | 日志目录 / 缓存目录 |
EXTEND_PATH / VENDOR_PATH | 扩展类库目录 / composer 目录 |
DS | 目录分隔符(Linux 为 /) |
echo ROOT_PATH . 'public' . DS . 'uploads';
// /www/wwwroot/project/public/uploads
二、路径助手函数
root_path(); // 项目根目录
app_path(); // 应用目录
config_path(); // 配置目录
runtime_path(); // 运行时目录
runtime_path('log'); // 运行时子目录
vendor_path(); // vendor 目录
读写文件、拼接目录优先用这些助手和常量,Linux/Windows 通吃,换部署环境不用改代码。
三、环境变量(.env)
不同环境(开发/测试/生产)的差异配置放 .env 文件,各环境各一份、不进版本库:
# .env
[app]
debug = true
[database]
hostname = 127.0.0.1
database = blog
username = root
password = 123456
use thinkfacadeEnv;
Env::get('app.debug'); // 读取:true
Env::get('database.hostname', 'localhost'); // 读取 + 默认值
配置文件里也可以引用环境变量,实现一处切换整套环境:
// config/database.php
'hostname' => Env::get('database.hostname', '127.0.0.1'),
'password' => Env::get('database.password', ''),
数据库密码等敏感信息放 .env,别写进会被提交到仓库的 config。
四、类库导入与自动加载
- 应用类库:遵循 PSR-4,
appcontrollerBlog对应app/controller/Blog.php,use即自动加载 - Composer 类库:
composer require安装后use vendorpackageClass;直接使用 - 扩展类库:自己写的通用类放
extend/目录,在composer.json的 psr-4 里补充命名空间映射后composer dump-autoload;更好的做法是封装成 composer 包
五、常用助手函数速查
| 分类 | 函数 | 作用 |
|---|---|---|
| 请求 | request() | 获取请求对象 |
| 响应 | json()、view()、redirect()、xml() | 生成各类响应 |
| 配置 | config('app.app_debug') | 读取(也可写入)配置 |
| 地址 | url('blog/read',['id'=>1]) | 按路由生成地址 |
| 会话/Cookie | session('user')、cookie('name') | 读写会话与 Cookie |
| 缓存 | cache('key')、cache('key', $val) | 读写缓存 |
| 数据库 | db('user') | 快速进入查询构造器 |
| 验证 | validate('appvalidateUser') | 获取验证器实例 |
| 调试 | dump()、halt() | 打印变量 / 打印并中止 |
| 其它 | abort(404)、lang('welcome') | 抛 HTTP 异常、多语言取值 |
六、综合小实例:按环境生成上传目录
把路径常量、助手、环境变量串起来:
use thinkfacadeEnv;
use thinkfacadeLog;
public function upload()
{
// 1. 路径助手 + DS 拼目录,跨平台安全
$uploadRoot = root_path() . 'public' . DS . 'uploads' . DS . date('Ymd');
// 2. 目录不存在则创建
if (!is_dir($uploadRoot)) {
mkdir($uploadRoot, 0755, true);
}
// 3. 环境变量决定是否记录调试日志
if (Env::get('app.debug')) {
Log::write('上传目录:' . $uploadRoot);
}
return json(['code' => 1, 'path' => $uploadRoot]);
}
一个方法用到了路径助手、目录分隔符、环境变量和日志 —— 这些正是杂项一章解决的"脚下的路"问题。
七、总结
路径靠常量和助手(ROOT_PATH/root_path/DS),环境差异靠 .env + Env::get,敏感信息进 .env 不进仓库;类库 PSR-4 自动加载、composer 管第三方;常用助手函数记住 request/json/view/url/config/cache/dump 这一串,开发效率高一截。