Laravel单控制器处理多同结构模型的实现方案咨询

嘿，这个需求我之前做项目的时候刚好碰到过！在Laravel里用单个控制器处理这类结构一致但数据完全独立的模型，完全可以实现，而且能大幅减少重复代码。下面是我实践过的一套方案，你可以参考下：

既然这些模型都只有id和name两个核心字段，先搞一个基类模型让所有这类模型继承，把重复的配置抽出来：

// app/Models/BaseNamedModel.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class BaseNamedModel extends Model
{
    // 统一设置可填充字段
    protected $fillable = ['name'];
    // 如果你的表命名有规律（比如xxx_cities、xxx_categories），也可以在这里统一处理表名，不然就让子类自己指定
}

然后每个具体模型只需要继承这个基类，指定自己的表名就行：

// app/Models/PostcodeCity.php
namespace App\Models;

class PostcodeCity extends BaseNamedModel
{
    protected $table = 'postcode_cities';
}

// app/Models/ProductCategory.php
namespace App\Models;

class ProductCategory extends BaseNamedModel
{
    protected $table = 'product_categories';
}

接下来写一个通用控制器，通过路由传入的模型标识来动态处理不同模型。这里一定要加白名单校验！ 防止恶意调用不存在的模型或者敏感模型：

// app/Http/Controllers/NamedResourceController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;

class NamedResourceController extends Controller
{
    // 白名单：允许处理的模型，键是路由里用的标识，值是模型类的完整路径
    protected $allowedModels = [
        'postcode_city' => \App\Models\PostcodeCity::class,
        'product_category' => \App\Models\ProductCategory::class,
        // 后续新增模型直接在这里加就行
    ];

    // 获取所有数据
    public function index(string $modelKey)
    {
        $modelClass = $this->getValidModel($modelKey);
        return $modelClass::all();
    }

    // 存储新数据
    public function store(Request $request, string $modelKey)
    {
        $modelClass = $this->getValidModel($modelKey);
        // 通用验证规则，如果不同模型需要不同规则，可以在这里根据modelKey动态调整
        $validated = $request->validate([
            'name' => 'required|string|max:255',
        ]);
        $resource = $modelClass::create($validated);
        return response()->json($resource, 201);
    }

    // 获取单条数据
    public function show(string $modelKey,, int $id)
    {
        $modelClass = $this->getValidModel($modelKey);
        return $modelClass::findOrFail($id);
    }

    // 更新数据
    public function update(Request $request, string $modelKey, int $id)
    {
        $modelClass = $this->getValidModel($modelKey);
        $resource = $modelClass::findOrFail($id);
        $validated = $request->validate([
            'name' => 'required|string|max:255',
        ]);
        $resource->update($validated);
        return $resource;
    }

    // 删除数据
    public function destroy(string $modelKey, int $id)
    {
        $modelClass = $this->getValidModel($modelKey);
        $resource = $modelClass::findOrFail($id);
        $resource->delete();
        return response()->json(null, 204);
    }

    // 私有方法：校验并返回合法的模型类
    private function getValidModel(string $modelKey): string
    {
        if (!isset($this->allowedModels[$modelKey])) {
            abort(403, '不允许访问该类型的数据');
        }
        return $this->allowedModels[$modelKey];
    }
}

在routes/api.php里添加一组通用路由，用模型标识作为参数：

use App\Http\Controllers\NamedResourceController;

Route::prefix('named-resources')->group(function () {
    Route::get('/{modelKey}', [NamedResourceController::class, 'index']);
    Route::post('/{modelKey}', [NamedResourceController::class, 'store']);
    Route::get('/{modelKey}/{id}', [NamedResourceController::class, 'show']);
    Route::put('/{modelKey}/{id}', [NamedResourceController::class, 'update']);
    Route::delete('/{modelKey}/{id}', [NamedResourceController::class, 'destroy']);
});

现在你就可以通过不同的路径访问不同模型的接口了：

• 获取所有邮政编码城市：GET /api/named-resources/postcode_city
• 创建产品分类：POST /api/named-resources/product_category
• 更新某个邮政编码城市：PUT /api/named-resources/postcode_city/1

如果后续有特殊需求，还可以做这些优化：

• 给基类模型添加通用的查询作用域，比如orderBy('name')，所有子类都能直接用
• 若不同模型需要不同的验证规则，可以创建多个请求类，或者在控制器里根据modelKey动态切换验证规则
• 要加权限控制的话，可以在控制器构造方法里添加中间件，根据modelKey判断用户是否有权限操作该类型数据

内容的提问来源于stack exchange，提问作者Cako