PHP不能直接读取CPU温度传感器,必须通过shell_exec()等调用sensors或cat /sys/class/thermal/等外部命令获取,再解析结果;需注意路径存在性、权限及温度单位换算。

PHP 能不能直接读取 CPU 温度传感器
不能。PHP 本身没有访问硬件传感器的底层能力,它不提供类似 get_cpu_temp() 这样的内置函数,也不具备绕过操作系统直接读取 SMBus、I2C 或 MSR 寄存器的权限。所有“PHP 读温度”的实现,本质都是调用外部命令或文件接口,再把结果解析出来。
常见错误现象:Warning: file_get_contents(): failed to open stream: No such file or directory —— 直接硬编码读取 /sys/class/thermal/thermal_zone0/temp 却没检查路径是否存在或权限是否足够。
- Linux 下温度通常暴露在
/sys/class/thermal/(如/sys/class/thermal/thermal_zone0/temp),但 zone 编号不固定,需先枚举 - 需要 PHP 进程有读取该路径的权限(通常 www-data 用户默认无权读
/sys下某些节点) - 返回值是毫摄氏度整数(如
54000表示 54.0°C),必须除以 1000 才是真实值
用 shell 命令 + shell_exec() 获取温度最稳妥
这是生产环境最常用、兼容性最好的方式。依赖的是系统已有的工具链(如 sensors、cat),而非 PHP 自身能力。
使用场景:你已经确认服务器装了 lm-sensors 并运行了 sensors-detect,且 sensors 命令能正常输出核心温度。
立即学习“PHP免费学习笔记(深入)”;
- 优先尝试
sensors -u(机器可读格式),比sensors的文本输出更易解析 - 若
sensors不可用,回退到cat /sys/class/thermal/thermal_zone*/temp 2>/dev/null | head -n1枚举方式 - 务必用
escapeshellarg()包裹变量(虽然此处一般无变量,但养成习惯) - 加超时和错误判断:
if (false === $output || empty(trim($output))) { /* 失败处理 */ }
简短示例:
$output = shell_exec('sensors -u 2>/dev/null | grep -A1 "Package id 0" | grep input | cut -d" " -f2');
$temperature = is_numeric($output) ? round((float)$output, 1) : null;
/sys/class/thermal/ 路径读取失败的三个常见原因
不是代码写错了,而是环境没对齐。90% 的“读不出温度”问题出在这三处。
-
/sys/class/thermal/目录下没有thermal_zone*子目录 → 主板 BIOS 关闭了 ACPI thermal 支持,或内核未启用CONFIG_THERMAL和对应驱动(如coretemp) - 读取返回空或 0 → 对应 zone 实际是主板芯片组、电池或 GPU 温度,不是 CPU;用
cat /sys/class/thermal/thermal_zone*/type查类型,找含Package或cpu-thermal的 zone - PHP 进程权限被拒 → 不要改
/sys权限,而是把 web 用户加入video或root组(不推荐),更安全的做法是用sudo配置免密命令(如www-data ALL=(ALL) NOPASSWD: /bin/cat /sys/class/thermal/thermal_zone*/temp)
为什么别用 exec() 调用 vcgencmd(树莓派)以外的硬件工具
vcgencmd measure_temp 是树莓派专用命令,依赖 VideoCore 固件。其他平台强行移植会失败,而且它返回的是字符串 temp=48.0'C,解析脆弱。
性能与兼容性影响:
- 调用外部命令有进程开销,但单次温度采集影响微乎其微;频繁轮询(如每秒一次)才需考虑缓存或改用守护进程
-
lm-sensors在 Intel/AMD 台式机、服务器上支持更好;ARM 设备(如 Jetson)可能得用nvidia-smi -q -d temperature - 容器环境(Docker)默认不挂载
/sys/class/thermal,需显式添加--volume /sys/class/thermal:/sys/class/thermal:ro
真正容易被忽略的是:温度值本身波动大,直接展示原始读数会显得“抖动”。实际部署时,几乎都需要加简单滑动平均或阈值过滤,否则前端图表会疯跳。



















