在 Laravel 中动态使用模型

概述

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

众所周知，Laravel的ORM相当强大，但每个Model都得有一个实体文件存在，在某些场景中并不是太方便

以下方法解决在laravel中无需新建文件就能够动态使用模型（Model） 的问题，尤其是需要动态修改表名的情况

需要解决方案的同学可以直接滑到最后 思考方法三

场景

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

解析

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 变量进行严格的验证，避免代码注入引起安全问题。

此方法也适合在高度抽象的业务模型、低代码后端执行逻辑的持久层，或者“代码动态写代码”等场景使用