frankenphp静态二进制硬编码php.ini，运行时不读取任何外部php.ini文件；唯一修改方式是重新编译源码或使用frankenphp build --php-ini指定嵌入配置。
php.ini 在 FrankenPHP 中无法运行时替换
FrankenPHP 官方发布的静态二进制（Linux/macOS）把 php.ini 硬编码进可执行文件，启动时不读取文件系统上的任何 php.ini，哪怕你把自定义配置 COPY 到 /usr/local/lib/php.ini 也完全无效。这不是权限或路径问题，是设计如此——它用的是 embed 模式下的内置 PHP 运行时，ini 文件随二进制一起编译进去。
唯一生效方式：重新编译 FrankenPHP 或使用 build 命令
想改 php.ini 配置，只有两条路：
- 在项目根目录用
frankenphp build构建单文件二进制时，通过--php-ini参数指定自定义 ini 文件路径（该文件会被嵌入新二进制） - 克隆 FrankenPHP 源码，修改
caddy/php/php.go中的phpIniContent模板或构建脚本里的 ini 生成逻辑，再执行make build
注意：frankenphp build 是生产环境最实用的方式，它会把你的 php.ini、Caddyfile、PHP 应用全部打包进一个独立二进制，无需依赖宿主机环境。
docker 场景下常见误操作与替代方案
很多人尝试在 Dockerfile 中覆盖 php.ini，结果发现不生效。典型错误包括：
-
COPY my-php.ini /usr/local/lib/php.ini—— FrankenPHP 不读这个路径 - 用
php_admin_flag opcache.enable on写进 Caddyfile —— embed SAPI 不支持 php_admin_* 指令 - 在容器启动时用
ini_set()修改关键项（如opcache.enable）—— 大部分 opcache 参数只在模块加载时读取，运行时调用无效
替代做法是：用环境变量驱动框架层行为（如 Laravel 的 APP_DEBUG），或在构建阶段就固化配置。生产环境建议直接用 frankenphp build --php-ini=prod.ini --output=myapp 生成最终镜像基础。
worker 模式下 php.ini 加载时机极关键
一旦 FrankenPHP 启动并进入 worker 模式，php.ini 就只加载一次。这意味着：
- 修改 ini 后必须重启整个进程，SIGHUP 或 reload 不起作用
-
opcache.preload路径若写相对路径（如preload.php），基准目录是 FrankenPHP 二进制所在位置，不是项目根目录，容易报Failed to open stream - 所有缓存类参数（
opcache.memory_consumption、max_accelerated_files）都必须在首次启动前设好，运行中无法扩容
最容易被忽略的一点：你看到的 php -i | grep opcache 输出，来自当前系统 PHP CLI，和 FrankenPHP 实际运行的 embed PHP 完全是两个实例——它不能代表真实配置是否生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
