Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

php-cli (v1.13.0): $argv[0] is "frankenphp" and the script path is shifted to $argv[1] — breaks Symfony Console

クローズ
#2,690 コメント 5 件 リアクション 1 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

関連するプルリクエストがすでにマージされています。

  • #2691 @henderkes による — マージ済み

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
30/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
go, php
領域
cli

調査の方向性

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
フォーク
490
平均マージ
2日 21時間
マージ済み PR(30日)
29

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

php/frankenphp のほかの issue

php/frankenphp の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。