聊聊 Interface 在 Laravel 开发中的使用

聊聊 Interface 在 Laravel 开发中的使用

你也许听过面向接口编程,而不是面向对象编程的设计思想,如 代码到接口,而不是实现,程序到接口,使用抽象而不是具体化等。

这些所指的都是同一件事,在开发中我们的应用程序应该依赖于抽象(接口)而不是具体的(类)。

为什么?

这是我第一次听到这个说法时的反应。为什么我要使用接口而不是类?意味着我需要创建一个接口,我还要创建一个实现该接口的类???这不是浪费时间吗?

当然这样设计是有意义的


在架构师的眼中「没有什么是不会变化的」,或者说 改变 才是 不变 的。

我们开发的业务需求随时间和不断扩张而变化,我们的代码也是如此。

所以我们的代码必须灵活。

代码到接口使我们的代码松散耦合且灵活。

怎么做?

请看以下代码示例:

class Logger {

    public function log($content) 
    {
        //输出 Log 日志到文件。
        echo "Log to file";
    }
}

一个简单的 Logger 类将日志记录到文件,我们来在控制器中调用它。

class LogController extends Controller
{
    public function log()
    {
        $logger = new Logger();
        $logger->log('Log this');
    }
}

但是,如果我们想记录其他位置,如数据库、文件、云或其他呢?

我们在 Logger 类中再添加几个方法:

class Logger 
{
    public function logToDb($content) 
    {
        //输出日志到 DB。
    }

    public function logToFile($content) 
    {
        //输出 Log 日志到文件。
    }

    public function logToCloud($content) 
    {
        //输出 Log 日志到云。
    } 
}

然后我们还要在 LoggerController 中添加判断:

class LogController extends Controller
{
    public function log()
    {
        $logger = new Logger();

        $target = config('log.target');

        $content = 'Log this.';

        switch ($target) {
            case 'db':
                $logger->logToDb($content);
                break;
            case 'file':
                $logger->logToFile($content);
                break;
            default:
                $logger->logToCloud($content);
        }
    }
}

好了,我们现在可以通过配置文件把日志输出到各种终端。但我们如果还要再输出日志到 redis 呢?我们还需要再增加一个方法,并且在控制器中再加一次判断。

控制器代码很快就变得臃肿,如果还要输出日志到更多地方呢?Logger 类中每个方法如果还需要扩展呢?这对于后期维护来说并不好。

这样做同时也不符合 SOLID 原则,我们先来拆分一下 Logger 类,将职责拆分成不同的类。

//DBLogger.php
namespace App\Logs;
class DBLogger
{
    public function log($content)
    {
        //输出日志到 DB。
    }
}

//FileLogger.php
namespace App\Logs;
class FileLogger
{
    public function log($content)
    {
        //输出 Log 日志到文件。
    }
}

//CouldLogger.php
namespace App\Logs;
class CloudLogger
{
    public function log($content)
    {
        //输出 Log 日志到云。
    }
}

再来修改 LogController:

class LogController extends Controller
{
    public function log()
    {
        $target = config('log.target');

        switch ($target) {
            case 'db':
                (new DBLogger())->log($content);
                break;
            case 'file':
                (new FileLogger())->log($content);
                break;
            default:
                (new CouldLogger())->log($content);
        }
    }
}

这看上去还行,我们拆分了 Logger,如果需要添加输出日志到 redis,那就继续再加 case 吧。


但依然有一个问题就是我们的控制器「知道太多了」,它应该只去调用一个 log() 方法来记录,而不应该知道使用哪个 Logger 类,也不应该去实例化任何类,这样在将来有改动的时候,不论是要输出到哪里,我们都不需要再来修改 LogController 的代码,那应该怎么做呢?

Interface 出场

这种情况最适合使用接口来实现了,什么是接口呢?

接口是定义对象可以哪些执行操作的描述。

回到我们的代码,控制器只需要一个带有 log() 方法的 Logger 类,所以我们的接口也必须定义一个 log() 方法。

interface LogInterface
{
    public function log($content);
}

我一般把 Interface 接口文件放在项目的 App\Contracts 文件夹。

接口只包含方法声明而不包含它的实现,这就是它被称为 抽象 的原因。

