frankenphp 不是 php 替代品，而是自带嵌入式 php 运行时（embed sapi）的单二进制应用服务器；它不依赖系统 php，启动即用内置版本（如 php 8.2/8.3），配置、扩展、版本均由其统一管控，避免环境冲突。
FrankenPHP 不是 PHP 的替代品，它依赖 PHP 运行时，必须先有 PHP 才能跑 FrankenPHP —— 但你不需要手动装 PHP。
FrankenPHP 自带 PHP 运行时，不依赖系统 PHP
FrankenPHP 的二进制文件里已经嵌入了 PHP 解释器（准确说是 embed SAPI），启动时直接调用内置版本，完全绕开系统 php 命令。你用 frankenphp php-server 启动服务，背后跑的是它自带的 PHP 8.2 或 8.3（取决于下载的发行版），和系统里装没装 php、装的是哪个版本、有没有启用 opcache 扩展，统统无关。
这意味着：
- 不用
apt install php或brew install php预装 PHP - 不会和系统 PHP 的配置（
php.ini）、扩展（pdo_mysql、redis）冲突 - 升级 FrankenPHP 就等于升级了 PHP 版本，无需单独维护 PHP
哪些情况你仍需手动装 PHP？
仅当你要做以下几件事时，才需要额外安装系统 PHP：
- 在 CLI 下独立运行脚本（比如定时任务、数据迁移），且不想用
frankenphp php-cli /path/to/script.php - 本地开发时用 IDE 调试、静态分析（如 PHPStan、Psalm），它们通常依赖
php可执行文件路径 - 构建阶段需编译扩展（如自定义
.so），而 FrankenPHP 的静态二进制不支持动态加载
注意：frankenphp php-cli 是它提供的 CLI 入口，功能等价于系统 php，只是路径和配置隔离。日常开发中，优先用它，能避免环境漂移。
装错顺序或混用会导致什么问题？
常见踩坑点：
- 误以为“FrankenPHP 是个 PHP 包”，用
composer global require dunglas/frankenphp—— 这根本不存在，FrankenPHP 不是 Composer 包 - 系统已装 PHP 8.1，又下载 FrankenPHP（含 PHP 8.3），结果
php -v和frankenphp php-cli -v显示不同版本，误判环境不一致 - 在
Caddyfile里写php_backend unix//var/run/php/php8.1-fpm.sock—— FrankenPHP 根本不走 FPM socket，这条配置会被忽略甚至引发 502
最简实践：只下载 FrankenPHP 二进制，chmod +x 后直接运行；把所有 PHP 相关操作（包括 CLI 脚本）都通过 frankenphp php-cli 触发。系统 PHP 留空，反而最干净。
真正要纠结的不是“装哪个”，而是“PHP 行为是否受控”——FrankenPHP 把 PHP 运行时封装进确定版本、确定扩展、确定配置的单二进制里，这种确定性比手动维护一堆 PHP 安装更关键。别被“PHP”二字带偏，它在这里是被管理的组件，不是你要打交道的主体。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
