不存在名为 slack-php 的官方库，推荐用 guzzlehttp/guzzle 直接调用 Slack Webhook；需通过环境变量管理 Webhook URL，发送时使用 text 字段，复杂场景可改用 blocks。
不能直接通过 Composer 安装 “Slack-PHP 库”——因为根本不存在官方或主流维护的、名为 slack-php 的通用库。 你实际需要的是一个能发 Slack 消息的 HTTP 客户端封装，最常用、最可靠的选择是 clue/redis-react？不，那是 Redis。正确答案是：maknz/slack（已归档）或更现代的 php-slack/slack，但真正被广泛采用且持续维护的是 spatie/slack-notification-channel（配合 Laravel）或纯 HTTP 方案：直接用 guzzlehttp/guzzle 调 Slack Webhook。
为什么找不到 slack-php？
Slack 官方只提供 slack/web-api（PHP SDK），但它依赖 Guzzle，且主要面向 Slack App 的 OAuth 流程和 API 方法调用（如 chat.postMessage），不是为“日志推送”这种简单场景设计的。搜索 composer require slack-php 会失败或装到过时/无人维护的包（比如 maknz/slack 已在 2020 年归档）。盲目安装这类包，轻则功能缺失，重则引入未修复的安全漏洞。
推荐方案：用 guzzlehttp/guzzle + Slack Webhook URL
这是最轻量、最可控、兼容性最好的方式。不需要 OAuth、不依赖框架、不引入冗余抽象层。日志推送本质就是向 Webhook URL 发一个 POST 请求，Guzzle 完全胜任。
- 执行
composer require guzzlehttp/guzzle:^7.5（PHP 8.0+ 推荐^7.5；PHP 7.4 可用^6.5） - 在 Slack 后台创建 Incoming Webhook：Workspace Settings → Custom Integrations → Incoming Webhooks → Add Configuration → 选择频道 → 复制生成的 URL
- URL 格式形如
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX，必须保密，不要硬编码进代码 - 使用环境变量存储：在
.env中写SLACK_WEBHOOK_URL=https://hooks.slack.com/...，再用$_ENV['SLACK_WEBHOOK_URL']或getenv('SLACK_WEBHOOK_URL')读取
发送日志消息的最小可行代码
以下是一个可直接运行的函数，适配 Monolog 或自定义日志逻辑：
立即学习“PHP免费学习笔记（深入）”；
<?php
use GuzzleHttp\Client;
function sendToSlack(string $message, ?string $webhookUrl = null): bool
{
$webhookUrl = $webhookUrl ?: $_ENV['SLACK_WEBHOOK_URL'] ?? getenv('SLACK_WEBHOOK_URL');
if (!$webhookUrl) {
error_log('SLACK_WEBHOOK_URL not set');
return false;
}
$client = new Client();
try {
$client->post($webhookUrl, [
'json' => ['text' => $message],
]);
return true;
} catch (Exception $e) {
error_log('Slack send failed: ' . $e->getMessage());
return false;
}
}
// 示例调用
sendToSlack('[ERROR] Database connection timeout at ' . date('c'));
注意：text 字段是必需的；如需富文本（加粗、链接、颜色块），改用 blocks 数组，但需遵守 Slack blocks 格式规范，调试成本上升。
接入 Monolog 时的常见坑
如果你用 Monolog（Laravel 默认日志库），别直接扩展 Monolog\Handler\AbstractProcessingHandler 写轮子。优先用现成的 monolog/slack-handler 包：
- 执行
composer require monolog/slack-handler - 它内部就用 Guzzle，并支持
level过滤（例如只推ERROR及以上） - 但注意：该包 v3+ 要求 PHP 8.0+；v2.x 支持 PHP 7.2+，但需手动指定版本：
composer require monolog/slack-handler:^2.4 - 配置时传入的
$webhookUrl必须是字符串，不能是null或空值，否则构造函数抛InvalidArgumentException - 测试时先关掉 Monolog 的
buffering，避免日志被缓存不触发发送
复杂点在于 Slack 对 Webhook 的限流（每秒 1 次）、消息长度限制（text 最多 4000 字符，blocks 更严），以及错误静默——网络失败时不会中断主流程，但你也收不到失败通知。真要保障可靠性，得加重试、降级（写本地文件）和监控。
