Linux下ThinkPHP如何实现自动化运维

Linux下ThinkPHP自动化运维实践

想让你的ThinkPHP应用在Linux服务器上跑得既稳当又省心？自动化运维是关键。下面这套从进程守护到一键巡检的实践方案，或许能给你带来不少启发。

一 进程守护与自动恢复

对于队列消费、WebSocket服务这类需要常驻内存的进程，最怕的就是悄无声息地崩溃。这时候，一个靠谱的“保姆”就至关重要了。

Supervisor正是这个角色的不二之选。它能帮你管理进程的启动、停止，更重要的是实现崩溃后的自动重启，还能把分散的日志集中起来，管理起来一目了然。

怎么用？其实很简单。无论是Ubuntu还是CentOS，安装都是一条命令的事：

sudo apt-get install supervisor
# 或
yum install supervisor

安装好后，关键是为你的ThinkPHP应用（比如一个队列处理器）创建一个配置文件，通常放在 /etc/supervisor/conf.d/ 目录下，例如 php-worker.conf：

[program:thinkphp-worker]
command=php /var/www/your_project queue:work --queue=default --tries=3 --sleep=3
autostart=true
autorestart=true
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/var/www/your_project/runtime/log/worker.log
stopwaitsecs=3600

配置文件写好，让Supervisor重新加载并启动它：

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start thinkphp-worker:*
sudo supervisorctl status  # 查看状态

这样一来，你的队列进程就有了“不死之身”。这个方案非常适合队列消费、自定义的守护进程，或是将计划任务常驻化。不过要提醒一点，PHP-FPM进程通常由系统服务管理，一般不建议交给Supervisor托管。

二 定时任务自动化

定时任务怎么搞才可靠？很多框架提供了钩子，但被动触发总有些不确定性。更稳妥的做法，是结合ThinkPHP的自定义命令和Linux的Crontab，实现主动、可控的调度。

具体分几步走：

1. 生成命令：先用ThinkPHP的命令行工具创建一个命令类。

   php think make:command CheckExpired check:expired

2. 编写逻辑：在生成的 app/command/CheckExpired.php 文件的 execute 方法里，写下你的业务逻辑。
3. 注册命令：在 config/console.php 中注册这个命令。

   return [
       'commands' => [
           'check:expired' => app\command\CheckExpired::class,
       ],
   ];

4. 手动测试：先在命令行跑一下，确保逻辑正确。

   php think check:expired

5. 交给Crontab：最后，把它添加到系统的定时任务里。比如，设置每天凌晨2点执行：

   0 2 * * * /usr/bin/php /var/www/your_project check:expired >> /var/log/php_cron.log 2>&1

这里有两个小建议：一是命令和路径尽量使用绝对路径，避免环境变量问题；二是记得将输出重定向到日志文件，这样既方便事后审计，也便于接入监控告警系统。

三 日志与性能监控

线上应用，不能做“睁眼瞎”。清晰的日志和有效的监控，是快速定位问题的生命线。

首先，用好应用内日志。 ThinkPHP的日志配置很灵活，可以按需调整级别和路径：

'log' => [
    'type' => 'file',
    'var_log_path' => './runtime/log',
    'level' => ['info','debug','warn','error'],
],

更进一步，可以加一个性能中间件，记录每个请求的耗时和内存峰值，对发现性能瓶颈特别有帮助：

namespace app\middleware;
use think\facade\Log;
class PerformanceMiddleware {
    public function handle($request, \Closure $next) {
        $start = microtime(true);
        $response = $next($request);
        $cost = microtime(true) - $start;
        Log::info("[{$request->method()}] {$request->url()} cost={$cost}s mem=".(memory_get_peak_usage()/1024/1024)."MB");
        return $response;
    }
}

查看日志时，tail -f 可以实时跟踪，而 grep 则能帮你快速筛选特定日期或错误级别的记录。

其次，系统级巡检不能少。 定期看看 top 或 htop 了解资源使用，用 vmstat、iostat 看看系统负载，用 ss -lntp | grep php 检查PHP进程的连接状态。别忘了 df -h，磁盘被日志或缓存写满可是个经典的“低级”故障。

