PHPackages                             tiacx/laravel-health-plus - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. tiacx/laravel-health-plus

ActiveLibrary[Utility & Helpers](/categories/utility)

tiacx/laravel-health-plus
=========================

Laravel-Health-Plus

1.0.4(1mo ago)091↓50%MITPHPPHP >=8.0.0

Since Jun 18Pushed 1mo agoCompare

[ Source](https://github.com/Tiacx/laravel-health-plus)[ Packagist](https://packagist.org/packages/tiacx/laravel-health-plus)[ Docs](https://github.com/tiacx/laravel-health-plus)[ RSS](/packages/tiacx-laravel-health-plus/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (5)Dependencies (4)Versions (7)Used By (0)

Laravel Health Plus
===================

[](#laravel-health-plus)

说明
--

[](#说明)

[spatie/laravel-health](https://spatie.be/docs/laravel-health/v1/introduction) 的增强扩展包，为你的 Laravel 应用提供额外的健康检查与通知功能。

安装
--

[](#安装)

```
composer require tiacx/laravel-health-plus
```

配置
--

[](#配置)

#### 发布配置文件：

[](#发布配置文件)

```
php artisan vendor:publish --tag=health-plus-config
```

该命令会发布 `config/health.php` 配置文件。

#### 配置检查项：

[](#配置检查项)

发布配置后，修改 `config/health.php` 中的 `checks` 数组来启用或配置你需要的检查项。默认配置如下：

```
// config/health.php
'checks' => [
    DatabaseCheck::class,
    RedisCheck::class,
    [UsedDiskSpaceCheck::class, [
        'warnWhenUsedSpaceIsAbovePercentage' => 85,
        'failWhenUsedSpaceIsAbovePercentage' => 95,
    ]],
    [DatabaseConnectionCountCheck::class, [
        'warnWhenMoreConnectionsThan' => 2000,
        'failWhenMoreConnectionsThan' => 5000,
    ]],
    [CpuLoadCheck::class, [
        'warnWhenLoadIsIncreasing' => 3.0, // 系统负载剧增超过3倍
        'topProcessesLimit' => 5, // Top5 进程
        'messages' => [
            'loadAbove' => 'CPU使用率超过阈值：{value}%%',
            'loadIncreasing' => 'CPU使用率急剧上升, ratio: {ratio}',
        ],
    ]],
    [RequestCheck::class, [
        'warnWhenRpsIsIncreases' => 3, // 每秒请求数剧增超过3倍
        'warnWhenDurationIsIncreases' => 10, // 请求响应时间剧增超过10倍
        'warnWhenMaxDurationIsAbove' => 30, // 最大响应时长超过30秒告警
        'messages' => [
            'fetchFailed' => '无法获取请求日志：{error}',
            'emptyData' => '请求日志数据为空',
            'rpsIncrease' => '突发流量激增, Rps5m: {rps5m}, Rps1h: {rps1h}',
            'durationIncrease' => '响应时间劣化, AvgDuration5m: {duration5m}ms, AvgDuration1h: {duration1h}ms',
            'maxDurationFail' => '最大响应时长 {maxDuration}s 超过阈值 {threshold}s',
        ],
    ]],
    [PhpFpmCheck::class, [
        'statusUrl' => 'http://localhost/fpm-status',
        'maxChildren' => env('FPM_PM_MAX_CHILDREN', 40),
        'warnWhenActiveProcessesIsAbovePercentOfMaxChildren' => 80,
        'failWhenActiveProcessesIsAbovePercentOfMaxChildren' => 95,
        'warnWhenListenQueueIsAbove' => 5,
        'failWhenListenQueueIsAbove' => 10,
        'warnWhenSlowRequestsIsAbove' => 5,
        'failWhenSlowRequestsIsAbove' => 10,
    ]],
    [LogCheck::class, [
        'failWhenErrorLogsAbove' => 0, // 有错误日志
        'warnWhenWarningLogsIsAbove' => 100, // 警告日志超过100条
        'messages' => [
            'fetchFailed' => '无法获取错误日志：{error}',
            'errorLogs' => '程序异常：{logs}',
            'warningLogs' => 'WARNING日志过多({count}条)，建议检查',
        ],
    ], 'everyFifteenMinutes'], // 15分钟一次
],
```

#### 配置通知：

[](#配置通知)

发布配置后，修改 `config/health.php` 中的 `notifications` 数组来启用或配置你需要的通知方式，默认使用 `webhook` 通知

```
'notifications' => [
    'enabled' => true,
    'notifications' => [
        HealthCheckNotification::class => ['webhook'],
    ],
    'notifiable' => HealthCheckNotifiable::class,
    'webhook' => [
        'url' => env('HEALTH_NOTIFICATION_WEBHOOK_URL', ''),
    ],
],
```

注：通过 `HEALTH_NOTIFICATION_WEBHOOK_URL` 环境变量来配置 Webhook URL。

#### 其他可用 `Check` 类：

[](#其他可用-check-类)

迁移
--

[](#迁移)

```
php artisan vendor:publish --tag="health-migrations"
```

```
php artisan migrate
```

使用
--

[](#使用)

手动运行健康检查：

```
php artisan health:check
```

定时运行健康检查：

`app/Console/Kernel.php` 中添加以下代码：

```
$schedule->command(RunHealthChecksCommand::class)->everyMinute();
```

或者在 `routes/console.php` 中添加以下代码：

```
Schedule::command(RunHealthChecksCommand::class)->everyMinute();
```

自定义告警消息
-------

[](#自定义告警消息)

支持多语言配置，通过 `messages` 配置项自定义各 Check 类的告警消息模板。模板使用 `{placeholder}` 占位符。

### CpuLoadCheck 消息模板

[](#cpuloadcheck-消息模板)

Key默认值参数`loadAbove`CPU使用率超过阈值：{value}%%`{value}` - 阈值`loadIncreasing`CPU使用率急剧上升, ratio: {ratio}`{ratio}` - 增长倍数### RequestCheck 消息模板

[](#requestcheck-消息模板)

Key默认值参数`fetchFailed`无法获取请求日志：{error}`{error}` - 错误信息`emptyData`请求日志数据为空-`rpsIncrease`突发流量激增, Rps5m: {rps5m}, Rps1h: {rps1h}`{rps5m}` - 5分钟RPS, `{rps1h}` - 1小时RPS`durationIncrease`响应时间劣化, AvgDuration5m: {duration5m}ms, AvgDuration1h: {duration1h}ms响应时间`maxDurationFail`最大响应时长 {maxDuration}s 超过阈值 {threshold}s`{maxDuration}` - 最大响应时长, `{threshold}` - 阈值### LogCheck 消息模板

[](#logcheck-消息模板)

Key默认值参数`fetchFailed`无法获取错误日志：{error}`{error}` - 错误信息`errorLogs`程序异常：{logs}`{logs}` - 错误日志JSON`warningLogs`WARNING日志过多({count}条)，建议检查`{count}` - 警告数量### PhpFpmCheck 消息模板

[](#phpfpmcheck-消息模板)

Key默认值参数`fetchFailed`无法访问 PHP-FPM 状态页面：{error}`{error}` - 错误信息`httpError`PHP-FPM 状态页面响应错误（HTTP {status}）`{status}` - HTTP 状态码`invalidResponse`PHP-FPM 状态页面内容无效...-`activePercentFail`活动进程数占比 {percent}% 超过阈值 {threshold}%`{percent}` - 占比, `{threshold}` - 阈值`activePercentWarn`活动进程数占比 {percent}% 超过阈值 {threshold}%`{percent}` - 占比, `{threshold}` - 阈值`activeProcessesFail`活动进程数 ({active}) 超过上限 ({limit})`{active}` - 当前值, `{limit}` - 上限`idleProcessesFail`空闲进程数 ({idle}) 低于最小值 ({limit})`{idle}` - 当前值, `{limit}` - 下限`slowRequestsFail`慢请求数 {count} 超过阈值 {limit}`{count}` - 当前值, `{limit}` - 阈值`listenQueueFail`监听队列长度 {size} 超过允许值 {limit}`{size}` - 当前值, `{limit}` - 上限更多说明
----

[](#更多说明)

请参考 [spatie/laravel-health 官方文档](https://spatie.be/docs/laravel-health/v1/introduction)。

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance94

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

5

Last Release

31d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3c173a7dad73458dd950276c67531a52ade5769c14c48218fa2a9e02416c4835?d=identicon)[Tiacx](/maintainers/Tiacx)

---

Tags

laravellaravel-healthlaravel-health-plus

### Embed Badge

![Health badge](/badges/tiacx-laravel-health-plus/health.svg)

```
[![Health](https://phpackages.com/badges/tiacx-laravel-health-plus/health.svg)](https://phpackages.com/packages/tiacx-laravel-health-plus)
```

###  Alternatives

[spatie/statamic-health

Check the health of your Statamic app

115.3k](/packages/spatie-statamic-health)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)