CentOS服务器如何安装部署PHP Resque队列系统？

在现代Web应用开发中,将耗时、非即时的任务（如发送邮件、数据处理、图片压缩等）从主请求流程中剥离出来，交由后台异步处理，是提升用户体验和系统性能的关键策略，PHP Resque正是基于这一需求，借鉴了Ruby的Resque设计思想，利用Redis作为消息队列，提供了一套轻量级、健壮且易于使用的后台任务处理方案，本文将详细介绍如何在CentOS环境下，从零开始安装和配置PHP Resque，并构建一个简单的任务处理示例。

准备工作：环境依赖

在开始安装PHP Resque之前，确保你的CentOS服务器已经具备以下基础环境，这些组件是PHP Resque运行所必需的基石。

依赖项	推荐版本	说明
CentOS	x / 8.x	主流的服务器操作系统
PHP	4 / 8.x	Resque的运行语言环境
Composer	最新稳定版	PHP的依赖管理工具，用于安装Resque库
Redis	x / 6.x	内存数据库，用作任务队列的存储后端
Git	任意版本	用于从GitHub克隆Resque相关代码（可选，Composer会自动处理）

第一步：安装依赖环境

我们需要通过yum或dnf（CentOS 8使用）来安装和配置上述依赖。

安装EPEL和Remi仓库

为了获取较新版本的PHP和Redis,我们推荐启用EPEL和Remi仓库。

# 对于CentOS 7
sudo yum install -y epel-release
sudo yum install -y http://rpms.remirepo.net/enterprise/remi-release-7.rpm
# 对于CentOS 8
sudo dnf install -y epel-release
sudo dnf install -y http://rpms.remirepo.net/enterprise/remi-release-8.rpm

安装PHP、Composer和Redis

安装PHP及其常用扩展,以及Composer和Redis，这里以安装PHP 8.1为例。

# 启用PHP 8.1模块
sudo yum-config-manager --enable remi-php81  # CentOS 7
# sudo dnf module enable php:remi-8.1 -y     # CentOS 8
# 安装PHP, Redis, Git, Composer及其他必要工具
sudo yum install -y php php-cli php-fpm php-devel php-redis git redis composer
# 启动并设置Redis和PHP-FPM开机自启
sudo systemctl start redis
sudo systemctl enable redis
sudo systemctl start php-fpm
sudo systemctl enable php-fpm

安装完成后,可以通过 php -v 和 redis-cli ping 命令来验证PHP和Redis是否安装成功并正常运行。

第二步：安装PHP Resque库

PHP Resque本身是一个PHP库，我们通过Composer来管理它，这能极大地简化安装和版本控制过程。

1. 创建项目目录
   为你的项目创建一个独立的目录，/var/www/my-resque-app。

   sudo mkdir -p /var/www/my-resque-app
   sudo chown -R $USER:$USER /var/www/my-resque-app
   cd /var/www/my-resque-app

2. 使用Composer安装Resque
   在项目目录下，执行以下命令来添加chrisboulton/php-resque这个核心库。

   composer require chrisboulton/php-resque

   Composer会自动下载PHP Resque及其所有依赖，并生成一个vendor目录和一个composer.json文件。vendor/autoload.php是关键，我们之后的所有脚本都需要包含它。

第三步：创建任务、入队与启动工作进程

环境搭建完成后,我们来实践一个完整的流程：定义一个任务、将任务推入队列、启动工作进程来消费队列中的任务。

创建一个任务类

任务是具体执行后台逻辑的PHP类,每个任务类都必须实现Resque_Job_Interface接口，并实现其perform方法。

创建一个文件 jobs/MyJob.php：

<?php
// 文件: /var/www/my-resque-app/jobs/MyJob.php
class MyJob implements Resque_Job_Interface
{
    /**
     * 执行任务的核心逻辑
     *
     * @param array $args 入队时传递的参数
     */
    public function perform()
    {
        // 从参数中获取数据
        $userId = $this->args['user_id'];
        $message = $this->args['message'];
        // 模拟一个耗时操作，例如写入日志或发送邮件
        echo "Starting job for user {$userId}...n";
        sleep(5); // 模拟耗时5秒
        echo "Job finished. Message: '{$message}'n";
        // 在实际应用中，这里可以是数据库操作、API调用、文件处理等
        file_put_contents('/tmp/resque_log.log', date('Y-m-d H:i:s') . " - Processed job for user {$userId}n", FILE_APPEND);
    }
}

创建任务入队脚本

这个脚本的作用是接收请求,并将任务信息（任务类名、参数等）序列化后推送到Redis队列中。

创建一个文件 enqueue.php：

