frankenphp v1.3支持在macos上直接执行php脚本:需先通过brew install frankenphp安装并确保frankenphp --version显示v1.3.x;运行脚本用frankenphp run script.php,支持传参(可加--隔离)和自定义php.ini配置。

在macOS上用FrankenPHP v1.3直接执行PHP脚本,不依赖Web服务器或额外服务进程,适合本地调试、CI任务或快速验证代码逻辑。
确认FrankenPHP已正确安装并可执行
打开终端,运行 frankenphp --version,输出应包含 v1.3.x 字样;若提示 command not found,请先通过 Homebrew 安装:brew install frankenphp,该命令会自动链接二进制到 /opt/homebrew/bin/frankenphp(Apple Silicon)或 /usr/local/bin/frankenphp(Intel)。
这一步必须成功,否则后续所有命令都会报错。如果已安装但不可用,检查 $PATH 是否包含对应路径,【未将 frankenphp 所在目录加入 PATH 会导致命令始终无法识别】。
用 FrankenPHP 直接运行单个 PHP 文件
进入脚本所在目录,执行:frankenphp run script.php。
FrankenPHP v1.3 的 run 子命令专为 CLI 模式设计,它会启动一个最小化运行时环境,加载 script.php 并执行其顶层代码(不经过 HTTP 生命周期)。与 php script.php 行为一致,但共享 FrankenPHP 内置的扩展和配置(如 opcache、curl、pdo_sqlite 默认启用)。
注意:该命令不支持 -f 或 --file 等传统 PHP CLI 参数别名,只接受位置参数形式。
运行带参数的 PHP 脚本
方法一:参数紧跟脚本名后,用空格分隔:frankenphp run test.php arg1 arg2 --verbose。
方法二:使用双横线隔离 FrankenPHP 自身参数与脚本参数:frankenphp run -- test.php --mode=dev -u admin。双横线之后的所有内容原样传入 $argv,FrankenPHP 不做解析。
脚本内可通过 var_dump($argv); 验证——$argv[0] 是 test.php,$argv[1] 开始才是你传入的参数。漏掉双横线可能导致参数被 FrankenPHP 误截获,比如 -v 会被当成 FrankenPHP 的版本查询指令而报错。
指定自定义 php.ini 配置运行
第一步:准备一个独立的配置文件,例如 cli-custom.ini,内容如:memory_limit = 512M、display_errors = On。
第二步:执行命令:frankenphp run --php-config cli-custom.ini script.php。
FrankenPHP v1.3 支持 --php-config 参数指定 INI 文件路径,该文件会在默认配置之后加载,覆盖对应指令。不加此参数时,它使用内置默认配置(等效于无 php.ini 的 CLI 模式)。【路径必须为绝对路径或相对于当前工作目录的相对路径,不支持 ~ 符号展开】。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











