本文介绍通过继承 symfony process 类并重写其构造方法，使其兼容字符串和数组类型的命令输入，同时严格遵循 php 构造函数签名兼容性规则，适用于 behat 测试等需灵活调用场景。
本文介绍通过继承 symfony process 类并重写其构造方法，使其兼容字符串和数组类型的命令输入，同时严格遵循 php 构造函数签名兼容性规则，适用于 behat 测试等需灵活调用场景。
在 Symfony 生态中，Symfony\Component\Process\Process 是处理外部进程的核心类。其原生构造方法强制要求第一个参数 $command 为 array 类型，这在 Behat 等测试场景中常导致报错："Argument #1 ($command) must be of type array, string given"。由于项目约束明确要求“仅允许通过继承覆盖（override）实现”，我们不能修改 vendor 源码、不能使用装饰器或工厂模式，而必须创建一个类型安全的子类。
关键在于：PHP 允许子类构造方法参数类型比父类更宽松（如 array|string），但必须确保所有合法输入最终能被父类构造器正确接收。因此，我们的自定义类需在调用 parent::__construct() 前完成类型归一化：
use Symfony\Component\Process\Process;
class CustomProcess extends Process
{
public function __construct(array|string $command, string $cwd = null, array $env = null, $input = null, ?float $timeout = 60)
{
// 将字符串命令自动转为单元素数组（如 'ls -l' → ['ls', '-l']）
// ⚠️ 注意：此处仅做最简转换；若需完整 shell 解析（含引号/空格处理），应使用 escapeshellarg() 或 Symfony 的 ProcessBuilder
if (is_string($command)) {
$command = preg_split('/\s+/', trim($command), -1, PREG_SPLIT_NO_EMPTY);
}
// 确保 command 始终为 array，再委托给父类
parent::__construct($command, $cwd, $env, $input, $timeout);
}
}
✅ 使用示例：
// 直接传入字符串（Behat 步骤中常见）
$process = new CustomProcess('git status');
$process->run();
// 或保持原有数组用法（完全向后兼容）
$process = new CustomProcess(['php', 'artisan', 'migrate']);
$process->run();
⚠️ 重要注意事项：
- 不要跳过父类构造逻辑：必须调用 parent::__construct(...)，否则 Process 内部状态（如 $this->command, $this->cwd）不会初始化，导致后续 run() 失败；
- 字符串解析需谨慎：上述 preg_split 仅适用于无引号、无嵌套空格的简单命令。生产环境若需健壮解析（如 'echo "hello world"'），建议改用 Symfony\Component\Process\ProcessUtils::escapeArgument() 配合 shell_exec，或直接使用 Process::fromShellCommandline() —— 但注意该静态方法返回的是新实例，不适用于本题“仅允许 override”的硬性要求；
-
PHP 版本兼容性：array|string 联合类型自 PHP 8.0 起支持；若项目使用 PHP 7.x，需降级为 mixed 并在文档与运行时断言中明确说明，例如：
/** * @param array|string $command */ public function __construct($command, string $cwd = null, array $env = null, $input = null, ?float $timeout = 60) { if (!is_array($command) && !is_string($command)) { throw new \InvalidArgumentException('Command must be array or string.'); } // ... 同上处理 }
总结：通过精准继承与前置参数标准化，CustomProcess 在不破坏原有 API 行为的前提下，无缝扩展了命令输入灵活性，既满足 Behat 测试的易用性需求，又严格遵守面向对象的 Liskov 替换原则与 PHP 类型系统约束。
