PHP探针怎么添加自定义检测项_PHP探针添加自定义检测途径【指引】

PHP探针添加自定义检测项需绕开硬编码：优先使用预留钩子函数，无钩子则在输出块前后插入带IN_PROBE开关的函数调用；硬件信息读取应兼容环境、避免shell命令；配置与扩展检测须选对函数；数据库连接需设超时、禁用敏感信息明文。

PHP探针怎么添加自定义检测项？直接改 index.php 或 functions.php 就行，但必须绕开硬编码陷

阱

绝大多数 PHP 探针（如 phpinfo_probe、serverstatus 类脚本）把检测逻辑写死在主文件或函数库中。想加自定义项，不能只 echo 一行结果——得让检测可复用、可开关、不破坏原有结构。

• 优先找 function get_custom_info() 这类预留钩子函数，很多探针已留了空壳
• 没钩子就搜 echo "MySQL"、show_php_info() 这类输出块，在其前后插入你自己的函数调用
• 避免直接在 phpinfo() 输出后追加 HTML，容易被 CSS 样式吞掉或错位
• 所有自定义逻辑必须包裹在 if (defined('IN_PROBE')) 或类似开关下，防止被外部直接访问执行

如何安全读取服务器硬件信息（CPU/内存/磁盘）而不报错？

PHP 默认禁用 exec、shell_exec，且不同系统命令差异大。硬写 cat /proc/meminfo 在 Windows 下直接挂，Linux 容器里也可能权限不足。

• 先判断环境：if (stripos(PHP_OS, 'Linux') !== false && function_exists('shell_exec') && ini_get('disable_functions') === '')
• 内存推荐用 memory_get_usage(true) + sys_getloadavg() 组合，比解析 /proc/meminfo 更稳
• CPU 型号慎读：cat /proc/cpuinfo | grep 'model name' | head -1 在容器里常为空，改用 php_uname('m') 获取架构更可靠
• 磁盘空间统一走 disk_total_space('/') . '/' . disk_free_space('/')，不依赖 shell

get_cfg_var() 和 ini_get() 读不到自定义配置？检查这三处

想检测某个扩展是否启用或某个 INI 值是否生效，用错函数会返回 false 或空字符串，不是探针代码问题，是调用方式不对。

• ini_get('extension_dir') 只能读 php.ini 中显式设置的值；若某扩展通过 zend_extension 加载，得用 extension_loaded('opcache')
• get_cfg_var('max_execution_time') 在 CGI/FPM 模式下常失效，必须用 ini_get('max_execution_time')
• 自定义 INI 配置（如你在 php.d/my.conf 里写的 myapp.debug = 1）需确保：① 文件被加载（查 php --ini 输出）；② 名称不含点（myapp_debug 更安全）；③ 用 ini_get('myapp_debug') 读取

添加 MySQL 连接检测时为什么总是超时或空白？

探针页面本身就在运行 PHP，再同步连一次数据库，容易触发连接池耗尽、超时、或因 MySQL 未绑定公网 IP 导致 localhost 解析失败。

• 别用 new mysqli('localhost', ...) —— 改用 new mysqli('127.0.0.1', ...)，绕过 socket 文件路径和 DNS 解析歧义
• 必须设超时：$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);，否则卡住整个探针页面
• 敏感信息（密码）绝对不要写死！从 $_ENV['DB_PASS'] 或独立配置文件读，且配置文件禁止放在 Web 可访问目录
• 连接失败时只输出 MySQL: ❌ (timeout)，不打印错误详情，避免泄露服务器路径或版本

// 示例：安全添加自定义数据库检测块（插入到探针主循环中）
if (function_exists('mysqli_init')) {
    $db = mysqli_init();
    mysqli_options($db, MYSQLI_OPT_CONNECT_TIMEOUT, 3);
    if (mysqli_real_connect($db, '127.0.0.1', 'root', $_ENV['DB_PASS'] ?: '', 'mysql', 3306)) {
        echo "MySQL: ✅ " . mysqli_get_server_info($db);
        mysqli_close($db);
    } else {
        echo "MySQL: ❌ (" . mysqli_connect_error() . ")";
    }
} else {
    echo "MySQL: ⚠️ 扩展未加载";
}

实际加自定义项最麻烦的不是代码，是每次更新探针版本时手动合并改动——建议把所有自定义逻辑抽成单独文件（如 custom_checks.php），用 require_once 引入，并在升级前 diff 该文件即可。