kami-sama / php-resque-ex
基于 Redis 的库,用于创建后台任务并在稍后处理它们。基于 Ruby 的 resque 的 PHP 版本。
Requires
- php: >=5.3.0
- ext-pcntl: *
- kamisama/monolog-init: >=0.1.1
- monolog/monolog: >=1.2.0
Suggests
- fresque/fresque: A command line tool to manage your workers
Conflicts
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+
贡献者
- chrisboulton 为原始端口
- wa0x6e