<?php
// 文件: /var/www/my-resque-app/enqueue.php
require_once 'vendor/autoload.php';
// 如果Redis不在默认地址，需要设置后端
// Resque::setBackend('localhost:6379');
// 定义队列名称、任务类名和参数
$queue = 'default';
$jobClass = 'MyJob'; // 注意：这里不需要完整路径，Resque会自动查找
$args = array(
    'user_id' => 123,
    'message' => 'Hello from Resque!'
);
// 将任务推入队列
$jobId = Resque::enqueue($queue, $jobClass, $args, true);
echo "Job '{$jobClass}' with ID '{$jobId}' has been enqueued to queue '{$queue}'.n";

运行这个脚本,就可以将一个任务添加到队列中：

php enqueue.php

启动Resque工作进程

工作进程是一个常驻后台的PHP脚本,它监听指定的队列，一旦发现有新任务，就会取出并执行，PHP Resque提供了一个内置的启动脚本。

在工作目录中,执行以下命令来启动一个监听default队列的工作进程：

# QUEUE环境变量指定要监听的队列，*表示监听所有队列
# APP_INCLUDE=vendor/autoload.php 确保工作进程能加载到我们的任务类
QUEUE=default APP_INCLUDE=vendor/autoload.php php vendor/bin/resque

你会看到类似以下的输出,表示工作进程已成功启动并在等待任务：

*** Starting worker your-hostname:pid:default
*** Checking for jobs on default
*** Waiting for default

再运行一次 php enqueue.php，你就会在工作进程的终端窗口中看到任务被执行的输出。

为了能让工作进程在后台稳定运行,推荐使用nohup或更专业的进程管理工具如Supervisor来管理它。

# 使用nohup简单地在后台运行
nohup sh -c "QUEUE=default APP_INCLUDE=vendor/autoload.php php vendor/bin/resque" > resque_worker.log 2>&1 &

配置与最佳实践

• 工作进程管理：在生产环境中，强烈建议使用Supervisor来管理Resque工作进程，它可以实现进程的自动重启、日志轮转、多进程管理等高级功能，确保任务处理的稳定性。
• 失败任务处理：Resque提供了失败任务后端的机制，可以将执行失败的任务记录下来，以便后续分析和重试，你可以自定义失败处理逻辑，例如将失败任务存入数据库或特定的Redis列表中。
• 环境隔离：为不同的应用或不同类型的任务创建不同的队列（如email_queue, image_queue），并启动相应的工作进程来处理，可以实现任务的优先级管理和环境隔离。

通过以上步骤,你已经成功在CentOS上搭建了一个功能完备的PHP Resque环境，这套系统能够有效地将你的Web应用与后台任务解耦，显著提升应用的响应能力和整体架构的健壮性。

---

相关问答FAQs

Q1: 我启动了工作进程，也执行了入队脚本，但任务似乎没有被处理，我应该从哪里开始排查？

A1: 这是一个常见问题，可以按照以下步骤进行排查：

1. 检查Redis连接：首先确认你的入队脚本和工作进程都能连接到同一个Redis实例，可以在入队脚本和工作进程中都运行 Resque::setBackend('your-redis-host:port'); 并确保地址端口正确。
2. 检查队列名称：确认入队脚本中Resque::enqueue的第一个参数（队列名）与启动工作进程时QUEUE环境变量指定的队列名完全一致，注意大小写和空格。
3. 查看工作进程日志：仔细观察工作进程的终端输出或日志文件（如果用Supervisor或nohup重定向了），它会显示是否有错误发生，比如找不到任务类（Could not find job class...）。
4. 检查PHP自动加载：确保启动工作进程时设置了正确的APP_INCLUDE环境变量，指向vendor/autoload.php，否则，工作进程将无法找到你定义的MyJob类。
5. 直接检查Redis：使用redis-cli连接到Redis，执行LLEN default（假设你的队列叫default）命令，如果返回值大于0，说明任务确实在队列中，问题出在工作进程端，如果返回0，说明任务可能根本没有成功入队。

Q2: 如何确保我的Resque工作进程在服务器重启后能自动启动？

A2: 仅仅使用nohup &无法保证进程在系统重启后自动恢复，最佳实践是使用系统的进程管理工具，例如systemd（CentOS 7+默认）或Supervisor。

使用Supervisor（推荐）：

1. 安装Supervisor: sudo yum install supervisor。
2. 在/etc/supervisord.d/目录下创建一个配置文件，如resque-worker.ini。
3. 配置文件内容如下：

   [program:resque-worker]
   process_name=%(program_name)s_%(process_num)02d
   command=php /var/www/my-resque-app/vendor/bin/resque
   environment=QUEUE="default",APP_INCLUDE="/var/www/my-resque-app/vendor/autoload.php"
   directory=/var/www/my-resque-app
   autostart=true
   autorestart=true
   user=your_user  # 运行进程的用户
   numprocs=1      # 启动1个工作进程
   redirect_stderr=true
   stdout_logfile=/var/log/supervisor/resque_worker.log

4. 更新Supervisor配置并启动进程：

   sudo supervisorctl reread
   sudo supervisorctl update
   sudo supervisorctl start resque-worker:*

   这样,Supervisor会监控你的工作进程，即使意外退出或服务器重启，它也会自动将其拉起。