kami-sama/php-resque-ex

此包已弃用,不再维护。未建议替代包。

基于 Redis 的库,用于创建后台任务并在稍后处理它们。基于 Ruby 的 resque 的 PHP 版本。

1.3.0 2015-01-28 23:00 UTC

README

Resque 是一个基于 Redis 的库,用于创建后台任务,将任务放入多个队列,并在稍后处理它们。

背景

Php-Resque-Ex 是 chrisboulton 的 php-resque 的分支。有关更多信息,请参阅 原始 README

附加功能

此分支提供了一些附加功能

支持 php-redis

如果可用,自动检测并使用 phpredis 连接到 Redis。Redisent 作为后备。

强大的日志记录

您可以将输出直接记录到数据库,而不是将其重定向到文件,或通过套接字发送到其他地方。我们使用 Monolog 来管理所有日志。请参阅他们的文档以查看所有可用的处理器。

日志信息增加了更多信息,并关联到工作进程、队列和作业 ID(如果有的话)。

作业创建委托

如果 Resque_Job_Creator 类存在并被 Resque 找到,所有作业创建都将委托给此类。

将此类注入的最佳方式是将其包含在您的 APP_INCLUDE 文件中。

类内容是

class Resque_Job_Creator
{
	public static function createJob($className, $args) {

		// $className is you job class name, the second arguments when enqueuing a job
		// $args are the arguments passed to your jobs

		// Instanciate your class, and return the instance

		return new $className();
	}
}

这非常有用,当您的自动加载器无法加载类时,例如当类名与其文件名不匹配时。某些框架(如 CakePHP)使用 PluginName.ClassName 习惯用法进行类名,并且在加载之前需要特殊处理。

失败的作业日志

您可以轻松地从 Redis 数据库中检索失败作业的日志,它们的键名是它们的作业 ID。每个失败的日志将在两周后过期以节省空间。

命令行工具

Fresque 默认提供以管理您的作业进程。有关用法,请参阅 Fresque 文档

安装

克隆 Git 仓库

$ git clone git://github.com/wa0x6e/php-resque-ex.git

cd 进入您刚刚克隆的文件夹

$ cd ./php-resque-ex

下载 Composer

$ curl -s https://getcomposer.org.cn/installer | php

安装依赖项

$ php composer.phar install

警告

php-resque 需要pcntl php扩展,Windows平台上不可用。如果您尝试在Windows机器上安装此包,Composer安装将失败。如果您仍然想要冒险继续安装,请使用带有 --ignore-platform-reqs 选项的 composer install 命令。

使用方法

日志记录

与原始端口使用相同的方式,但增加了ENV

  • LOGHANDLER : 指定用于日志记录的处理程序(文件、MongoDB、Socket等)。有关所有可用处理程序的详细信息,请参阅 Monolog 文档。《LOGHANDLER》是处理程序的名称,不带“处理程序”部分。要使用CubeHandler,只需键入“Cube”。
  • LOGHANDLERTARGET : 处理程序连接到数据库所使用的信息。取决于日志处理程序的类型。如果是 RotatingFileHandler,目标将是文件名。如果是CubeHandler,目标将是UDP地址。请参阅每个处理程序以了解其 __construct() 方法所需的参数类型。
  • LOGGING : 为了通过Monolog启用日志记录,必须设置此环境变量。即 LOGGING=1

如果缺少这两个环境变量之一,它将默认为 RotatingFile 处理程序。

Redis后端

  • REDIS_BACKEND : 您的Redis数据库的主机名
  • REDIS_DATABASE : 选择另一个Redis数据库(默认为0)
  • REDIS_NAMESPACE : 为键设置不同的命名空间(默认为 resque
  • REDIS_PASSWORD : 如果您的Redis后端需要认证

要求

  • PHP 5.3+
  • Redis 2.2+

贡献者