验证frankenphp需三步:一查二进制存在与执行权限(which、ls -l);二验架构匹配(file或--version,arm64/x86_64须对应芯片);三启服务测健康端点(php-server + curl返回ok)。

macOS安装FrankenPHP v1.2.1后,需通过终端命令验证二进制是否可执行、架构是否匹配、基础服务能否启动,三者缺一不可。
检查二进制是否存在且有执行权限
在终端中运行:which frankenphp。若返回路径(如 /usr/local/bin/frankenphp),说明已加入PATH;若无输出,检查是否漏掉 sudo mv 步骤或路径写错。
运行 ls -l $(which frankenphp),确认权限含 x(如 -rwxr-xr-x)。没有执行权限会直接报 command not found 或 Permission denied,此时必须补上 chmod +x。
验证架构是否与Mac硬件匹配
方法一:用 file 命令看二进制类型
运行 file $(which frankenphp)。
Apple Silicon(M1/M2/M3)应显示 Mach-O 64-bit executable arm64;Intel Mac 应显示 Mach-O 64-bit executable x86_64。
【若显示 x86_64 却在 M 系列芯片上运行,后续必报 exec format error】
方法二:快速试运行
直接输入 frankenphp --version。成功则输出类似 FrankenPHP v1.2.1 (Go 1.23.2, PHP 8.3.12);失败若提示 Bad CPU type in executable,就是架构错配,需重新下载 frankenphp-darwin-arm64 或 frankenphp-darwin-amd64 对应版本。
启动最小服务并访问健康端点
第一步:进入一个空目录,例如 mkdir -p ~/test-franken && cd ~/test-franken
第二步:创建最简 PHP 入口文件 index.php,内容为 <?php echo "OK";
第三步:启动服务:frankenphp php-server --document-root . --router ./index.php
第四步:新开终端窗口,执行 curl -s http://127.0.0.1:8080/。预期返回纯文本 OK。
若返回空、超时或连接拒绝,说明服务未真正监听——常见原因是端口被占用(换 --addr :8081 重试)或 router 路径写错(必须是相对当前目录的路径,不能写绝对路径)。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











