FrankenPHP是用Go编写的现代PHP应用服务器，通过直接集成libphp绕过FastCGI协议层，实现零IPC开销和Goroutine级隔离；它不兼容依赖Apache hooks的扩展、REQUEST_URI由自身构造、无opcache.restrict_api等效机制。
FrankenPHP 是什么，它和传统 PHP-FPM 有什么根本区别
FrankenPHP 不是 PHP 的替代品，而是用 Go 编写的现代 PHP 应用服务器，它把 libphp（PHP 官方嵌入式 SAPI）直接集成进 Go 进程，绕过了 CGI/FastCGI 协议层。这意味着没有额外的进程间通信开销，也没有独立的 PHP-FPM master/worker 管理模型。
你不用再配 php-fpm.conf、不用写 location ~ \.php$ 的 Nginx 规则、也不用担心 pm.max_children 和内存泄漏传导问题——FrankenPHP 自己调度 PHP 请求，且每个请求在独立的 Goroutine 中运行，崩溃不会波及其他请求。
常见误判点：
– 它不兼容所有 PHP 扩展（尤其是依赖 mod_php 或 Apache hooks 的）；
– $_SERVER['REQUEST_URI']、$_SERVER['SCRIPT_NAME'] 的值由 FrankenPHP 主动构造，不是从 Web 服务器传入，某些重写逻辑会出错；
– 没有 opcache.restrict_api 的等效机制，OPcache 配置仍需在 php.ini 中设置。
如何用 FrankenPHP 启动一个 Laravel 项目（无 Docker）
FrankenPHP 提供开箱即用的静态二进制，不需要编译或安装 Go 环境。关键动作是让它的内置 HTTP 服务器正确识别 Laravel 的入口和静态资源路径。
执行步骤：
- 下载对应平台的
frankenphp二进制（如frankenphp_1.2.0_linux_amd64.tar.gz），解压后确保可执行权限 - 进入 Laravel 项目根目录（含
public/子目录），运行：./frankenphp server --document-root public/ --router ./public/.frankenphp.router.php
-
.frankenphp.router.php必须存在，最简内容为：<?php return [ 'index' => 'index.php', ];
- 如果 Laravel 使用了自定义中间件或需要
APP_URL动态识别，建议在.frankenphp.router.php中显式设置：$_SERVER['APP_URL'] = 'http://' . ($_SERVER['HTTP_HOST'] ?? 'localhost:8080');
注意：FrankenPHP 默认监听 :8080，不自动读取 .env 中的 APP_PORT；Laravel 的 storage/logs/ 权限仍需手动保证 web 用户可写。
为什么 $_FILES 为空或上传失败
FrankenPHP 对文件上传的处理与 PHP-FPM 不同：它默认将上传临时文件写入内存（max_memory_upload），超过阈值才落盘。但这个阈值默认极小（约 2MB），且不响应 upload_max_filesize 或 post_max_size 的 ini 设置。
修复方式只有两种：
- 在启动命令中显式调大内存限制：
./frankenphp server --document-root public/ --upload-max-memory 50M
- 或强制全部上传都落盘（更稳定，尤其对大文件）：
./frankenphp server --document-root public/ --upload-dir /tmp/frankenphp-uploads
（需提前mkdir -p /tmp/frankenphp-uploads && chmod 755 /tmp/frankenphp-uploads）
另一个易漏点：FrankenPHP 不自动清理 --upload-dir 下的临时文件，必须自己加定时任务或在 PHP 中用 register_shutdown_function() 清理，否则磁盘会被撑满。
何时该放弃 FrankenPHP，退回 PHP-FPM
FrankenPHP 适合新项目、API 服务、轻量后台，但遇到以下情况建议立刻切回 PHP-FPM：
- 项目重度依赖
apache_request_headers()、set_error_handler()的全局注册行为，或使用了pcntl_fork()—— FrankenPHP 不支持多进程模型 - 用了
ext-apcu并开启apc.enable_cli=1，因为 FrankenPHP 的 CLI 模式不加载 APCu 的共享内存段 - 部署环境受限于旧内核（failed to create new OS thread
- 需要
xdebug远程调试 —— 当前版本 FrankenPHP 无法与 Xdebug 协同工作（会卡在zend_execute_ex）
FrankenPHP 的优势集中在“单二进制、低延迟、无外部依赖”，但它不是万能胶。真正难的是判断哪些框架特性你其实没在用，却因惯性不敢换——比如 Laravel 的队列驱动、缓存适配器、日志通道，大多和底层 SAPI 无关，可以照常跑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
