Generic placeholder image
闲敲代码、落灯花
What's past is prologue

联系邮箱:email@hezehua.net


联系QQ:1907330840

座右铭

保持热情,持续学习,每日精进

Laravel服务提供者在平台短信服务中的应用

Laravel服务提供者在平台短信服务中的应用

本文与作者在csdn上的博文【Laravel服务提供者在平台短信服务中的应用】保持同步


服务提供者是一个有效的将工具与业务解耦的方案,下面结合一个实用案例来解释服务提供者在实现提供基础服务的工具中的应用。

服务提供者

服务提供者是 Laravel 应用启动的中心,所有 Laravel 的核心服务都是通过服务提供者启动,通过使用服务提供者来管理类的依赖和执行依赖注入,可以很好地将一些底层服务与应用层代码解耦。

短信服务

短信服务对于一个系统来说,是基础的、通用的服务,不依赖于业务细节,所以应该将其与业务解耦。

系统设计

将不同服务商的sdk称为驱动,短信服务应该满足以下需求:

  1. 可替换驱动
  2. 驱动实例化对使用者透明

1、可替换驱动

要满足第1点,首先应该使用接口约束对外暴露的方法,只有驱动满足接口约束,才能不影响业务直接替换驱动,于是设计接口:

<?php

namespace App\Interfaces;

Interface SmsDriverInterface
{

    public function sendMessage($phones, $template_id, $parameters);
}

如果接入的厂商是七牛云,则创建七牛云短信驱动,并在驱动中调用SDK实现功能:

<?php
namespace App;

use Qiniu\Auth;
use Qiniu\Http\Client;
use Qiniu\Http\Error;
use Qiniu\Sms\Sms;
class QiniuDriver implements SmsDriverInterface
{
    const HOST = 'https://sms.qiniuapi.com';

    const VERSION = 'v1';
    public function __construct()
    {
        $this->auth  = new Auth(config('access_key'), config('secret_key'));

        $this->sms = new Sms($this->auth);
    }

    public function sendMessage($phones, $template_id, $parameters = [])
    {
        $phones = array_map(function($item)
        {
            if(!is_string($item))
            {
                $item = strval($item);
            }

            return $item;
        }, $phones);

        $ret = $this->sms->sendMessage($template_id, $phones, $parameters);

        $result = $this->getResultApiRet($ret);

        return $result;
    }
}

别的厂商的驱动也这样实现接口SmsDriverInterface,在更换厂商的时候,换一个驱动实例化就可以了。

2、驱动实例化对使用者透明

此处的使用者就是使用短信服务实现业务需求的工程师啦,因为短信服务的基础、通用的特性,会被在业务中很多地方使用,如果更换驱动的话,会涉及很多具体业务代码的修改,所以需要创建一个服务类,用来统筹驱动的使用,具体业务中再调用这个服务类,驱动的实例化就对业务透明了:

<?php
namespace App;
class SmsService
{
    public $driver;

    public function driver($driver_name)
    {
        switch($driver_name)
        {
            case 'qiniu':
                $this->driver = new QiniuDriver();
            break;
            case 'aliyun':
                $this->driver = new AliyunDriver();
            break;
        }
    }

    public function senndMessage($phone, $template_id)
    {
        return $this->driver->sendMessage($phone, $template_id);
    }
} 

再做改进,将传参选择驱动类型改为从配置中获取驱动类型:

<?php
namespace App;
class SmsService
{
    public $driver;

    public function driver()
    {
        switch(config('driver'))
        {
            case 'qiniu':
                $this->driver = new QiniuDriver();
            break;
            case 'aliyun':
                $this->driver = new AliyunDriver();
            break;
        }
    }
    ......
}

至此,基本满足了刚才所说的2点基本需求,但是,在增加驱动的时候要去改动driver()中的代码,增加其它驱动项,在服务类中枚举出所有的驱动似乎不够简洁,这里可以使用服务提供者再做优化:

<?php

namespace App\Providers;

use App\Interfaces\SmsDriverInterface;
use App\NullSms;
use App\QiniuSms;
use App\SmsService;
use Illuminate\Support\ServiceProvider;

class SmsServiceProvider extends ServiceProvider
{

    protected $defer = true;

