which frankenphp 返回空或 command not found，说明PATH未包含其所在目录，需检查文件存在性、执行权限、PATH配置及macOS Gatekeeper拦截。
which frankenphp 返回空或 command not found
说明系统 PATH 没包含该二进制所在目录，不是文件丢了，而是 shell 根本没去那找。常见于手动下载后没挪到标准路径、Homebrew 安装失败、或终端未重载 PATH。
检查步骤：
- 运行
ls -l ./frankenphp或ls -l ~/Downloads/frankenphp确认文件确实存在且有执行位（-r-xr-xr-x） - 用
echo $PATH查看当前 PATH 是否含你放二进制的目录（比如/usr/local/bin或~/bin） - 临时加路径测试：
PATH="$PATH:/path/to/dir" frankenphp --version - 永久生效：把
export PATH="/path/to/dir:$PATH"加进~/.zshrc（macOS）或~/.bashrc（Linux），再source一下
which 找到了但运行报 Permission denied
这大概率是 macOS Gatekeeper 拦截，不是权限位问题。chmod +x 无效，因为系统压根不让你 execve 加载它。
验证方式：
立即学习“PHP免费学习笔记（深入）”；
- 运行
file $(which frankenphp)，若输出含cannot execute binary file或Operation not permitted，就是 Gatekeeper - 右键该文件 → “显示简介” → 底部看是否有“已阻止来自未知开发者的应用”提示
解决办法（选一个）：
- 右键 → “打开”，弹窗点“仍要打开”（一次性的，最安全）
- 命令行清除隔离标记：
xattr -d com.apple.quarantine $(which frankenphp) - 若为开发机且信任来源，运行
sudo spctl --master-disable，然后在“系统设置→隐私与安全性→安全性”里勾选“任何来源”
which 找到、能执行，但提示 php 命令不存在
FrankenPHP 本身不提供 php 命令，它只带 frankenphp。如果你在配置或脚本里写了 php -v 或调用了 php，那它查的是系统 PATH 里的 php，和 FrankenPHP 无关。
常见误操作：
- 误以为
frankenphp安装会覆盖或提供phpCLI —— 不会，它只新增一个命令 - 在 Caddyfile 或启动脚本中硬编码了
php路径，但系统没装 PHP 或 PATH 不对 - 用
frankenphp php-cli -v却提示找不到php-cli子命令——注意：这是 FrankenPHP v1.1+ 才支持的内置子命令，旧版本不识别
docker run 启动后容器里找不到 frankenphp 命令
Docker 镜像里没有 frankenphp，除非你显式安装或 COPY 进去。官方镜像 dunglas/frankenphp 的入口是 frankenphp，但它的 $PATH 可能没把二进制所在目录加进去，或者你覆盖了 ENTRYPOINT。
排查重点：
- 进容器执行
which frankenphp或find / -name frankenphp 2>/dev/null - 确认你用的是
dunglas/frankenphp:latest（不是php:alpine这类基础镜像） - 如果自己写 Dockerfile，别漏掉
COPY frankenphp /usr/local/bin/和RUN chmod +x /usr/local/bin/frankenphp - 避免用
docker run -it php:8.3 bash这类命令，它根本没 FrankenPHP
