# laravel-mns

**Repository Path**: abrahamgreyson/laravel-mns

## Basic Information

- **Project Name**: laravel-mns
- **Description**: 阿里云消息服务（Aliyun MNS）的 Laravel 队列适配
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2022-06-21
- **Last Updated**: 2024-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Laravel, queue

## README

# Laravel-MNS
[![Build Status](https://travis-ci.org/abrahamgreyson/laravel-mns.svg?branch=master)](https://travis-ci.org/abrahamgreyson/laravel-mns)
[![Code Coverage](https://scrutinizer-ci.com/g/abrahamgreyson/laravel-mns/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/abrahamgreyson/laravel-mns/?branch=master)
[![Latest Stable Version](https://poser.pugx.org/abe/laravel-mns/v/stable)](https://packagist.org/packages/abe/laravel-mns)
[![License](https://img.shields.io/badge/license-MIT-000000.svg)](https://packagist.org/packages/abe/laravel-mns)

阿里云消息服务（MNS）的 Laravel 适配，本质上是为 Laravel 的队列增加 MNS 驱动。包含了阿里云 MNS SDK，为了 Laravel 能透明的使用 MNS 而对其作必要的引用。

 > 自 [chefxu/aliyun_mns](https://github.com/chefxu/aliyun_mns) 之上修改而来，鉴于缩进、换行和文件命名等代码风格有所差异，无法发 pr。

 > 阿里云 MNS SDK 不支持 Composer，直接将其包含在版本库中，并注册到 `AliyunMNS` 命名空间下。


## 安装使用

通过 Composer 安装：

```shell
$ composer require abe/laravel-mns
```

之后在 config/queue.php 中增加 `mns` 配置：

```php
'connections' => [
    'redis' => [
        'driver'     => 'redis',
        'connection' => 'default',
        'queue'      => 'default',
        'expire'     => 60,
    ],

    // 新增阿里云 MNS。
    'mns'   => [
        'driver'   => 'mns',
        'key'      => env('MNS_ACCESS_KEY', 'access-key'),
        'secret'   => env('MNS_SECRET_KEY', 'secret-key'),
        // 外网连接必须启用 https。
        'endpoint' => 'your-endpoint',
        'queue'    => env('MNS_DEFAULT_QUEUE', 'default-queue-name'),
    ],
],
```

并且在你常用的 ServiceProvider 中注册队列驱动：

```php
Queue::extend('mns', function()
{
    return new \LaravelMns\Connectors\MnsConnector();
});
```

正常使用 Laravel Queue 即可：

[https://laravel.com/docs/5.2/queues](https://laravel.com/docs/5.2/queues)


## 许可

MIT