Laravel 基于remote model 思想实现快速服务化（入门篇）

快速预览

安装laravel5.5 - laravel8之间的版本，然后安装快速服务化的package

## 必须使用composer2版本
composer require windawake/laravelremodel dev-master

首先执行命令php artisan laravelremodel:example-models把./vendor/windawake/laravelremodel/examples/Models目录下面的OrderDetailRemote.php、OrderRemote.php、 ProductRemote.php三个文件复制到app文件夹下面。

php artisan laravelremodel:example-models

laravel58
├── app
│ ├── Console
│ │ └── Kernel.php
│ ├── Exceptions
│ │ └── Handler.php
│ ├── Http
│ │ ├── Controllers
│ │ ├── Kernel.php
│ │ └── Middleware
│ ├── Models
│ │ ├── OrderDetailRemote.php
│ │ ├── OrderRemote.php
│ │ └── ProductRemote.php

然后创建sqlite的数据库文件test.db

php ./vendor/windawake/laravelremodel/examples/sqlite/build.php

phpunit.xml增加sqlite的配置并且增加testsuite Remote

<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
         bootstrap="vendor/autoload.php"
         colors="true">
    <testsuites>
        ......
        <testsuite name="Remote">
                <directory>./vendor/windawake/laravelremodel/tests</directory>
        </testsuite>
    </testsuites>
    <php>
        ......
        <server name="DB_CONNECTION" value="sqlite"/>
        <server name="DB_DATABASE" value="./test.db"/>
    </php>
</phpunit>

最后运行测试命令 ./vendor/bin/phpunit --testsuit=Remote
运行结果如下所示，18个orm例子测试通过。

root@DESKTOP-VQOELJ5:/web/linux/php/laravel/laravel58# ./vendor/bin/phpunit --testsuit=Remote
PHPUnit 7.5.20 by Sebastian Bergmann and contributors.

..................                                                18 / 18 (100%)

Time: 208 ms, Memory: 20.00 MB

OK (18 tests, 21 assertions)

功能特性

1. app后端的代码不需要重构，渐进式地跟业务基础服务接口对接。
2. 基础服务可拆解，可组合，可回退。
3. 支持懒加载，避免了n+1查询api。
4. 支持连表，联表，原生sql查询，聚合查询，子查询等等，laravel orm特性几乎全部可以使用。
5. 使用了laravel服务容器写法，所以query编译器，分布式事务方法可以自定义。（推荐分布式事务组件）。
6. 支持接入GraphQL API（开发中）

原理解析

remote model是远程数据模型的意思。基础服务的api接口被封装成ORM。app后端的model只是虚拟的model，是业务基础服务model的一个镜像。

例如紫色的ProductModel是镜像，但是OrderLogic使用它跟使用白色的ProductModel几乎一样。
这样子做有什么好处呢？可以复用laravel model的所有特性。因为现在很多package包针对model做了很多新功能，实现model增强功能，使用它们可以提高开发效率和排错效率，代码更加简洁强悍。

如何使用

新建一个ProductRemote类继承RemoteModel类。

<?php
namespace App\Models;

use Laravel\Remote2Model\RemoteModel;

class ProductRemote extends RemoteModel {
    const CREATED_AT = null;
    const UPDATED_AT = null;

    protected $primaryKey = 'pid';
    protected $table = 'product';
    public $timestamps = false;

    public function getHandle()
    {
        /**
         * @var RemoteTool
         */
        $remoteTool = app('laravelremodel.tool');
        $condition = $remoteTool->queryToCondition($this->queryBuilder);

        $client = new \GuzzleHttp\Client();
        $res = $client->request('GET', 'http://127.0.0.1:18001/api/product', [
            'query' => [
                'condition' => $condition
            ],
        ]);
        $json = $res->getBody()->getContents();

        $list = json_decode($json, true);
        return $list;
    }

}

这里以查询getHandle为例子。默认提供getHandle，updateHandle，insertGetIdHandle，deleteHandle和existsHandle 这5个方法。继承RemoteModel类后，不定义getHandle等这些方法，它会默认走db驱动，跟普通的Model类一样。

个人笔记

这一次是入门篇，下一次估计会出源码篇。写了那么多年的代码，老是会发现服务化接口，就是查询一张表数据然后返回。搞得我经常怀疑人生。现在我坚定起来了，平时，我经常跟同事说laravel可以实现一秒服务化，他们都不相信。这次我可以证明给他们看。

本作品采用《CC 协议》，转载必须注明作者和本文链接