Write once, run anywhere

概述

环境：LNMP（CentOS7.2 + Nginx1.10 + MariaDB10.0 + PHP5.6），Laravel5.1，Yar；

用户Api项目：项目名：example_user_api（example可替换为具体公司的名字，代表公司的user项目，下同），域名：api.user.example.com，对应数据：user；

订单Api项目：项目名：example_order_api，域名：api.order.example.com，对应数据：order；

订单项目：项目名：example_order，域名：order.example.com；

正文

作为一名PHP后端开发工程师，时常感受到来自项目deadline的压力，而且还有需求在开发过程中的变更。

如何应对需求的变更和来自项目deadline的压力，那就要考虑系统的架构了，然后，才是编码——为何这样说，我喜欢用一个比喻解释，大厦的架构搭建好了，垒砖就容易多了。

系统架构从项目的角度来讲有两个方面，一方面是项目与项目之间的搭配，另一方面是项目本身的分层。

本文主要讲项目与项目之间的搭配这一方面的架构，也就是实现Write once, run anywhere的基础。先下结论：项目与项目之间通过RPC接口调用。

如环境描述和项目清单所述，环境为LNMP，用户相关项目有用户Api项目，订单相关项目有订单Api项目和订单项目。

读者或许有疑问了，这里用户相关的只有一个项目，为何订单相关的项目有两个，它们之间有什么区别？其实，这就是Write once, run anywhere的关键。

用户Api项目能够为订单项目提供Rpc服务，订单Api项目更是主要是为订单项目提供Rpc服务，这两者本身都是没有界面的，这也是它们为何被定义为Api项目的原因。而订单项目通过调用用户Api项目和订单Api项目的Rpc服务，为用户提供查看、修改等操作自己订单的服务，因此是有界面的。
然而，这也不足以要把订单划分成订单Api项目和订单项目两个项目。进一步的原因是订单Api项目不仅用于（用户查询、修改订单等操作的）订单项目，也可以为公司内部的ERP系统提供订单相关的Rpc服务。

代码

Talk is easy, show me the code.
用户Api项目，有t_user表，其对应的Model为User，文件名为User.php，内容如下：

<?php
namespace App\Model;

use DB;
use Log;
use Redis;

/**
 * 用户表
 * @author los_gsy
 */
class User {
    /**
     * 查询一条记录，根据id
     * @param int $id
     * @return null | object
     */
    static public function getById($id) {
        $result = DB::connection('user')->table('user')
            ->where('id', $id)
            ->first();
        if (!$result) {
            Log::warning(__METHOD__ . ': $param = ' . var_export(func_get_args(), true));
        }
        return $result;
    }

}

通过Controller封装成Rpc服务，这里取文件名为ModelController.php，内容如下：

<?php
namespace App\Http\Controllers\Rpc;

use App\Http\Controllers\Controller;
use App\Model\User;
use Illuminate\Http\Request;
use Log;
use Yar_Server;

/**
 * 模型
 * @author los_gsy
 */
class ModelController extends Controller {
    /**
     * 构造函数
     */
    public function __construct(Request $req) {
        parent::__construct();
    }


    /**
     * 用户
     */
    public function user(Request $req) {
        $service = new Yar_Server(new User());
        $service->handle();
    }

}

类似的，订单Api项目，有t_order表，其对应的Model为Order，文件名为Order.php，内容如下：

<?php
namespace App\Model;

use DB;
use Log;
use Redis;

/**
 * 订单表
 * @author los_gsy
 */
class Order {
    /**
     * 查询一条记录，根据id
     * @param int $id
     * @return null | object
     */
    static public function getById($id) {
        $result = DB::connection('order')->table('order')
            ->where('id', $id)
            ->first();
        if (!$result) {
            Log::warning(__METHOD__ . ': $param = ' . var_export(func_get_args(), true));
        }
        return $result;
    }

}

通过Controller封装成Rpc服务，这里同样取文件名为ModelController.php，内容如下：

<?php
namespace App\Http\Controllers\Rpc;

use App\Http\Controllers\Controller;
use App\Model\Order;
use Illuminate\Http\Request;
use Log;
use Yar_Server;

/**
 * 模型
 * @author los_gsy
 */
class ModelController extends Controller {
    /**
     * 构造函数
     */
    public function __construct(Request $req) {
        parent::__construct();
    }


    /**
     * 订单
     */
    public function order(Request $req) {
        $service = new Yar_Server(new Order());
        $service->handle();
    }

}

订单项目，在这里用户需要查询自己的一个订单详情，于是通过调用用户Api项目和订单Api项目的Rpc服务来实现，代码如下：

<?php
namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Yar_Client;

/**
 * 订单
 * @author los_gsy
 */
class OrderController extends Controller {
    /**
     * 构造函数
     */
    public function __construct(Request $req) {
        parent::__construct();
    }


    /**
     * tmp
     * @param Request $req
     */
    public function tmp(Request $req) {
        //定义变量
        $oUser = new Yar_Client('http://api.user.example.com/Rpc/Model/user');
        $oOrder = new Yar_Client('http://api.order.example.com/Rpc/Model/order');

        //查询用户和订单
        $user = $oUser->getById(1);
        $order = $oOrder->getById(1);

        //打印用户和订单信息
        var_export($user);
        var_export($order);
    }

}

结尾

Write once, run anywhere主要的思路就如上所述，以及代码示例了。仅用于学习参考，如果是生产使用，还需考虑安全、性能等因素。
刚开始在简书上写日志，不足之处，还请各位不吝赐教。