FrankenPHP配置文件frankenphp.conf.php需用php -l检查语法，因其是纯PHP脚本；启动时直接include，故不可含运行时函数、输出语句或未定义依赖，且OPcache可能导致修改不生效。
有，但不能直接用 frankenphp 命令检查配置语法——它不提供类似 nginx -t 的验证模式。FrankenPHP 的配置本质是 PHP 代码（frankenphp.conf.php），所以得按 PHP 文件来验。
frankenphp.conf.php 是 PHP 脚本，必须用 php -l 检查
FrankenPHP 启动时会 直接 include 你的 frankenphp.conf.php，这意味着：它必须是合法的 PHP 代码，且不能依赖运行时上下文（比如不能调用 frankenphp_set_header() 等函数，因为此时 FrankenPHP 还没初始化）。
- 用
php -l frankenphp.conf.php可立即发现基础语法错误（漏分号、括号不配对、未闭合引号等） - 如果报错行是
return [ ... ];附近，重点检查数组键名是否用了非法字符、短数组[]是否在低版本 PHP 下使用、是否有 PHP 8+ 特性（如命名参数）写进了配置 - 注意：该文件里不能出现
echo、var_dump或任何输出语句，否则启动会失败（即使php -l通过）
配置里用了环境变量或动态逻辑？php -l 会静默失败
php -l 只做词法/语法解析，不执行代码。但如果你的 frankenphp.conf.php 包含了类似 $_ENV['APP_ENV'] ?? 'dev' 或 file_get_contents(__DIR__.'/secrets.json') 这类逻辑，php -l 仍能通过——但它可能在 FrankenPHP 启动时因环境缺失或文件不可读而崩溃。
- 临时加个
die('config loaded');在文件末尾，然后运行php frankenphp.conf.php，可验证是否能完整执行到结尾 - 若报
Undefined index或failed to open stream，说明环境或路径问题，不是语法错，但属于配置层面致命缺陷 - 不要在配置里写条件分支调用
frankenphp_*()函数——这些函数只在 FrankenPHP 运行时存在，php -l和php frankenphp.conf.php都会报Call to undefined function
修改后服务仍报 Parse error？大概率是 OPcache 缓存了旧配置
FrankenPHP 启动后，frankenphp.conf.php 会被 OPcache 编译缓存。你改了文件，但 PHP 还在用旧字节码，就会出现“明明 php -l 通过，启动却报错”的情况。
立即学习“PHP免费学习笔记（深入）”；
- 重启 FrankenPHP 进程（不是 reload）：先
kill -TERM $(cat frankenphp.pid)，再重新frankenphp server - 开发时加
-d opcache.enable=0：运行php -d opcache.enable=0 -l frankenphp.conf.php更贴近实际加载行为 - 确认
opcache.revalidate_freq=0（仅开发环境），避免缓存干扰
真正容易被忽略的是：FrankenPHP 配置文件里混用框架辅助函数（比如 Laravel 的 base_path()）、或把 .env 解析逻辑塞进去——这些在纯 PHP CLI 环境下根本不存在，php -l 看不出，但启动必挂。检查前先问自己：这行代码，脱离 FrankenPHP 运行时，能不能被 PHP 解释器单独跑通？
