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 解析失败。
立即学习“PHP免费学习笔记（深入）”；
- 别用
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 该文件即可。 
