PHP代码格式化优化器

格式化后的PHP代码

<?php

namespace App\Http\Controllers;

use App\Service\UserService;

class UserController
{
    public function show($id, $includePosts = false)
    {
        $svc = new UserService();

        $id = is_numeric($id) ? (int) $id : null;

        if ($id === null) {
            return response()->json(['error' => 'invalid id'], 400);
        }

        $user = $svc->findUserById($id);

        if (!$user) {
            return response()->json(['error' => 'not found'], 404);
        }

        $data = [
            'id' => $user->id,
            'name' => trim($user->name),
            'email' => $user->email,
        ];

        if ($includePosts) {
            $data['posts'] = array_map(
                function ($p) {
                    return [
                        'id' => $p->id,
                        'title' => $p->title,
                    ];
                },
                $svc->getPostsByUserId($id)
            );
        }

        return response()->json($data, 200);
    }
}

格式优化说明

• 命名空间与use语句分行并在逻辑块之间添加空行：符合 PSR-12 对文件结构分隔的要求，提升可读性。
• 类与方法的大括号风格：类的左大括号独占一行，方法的左大括号同一行结尾，符合 PSR-12 约定。
• 缩进与空白：统一使用 4 个空格缩进；在二元运算符（=、? :、=>、,）两侧添加适当空格；移除不必要的内部空格，如函数调用和数组索引中的多余空格。
• 控制结构规范：在 if 关键字后添加空格；小括号内不在开头与结尾处添加空格；大括号换行，符合 PSR-12。
• 数组语法与对齐：统一为短数组语法 []; 多行数组每项独立一行并添加尾逗号，便于版本控制的差异比较。
• 类型转换与函数参数空格：在 (int) 强制类型转换后添加空格；方法与函数参数的逗号后添加空格，提升可读性。
• 匿名函数格式：function 与参数列表之间保留一个空格；函数体换行并缩进，符合 PSR-12 对闭包的格式要求。
• 长行拆分：对 array_map 的回调与参数进行多行拆分，控制行宽与视觉层次。
• 返回语句统一：response()->json 调用参数间空格统一，状态码与数据分隔清晰。

以上操作仅涉及格式与风格，未改动任何业务逻辑与行为。

技术建议

• 类型声明：在不影响现有调用方的前提下，考虑为 $id 与 $includePosts 增加参数与返回类型声明（如：int|string|null、bool、Illuminate\Http\JsonResponse），并结合请求验证进一步收敛类型。
• 依赖注入：建议通过构造函数或方法注入注入 UserService，便于测试与解耦（遵循依赖倒置原则）。
• 文档块：为控制器与方法添加 PHPDoc，说明参数含义、可能的返回结果与异常场景，辅助团队协作与静态分析。
• 数据转换层：考虑使用资源类/Transformer（如 Laravel Resource）统一输出结构与字段映射，便于后续扩展与版本化。
• 大数据处理：当 includePosts 为真且帖子数据较大时，建议分页或限制字段，以控制响应体大小与接口性能。