Laravel API 用户注册：优雅处理重复邮箱并返回 JSON 响应

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;

class AuthController extends Controller
{
    /**
     * 处理新用户注册请求。
     *
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function register(Request $request)
    {
        // 1. 检查邮箱是否已存在
        // 使用 User::where('email', $request->input('email'))->exists() 判断邮箱是否已被占用
        if (User::where('email', $request->input('email'))->exists()) {
            return response()->json([
                'result' => false,
                'message' => '该邮箱已被注册，请尝试其他邮箱或直接登录。'
            ], 409); // 409 Conflict 状态码表示请求与目标资源的当前状态冲突
        }

        // 2. 创建新用户实例并填充数据
        $user = new User();
        $user->name = $request->input('name');
        $user->email = $request->input('email');
        $user->password = Hash::make($request->input('password')); // 密码加密存储

        // 3. 尝试保存用户到数据库
        if ($user->save()) {
            return response()->json([
                'result' => true,
                'message' => '用户注册成功。',
                'user_id' => $user->id // 可选择返回新用户ID或其他信息
            ], 201); // 201 Created 状态码表示资源已成功创建
        } else {
            // 理论上，在 `exists()` 检查后，这里通常不会因重复邮箱而失败
            // 失败原因可能包括数据库连接问题、其他字段约束等
            return response()->json([
                'result' => false,
                'message' => '用户注册失败，请稍后再试或联系管理员。'
            ], 500); // 500 Internal Server Error 表示服务器内部错误
        }
    }
}

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Validator; // 引入 Validator Facade

class AuthController extends Controller
{
    /**
     * 处理新用户注册请求（使用 Laravel 验证器）。
     *
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function register(Request $request)
    {
        // 1. 定义验证规则
        $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' => '该邮箱已被注册，请尝试其他邮箱。',
            'required' => ':attribute 字段是必填的。',
            'email' => ':attribute 格式不正确。',
            'min' => ':attribute 至少需要 :min 个字符。',
            'confirmed' => '两次输入的密码不一致。'
        ]);

        // 2. 执行验证
        if ($validator->fails()) {
            return response()->json([
                'result' => false,
                'message' => '数据验证失败。',
                'errors' => $validator->errors() // 返回详细的验证错误信息
            ], 422); // 422 Unprocessable Entity 状态码表示请求格式正确但由于语义错误无法处理
        }

        // 3. 验证通过后，创建并保存用户
        // 使用 create 方法更简洁，前提是 User 模型设置了 $fillable 或 $guarded
        $user = User::create([
            'name' => $request->input('name'),
            'email' => $request->input('email'),
            'password' => Hash::make($request->input('password')),
        ]);

        // 4. 返回成功响应
        return response()->json([
            'result' => true,
            'message' => '用户注册成功。',
            'user_id' => $user->id
            // 'user' => $user // 可以选择返回用户部分信息，但需注意敏感数据
        ], 201); // 201 Created
    }
}