    /**
     * Bootstrap the application services.
     *
     * @return void
     */
    public function boot()
    {

    }

    /**
     * Register the application services.
     *
     * @return void
     */
    public function register()
    {
        $this->app->singleton(SmsDriverInterface::class, function ($app) {

            switch(config('driver'))
            {
                case 'qiniu':
                    return new QiniuDriver();
            }

            return new NullSms();
        });
    }

    public function provides()
    {
        return [SmsDriverInterface::class];
    }
}

这里将驱动接口与配置中指定的具体驱动绑定,在服务类中的实例化方式可以改成依赖注入,因为短信驱动应该使用单例并且为了调用短信服务方便,将服务类中方法改为静态方法:

namespace App;
class SmsService
{
    public $driver;

    public function __construct(SmsDriverInterface $driver)
    {
        $this->driver = $driver;
    }

    public static function driver()
    {
        return app(self::class)->driver;
    }
    public static function sendMessage($phone, $template_id)
    {
        return SmsSend::driver()->sendMessage($phone, $template_id);
    }
}

最后将短信服务提供者添加到config/app.php文件的providers列表中,短信服务者的开发就完成了。

在这个案例中,短信服务提供者通过服务容器的依赖注入,实现了驱动在服务类中的自动实例化,在逻辑上将底层驱动与上层服务解耦。

这个案例比较简单,还有很多可以完善的地方,比如,不在服务提供者中能够使用switch去匹配驱动类型,而是增加一个驱动管理器,根据命名规则去实例化对应的驱动,这样的话就达到了增加并更换驱动的时候,只增加驱动类,以及更换config配置,就能“平滑”替换驱动的目的。

猜你喜欢
支付宝支付同步回调url中携带参数的两种方法
阅读 479

1、 如果要传递的参数是my_data,可以先将该参数添加到回调的url上: $return_url = "http://abcdefg.com/return_url?my_data=hello"; 当支付宝同步回调该url时,会在该url上增加其它字段...

Laravel中使用Eloquent时给查询的字段设置别名
阅读 698

示例 $user-&gt;where('is_active',1)-&gt;get('id','account as username'); 该示例中取出account字段时用了as关键之设置别名,取出的数据中将包含id、username俩字段

单例测试phpunit
阅读 254

1、执行单例测试 ./vendor/bin/phpunit 2、执行指定单例测试文件 ./vendor/bin/phpunit tests/BlogTest.php 3、执行指定测试函数 ./vendor/bin/phpunit --filter testPostArticle 4、执...

Laravel5.6 实现小程序使用openid登陆、手机号验证码登陆、账户密码登陆三种登陆方式
阅读 458

目前开发小程序,按需求要实现3种登陆方式: 1、微信授权登陆 2、手机号、验证码登陆 3、账户密码登陆 我使用laravel自带的Auth认证机制,通过attempt方法进行账户验证,但是默认的认证机制必须包含password字段,而我的第1、3种登陆方式都没有password字段,所以需要深入源...

Laravel Collection 常用方法(1)
阅读 415

1、first 返回集合第一个通过指定测试的元素: collect([1, 2, 3, 4])->first(); // 1 collect([1, 2, 3, 4])->first(function ($value, $key) { return $v...

laravel-admin form中的数据,在提交后,保存前,获取并进行编辑
阅读 1211

有一个这样的需求: 当商品设置为立即上架时,通过审核就进入上架状态,当设置为保存时,通过审核就进入未上架状态。 所以,需要在保存前根据提交的审核状态和设置的方式得到商品状态再保存,而通过$form-&gt;model()-&gt;attribute_na...

Laravel 怎么查看执行的Sql语句
阅读 95

1、如果是使用Eloquent ORM操作数据库的话,在sql查询时可以调用toSql()方法来获取sql: App\User::where('name','like','%hezehua%')->toSql(); 2、如果是执...

laravel-admin grid中使用的switch必须form中同时具有switch才能生效的解决方案
阅读 843

laravel-admin中的grid使用switch时必须在form里使用switch,但有时候想单独作为一种操作,不想放在form中被编辑,就需要绕过这种限制,根据laravel-admin的源码可知,所有的默认的更新操作都是通过update函数来处理,而在这个函数中又调用了prepare函数...