Gearman Manager for PHP 技术文档

本文档旨在帮助用户安装、使用 Gearman Manager for PHP，并详细说明其项目API的使用。以下是本文档的结构：

1. 安装指南

系统要求

• PHP 5.5.9（已测试此版本）
• POSIX扩展
• 进程控制扩展
• pecl/gearman 或 Net_Gearman

安装步骤

1. 安装PHP和所需的扩展（POSIX、进程控制、pecl/gearman或Net_Gearman）。
2. 从GitHub下载Gearman Manager for PHP源代码。
3. 将下载的源代码放到服务器的适当目录。

2. 项目使用说明

Gearman Manager旨在简化Gearman工作进程的运行。部署后，您只需编写实际执行工作的代码，无需重复设置工作进程。

工作原理

• 创建一个目录来存放工作进程代码，例如worker_dir。
• 在该目录下创建文件，文件名决定注册到gearmand服务器的函数。

示例

过程式风格:

// worker_dir/example_function.php

function example_function($job, &$log) {
    $workload = $job->workload();
    // 在此处处理工作，如pecl/gearman文档所述
    $log[] = "Success";
    return $result;
}

面向对象风格:

// worker_dir/ExampleFunction.php

class ExampleFunction {
    public function run($job, &$log) {
        $workload = $job->workload();
        // 在此处处理工作，如pecl/gearman文档所述
        $log[] = "Success";
        return $result;
    }
}

进程管理

Gearman Manager还提供进程管理功能。如果进程死亡，它会重新启动一个新的进程来替代。您可以配置工作进程在一定时间后死亡，以防止PHP占用过多内存。

代码部署

Gearman Manager具有监控工作目录的选项，如果检测到新代码部署到服务器，会重新启动工作进程。

3. 项目API使用文档

Gearman Manager的配置文件分为全局部分[GearmanManager]和每个函数的独立部分。以下是一些常用配置选项：

• worker_dir：定义工作进程函数所在的目录。
• include：指定要注册的工作进程函数。
• count：定义应该运行的最小工作进程数。
• dedicated_count：为每个注册的函数定义专用进程数。
• max_worker_lifetime：定义工作进程在死亡前的最大生命周期。
• auto_update：如果设置为1，管理器会监控工作目录并重新加载新代码。

4. 项目安装方式

运行以下命令启动Gearman Manager守护进程：

# ./pecl-manager.php -c /path/to/config.ini

以下是一些有用的命令行选项：

• -P：指定管理进程的PID文件存储位置。
• -d：使管理器作为守护进程运行。
• -u：指定运行守护进程的用户。

如需调试，可以安装并配置Xdebug。

安装

pecl install xdebug

配置

在xdebug.ini中添加以下内容：

zend_extension="/path/to/where/your/xdebug.so"
xdebug.scream = 1
xdebug.show_exception_trace = 1

以上文档提供了安装和使用Gearman Manager for PHP的详细指南，以及如何配置和使用其API。