最后，考虑引入专业的APM工具。 如果你需要更强大的可视化和告警，可以试试这些方案：

• Prometheus + Grafana：在ThinkPHP中通过一个中间件或扩展暴露一个 /metrics 接口，让Prometheus定时抓取数据，然后在Grafana里配置酷炫的面板和告警规则。
• Datadog / New Relic：这类商业APM功能更全面。安装对应的Agent和PHP扩展后，就能自动上报响应时间、吞吐量、错误率、慢事务追踪等数据，实现全链路可观测性。

四 部署发布与回滚自动化

手动上传代码、改配置、重启服务的时代该过去了。一个标准化的自动化部署流程，能极大减少人为失误。

标准流程可以固化如下：

1. 从代码仓库拉取最新版本（git pull 或 rsync同步）。
2. 安装生产环境依赖：composer install --optimize-autoloader --no-dev。
3. 如有数据库变更，执行迁移：php think migrate:run。
4. 清理应用缓存：php think clear。
5. 平滑重启相关服务，如Supervisor管理的进程或PHP-FPM。

如何实现零停机发布和快速回滚？ 这里有几个思路：

• 蓝绿/金丝雀发布：准备两套完全独立的环境（蓝环境和绿环境），通过切换Nginx的upstream指向来完成发布和回滚。或者，使用软链接切换发布目录，配合健康检查实现快速切流。
• 快速回滚：本质上就是切换到上一个已知的稳定版本。一条命令即可：git reset --hard <旧版本号>，然后重启相关进程。前提是你的部署流程要保证每次发布都有清晰的版本标记。

Nginx配置要点：

确保站点根目录指向ThinkPHP的 public 目录，并利用 try_files 隐藏入口文件。PHP请求则转发给PHP-FPM处理。

server {
    listen 80;
    server_name your.domain;
    root /var/www/your_project/public;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
}

最后，生产环境务必记得关闭调试模式（app_debug=false），限制对 .env 等敏感文件的访问，并启用HTTPS（Let‘s Encrypt可以免费获取证书）。

五 告警与一键巡检脚本

自动化运维的最后一环，是让系统在出现问题时能主动“喊”你。几个简单的脚本就能搭建起基础的告警体系。

简易日志错误告警脚本

这个脚本会检查最近5分钟内是否有新的ERROR或Exception日志，并通过邮件发送告警：

#!/usr/bin/env bash
LOG=/var/www/your_project/runtime/log/error.log
ALERT_EMAIL=ops@example.com
TMP_ERR=$(mktemp)
# 近5分钟新增错误
grep "$(date -d '5 minutes ago' '+%Y-%m-%d %H:%M')" -A2 "$LOG" | grep -E 'ERROR|Exception' > "$TMP_ERR"
if [ -s "$TMP_ERR" ]; then
    SUBJ="[ThinkPHP] 近5分钟发现错误"
    mail -s "$SUBJ" "$ALERT_EMAIL" < "$TMP_ERR"
fi
rm -f "$TMP_ERR"

一键健康检查脚本

这个脚本能快速给你一份系统核心服务的健康快照：

#!/usr/bin/env bash
echo "=== ThinkPHP Health Check $(date) ==="
echo "1) PHP-FPM: $(systemctl is-active php7.4-fpm)"
echo "2) Nginx: $(systemctl is-active nginx)"
echo "3) Disk: $(df -h | awk '$NF=="/"{print $5}') used"
echo "4) Queue: $(php think queue:status 2>&1 | head -n 20)"
echo "5) Recent Errors:"
tail -n 50 /var/www/your_project/runtime/log/error.log | tail -n 20

建议将这类脚本加入Crontab定时执行。告警信息也不应局限于邮件，可以集成到企业微信、钉钉或Slack的机器人，形成从发现问题到通知到人的完整闭环。这样一来，你就能在问题影响用户之前，抢先一步行动了。