php-cli (v1.13.0): $argv[0] is "frankenphp" and the script path is shifted to $argv[1] — breaks Symfony Console
维护者通常 1 天内回复
评估
调研方向
Start by reading caddy/php-cli.go and trace how its argument vector reaches frankenphp_execute_script_cli and do_php_cli. Compare the resulting $argv and $argc with native PHP and FrankenPHP 1.12.7 using the reproduction in the issue. Done means php-cli exposes the script path as $argv[0] and the remaining arguments in the same positions as native PHP.
由索引模型根据 Issue 内容生成。
描述
What happened?
Since v1.13.0, frankenphp php-cli script.php args... exposes the binary name as $argv[0] and shifts the script path to $argv[1] ($argc grows by one). Native php and FrankenPHP ≤ 1.12.7 expose the script path as $argv[0], as documented for the CLI SAPI.
Minimal reproduction (same PHP 8.5.11, only FrankenPHP differs):
<?php printf("PHP %s SAPI=%s argc=%d argv=%s\n", PHP_VERSION, PHP_SAPI, $argc, json_encode($argv));
# dunglas/frankenphp:1.12.7-php8.5
php /t/argv.php foo bar → PHP 8.5.11 SAPI=cli argc=3 argv=["/t/argv.php","foo","bar"]
frankenphp php-cli /t/argv.php foo bar → PHP 8.5.11 SAPI=cli argc=3 argv=["/t/argv.php","foo","bar"]
# dunglas/frankenphp:1.13.0-php8.5
php /t/argv.php foo bar → PHP 8.5.11 SAPI=cli argc=3 argv=["/t/argv.php","foo","bar"]
frankenphp php-cli /t/argv.php foo bar → PHP 8.5.11 SAPI=cli argc=4 argv=["frankenphp","/t/argv.php","foo","bar"]
$_SERVER['argv'] shows the same shift. SCRIPT_NAME, PHP_SELF and SCRIPT_FILENAME are correct in both versions. Passing -- does not help (-- then shows up inside $argv).
Impact: anything that treats $argv[0] as the script and $argv[1] as the first argument breaks. The most visible case is Symfony Console: ArgvInput drops argv[0] and takes the next element as the command name, so every command fails with
Command "/app/bin/console" is not defined.
This affects frankenphp php-cli bin/console doctrine:migrations:migrate, messenger:consume, messenger:stop-workers, etc. The HTTP server and worker mode are unaffected.
Likely cause: #1757 ("simply use the built-in php-cli"). caddy/php-cli.go now builds the argument vector as append([]string{os.Args[0]}, os.Args[2:]...) (the binary name is prepended so option parsing works like php -i) and passes it unchanged through frankenphp_execute_script_cli to do_php_cli(argc, argv). The real php binary shifts the vector after option parsing so that the script becomes $argv[0]; that shift does not happen on this code path, so user scripts see the raw vector including the binary name. The pre-1.13 emulation built the vector starting at the script path, which is why it was correct before.
Expected: frankenphp php-cli script.php a b gives $argv === ["script.php","a","b"], exactly like php script.php a b.
Build Type
Official Docker image (dunglas/frankenphp:1.13.0-php8.5); also reproduced with a custom build of v1.13.0.
Worker Mode
No — CLI only (php-cli), unrelated to worker mode.
Operating System
GNU/Linux (Debian-based official image; host: Linux x86_64, podman 5.8)
CPU Architecture
x86_64
PHP configuration
phpinfo() output
PHP 8.5.11 (bundled in the official image), default php.ini, no custom extensions needed to reproduce. The repro script above has no dependencies.
Relevant log output
Relevant log output
$ podman run --rm -v $PWD/argv.php:/t/argv.php:ro dunglas/frankenphp:1.13.0-php8.5 frankenphp version
FrankenPHP v1.13.0 PHP 8.5.11 Caddy v2.11.7 h1:yj0Y4fYZGPkSvibBJ1sTWE33xC0fxztVyXEW5iIdUT4=
$ podman run --rm -v $PWD/argv.php:/t/argv.php:ro dunglas/frankenphp:1.13.0-php8.5 frankenphp php-cli /t/argv.php foo bar
PHP 8.5.11 SAPI=cli argc=4 argv=["frankenphp","\/t\/argv.php","foo","bar"]
$ podman run --rm -v $PWD/argv.php:/t/argv.php:ro dunglas/frankenphp:1.12.7-php8.5 frankenphp php-cli /t/argv.php foo bar
PHP 8.5.11 SAPI=cli argc=3 argv=["\/t\/argv.php","foo","bar"]
# Symfony 7.4 app, same container, v1.13.0:
$ frankenphp php-cli /app/bin/console doctrine:migrations:migrate -n
Command "/app/bin/console" is not defined.
- 主要语言
- Go
- 星标
- 11.4k
- 派生
- 487
- 平均合并
- 2 天 19 小时
- 30 天内合并 PR
- 20
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
php/frankenphp 的其他 Issue
-
Segfault of the whole process when restarting an unhealthy thread: SG(server_context) is read after ts_free_thread()可能已有人在做 @BastienClement 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 76/100
php/frankenphp#2688 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 90/100
php/frankenphp#2671 · 1 条评论 ·
维护者通常 1 天内回复
-
Include frankenphp version in logs可能已有人在做 @ousamabenyounes 于 78 天前认领。 未关闭enhancement
难度 2/5 1-3 小时 新手友好度 68/100
php/frankenphp#2483 · 3 条评论 ·
维护者通常 1 天内回复
-
suggestion about compile.md可能重新可做 关联的 PR 已关闭且未合并。 未关闭enhancement
难度 1/5 1-3 小时 新手友好度 68/100
php/frankenphp#601 · 5 条评论 ·
维护者通常 1 天内回复
-
bug
难度 4/5 3-5 天 新手友好度 35/100
php/frankenphp#2695 ·
维护者通常 1 天内回复
相似的 Issue
-
bug from-studio
难度 2/5 1-3 小时 新手友好度 63/100
esengine/DeepSeek-Reasonix#12355 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
维护者通常 1 天内回复
-
needs-triage
难度 2/5 1-3 小时 新手友好度 76/100
gke-labs/kube-agents#2612 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 66/100
bluesky-social/indigo#1496 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 86/100
Gentleman-Programming/gentle-ai#5371 ·
维护者通常 1 天内回复