Laravel 8 + PHP 8.0（Homebrew）环境下Symfony Process执行Shell命令报"No such file or directory"错误排查

这个问题的核心是Symfony Process组件的用法不符合标准规范，在PHP 8对应的新版本组件中不再兼容旧的松散写法，导致命令解析错误。

为什么PHP 7.4能跑，PHP 8不行？ #

你当前的代码把完整的命令（包括参数）作为数组的单个元素传入Process构造函数：

$process1 = new Process(["mkdir ". $newDir]);

在PHP 7.4使用的旧版Process组件中，它会尝试自动把这个字符串拆分成命令和参数；但适配PHP 8的新版本Process组件更严格，它会把这个完整字符串当作一个可执行文件的路径去寻找——也就是它在找一个名为mkdir /Users/username/code/project-name/storage/test的文件，自然找不到，所以抛出了“不存在文件或目录”的错误。

正确的写法 #

按照Process组件的标准用法，需要把命令本身和参数拆分成数组的独立元素：

$newDir = storage_path('test');
// 命令是"mkdir"，参数是目标路径，分开传入数组
$process1 = new Process(["mkdir", $newDir]);
$process1->run();
if (! $process1->isSuccessful()) {
    throw new ProcessFailedException($process1);
}

这种写法不仅能解决PHP 8下的执行问题，还能避免路径包含空格、特殊字符时的解析错误，是官方推荐的用法。

额外排查建议 #

1. 复杂命令的处理：如果要执行带管道、重定向的复杂shell命令，可以通过调用shell来包裹执行，比如：

$process1 = new Process(["sh", "-c", "mkdir -p ". escapeshellarg($newDir)]);

注意这里要用escapeshellarg()转义路径，避免特殊字符引发安全问题。
2. 权限验证：手动在终端执行mkdir storage/test（切换到项目根目录），确认当前用户对storage目录有写入权限，排除权限隐患。
3. 组件版本检查：通过composer show symfony/process查看组件版本，Laravel 8适配的Symfony Process版本是5.x系列，确保你安装的是该范围内的稳定版本，避免版本不兼容问题。

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