应使用 file_put_contents($path, $line . “n”, FILE_APPEND | LOCK_EX) 配合绝对路径、权限预配置和磁盘空间检查，失败时通过 error_log 兜底；高频场景需缓冲写入，避免 SD 卡磨损与阻塞。
PHP 脚本如何安全地写入本地日志文件（嵌入式场景）
在嵌入式设备（如树莓派、OpenWrt 路由器 、工业 PLC 边缘网关）上运行 PHP 时，fopen() 直接追加写日志看似简单，但极易因权限、路径、并发或磁盘满导致失败甚至阻塞主逻辑。必须绕过 Web 服务器上下文，用最小依赖、可预测行为的方式落盘。
- 日志路径必须使用绝对路径，
/var/log/myapp.log比./log.txt可靠得多——后者在 cron 或 systemd 启动时工作目录不可控 - 避免
fopen(……, 'a')长时间持有句柄：嵌入式系统常禁用fsync()缓存策略，需显式调用fflush()+fclose()确保数据落盘 - 务必检查返回值：
fopen()失败时返回false，不判断就写会触发Warning: fwrite() expects parameter 1 to be resource, bool given - 建议用
file_put_contents($path, $line . "n", FILE_APPEND | LOCK_EX)替代手动 fopen/fwrite ——LOCK_EX防止多进程写乱序，且自动处理打开 / 关闭
记录硬件传感器数据时的格式与频率控制
直接 file_put_contents() 每次采集都写一行，高频下（如每秒读温湿度）会迅速拖慢 PHP 进程并磨损 SD 卡。关键不是“能不能写”，而是“要不要每条都立刻落盘”。
- 单次采集数据建议拼成结构化行，例如：
date('c') . "t" . $sensor_id . "t" . $temp . "t" . $humidity . "n"，用制表符分隔便于后续awk或 Python 解析 - 若采集频率 >1Hz，改用内存缓冲：累计 10 条再批量写入，或用
pcntl_signal()注册SIGTERM在脚本退出前刷一次缓存 - 警惕浮点精度：
number_format($v, 2, '.', '')比直接(string)$v更稳定，避免科学计数法污染日志可读性 - SD 卡寿命敏感场景，禁用
FILE_APPEND的隐式 seek，改用fopen($path, 'c')+fseek($fp, 0, SEEK_END)+fwrite()，减少元数据更新次数
权限、路径与 systemd 服务配置要点
PHP 脚本在嵌入式中常以非 root 用户（如 www-data 或自定义 sensor）运行，而 /var/log 默认仅允许 root 写入。硬改目录权限是反模式，应从运行环境层面解决。
- 创建专用日志目录：
sudo mkdir -p /var/log/sensor && sudo chown sensor:sensor /var/log/sensor，PHP 中写入/var/log/sensor/data.log - 若用 systemd 启动脚本，必须在 service 文件中声明
User=sensor和UMask=0002，否则生成的日志文件权限可能是 600，其他用户无法tail查看 - 禁止在日志路径中拼接变量：
$path = '/var/log/' . $_GET['module'] . '.log'是严重路径遍历漏洞，嵌入式设备也需防物理接触攻击 - 检查磁盘空间：写入前用
disk_free_space('/var/log')判断剩余空间，低于 5MB 时跳过写入并触发告警（如 GPIO 控制 LED 闪烁）
常见错误现象与对应修复
嵌入式 PHP 日志失效往往不是代码问题，而是环境链断裂。以下错误出现时，优先查这几点而非重写逻辑：
立即学习 “PHP 免费学习笔记（深入）”；
-
failed to open stream: Permission denied→ 不是 PHP 配置问题，是 systemd service 缺少ReadWritePaths=/var/log/sensor（在 OpenWrt 或 Yocto 上尤其常见） - 日志文件存在但内容为空 →
file_put_contents()被 OOM killer 终止，或 SD 卡已只读（dmesg | grep -i "readonly|I/O error"可确认） - 多进程写入时出现乱码或断行 → 未加
LOCK_EX，或用了fopen('a')但没fflush()，导致不同进程缓存区覆盖 - systemd journal 显示
PHP Warning: file_put_contents(): No space left on device→ 实际是/tmp满（PHP session 默认存这里），和日志路径无关
if (false === $fp = @fopen('/var/log/sensor/raw.log', 'a')) {// 记录到系统日志兜底，避免静默失败 error_log('Log write failed:' . error_get_last()['message']); exit(1); } fwrite($fp, date('Y-m-d H:i:s') . "t" . $adc_value . "n"); fflush($fp); fclose($fp);嵌入式日志真正的难点不在“怎么写”，而在“写失败时系统是否还能继续采集”。所有写操作必须有 fallback 路径，且 fallback 本身不能依赖可能失效的资源（比如再写另一个文件）。
