PHP getopts()首参数导致后续参数失效问题求助

PHP 的 getopt() 函数默认会在遇到第一个非选项参数（即不带 - 或 -- 前缀的参数）时停止解析后续参数。当你把 <filename> 作为第一个参数传入时，getopt() 会将它识别为非选项参数，直接跳过后面的 -r/--root 选项，导致这些参数无法被读取。

你可以手动遍历 $argv 数组，分离非选项参数和选项参数，确保所有选项参数都能被正确解析，不管它们在命令行中的位置。以下是实现代码：

<?php
$short_options = "r:";
$long_options = ["root:"];
$parsed_options = [];
$non_option_args = [];

$argc = count($argv);
$i = 1; // 跳过脚本文件名（$argv[0]）

while ($i < $argc) {
    $current_arg = $argv[$i];

    // 处理长选项（如 --root foo 或 --root=foo）
    if (str_starts_with($current_arg, '--')) {
        $option_name = substr($current_arg, 2);
        if (str_contains($option_name, '=')) {
            // 处理 --key=value 格式
            [$key, $value] = explode('=', $option_name, 2);
            $parsed_options[$key] = $value;
            $i++;
        } else {
            // 处理 --key value 格式
            if (in_array($option_name . ':', $long_options)) {
                $parsed_options[$option_name] = $argv[$i + 1];
                $i += 2;
            } else {
                // 无值长选项（本例中不涉及，可按需保留）
                $parsed_options[$option_name] = true;
                $i++;
            }
        }
    }
    // 处理短选项（如 -r foo、-r=foo 或 -rfoo）
    elseif (str_starts_with($current_arg, '-')) {
        $option_chars = substr($current_arg, 1);
        $char_count = strlen($option_chars);
        
        for ($j = 0; $j < $char_count; $j++) {
            $char = $option_chars[$j];
            if (str_contains($short_options, $char . ':')) {
                // 短选项需要值
                if ($j === $char_count - 1) {
                    // 值在后续参数中（如 -r foo）
                    $parsed_options[$char] = $argv[$i + 1];
                    $i += 2;
                    break;
                } else {
                    // 值跟在选项后（如 -rfoo）
                    $parsed_options[$char] = substr($option_chars, $j + 1);
                    $i++;
                    break;
                }
            } else {
                // 无值短选项（本例中不涉及，可按需保留）
                $parsed_options[$char] = true;
                $i++;
            }
        }
    }
    // 收集非选项参数（如 <filename>）
    else {
        $non_option_args[] = $current_arg;
        $i++;
    }
}

// 输出结果
echo "非选项参数：";
print_r($non_option_args);
echo "解析的选项：";
print_r($parsed_options);
?>

运行以下命令，无论 <filename> 放在哪个位置，-r/--root 参数都能被正确解析：

• php my-file.php test.txt -r foo
• php my-file.php -r foo test.txt
• php my-file.php test.txt --root=bar

内容的提问来源于stack exchange，提问作者Oliver Williams