minchao/every8d-laravel

Laravel Package for EVERY8D's PHP SDK

0.0.3 2019-11-02 00:27 UTC

This package is auto-updated.

Last update: 2024-11-29 05:03:43 UTC


README

Build Status Latest Stable Version Latest Unstable Version composer.lock

這是一個簡單的 Laravel service provider,讓您在 Laravel 或 Lumen 應用中更容易的使用 EVERY8D SDK

執行環境

安裝

建議透過 Composer 安裝:

$ composer require minchao/every8d-laravel

安裝後,您必須在應用啟動時註冊這個套件,請參考以下步驟說明。

Laravel

在 Laravel 5.5 或以上版本,這個套件可以自動註冊 provider 與 facade。

Lumen

由於 Lumen 沒有自動註冊機制,請在專案的 bootstrap/app.php 檔案中加入 Every8d\Laravel\Every8dServiceProvider

    $app->register(Every8d\Laravel\Every8dServiceProvider::class);

複製 every8d.php 設定擋:

$ mkdir config
$ cp vendor/minchao/every8d-laravel/config/every8d.php config/every8d.php

設定

使用 Artisan 指令產生套件設定擋(Lumen 未支援)。

$ php artisan vendor:publish --provider="Every8d\Laravel\Every8dServiceProvider"

然後在 config/every8d.php 設定檔內填入您的 EVERY8D SMS API 帳號密碼。另一個選擇,您也可以在 .env 檔案中透過環境變數設定:

EVERY8D_USERNAME=username
EVERY8D_PASSWORD=password

使用

在應用內使用時,您可以從 service container 中取得 EVERY8D SDK 實例:

$every8d = app(\Every8d\Client::class);

$sms = new \Every8d\Message\SMS('+886987654321', 'Hello, Laravel IoC Container');
$result = $every8d->sendSMS($sms);

或,您也可以使用 facade:

$sms = new \Every8d\Message\SMS('+886987654321', 'Hello, Facade');
$result = Every8d::sendSMS($message);

License

See the LICENSE file for license rights and limitations (BSD 3-Clause).