chatroom/app/Http/Requests/UpdateChatPreferencesRequest.php

<?php

/**
 * 文件功能：聊天室偏好设置验证器
 * 负责校验用户提交的屏蔽播报与禁音配置。
 */

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;

/**
 * 聊天室偏好设置验证器
 * 仅允许提交白名单内的屏蔽项与布尔型禁音状态。
 */
class UpdateChatPreferencesRequest extends FormRequest
{
    /**
     * 允许已登录用户保存自己的聊天室偏好。
     */
    public function authorize(): bool
    {
        return $this->user() !== null;
    }

    /**
     * 获取聊天室偏好的验证规则。
     *
     * @return array<string, mixed>
     */
    public function rules(): array
    {
        return [
            'blocked_system_senders' => ['nullable', 'array'],
            'blocked_system_senders.*' => [
                'string',
                Rule::in(['钓鱼播报', '星海小博士', '百家乐', '跑马','神秘箱子']),
            ],
            'sound_muted' => ['required', 'boolean'],
        ];
    }

    /**
     * 获取聊天室偏好的中文错误提示。
     *
     * @return array<string, string>
     */
    public function messages(): array
    {
        return [
            'blocked_system_senders.array' => '屏蔽设置格式无效。',
            'blocked_system_senders.*.in' => '存在不支持的屏蔽项目。',
            'sound_muted.required' => '请传入禁音状态。',
            'sound_muted.boolean' => '禁音状态格式无效。',
        ];
    }
}