启用Windows长路径支持并配合mklink创建软链接：修改注册表LongPathsEnabled为1（需重启），再以管理员身份执行mklink /D runtime C:\tp-r，最后在config/app.php中配置'runtime_path' => 'C:/tp-r/'。
Windows下ThinkPHP报错“路径太长”怎么绕过
Windows默认限制文件路径不能超过260字符，而ThinkPHP在调试模式下生成的缓存路径（比如 runtime\cache\8f\9a\...）嵌套深、哈希长，很容易触发 ERROR_PATH_TOO_LONG 或直接抛出 InvalidArgumentException。这不是ThinkPHP的bug，是Windows API层硬限制。
最直接有效的做法不是改框架，而是让系统“看不见”长路径：
- 启用Windows的长路径支持：修改注册表
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled，设为1（需管理员权限 + 重启生效） - 或用组策略：计算机配置 → 管理模板 → 系统 → 文件系统 → “启用Win32长路径”，启用它
- 确认PHP运行在Windows 10 1607+ 或 Windows Server 2016+，旧系统不支持该开关
注意：即使开了长路径，某些老旧扩展（如部分版本的 opcache 或 APCu）仍可能因底层调用 CreateFileA 而失败，此时必须配合软链接降级路径深度。
用mklink创建软链接缩短ThinkPHP runtime路径
把深层嵌套的 runtime 目录映射到短路径（如 C:\tp-r），既绕过长度限制，又不影响框架逻辑。关键点在于：ThinkPHP只认你配置的 ROOT_PATH . 'runtime'，它不管这目录是不是链接。
立即学习“PHP免费学习笔记（深入）”；
操作前确保以管理员身份运行CMD或PowerShell：
- 先删掉原有
runtime目录：rmdir /s /q runtime - 创建短路径目标目录：
mkdir C:\tp-r - 建立目录软链接：
mklink /D runtime C:\tp-r - 检查是否成功：进项目根目录执行
dir，看到runtime [C:\tp-r]即生效
⚠️ 常见坑：mklink 在普通用户权限下会报“拒绝访问”，且 /D 参数不可省略（符号链接 vs 目录联接）；如果用Git Bash或WSL执行，mklink 不可用，必须切回Windows原生命令行。
将提醒同步至 Windows/Outlook 日历。用户提及「提醒我」「设置提醒」「加到日历」「同步到日历」「日程」「calendar」「日历」时触发。支持Microsoft Graph API 设备代码流认证，无需 Web 服务器，直接写入用户 Outlook 日历。
ThinkPHP中如何安全配置runtime路径指向软链接
不需要改框架源码，ThinkPHP 6.x 允许在 config/app.php 中显式指定 runtime_path，但要注意路径分隔符和末尾斜杠——Windows下用反斜杠易被PHP解析为转义，一律用正斜杠或双反斜杠。
推荐写法（在 app.php 中）：
return [
// ...
'runtime_path' => 'C:/tp-r/',
];
如果你坚持用相对路径（比如 ../tp-r/），要确保当前工作目录（getcwd()）稳定——CLI模式下常因启动位置不同导致解析失败；Web模式下一般没问题，但Nginx/Apache的root设置会影响相对路径基准。
另外，runtime 下子目录（cache、log、temp）会自动创建，无需手动建；但首次运行前建议清空原 runtime 内容，避免软链接残留旧文件句柄冲突。
软链接 + 长路径开关组合使用的兼容性边界
这套方案在ThinkPHP 6.0–6.3全系有效，但有两个容易被忽略的硬约束：
- PHP必须以
cli或cgi模式运行（即非ISAPI），IIS的ISAPI模式下软链接可能被忽略 - 杀毒软件（尤其是360、腾讯电脑管家）常拦截
mklink创建的链接，或实时扫描时锁死C:\tp-r导致ThinkPHP写缓存失败，临时关闭实时防护可验证是否为此原因
真正麻烦的是CI/CD场景：自动化部署脚本在无交互、无管理员权限的Windows Agent上无法执行 mklink，这时只能退回到开启长路径 + 调整ThinkPHP缓存命名规则（比如缩短哈希长度、减少目录层级），但这需要重写 Think\Cache\Driver\File 的 getCacheKey 方法——比软链接重得多。
