MacOS安装FrankenPHP权限不足需三步：先用xattr -d com.apple.quarantine解除隔离属性；再用chmod +x赋予执行权限；最后验证frankenphp --version是否成功。
MacOS 安装 FrankenPHP 时提示权限不足，通常出现在手动下载二进制文件后直接运行、或通过 Homebrew 安装后执行脚本失败的场景。根本原因是 macOS 默认不允许执行未签名或非系统路径下的可执行文件，尤其当文件从网络下载（如官网 zip 包）时，系统会自动加上 com.apple.quarantine 属性，阻止运行。
检查是否被系统隔离
终端中进入 FrankenPHP 二进制所在目录（比如 ~/Downloads/frankenphp），运行：
ls -l@ frankenphp
如果输出中包含 com.apple.quarantine，说明被 macOS 隔离。解除命令：
xattr -d com.apple.quarantine frankenphp
确保文件有执行权限
即使解除了隔离，仍需显式赋予可执行权限：
立即学习“PHP免费学习笔记（深入）”；
chmod +x frankenphp
若安装的是 Homebrew 版本（brew install frankenphp），正常情况下权限已正确设置；但如果用 brew link --force 或自定义路径迁移过，建议重新安装或手动修复：
- 卸载重装：
brew uninstall frankenphp && brew install frankenphp - 验证位置：
which frankenphp应返回/opt/homebrew/bin/frankenphp（Apple Silicon）或/usr/local/bin/frankenphp（Intel） - 确认权限：
ls -l $(which frankenphp)中应含-r-xr-xr-x或类似可执行标记
Laravel Octane 场景下的特殊处理
如果你是通过 php artisan octane:install --server=frankenphp 安装 Laravel Octane，它会在 vendor/bin/ 下生成 frankenphp-worker.php 和调用脚本。此时权限问题常出现在：
-
vendor/bin/frankenphp文件缺失或不可执行：先运行php artisan octane:install --server=frankenphp确保生成，再执行chmod +x vendor/bin/frankenphp - CI/CD 或 Docker 构建中跳过下载：检查
vendor/bin/frankenphp是否存在，不存在则手动下载对应 macOS 二进制并放入该路径，再赋权 - M1/M2 芯片用户遇到
bad CPU type in executable：确认下载的是darwin-arm64版本，不是darwin-amd64
验证是否真正生效
执行以下任一命令，不报错即成功：
frankenphp --version<br>frankenphp php-server --help
若仍提示 command not found，检查 PATH 是否包含 frankenphp 所在目录（Homebrew 默认已配置；手动安装需加到 ~/.zshrc 或 ~/.bash_profile）：
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc<br>source ~/.zshrc
