Laravel框架中扩展类时如何正确重写父类构造函数

错误原因 #

你编写的子类构造函数调用父类构造函数时，没有传入父类要求的必填参数$documentTemplate，导致参数缺失报错。父类构造函数的签名明确要求传入模板文件路径参数，你调用parent::__construct()时为空参，不符合父类的传参要求。

正确代码实现 #

如果你的子类构造不需要新增额外参数，直接将接收到的参数透传给父类即可：

public function __construct($documentTemplate)
{
    // 子类自定义初始化逻辑可写在这里（父类构造调用前执行）
    parent::__construct($documentTemplate);
    // 依赖父类初始化结果的自定义逻辑可写在这里（父类构造调用后执行）
}

扩展场景说明 #

如果子类需要新增自定义构造参数，建议将自定义参数放在参数列表末尾，并设置默认值保证向下兼容：

public function __construct($documentTemplate, $customConfig = [])
{
    // 自定义参数处理逻辑
    if (!empty($customConfig)) {
        // 处理你的自定义配置
    }
    parent::__construct($documentTemplate);
}

Laravel环境注意事项 #

如果是扩展需要通过Laravel服务容器自动解析的类，需要确保构造参数要么是容器可以自动解析的类型，要么在服务提供者中绑定类的时候手动指定传参规则，避免容器实例化时参数解析失败。

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