答案：通过配置php错误日志、使用monolog记录接口异常、集成sentry和prometheus监控并设置grafana告警规则，结合钉钉通知，实现接口稳定运行与实时告警。
调试和监控 PHP 接口并配置异常告警，关键在于日志记录、性能监控、错误捕获和及时通知。下面介绍一套实用的配置方法，帮助你实现 PHP 接口的稳定运行与自动告警。
1. 启用错误日志与异常捕获
确保 PHP 能记录所有运行时错误和异常是第一步。
- 在 php.ini 中开启错误报告：
display_errors = Off（生产环境关闭显示）
log_errors = On
error_log = /var/log/php/error.log - 在代码中捕获异常：
示例代码：
// 全局异常处理
set_exception_handler(function($exception) {
error_log("Exception: " . $exception->getMessage() . ' in ' . $exception->getFile() . ':' . $exception->getLine());
// 可写入数据库或发送到监控系统
});
// 捕获致命错误
register_shutdown_function(function() {
$error = error_get_last();
if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) {
error_log("Fatal Error: {$error['message']} in {$error['file']}:{$error['line']}");
}
});
2. 使用日志系统集中管理信息
推荐使用 Monolog 将日志输出到文件、数据库或远程服务。
立即学习“PHP免费学习笔记（深入）”；
- 安装 Monolog：
composer require monolog/monolog - 记录接口调用与异常：
示例：
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$logger = new Logger('api');
$logger->pushHandler(new StreamHandler('/var/log/php/api.log', Logger::WARNING));
try {
// 接口逻辑
} catch (Exception $e) {
$logger->error('API Error: ' . $e->getMessage(), ['trace' => $e->getTraceAsString()]);
}
3. 集成监控工具进行实时观察
借助外部工具实现可视化监控和性能分析。
- Prometheus + Grafana：通过 prometheus/client_php 暴露指标（如请求次数、响应时间）。
-
Sentry：捕获异常并提供堆栈跟踪，支持邮件、Slack 告警。
注册后在项目中接入：
require_once 'vendor/autoload.php';
\Sentry\init(['dsn' => 'https://xxx@oxxx.ingest.sentry.io/xxx']);
try {
// 接口调用
} catch (Throwable $exception) {
\Sentry\captureException($exception);
throw $exception;
}
4. 配置告警规则与通知渠道
基于日志或监控平台设置触发条件。
- Sentry：在项目设置中添加 Alert Rules，例如“每小时超过5次500错误”触发告警。
- Grafana：对接 Prometheus 数据源，创建“响应时间 > 2s”或“错误率 > 5%”的告警，并通过 Email、Webhook、钉钉或企业微信通知。
- 自定义脚本定时检查日志：
示例 shell 脚本片段：
count=$(grep -c "PHP Fatal" /var/log/php/error.log --since="5 minutes ago")
if [ $count -gt 0 ]; then
curl -H "Content-Type: application/json" -d '{"msg":"PHP 接口出现致命错误！"}' https://webhook.dingtalk.com/...
fi
基本上就这些。只要做好日志记录、接入监控平台、设置合理阈值，就能实现 PHP 接口的稳定运行与自动告警。关键是让问题发生时你能第一时间知道。