在我们实现接口时,实现接口的类必须提供接口中定义的 抽象方法 的实现细节。

再回到我们的代码,我们改写成以下:

// LogController
class LogController extends Controller
{
    public function log(LogInterface $logger)
    {
        $logger->log('log to');
    }
}

//DBLogger.php
namespace App\Logs;
use App\Contracts\LogInterface;

class DBLogger implements LogInterface
{
    public function log($content)
    {
        //输出日志到 DB。
    }
}

//FileLogger.php
namespace App\Logs;
use App\Contracts\LogInterface;

class FileLogger implements LogInterface
{
    public function log($content)
    {
        //输出 Log 日志到文件。
    }
}

//CouldLogger.php
namespace App\Logs;
use App\Contracts\LogInterface;

class CouldLogger implements LogInterface
{
    public function log($content)
    {
        //输出 Log 日志到云。
    }
}

现在我们的代码灵活且松耦合,无需触及现有代码,就可以随时改变 Logger 的实现来应对需求的变化:

class RedisLogger implements LogInterface
{
    public function log($content)
    {
        //输出 Log 日志到redis。
    }
}

依赖注入

在使用 Laravel 框架时,我们可以利用它的服务容器来自动注入接口的实现。

我们先新建一个配置文件 config/log.php

<?php

return [
    'default' => env('LOG_TARGET', 'file'),

    'file' => [
        'class' => App\Logs\FileLogger::class,
    ],

    'db' => [
        'class' => App\Logs\DBLogger::class,
    ],

    'redis' => [
        'class' => App\Logs\RedisLogger::class,
    ]
];

并在 app/Providers/AppServiceProvider.php 添加以下代码。

public function register()
{
    $default = config('log.default');
    $logger = config("log.{$default}.class");

    $this->app->bind(
        \App\Contracts\LogInterface::class, 
        $logger
    );
}

我们从配置文件中读取默认 Logger,并将其绑定到 LogInterface。这样每当我们请求 Logger 接口时,容器都会解析它并返回默认的 Logger 实例。

默认 Logger 是在 env() 配置的,我们可以在不同的环境中使用不同的 Logger,例如本地环境中记录到文件、生产环境中记录到数据库。

总结

接口允许我们创建松散耦合的代码,同时提供一定程度的抽象。它允许我们随时更改我们的实现,而无需更改它们的上下文。所以我们应该将应用程序中的所有可能会有变化的部分使用接口来实现。

在大型应用中,接口是很有帮助的。和提升的代码灵活性、可测试性相比,多敲几下键盘花费的时间就显得微不足道了。当你在不同的接口实现类之间切换如飞的时候,你的经理一定会被你的神速惊到。此外,你也能够写出更能适应变化的代码。

当然,你如果在中小型项目中,不喜欢使用接口原则那也没什么不对,记住「Code Happy」快乐撸码。不过还是建议你在闲暇时间好好评估一下这件事。


enjoy :tada:

本作品采用《CC 协议》,转载必须注明作者和本文链接
悲观者永远正确,乐观者永远前行。
本帖由系统于 1年前 自动加精
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
讨论数量: 9
九霄道长

通俗易懂 :+1:

1年前 评论

写得太好了,我要转发到自己的博客上 :+1:

1年前 评论

我个人还是认为多数情况下都不太需要接口,没有那么多需要改变实现的情况,盲目写接口只会让代码更难维护

1年前 评论
云客网络工作室 1年前

接口只是用来限定规范,假如后面别人写了一个新的类不继承Interface,一样可以定义那些方法使用。

1年前 评论

我觉得接口设计挺好的, 让大家遵守约定, 项目里也用到了, 不过这也写的话, 确定代码检查时该类实现了接口, 以前代码里同事就是没实现接口, 一直调用失败, 比如: 多个短信渠道

1年前 评论

群主 在容器中绑定接口到实现的关系后 我们注入接口 是可以注入对应的实现类,如果说我们的项目中需要用到多个实现类,我们是用什么样的呢? 我知道可以使用上下文绑定,但是现在很多常驻内存框架 应该这条路走不通吧。。。。

1年前 评论

如果有的地方使用db 有的地方使用redis呢

1年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!