FrankenPHP 1.2默认加载系统php.ini，但推荐用-c /dev/null禁用所有ini文件，再通过frankenphp.yaml或ini_set()按需配置，以避免opcache、xdebug等扩展冲突。
FrankenPHP 1.2 默认使用系统级 php.ini（如 /etc/php/8.x/cli/php.ini 或编译时指定路径），但它的设计目标之一是轻量、隔离、面向现代 PHP 应用（尤其是 Symfony/Laravel），因此提供了明确的机制绕过或禁用传统 php.ini 加载，从而避免扩展冲突（比如 opcache、xdebug、session 等与 FrankenPHP 内置行为不兼容的模块）。
以下是实际可行的三种方式，按推荐顺序排列：
-
方式一：启动时显式指定空配置目录（最推荐）
使用-c /dev/null（Linux/macOS）或-c NUL（Windows）强制 PHP 不加载任何php.ini文件：frankenphp run -c /dev/null -v
这会跳过所有
php.ini查找逻辑（包括PHPRC、默认路径等），所有配置回归 PHP 编译默认值。你再通过ini_set()、.user.ini或 FrankenPHP 的frankenphp.yaml显式启用所需项（如opcache.enable=1），完全掌控扩展行为。 -
方式二：用
-c指向一个空白或最小化 ini 文件
创建一个仅保留必要配置的frankenphp.ini，例如：; 只启用 FrankenPHP 兼容必需项 zend.enable_gc = 1 error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT display_errors = Off log_errors = On ; 显式禁用易冲突扩展 extension=opcache.so opcache.enable=0 session.auto_start=0
启动时指定：
立即学习“PHP免费学习笔记（深入）”；
frankenphp run -c /path/to/frankenphp.ini
-
方式三：利用 FrankenPHP 的
frankenphp.yaml覆盖运行时配置（适用于 HTTP 模式）
在项目根目录放frankenphp.yaml，用php_ini_values键直接设置关键 ini 项（无需扩展加载）：php_ini_values: opcache.enable: "0" session.save_handler: "files" xdebug.mode: ""
此方式不会禁用
php.ini，但能覆盖其中冲突项，适合渐进式迁移。
⚠️ 注意事项：
-
--disable-session这类编译期选项在 FrankenPHP 中不可用（它基于 PHP 构建但不暴露原始./configure参数）。禁用 session 应改用session.auto_start=0+ini_set('session.save_handler', 'none')（PHP 8.4+ 支持'none'handler）。 -
phar.readonly=0等安全敏感项若需修改，必须在-c指定的 ini 文件中设置，不能靠ini_set()（因INI_SYSTEM级别限制）。 - 扩展冲突常见于
xdebug、blackfire、newrelic等调试/监控扩展——它们常依赖auto_prepend_file或rinit钩子，与 FrankenPHP 的协程/worker 模型不兼容，建议彻底移除或仅在 CLI 调试时临时启用。
不复杂但容易忽略的是：FrankenPHP 的 run 命令默认走 CLI SAPI，而 server 模式用的是自定义 SAPI，两者 php.ini 加载行为一致，但扩展兼容性表现可能不同。测试时建议统一用 frankenphp run -c /dev/null 快速验证是否为 ini 干扰所致。
