如何为长时间运行的 PHP CLI 任务配置 Kubernetes 存活性探针-php教程-PHP中文网

如何为长时间运行的 PHP CLI 任务配置 Kubernetes 存活性探针

本文介绍在不修改 PHP 脚本逻辑、不引入额外依赖的前提下，通过 Kubernetes exec 类型 liveness probe 监控无服务暴露的批处理 CLI 进程是否存活并持续工作。

本文介绍在不修改 php 脚本逻辑、不引入额外依赖的前提下，通过 kubernetes `exec` 类型 liveness probe 监控无服务暴露的批处理 cli 进程是否存活并持续工作。

对于运行在 Kubernetes 中的长期 PHP CLI 批处理任务（如数据清洗、报表生成、ETL 等），由于其不启动 HTTP 或其他网络服务，传统基于 HTTP 的 livenessProbe 不适用；而单纯检查进程是否存在（如 ps aux | grep php）也存在误判风险——进程可能僵死、卡住或陷入无限循环，但仍在系统中“存活”。

推荐方案是采用 exec 类型的 liveness probe，配合轻量级状态标记机制：PHP 主脚本在正常执行过程中周期性更新一个本地文件（如 /tmp/health.stamp）的时间戳，而探针通过检查该文件的存在性与新鲜度来判断业务是否健康。

✅ 示例实现步骤：

在 PHP CLI 脚本中添加心跳写入逻辑（无需外部库）：

PHP
编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载
```
// 在主循环关键位置（例如每处理完一批数据后）插入：
file_put_contents('/tmp/health.stamp', date('c'));
```

编写探针命令（Shell 层面校验文件时效性）：
推荐使用 stat + date 判断文件是否在合理窗口内被更新（例如：30 秒内）：

# 检查 /tmp/health.stamp 是否存在且距今不超过 30 秒
[ -f /tmp/health.stamp ] && [ $(($(date +%s) - $(stat -c '%Y' /tmp/health.stamp))) -le 30 ]

Kubernetes Pod 配置示例（关键片段）：

livenessProbe:
  exec:
    command:
      - sh
      - -c
      - '[ -f /tmp/health.stamp ] && [ $(($(date +%s) - $(stat -c "%Y" /tmp/health.stamp))) -le 30 ]'
  initialDelaySeconds: 30    # 给脚本充分启动时间
  periodSeconds: 15          # 每15秒探测一次
  failureThreshold: 3        # 连续3次失败才重启
  timeoutSeconds: 5

⚠️ 注意事项：

确保容器内安装了 stat 命令（多数基础镜像如 php:alpine 需 apk add --no-cache coreutils；php:debian 默认包含）；若不可用，可用 ls -la /tmp/health.stamp 2>/dev/null | head -n1 辅助判断，但精度略低。
避免将心跳文件写入内存受限路径（如某些 tmpfs 卷），建议使用默认可写路径 /tmp。
initialDelaySeconds 必须大于 PHP 脚本完成初始化所需时间，防止探针过早触发误杀。
不建议仅检查文件存在性（如 test -f /tmp/health.stamp），否则无法识别脚本挂起后未更新时间戳的情况。