本文介绍如何通过请求验证类（formrequest）和服务层（service class）解耦 laravel 控制器，实现验证、业务逻辑与 http 层职责分离，提升代码可维护性、可测试性与复用性。
在 Laravel 开发中，控制器（Controller）应严格遵循「单一职责原则」：仅负责接收 HTTP 请求、调用业务逻辑、返回响应，不处理验证规则、文件存储路径拼接、模型创建细节或权限判断等业务逻辑。将这些职责硬编码在 store() 方法中，不仅导致控制器臃肿，更会阻碍单元测试、代码复用与团队协作。以下是经过生产验证的三层精简方案：
✅ 第一步：使用 FormRequest 封装验证逻辑
运行 Artisan 命令生成专用请求类：
php artisan make:request StoreInfoRequest
编辑 app/Http/Requests/StoreInfoRequest.php：
<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
class StoreInfoRequest extends FormRequest
{
public function authorize(): bool
{
// 例如：仅允许已认证用户提交
return $this->user() !== null;
}
public function rules(): array
{
return [
'lname' => ['required', 'string', 'max:255'],
'fname' => ['required', 'string', 'max:255'],
'ar_lname' => ['required', 'string', 'max:255'],
'ar_fname' => ['required', 'string', 'max:255'],
'tel' => ['required', 'digits:10', 'unique:infos,tel'],
'level' => ['required', 'string', 'max:50'],
'goal' => ['required', 'string'],
'img' => ['required', 'image', 'mimes:jpeg,bmp,png'],
'cin' => ['required', 'image', 'mimes:jpeg,bmp,png'],
'bday' => ['nullable', 'date'], // 显式声明可空字段
];
}
// （可选）自定义错误消息
public function messages(): array
{
return [
'tel.unique' => '该手机号已被注册。',
'img.image' => '头像必须是有效图片文件。',
];
}
}✅ 优势：自动注入、自动重定向、错误响应标准化、规则复用（如 update 方法也可复用）。
✅ 第二步：创建 Service 类封装业务逻辑
运行命令创建服务类（推荐置于 app/Services 目录）：
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
mkdir app/Services php artisan make:class Services/InfoService
app/Services/InfoService.php 示例：
<?php
namespace App\Services;
use App\Models\Info;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
class InfoService
{
public function store(array $validated): Info
{
// 处理文件上传（含路径安全处理）
$imgPath = $validated['img']->store('images', 'public');
$cinPath = $validated['cin']->store(
'cins/' . trim($validated['lname'] . ' ' . $validated['fname']),
'public'
);
// 创建模型（使用 fill + save 更利于扩展钩子）
return Info::create([
'user_id' => auth()->id(),
'lname' => $validated['lname'],
'fname' => $validated['fname'],
'ar_lname' => $validated['ar_lname'],
'ar_fname' => $validated['ar_fname'],
'bday' => $validated['bday'] ?? null,
'tel' => $validated['tel'],
'level' => $validated['level'],
'goal' => $validated['goal'],
'img' => $imgPath,
'cin' => $cinPath,
'registered'=> true,
]);
}
}✅ 优势：逻辑集中、便于事务控制、支持依赖注入（如邮件通知、日志记录）、可独立单元测试。
✅ 第三步：精简控制器至「胶水层」
在控制器中注入 StoreInfoRequest 和 InfoService：
<?php
namespace App\Http\Controllers;
use App\Http\Requests\StoreInfoRequest;
use App\Services\InfoService;
use Illuminate\Http\RedirectResponse;
class InfoController extends Controller
{
public function __construct(private readonly InfoService $infoService)
{
// 构造函数注入，无需手动实例化
}
public function store(StoreInfoRequest $request): RedirectResponse
{
// 自动验证通过后，$request->validated() 返回安全数据
$this->infoService->store($request->validated());
return redirect()->route('user.index')
->with('success', '个人信息提交成功！');
}
}⚠️ 注意事项与最佳实践
- 不要在 Service 中访问 $request 或 session()：Service 应保持无状态、HTTP 无关；所有输入必须显式传入（如 $validated 数组）。
- 文件路径需防注入：$validated['lname'] . ' ' . $validated['fname'] 建议使用 Str::slug() 或正则过滤，避免目录遍历风险。
- 错误处理统一交由 Laravel 框架：FormRequest 的 authorize() 失败自动返回 403；验证失败自动重定向并闪存错误。
-
后续扩展建议：
- 在 Service 中添加 try/catch 包裹数据库操作，抛出自定义异常（如 InfoCreationFailedException）；
- 使用事件（InfoCreated::dispatch()）解耦后续动作（如发送欢迎邮件）；
- 对大文件上传启用队列（$request->file()->storeAs(..., ['queue' => 'default'])）。
通过以上重构，控制器 store() 方法从 30+ 行压缩为 5 行核心逻辑，验证、存储、安全、扩展性全部外移——这才是 Laravel 的「约定优于配置」与「关注点分离」哲学的真正落地。
