解耦控制器逻辑：通过服务层实现业务逻辑的复用与管理

public function createUser(Request $request)
{
    // 使用 $request 中的数据创建用户
    // ...
}

public function someMethod(){
    $array = [
        'name' => 'John Doe',
        'email' => 'john.doe@example.com'
    ];

    // 错误：期望 Request 对象，却传入了数组
    return $this->createUser($array);
}

// app/Services/UserService.php (假设您的服务类位于 app/Services 目录下)

<?php

namespace App\Services;

class UserService
{
    /**
     * 创建一个新用户。
     *
     * @param array $userData 包含用户数据的关联数组。
     * @return \App\Models\User 新创建的用户模型实例。
     */
    public function createUser(array $userData)
    {
        // 在这里实现用户创建的实际逻辑，例如：
        // 1. 数据验证 (如果尚未在控制器中完成)
        // 2. 密码哈希
        // 3. 数据库插入
        // 4. 返回新创建的用户实例

        // 示例：简单地模拟创建并返回用户数据
        $newUser = (object) $userData; // 实际项目中会返回一个 Eloquent 模型
        $newUser->id = uniqid(); // 模拟ID
        $newUser->created_at = now();

        // 实际应用中，您可能会这样操作：
        // $user = User::create([
        //     'name' => $userData['name'],
        //     'email' => $userData['email'],
        //     'password' => bcrypt($userData['password']),
        // ]);
        // return $user;

        return $newUser;
    }
}

// app/Http/Controllers/SomeController.php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Services\UserService; // 引入 UserService

class SomeController extends Controller
{
    protected $userService;

    /**
     * 构造函数，通过依赖注入获取 UserService 实例。
     *
     * @param UserService $userService
     */
    public function __construct(UserService $userService)
    {
        $this->userService = $userService;
    }

    /**
     * 处理创建用户的HTTP请求。
     *
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function createUser(Request $request)
    {
        // 可以在此处进行请求数据的验证
        $validatedData = $request->validate([
            'name' => 'required|string|max:255',
            'email' => 'required|email|unique:users,email',
            // ... 其他验证规则
        ]);

        // 调用服务层方法创建用户
        $newUser = $this->userService->createUser($validatedData);

        return response()->json([
            'message' => 'User created successfully',
            'user' => $newUser
        ], 201);
    }

    /**
     * 另一个方法，需要创建用户但数据来源于内部。
     *
     * @return \Illuminate\Http\JsonResponse
     */
    public function someMethod()
    {
        $array = [
            'name' => 'Jane Doe',
            'email' => 'jane.doe@example.com',
            // ... 其他用户数据
        ];

        // 直接将数组传递给服务层方法
        $newUser = $this->userService->createUser($array);

        return response()->json([
            'message' => 'User created from internal method',
            'user' => $newUser
        ]);
    }
}