Laravel模型提交外部API所需固定默认字段的最佳存放位置

结论 #

你的判断完全符合Laravel的设计规范，这类对接外部API的固定字段应该存放在对应Service类内，不要放到Order模型中。

原因说明 #

• 从单一职责原则来看，Order作为你系统内部的Eloquent模型，核心职责是管理本地MySQL存储的订单数据、处理和系统内部其他模型（比如User）的关联、以及订单相关的内部业务逻辑。外部API的参数要求属于第三方对接的规则，完全不属于Order模型的职责范围，把这类字段放到模型里会导致核心业务模型和外部系统规则耦合，后续API规则变动时还要修改核心模型，维护成本会更高。
• 你封装的这个Service本身的定位就是对接该外部下单API，所有和这个API交互相关的规则、参数约定、固定配置都应该内聚在这个Service内部，和上层的Controller、核心模型完全解耦。你可以直接把这些固定字段定义为Service的私有常量，示例代码如下：

class PlaceOrderService
{
    // 把API要求的固定字段定义为私有常量，仅在本Service内部使用
    private const API_FIXED_FIELDS = [
        'source' => 'your_system_name',
        'version' => 'v1',
        // 其他固定字段
    ];

    public function submitOrder(Order $order)
    {
        // 组装参数时合并模型数据和固定字段
        $requestParams = array_merge(
            $order->only(['goods', 'quantity', /* 其他需要提交的模型字段 */]),
            self::API_FIXED_FIELDS
        );
        // 调用API逻辑...
    }
}

• 如果这些固定字段在不同环境（测试/生产）取值不同，你还可以把值存到.env文件中，通过config()辅助函数在Service内读取，不需要改动业务逻辑，扩展性更强。

核心原则总结 #

Laravel的最佳实践核心是按职责域拆分逻辑：内部核心模型只处理系统内的业务规则，所有和外部系统对接的适配逻辑、特殊参数处理都应该放到对应的Service、适配器类中，避免外部依赖污染核心业务层。

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