laravel-mns

KO | EN

gitlite — search

#python #javascript #reactjs #api #react #css #aws #docker #deep-learning #html #go #swift

★ 26 Open GitHub ↗

Aliyun MNS Queue Driver For Laravel

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Aliyun MNS Queue Driver For Laravel

[![Latest Version on Packagist][ico-version]][link-packagist]
[![Software License][ico-license]](https://raw.githubusercontent.com/lokielse/laravel-mns/master/LICENSE.md)
[![Total Downloads][ico-downloads]][link-downloads]

## Install

Via Composer

``` bash
$ composer require lokielse/laravel-mns
```

## Config

Add following service providers into your providers array in `config/app.php`

``` php
Lokielse\LaravelMNS\LaravelMNSServiceProvider::class
```

Edit your `config/queue.php`, add `mns` connection

```php
'mns'        => [
	'driver'       => 'mns',
	'key'          => env('QUEUE_MNS_ACCESS_KEY'),
	'secret'       => env('QUEUE_MNS_SECRET_KEY'),
	'endpoint'     => env('QUEUE_MNS_ENDPOINT'),
	'queue'        => env('QUEUE_NAME'),
	'wait_seconds' => 30,
]
```
About [wait_seconds](https://help.aliyun.com/document_detail/35136.html)

Edit your `.env` file

```bash
QUEUE_DRIVER=mns
QUEUE_NAME=foobar-local
QUEUE_MNS_ACCESS_KEY=your_acccess_key
QUEUE_MNS_SECRET_KEY=your_secret_key
QUEUE_MNS_ENDPOINT=http://12345678910.mns.cn-hangzhou.aliyuncs.com/
```
You should update `QUEUE_MNS_ENDPOINT` to `internal endpoint` in production mode

## Usage

First create a queue and get queue endpoint at [Aliyun MNS Console](https://mns.console.aliyun.com/)

Then update `MNS_ENDPOINT` in `.env`

Push a test message to queue

```php
Queue::push(function($job){
	/**
	 * Your statments go here
	 */
	$job->delete();
});
```

Create queue listener, run command in terminal

```bash
$ php artisan queue:listen
```
## Commands
Flush MNS messages on Aliyun

```bash
$ php artisan queue:mns:flush
```

## Security

Create RAM access control at [Aliyun RAM Console](https://ram.console.aliyun.com)

1. Create a custom policy such as `AliyunMNSFullAccessFoobar`

```
	{
	  "Version": "1",
	  "Statement": [
		{
		  "Action": "mns:*",
		  "Resource": [
			"acs:mns:*:*:*/foobar-local",
			"acs:mns:*:*:*/foobar-sandbox",
			"acs:mns:*:*:*/foobar-production"
		  ],
		  "Effect": "Allow"
		}
	  ]
	}
	```

2. Create a user for you app such as `foobar`

3. Assign the policy `AliyunMNSFullAccessFoobar` to the user `foobar`

4. Create and get the `AccessKeyId` and `AccessKeySecret` for user `foorbar`

5. update `QUEUE_MNS_ACCESS_KEY` and `QUEUE_MNS_ACCESS_SECRET` in `.env`

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash
$ composer test
```

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.

## Credits

- [Loki Else][link-author]
- [abrahamgreyson](https://github.com/abrahamgreyson/laravel-mns)
- [All Contributors][link-contributors]

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

[ico-version]: https://img.shields.io/packagist/v/lokielse/laravel-mns.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
[ico-travis]: https://img.shields.io/travis/lokielse/laravel-mns/master.svg?style=flat-square
[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/lokielse/laravel-mns.svg?style=flat-square
[ico-code-quality]: https://img.shields.io/scrutinizer/g/lokielse/laravel-mns.svg?style=flat-square
[ico-downloads]: https://img.shields.io/packagist/dt/lokielse/laravel-mns.svg?style=flat-square

[link-packagist]: https://packagist.org/packages/lokielse/laravel-mns
[link-travis]: https://travis-ci.org/lokielse/laravel-mns
[link-scrutinizer]: https://scrutinizer-ci.com/g/lokielse/laravel-mns/code-structure
[link-code-quality]: https://scrutinizer-ci.com/g/lokielse/laravel-mns
[link-downloads]: https://packagist.org/packages/lokielse/laravel-mns
[link-author]: https://github.com/lokielse
[link-contributors]: ../../contributors

laravel-mns

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README