README

将消息发送到 Slack 的您的 Laravel 应用程序。

本包提供

• 命令后处理

  使用 Laravel 命令将消息发送到 Slack。

• 统计命令

  使用此可自定义的命令发送您的 Laravel 应用程序的统计信息。

  

• 异常处理器

  在异常发生时输出到 Slack 的有用信息。

  

• 失败作业处理器

  当作业失败时获得警报。

  

• 计划命令报告

  关注您的计划命令的结果。

  

要求

• Laravel 5.1 或更高版本
• PHP 5.5.9 或更高版本

安装

您可以使用 Composer 包管理器安装此包。您可以在项目根目录下运行此命令来安装它

composer require sonnn/laravel-slack-bot

您需要在您的 Laravel 应用程序中包含服务提供者和外观。

将服务提供者添加到 config/app.php 文件中的 providers 数组

'providers' => [
  ...
  Sonnn\SlackOutput\ServiceProvider::class,
],

然后添加外观到您的 aliases 数组

'aliases' => [
  ...
  'SlackOutput' => Sonnn\SlackOutput\Facade\SlackOutput::class,
],

使用

php artisan vendor:publish --provider="Sonnn\SlackOutput\ServiceProvider"

您需要将 webhook URL 添加到配置文件中，以便包可以发布到 Slack。在您的 Slack 账户上 创建一个入站 webhook。复制 webhook URL 并打开 config/slack-output.php，将 webhook URL 设置为 endpoint。

如果设置了 null，则包将回退到 webhook 设置的默认设置。

使用方法

命令后处理

命令 slack:post 将消息发布到 Slack。它可以接受以下参数

• message: 要发送的消息
• to: 要发布到的频道或人员
• attach: 附件有效负载

您可以在此处找到有关 attach 参数的信息： https://api.slack.com/docs/attachments

您可以通过运行以下命令来调用它

php artisan slack:post "Hello, I'm a bot" @nico

您也可以在您的 Laravel 应用程序中调用它

Artisan::queue('slack:post', [
  'to' => "#api-output",
  'attach' => $someAttachment,
  'message' => "Hello, I'm a bot"
]);

注意 Artisan::queue，该命令将在后台执行，而不会阻塞当前请求。

统计命令

命令 slack:stats 将有关应用程序的有用统计信息发送到 Slack。

您需要通过在 config/slack-output.php 中设置您首选的 Eloquent 类和日期来配置此命令。

您可以为类添加约束以限制计数数据的数量。

'classes' => [
	  \App\Models\User::class => [
		  'is_active' => true //optional constraint
	  ]
],

日期数组的形式为 '日期的名称' => Carbon::instance()。例如

'dates' => [
	'yesterday' => \Carbon\Carbon::yesterday(),
	'last week' => \Carbon\Carbon::today()->subWeek(1)
]

要每天安排此命令，只需将其添加到 app/Console/Kernel.php

protected function schedule(Schedule $schedule)
{
  $schedule->command('slack:stats')->daily()
}

异常处理器

要向 Slack 报告有用的异常，请打开 app/Exceptions/Handler.php，并修改如下

use Sonnn\SlackOutput\Facade\SlackOutput;

...

public function report(Exception $e)
{
  if ($this->shouldReport($e)) {
    SlackOutput::exception($e);
  }

  parent::report($e);
}

这将仅报告同一文件中的 $dontReport 数组中的异常。

失败作业处理器

要向 Slack 报告失败的作业，请打开 app/Providers/AppServiceProvider.php，并修改如下

use Sonnn\SlackOutput\Facade\SlackOutput;

...

public function boot()
{
  Queue::failing(function (JobFailed $job) {
    SlackOutput::jobFailed($job);
  });
}

计划命令报告

要向 Slack 报告计划命令的输出，请打开 app/Console/Kernel.php，并修改如下

use Sonnn\SlackOutput\Facade\SlackOutput;

...

protected function schedule(Schedule $schedule)
{
  SlackOutput::scheduledCommand(
    $schedule->command('db:backup-auto')->daily()
  );
}

贡献

如果您有问题，发现了错误或有一些建议的功能，请请在 GitHub 上添加问题。也欢迎提交拉取请求！

许可

本包是开源软件，许可证为 MIT 许可证