Laravel 8 中实现唯一用户注册并返回 JSON 响应的教程

// 原始代码片段 (存在问题)
public function register(Request $request)
{
    $user = new User();
    $user->name = $request->input('name');
    $user->email = $request->input('email'); // 如果此邮箱已存在，将导致问题
    $user->password = Hash::make($request->input('password'));
    if($user->save()){ // 此时如果邮箱重复，会抛出 QueryException
        if (Auth::attempt(['email' => $request->input('email'), 'password' => $request->input('password')])) {
            return response(['result' => true, 'user' => Auth::user()]);
        }
    }
    return response(['result' => false, 'user' => new User()]);
}

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Validator;
use App\Models\User; // 确保引入 User 模型

class AuthController extends Controller
{
    public function register(Request $request)
    {
        // 定义验证规则
        $validator = Validator::make($request->all(), [
            'name' => ['required', 'string', 'max:255'],
            'email' => ['required', 'string', 'email', 'max:255', 'unique:users'], // 关键：unique:users
            'password' => ['required', 'string', 'min:8', 'confirmed'], // 'confirmed' 要求有 password_confirmation 字段
        ], [
            'email.unique' => '该邮箱已被注册，请尝试其他邮箱。', // 自定义错误消息
        ]);

        // 检查验证是否失败
        if ($validator->fails()) {
            // 如果请求是 AJAX 或期望 JSON 响应，Laravel 会自动处理并返回 422 Unprocessable Entity
            // 包含验证错误信息的 JSON 响应。
            // 但为了更明确地控制响应格式，我们可以手动返回。
            return response()->json([
                'result' => false,
                'message' => '验证失败',
                'errors' => $validator->errors()
            ], 422); // 422 Unprocessable Entity 是处理验证错误的标准 HTTP 状态码
        }

        // 验证通过，创建用户
        $user = User::create([
            'name' => $request->name,
            'email' => $request->email,
            'password' => Hash::make($request->password),
        ]);

        // 尝试登录用户（如果需要）
        // 注意：Auth::attempt 通常需要原始密码，而不是哈希后的密码
        // 如果注册后直接登录，通常的做法是 Auth::login($user)
        // 或者让用户在注册成功后自行登录。
        // 此处为了与原问题保持一致，但建议使用 Auth::login($user) 或引导用户登录
        // if (Auth::attempt(['email' => $request->email, 'password' => $request->password])) { // 这行代码在注册后直接用明文密码尝试登录是不对的
        //     return response()->json(['result' => true, 'user' => Auth::user()], 200);
        // }

        // 注册成功，返回用户数据
        return response()->json([
            'result' => true,
            'message' => '用户注册成功',
            'user' => $user
        ], 201); // 201 Created 是创建资源的标准 HTTP 状态码
    }
}

php artisan make:request RegisterRequest

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class RegisterRequest extends FormRequest
{
    /**
     * Determine if the user is authorized to make this request.
     *
     * @return bool
     */
    public function authorize()
    {
        return true; // 允许所有用户进行此请求
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array
     */
    public function rules()
    {
        return [
            'name' => ['required', 'string', 'max:255'],
            'email' => ['required', 'string', 'email', 'max:255', 'unique:users'],
            'password' => ['required', 'string', 'min:8', 'confirmed'],
        ];
    }

    /**
     * Get the error messages for the defined validation rules.
     *
     * @return array
     */
    public function messages()
    {
        return [
            'email.unique' => '该邮箱已被注册，请尝试其他邮箱。',
            'required' => ':attribute 字段是必填的。',
            'email' => ':attribute 必须是一个有效的邮箱地址。',
            'min' => ':attribute 长度不能少于 :min 个字符。',
            'confirmed' => '两次输入的密码不一致。',
        ];
    }
}

<?php

namespace App\Http\Controllers;

use App\Http\Requests\RegisterRequest; // 引入 RegisterRequest
use App\Models\User;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Auth; // 如果需要自动登录

class AuthController extends Controller
{
    public function register(RegisterRequest $request)
    {
        // 验证已由 RegisterRequest 自动处理。
        // 如果验证失败，Laravel 会自动重定向回上一页（对于 web 请求）
        // 或返回 JSON 响应（对于 AJAX/API 请求，包含 422 状态码和错误信息）。

        $user = User::create([
            'name' => $request->name,
            'email' => $request->email,
            'password' => Hash::make($request->password),
        ]);

        // 如果需要注册后自动登录
        // Auth::login($user); // 这种方式直接登录用户，无需密码

        return response()->json([
            'result' => true,
            'message' => '用户注册成功',
            'user' => $user
        ], 201);
    }
}