frankenphp 命令找不到是因二进制未加入 path:需从 github releases 下载预编译文件,解压后复制到 /usr/local/bin 或添加至用户 path,并确认非通过 composer 安装。

FrankenPHP 安装后命令找不到,通常不是安装失败,而是二进制文件没放进系统 PATH,或下载/解压路径没被正确使用。
确认是否真的安装了二进制
FrankenPHP 不通过 composer install 或 pecl 安装,它是预编译的 Go 二进制。你需要手动下载、解压,并确保可执行:
- 去 GitHub Releases 页面 下载对应系统的最新版(如
frankenphp_1.2.0_linux_amd64.tar.gz) - 解压后检查是否存在
frankenphp文件:tar -tzf frankenphp_*.tar.gz - 运行
./frankenphp --version看是否输出版本号——如果可以,说明二进制本身没问题
把命令加进系统 PATH
如果 ./frankenphp 能运行,但 frankenphp(不带 ./)报 “command not found”,说明它不在 PATH 中:
- 把二进制复制到系统级目录:
sudo cp ./frankenphp /usr/local/bin/ - 或加到用户 PATH:编辑
~/.bashrc或~/.zshrc,追加一行:export PATH="$HOME/bin:$PATH",再把frankenphp放进~/bin/ - 执行
source ~/.bashrc(或source ~/.zshrc)刷新环境 - 验证:
which frankfurtphp应返回路径;frankenphp --help应正常显示
别和 Composer 工具混淆
FrankenPHP 和 composer create-project 生成的项目无关,也不提供 frankenphp 命令作为 PHP 包。如果你是用 composer require dunglas/frankenphp,那只是引入了 PHP SDK,不是安装服务器二进制——这个包里没有可执行文件。
真正能跑服务的 frankenphp 命令,只来自 GitHub 发布页下载的独立二进制。
Windows 用户注意路径和执行权限
Windows 上需确保:
- 下载的是
.zip版本(如frankenphp_1.2.0_windows_amd64.zip),解压后得到frankenphp.exe - 把它所在文件夹加进系统环境变量
PATH(控制面板 → 系统 → 高级系统设置 → 环境变量) - 重启终端(CMD/PowerShell)再试,不要依赖临时解压路径直接双击运行
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











