PHP 8+下Laravel自定义验证规则返回消息格式兼容问题求助

问题背景 #

升级到PHP8+后，原Laravel自定义验证规则中的以下写法会触发报错，而PHP7.4中可正常运行：

public function message(): array
{
    return [$this->validator->errors()->messages()];
}

直接改为返回$this->validator->errors()->messages()可避免报错，但会改变原消息格式，不符合需求。

报错原因 #

报错源自Laravel框架FormatsMessages类的replaceAttributePlaceholder方法：

protected function replaceAttributePlaceholder(string $message, string $value): string
{
    return str_replace(
        [':attribute', ':ATTRIBUTE', ':Attribute'],
        [$value, Str::upper($value), Str::ucfirst($value)],
        $message
    );
}

PHP8+对类型检查更严格，该方法要求$message为字符串，但上述写法返回的是嵌套二维数组，框架处理时会将数组传入该方法，触发类型错误；而PHP7.4会隐式将数组转为字符串"Array"，因此未报错。

解决方案 #

要保留原消息格式同时修复错误，需调整返回结构，确保框架处理时传入replaceAttributePlaceholder的是字符串而非数组：

方案1：保持字段-消息数组结构（适配原格式） #

若原格式要求返回以字段名为键、消息数组为值的结构，直接返回错误消息数组即可，无需外层包裹：

public function message(): array
{
    return $this->validator->errors()->messages();
}

如果原需求是外层必须有数组包裹，可将每个字段的消息数组转为字符串后再包裹：

public function message(): array
{
    $formattedMessages = [];
    foreach ($this->validator->errors()->messages() as $field => $messages) {
        $formattedMessages[$field] = implode(', ', $messages);
    }
    return [$formattedMessages];
}

方案2：遵循Laravel自定义规则规范（长期兼容） #

更规范的做法是在validate方法中添加错误，message方法仅返回当前规则的对应消息字符串：

public function validate($attribute, $value, $parameters, $validator)
{
    // 自定义验证逻辑
    $isValid = // 你的验证判断条件;

    if (!$isValid) {
        // 添加错误到验证器
        $validator->addError($attribute, 'custom_validation_failed', [
            'value' => $value
        ]);
        return false;
    }

    return true;
}

public function message(): string
{
    return 'The :attribute is invalid, received value: :value';
}

这种写法完全符合Laravel规范，在PHP7.4和PHP8+中均可正常运行，且能自动处理占位符替换。

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