README

Messente 扩展包 for Laravel

简介

这是一个简单的 Laravel Service Provider，提供对 Messente API 的访问

安装

使用 Composer 安装 PHP 客户端库

composer require jcsofts/laravel-messente

或者，将这些两行代码添加到你的 composer require 部分

{
    "require": {
        "jcsofts/laravel-messente": "^1.0"
    }
}

Laravel 5.5+

如果你使用 Laravel 5.5 或更高版本，该包将自动注册 Messente 提供器和外观。

Laravel 5.4 及以下

将 Jcsofts\LaravelMessente\MessenteServiceProvider 添加到你的 config/app.php 文件中的 providers 数组中

'providers' => [
    // Other service providers...

    Jcsofts\LaravelMessente\MessenteServiceProvider::class,
],

如果你想使用外观接口，可以在需要时使用外观类

use Jcsofts\LaravelMessente\Facade\Messente;

或者在你的 config/app.php 中添加别名

'aliases' => [
    ...
    'Messente' => Jcsofts\LaravelMessente\Facade\Messente::class,
],

在 Lumen 中使用 Laravel-Messente

laravel-messente 也可以与 Lumen 一起使用！你需要手动做一些工作来使其运行。首先，使用 composer 安装包

composer require jcsofts/laravel-messente

接下来，我们需要告诉 Lumen 我们的库存在。更新 bootstrap/app.php 并注册 MessenteServiceProvider

$app->register(Jcsofts\LaravelMessente\MessenteServiceProvider::class);

最后，我们需要配置库。不幸的是，Lumen 不支持自动发布文件，所以你需要自己创建配置文件，创建一个配置目录并将配置文件从包中复制到你的项目中

mkdir config
cp vendor/jcsofts/laravel-messagete/config/messente.php config/messente.php

此时，在你的 .env 文件中设置 MESSENTE_API_USERNAME 和 MESSENTE_API_PASSWORD，它应该可以为你工作了。你可以使用以下路由进行测试

try{
        $mid=Messente::send('Hello word', '+8618903859445');
        echo $mid;
    }catch(Exception $e){
        echo $e->getMessage();
    }

配置

你可以使用 artisan vendor:publish 将分发配置文件复制到你的应用的配置目录

php artisan vendor:publish

然后更新 config/messente.php 并使用你的凭据。或者，你也可以在 .env 文件中更新以下内容

MESSENTE_API_USERNAME=API Username
MESSENTE_API_PASSWORD=API Password
MESSENTE_SENDER=

用法

要使用 Messente 客户端库，你可以使用外观，或者从服务容器中请求实例

try{
        $messageId=Messente::send('Hello word', '+8618903859445');
        echo $messageId;
    }catch(Exception $e){
        echo $e->getMessage();
    }

或者

$messente = app('Messente');

$messageId=$messente->send('Hello word', '+8618903859445');