如何在 Laravel 中动态使用模型

龍吟锋

概述

关键词：laravel、模型、Eloquent、ORM，动态模型、模型文件、数据建模

众所周知，Laravel的ORM相当强大，但每个Model都得有一个实体文件存在，在某些场景中并不是太方便
以下方法解决在laravel中无需新建文件就能够动态使用模型（Model） 的问题，尤其是需要动态修改表名的情况
需要解决方案的同学可以直接滑到最后 思考方法三
场景

• 有多个几乎一致的数据模型，仅表明或者某些字段的配置不一样，不想编写多个模型文件
  
• 有工厂类生成所需模型，但不好实现在没有多文件的时候动态修改表名
  

解析

Model类本身提供了setTable()方法，但Model::query() 方法中在以调用的类名或者已写入的表名重载对象，而不是以实例的形式在重载，因此会导致丢失动态设置的表名值

<?php

// vendor/illuminate/database/Eloquent/Model.php:819
public static function query()
{
  return (new static)->newQuery();
}
重载对象后表名被重置，动态设置的表名丢失
追踪 query() 方法的调用可知，很多静态调用的方法都会造成动态属性丢失，在魔术方法中被调用
<?php
// vendor/illuminate/database/Eloquent/Model.php:1487
public static function __callStatic($method, $parameters)
{
  return (new static)->$method(...$parameters);
}
// 此魔术方法实现了在Model后紧跟的静态方法调用，类似于门面(Facades)的方式
思考方法一

在静态调用之后修改表名 有问题
<?php
Model::query()->setTable('new_table')->get();
问题：一旦下次有query()调用，表名将会被重置；
无法确定后续的使用不会有query()调用，故舍弃；
思考方法二

在模型的构造函数中设置表名 有问题
需要同时满足可动态表名，以及query()调用时动态表名不丢失
<?php
class BaseModel extends Model
{

    // 动态表名
    protected static $otherTable = '';

    public function __construct($table='')
    {
        if($table){
            self::$otherTable = $table;
            $this->setTable($table);
        }

        parent::__construct();
    }

    public static function query(){
        $model = new self(self::$otherTable);
        return $model->newQuery();
    }

    // 代理其他很多的模型静态方法
    // 。。。
}

$model = new BaseModel('new_table');
$res = $mode::query()->first(); // success!
问题：以上方法只能同时虚拟一个模型，由于静态属性多对象共享，可能导致表名混乱
无法保证这个模型只被调用一次，况且只能调用一次的话动态的意义不大，故舍弃！
思考方法三

观察Model写法，以及Model 的抽象父类等，发现Model基本上只能手写，而不能动态去调
那么如果让代码自己执行一段代码，岂不是就能实现动态修改表名的效果了？
此时应有 eval() 函数以及匿名类出场

eval ： 将一段字符串当做 PHP 代码来执行
匿名类：PHP 7 支持通过 new class 来实例化一个匿名类，这可以用来替代一些"用后即焚"的完整类定义。解决动态命名问题

用eval 函数 和匿名类的形式直接实例化一个匿名类的模型实例，保证所有的调用都能够统一
匿名类中的表名直接拼接进去，匿名类继承编写的继承自Model的模型类，把所有操作都写进去
匿名类中仅解决动态表名的问题，所有的调用都能够正常使用
上代码:
<?php
// 动态的表名
$key = 'new_table';
$res  = eval(
            '
            use Illuminate\Database\Eloquent\Model;

            return (new Class extends Model{
                protected $table = "'.$key.'";
            });
            '
        );

$model = $res;

$res = $model::query()->find($id); // 调用成功
总结
方法三虽然解决了问题，但可以看到 eval() 函数直接执行了代码
因此需要对动态拼接进去的 $key 变量进行严格的验证，避免代码注入引起安全问题。
此方法也适合在高度抽象的业务模型、低代码后端执行逻辑的持久层，或者“代码动态写代码”等场景使用