laravel怎么自定义一个 Artisan 命令的退出代码_laravel自定义Artisan命令退出代码方法-Laravel-PHP中文网

laravel怎么自定义一个 Artisan 命令的退出代码_laravel自定义Artisan命令退出代码方法

裘德小鎮的故事

发布： 2025-11-05 02:41:35

原创

457人浏览过

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

laravel怎么自定义一个 artisan 命令的退出代码_laravel自定义artisan命令退出代码方法

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

定义 Artisan 命令的退出代码

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

0 表示成功，非零值表示失败或特定错误类型。

例如：

```php namespace App\Console\Commands;

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; // 假设失败
}

登录后复制

}

<H3>常见的退出代码约定</H3>
<p>虽然你可以使用任意整数，但建议遵循 Unix 系统的惯例：</p>
<ul>
  <li><strong>0</strong>：成功</li>
  <li><strong>1</strong>：通用错误</li>
  <li><strong>2</strong>：误用命令（如参数错误）</li>
  <li><strong>127</strong>：命令未找到</li>
</ul>
<p>你也可以根据业务定义更细粒度的错误码，比如：</p>
<ul>
  <li>10：数据库连接失败</li>
  <li>20：配置缺失</li>
  <li>30：网络请求超时</li>
</ul>

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

登录后复制

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

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

以上就是laravel怎么自定义一个 Artisan 命令的退出代码_laravel自定义Artisan命令退出代码方法的详细内容，更多请关注php中文网其它相关文章！