frankenphp php-cli 命令可直接运行 php 脚本，格式为 ./frankenphp php-cli /path/to/script.php，使用 frankenphp 自带运行时（含 opcache、xdebug），无需系统 php，支持传参和生产环境一致性校验。
frankenphp php-cli 命令能直接运行 PHP 脚本
FrankenPHP 的 php-cli 子命令就是为这个场景设计的：不走 HTTP 请求链路，纯 CLI 模式执行单个 PHP 文件，适合跑定时任务、数据迁移、调试脚本等。它和系统里装的 php 命令行为基本一致，但用的是 FrankenPHP 自带的 PHP 运行时（含 OPcache、Xdebug 等扩展），无需额外安装 PHP。
常见错误现象：
- 直接运行
./frankenphp myscript.php报错 “command not found”，因为没指定子命令 - 误用
php-server启动后手动发 HTTP 请求去“触发”脚本，绕远路且不可靠 - 脚本里用了
$_SERVER相关变量（如$_SERVER['DOCUMENT_ROOT']），结果为空——CLI 环境下这些变量默认不设置
实操建议：
- 确保你用的是 FrankenPHP 0.12+ 版本（2026 年主流发行版都满足），旧版可能不支持
php-cli - 命令格式固定为：
./frankenphp php-cli /path/to/script.php，路径必须是绝对路径或相对于当前工作目录的显式路径 - 如需传参，直接跟在脚本路径后：
./frankenphp php-cli ./migrate.php --env=prod --force - 想让脚本访问项目根目录？在脚本开头加一行：
chdir(__DIR__ . '/..');，避免依赖$_SERVER
为什么不用系统 php 命令而要用 frankenphp php-cli
核心区别在于运行时环境一致性。如果你的 Web 请求由 FrankenPHP 处理（比如用了 worker 模式或 Caddyfile 配置），而 CLI 脚本却用系统 php 执行，可能出现以下问题：
- PHP 版本不一致：系统可能是 PHP 8.2，FrankenPHP 自带的是 PHP 8.5，某些语法或扩展行为不同
- 扩展缺失：系统 php.ini 关闭了
pdo_mysql，但 FrankenPHP 二进制里默认启用，导致 Web 正常、CLI 报错 - OPcache 行为差异：CLI 默认禁用 OPcache，但
frankenphp php-cli可通过--enable-opcache显式开启，与 Web 环境对齐 - 配置加载路径不同：FrankenPHP 的
php-cli会优先读取其内置的php.ini（通常在二进制同级的etc/php.ini），而非系统路径
简单验证方式：./frankenphp php-cli -v 和 php -v 对比版本；./frankenphp php-cli -m 查看实际加载的扩展列表。
frankenphp php-cli 在 Docker 容器里怎么用
Docker 镜像（如 dunglas/frankenphp）默认入口是 php-server，要执行 CLI 脚本得覆盖 entrypoint 或用 docker run --entrypoint。
典型做法：
- 临时执行一个脚本：
docker run --rm -v $PWD:/app dunglas/frankenphp php-cli /app/artisan optimize:clear - 进入容器交互调试：
docker run -it --rm -v $PWD:/app dunglas/frankenphp sh -c "cd /app && ./frankenphp php-cli artisan tinker" - 注意挂载路径：容器内
/app是常用挂载点，但脚本路径必须写成容器内的路径（即/app/xxx.php），不是宿主机路径
容易踩的坑：
- 忘记
--rm，容器退出后残留，下次docker ps -a一堆 exited 状态 - 权限问题：宿主机脚本在 Linux 上无执行权限，容器内
chmod +x无效，应确保脚本本身可读（CLI 不需要 x 权限） - 容器内没有
/app目录？镜像启动逻辑可能先 cd 到某目录再执行，建议统一用-w /app指定工作目录
worker 模式下还能用 php-cli 吗
可以，而且推荐。worker 模式只影响 php-server 的请求处理流程，php-cli 是完全独立的子命令，不共享任何进程状态或内存空间。
但要注意：
-
php-cli每次执行都是全新进程，不会复用 worker 模式下已初始化的框架容器或数据库连接池 - 如果脚本需要复用 Laravel/Symfony 的服务容器，别指望 CLI 下自动加载——得自己调用
require 'vendor/autoload.php'和Application::getInstance()初始化 - 想让 CLI 脚本也享受常驻内存优势？目前不行。FrankenPHP 的 worker 模式仅作用于 HTTP 请求生命周期，CLI 就是传统 fork-exec 模型
真正容易被忽略的一点：FrankenPHP 的 php-cli 不支持 -S（内置服务器）参数，也不支持 -t（设置文档根目录）。它就是一个干净的 CLI 执行器，别试图把它当 Web 服务器用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
