安装后需三步验证：一查二进制存在与权限，运行which和--version；二验依赖库，linux用ldd、macos用otool排查缺失；三启最小服务并curl测试响应。

安装完成后，不能只看命令是否返回成功，关键要确认二进制可执行、依赖库完整、基础服务能启动且响应正常。以下三步缺一不可。

第一步：确认二进制存在且有执行权限

运行 which frankenphp，确保输出类似 /usr/local/bin/frankenphp；再执行 frankenphp --version，应显示 FrankenPHP 版本（如 v1.2.0）。若提示 command not found 或权限错误，需检查是否漏了 chmod +x 或未放入 $PATH 路径。

第二步：验证系统依赖是否满足

FrankenPHP 不是“免依赖”，仍需 libc、libssl、libbpf 等底层库。启动失败常卡在 dlopen 阶段，表现为静默退出或 Operation not permitted。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• Linux 上运行：ldd $(which frankenphp) | grep "not found"，重点排查标为 not found 的行（如 libbpf.so.1 => not found）
• macOS 上改用：otool -L $(which frankenphp)，若某库只有名字、没有 => 后的路径，说明系统找不到它

第三步：启动一个最小服务并验活

建一个空目录，放一个 index.php，内容为 <?php echo "OK"; ?>，然后执行：

frankenphp php-server --document-root .

接着访问 curl http://localhost:8000/，预期返回 OK 且 HTTP 状态码为 200。若连接拒绝、超时或返回 404，说明监听失败或 document-root 路径不匹配。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！