worker模式下chdir()会永久改变线程cwd并污染后续请求：因线程复用，cwd变更不自动重置，require等相对路径操作将基于最后一次chdir()路径查找，导致文件加载失败；需在入口显式chdir(__dir__)或改用绝对路径构造。
Worker模式下chdir()会污染整个线程的当前工作目录
在 FrankenPHP Worker 模式中，PHP 脚本常驻内存、复用同一个线程处理多个请求，chdir() 不再是“一次一清”的临时切换——它会永久改变该线程的当前工作目录（CWD），后续所有请求都会继承这个路径。这和 classic 模式（每次请求新建进程/线程）完全不同，后者每次执行完就销毁，CWD 变更不会残留。
- 常见错误现象：
require 'config/database.php'在第一个请求成功，第二个请求报Warning: require(): failed to open stream；或者file_get_contents('data/cache.json')偶发找不到文件 - 根本原因：某个请求里调用了
chdir('/app')，之后同一线程处理的其他请求执行require 'config/...'时，实际查找的是/app/config/...，而非你预期的项目根目录 - Worker 线程生命周期内，
getcwd()返回值只取决于最后一次chdir()，且无法被自动重置
__DIR__ 和 dirname(__FILE__) 是安全的，但相对路径仍可能出错
虽然 __DIR__ 总是返回当前文件所在绝对路径，不受 chdir() 影响，但很多老代码依赖相对路径拼接，比如 require '../vendor/autoload.php' 或 file_put_contents('logs/app.log', $msg)。这类写法在 Worker 模式下极易因 CWD 变更而失效。
- 使用场景：Laravel 的
bootstrap/app.php、ThinkPHP 的start.php或自定义 Worker 入口脚本中常见此类逻辑 - 参数差异：
chdir()接受字符串路径，不校验是否真实存在；而realpath(__DIR__ . '/..')才能拿到稳定父目录 - 实操建议：所有 require/include 路径优先用
__DIR__或dirname(__FILE__)构造绝对路径；日志/缓存等写入操作避免裸用相对路径，改用__DIR__ . '/../storage/logs/'
Worker重启不会自动恢复初始CWD，必须显式重置
即使你配置了 worker_restart_interval 或触发了 Worker 主动重启，FrankenPHP 并不会把线程的 CWD “回滚”到启动时的状态。新实例的 CWD 默认继承上一个 Worker 实例退出前的最后值，而不是项目根目录或 frankenphp run 启动时的工作目录。
- 容易踩的坑：本地开发时反复
Ctrl+C再frankenphp run，看似重启了，但 Docker 容器或 systemd 服务里长期运行的 Worker 可能已偏离原始路径数小时 - 性能影响：频繁
chdir()+getcwd()调用本身开销极小，但路径错误导致的stat()失败、open_basedir 拒绝、OPcache 失效才是真瓶颈 - 实操建议：在 Worker 入口脚本顶部加一行
chdir(__DIR__);（假设入口文件在项目根），或更稳妥地用chdir($_SERVER['DOCUMENT_ROOT'] ?? __DIR__);
PHP-FPM对比：为什么这里特别危险
PHP-FPM 下每个请求都在独立子进程中执行，chdir() 只影响当前进程生命周期，进程退出即销毁。而 FrankenPHP Worker 的线程是共享资源，CWD 是线程级状态，不是请求级上下文。这种差异让“习惯性写法”突然变成隐蔽的竞态源。
- 调试技巧：在关键位置插入
error_log('CWD: ' . getcwd());，观察多个请求日志中的路径是否一致 - 兼容性注意：Swoole、RoadRunner 等常驻模式也有同样问题，但 FrankenPHP 因默认启用 OPcache + 静态文件服务，更容易掩盖路径错误引发的缓存命中失败
- 复杂点在于：有些框架（如旧版 CodeIgniter）在初始化时会主动
chdir()到APPPATH，若未包裹在chdir()/chdir()成对调用中，就会污染全局
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
