在 Laravel 中自定义 Artisan 命令可通过返回整数设置退出代码：0 表示成功，非零表示错误，如 1 为通用错误、2 为参数错误，可在 shell 脚本中通过 $? 捕获并处理不同状态码以控制流程。

在 Laravel 中自定义 Artisan 命令时，可以通过返回一个整数来设置命令的退出代码。这个退出代码用于指示命令执行是否成功或遇到何种错误，常用于脚本自动化、CI/CD 流程等场景。

定义 Artisan 命令的退出代码

Laravel 的 Artisan 命令默认在 handle() 方法中执行逻辑。你只需从该方法返回一个整数值，即可作为该命令的退出状态码：

例如：

use Illuminate\Console\Command;

class SendEmails extends Command { protected $signature = 'email:send'; protected $description = 'Send example emails';

public function handle()
{
    if (! $this->sendEmail()) {
        $this->error('Failed to send email.');
        return 1; // 自定义退出代码：发送失败
    }

    $this->info('Email sent successfully.');
    return 0; // 成功执行
}

private function sendEmail()
{
    // 模拟邮件发送逻辑
    return false; // 假设失败
}

}

常见的退出代码约定
虽然你可以使用任意整数，但建议遵循 Unix 系统的惯例：

  
0：成功
  
1：通用错误
  
2：误用命令（如参数错误）
  
127：命令未找到

你也可以根据业务定义更细粒度的错误码，比如：

  
10：数据库连接失败
  
20：配置缺失
  
30：网络请求超时


在脚本中使用退出代码
当你在 shell 脚本中调用 Artisan 命令时，可以检查其退出状态：
```bash
php artisan email:send
if [ $? -eq 0 ]; then
  echo "Command succeeded"
else
  echo "Command failed with exit code $?"
fi

这样可以根据不同的退出码触发重试、告警或终止流程。

基本上就这些。Laravel 会自动将 handle() 方法的返回值作为进程退出码，无需手动调用 exit()。只要合理设计返回值，就能实现清晰的命令执行反馈机制。