Laravel 11执行php artisan install:api报错ProcessStartFailedException

问题背景 #

在Mac OS Sonoma 14.3.1环境下，基于PHP 8.3.6搭建的全新Laravel 11项目，执行php artisan install:api命令时触发Symfony\Component\Process\Exception\ProcessStartFailedException错误，已手动安装laravel/sanctum:^4.0但问题未解决。

排查与解决方案 #

1. 检查PHP的proc_open函数权限 #

该错误通常与Symfony Process组件无法启动子进程有关，首先确认PHP是否禁用了proc_open：

• 执行命令查看禁用函数列表：

  php -i | grep disable_functions
  

• 如果输出中包含proc_open，找到PHP配置文件（通过php --ini查看路径），编辑并移除disable_functions中的proc_open项，保存后重新执行命令。

2. 修复Composer依赖完整性 #

• 重新生成自动加载文件：

  composer dump-autoload
  

• 更新依赖确保版本兼容：

  composer update
  

  注：Laravel 11.9与symfony/process:^7.1版本兼容，此步骤可修复潜在的依赖冲突或安装不完整问题。

3. 手动完成API安装流程 #

php artisan install:api本质是自动化完成以下操作，可手动替代：

1. 创建API路由文件：在项目routes目录下新建api.php，添加基础路由内容：

   <?php
   
   use Illuminate\Http\Request;
   use Illuminate\Support\Facades\Route;
   
   Route::get('/user', function (Request $request) {
       return $request->user();
   })->middleware('auth:sanctum');
   

2. 启用API路由：编辑bootstrap/app.php，在withRouting方法中添加api路由配置：

   return Application::configure(basePath: dirname(__DIR__))
       ->withRouting(
           web: __DIR__.'/../routes/web.php',
           api: __DIR__.'/../routes/api.php', // 添加此行
           commands: __DIR__.'/../routes/console.php',
           health: '/up',
       )
       ->withMiddleware(function (Middleware $middleware) {
           // 可选：添加API专属中间件，如throttle
       })
       ->create();
   

3. 配置Sanctum：

   php artisan vendor:publish --tag=sanctum-config
   php artisan migrate
   

4. 修复项目目录权限 #

确保项目关键目录有读写权限：

chmod -R 755 storage bootstrap/cache
sudo chown -R $(whoami):staff /path/to/your/project

5. 验证PHP CLI环境配置 #

• 确认CLI使用的PHP版本正确：

  php -v
  

• 确认加载的配置文件路径无误：

  php --ini
  

  检查配置文件中是否存在影响进程启动的错误配置。

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