README

Laravel 和 Lumen 的 AMQP 包装器，特别用于从 RabbitMQ 发布和消费消息

功能

• 高级队列配置
• 轻松将消息添加到队列中
• 使用有用选项监听队列

安装

Composer

将以下内容添加到 composer.json 中的 require 部分

"bschmitt/laravel-amqp": "1.*"

$ php composer update

或者

$ php composer require bschmitt/laravel-amqp

集成

Lumen 和 Laravel 都支持

在 Lumen 应用程序的根目录下创建一个 config 文件夹，并将 vendor/bschmitt/laravel-amqp/config/amqp.php 的内容复制到 config/amqp.php。

在此处或 .env 文件中调整属性以满足您的需求

return [

    'use' => 'production',

    'properties' => [

        'production' => [
            'host'                => '',
            'port'                => '',
            'username'            => '',
            'password'            => '',
            'vhost'               => '/',
            'connect_options'     => [],
            'ssl_options'         => [],

            'exchange'              => 'amq.topic',
            'exchange_type'         => 'topic',
            'exchange_passive'      => false,
            'exchange_durable'      => true,
            'exchange_auto_delete'  => false,
            'exchange_internal'     => false,
            'exchange_nowait'       => false,
            'exchange_properties'   => [],

            'queue_force_declare'   => false,
            'queue_passive'         => false,
            'queue_durable'         => true,
            'queue_exclusive'       => false,
            'queue_auto_delete'     => false,
            'queue_nowait'          => false,
            'queue_properties'      => ['x-ha-policy' => ['S', 'all']],

            'consumer_tag'      => '',
            'consumer_no_local'   => false,
            'consumer_no_ack'     => true,
            'consumer_exclusive'  => false,
            'consumer_nowait'     => false,
            'timeout'             => 0,
            'persistent'          => true,
        ],

    ],

];

在 bootstrap/app.php 中注册 Lumen 服务提供者

/*
|--------------------------------------------------------------------------
| Register Service Providers
|--------------------------------------------------------------------------
*/

//...

$app->configure('amqp');
$app->register(Bschmitt\Amqp\LumenServiceProvider::class);

//...

为 Lumen 5.2+ 添加 Facade 支持

//...
$app->withFacades();
class_alias(\Illuminate\Support\Facades\App::class, 'App');
//...

Laravel

打开 config/app.php 并添加服务提供者和别名

'Bschmitt\Amqp\AmqpServiceProvider',

'Amqp' => 'Bschmitt\Amqp\Facades\Amqp',

发布消息

使用路由键推送消息

    Amqp::publish('routing-key', 'message');

使用路由键推送消息并创建队列

    Amqp::publish('routing-key', 'message' , ['queue' => 'queue-name']);

使用路由键推送消息并覆盖属性

    Amqp::publish('routing-key', 'message' , ['exchange' => 'amq.direct']);

使用路由键推送大量消息

    Amqp::publish('routing-key', ['message1', 'message2', ......], a);

消费消息

消费消息，确认并在没有消息时停止

Amqp::consume('queue-name', function ($message, $resolver) {
    		
   var_dump($message->body);

   $resolver->acknowledge($message);

   $resolver->stopWhenProcessed();
        
});

永久消费消息

Amqp::consume('queue-name', function ($message, $resolver) {
    		
   var_dump($message->body);

   $resolver->acknowledge($message);
        
});

使用自定义设置消费消息

Amqp::consume('queue-name', function ($message, $resolver) {
    		
   var_dump($message->body);

   $resolver->acknowledge($message);
      
}, [
	'timeout' => 2,
	'vhost'   => 'vhost3'
]);

扇出示例

发布消息

\Amqp::publish('', 'message' , [
    'exchange_type' => 'fanout',
    'exchange' => 'amq.fanout',
]);

消费消息

\Amqp::consume('', function ($message, $resolver) {
    var_dump($message->body);
    $resolver->acknowledge($message);
}, [
    'exchange' => 'amq.fanout',
    'exchange_type' => 'fanout',
    'queue_force_declare' => true,
    'queue_exclusive' => true,
    'persistent' => true// required if you want to listen forever
]);

致谢

• 一些概念来自 https://github.com/mookofe/tail

许可协议

本软件包是开源软件，许可协议为 MIT 许可协议