PHP本身没有内置CACHE常量,直接使用会报“Undefined constant 'CACHE'”错误;所有CACHE_DIR、CACHE_PATH等均为项目或框架自行定义,原生PHP仅提供__DIR__等基础路径工具。

PHP 本身没有内置的 CACHE 常量,任何直接使用 CACHE 的代码都会报 Undefined constant 'CACHE' 错误。你看到的 CACHE_DIR、CACHE_PATH 等,全是项目自己定义的,不是 PHP 语言层提供的。
为什么直接用 CACHE 会报错
PHP 解析器在遇到未声明的常量时,会先尝试把它当字符串字面量处理(PHP 7.2+ 已禁用该行为),但更大概率直接抛出 Notice: Use of undefined constant CACHE 或 Fatal error。这不是配置问题,是根本不存在这个东西。
-
CACHE_DIR常见于手写缓存逻辑,比如define('CACHE_DIR', __DIR__ . '/cache'); -
CACHE_PATH多见于 ThinkPHP 框架,默认指向RUNTIME_PATH . 'cache/',但前提是框架已初始化并完成常量定义 - 原生 PHP 只提供
__DIR__、__FILE__、dirname()这类路径基础工具,所有“缓存目录常量”都得你自己造
__DIR__ 是构建缓存路径的唯一可靠起点
别依赖环境变量或相对路径拼接,__DIR__ 返回当前文件所在目录的绝对路径,不随 chdir() 或 CLI 工作目录变化,是唯一可信赖的锚点。
- 想在当前文件同级建
cache/:$cacheDir = __DIR__ . '/cache'; - 想在项目根目录建
runtime/cache/:$root = dirname(__DIR__, 2); $cacheDir = $root . '/runtime/cache';(PHP 7.0+ 支持dirname($path, $levels)) - 避免
getcwd() . '/cache'—— CLI 下执行位置不同,结果就不同;Web 下可能返回 Web 服务器工作目录,和你的代码位置完全无关
ThinkPHP 中的 CACHE_PATH 不是全局可用的
ThinkPHP 的 CACHE_PATH 是框架在初始化 runtime 目录时动态定义的,仅在框架生命周期内有效。如果你在入口文件 index.php 之外、或框架未启动前(比如单独跑一个 CLI 脚本)直接 echo CACHE_PATH,照样报错。
立即学习“PHP免费学习笔记(深入)”;
- 确认是否已加载框架:检查是否执行过
require 'thinkphp/start.php'或类似引导逻辑 - 运行时目录权限必须可写,否则
CACHE_PATH对应的物理目录无法创建,后续cache()方法会静默失败 - 不要在配置文件里反向依赖
CACHE_PATH—— 它本身是由RUNTIME_PATH拼出来的,而RUNTIME_PATH又可能依赖ROOT_PATH,环状依赖极易出错
手写缓存目录时最容易忽略的三个细节
哪怕你用 __DIR__ 拼出了路径,mkdir 和写入仍可能失败,原因往往藏在这些地方:
- 目录权限没递归设置:
mkdir($cacheDir, 0755, true)的第三个参数true必须加,否则父目录不存在时直接报错 - SELinux 或容器环境限制:Linux 容器里即使权限是 755,也可能因安全策略禁止写入,需检查
ls -Z $cacheDir和日志中的 AVC denied 记录 - Windows 路径分隔符混用:虽然
__DIR__自动适配系统,但硬编码'/cache'在 Windows 下可能被解释为根目录,应统一用DIRECTORY_SEPARATOR或保持单斜杠(PHP 内部会自动转换)



















