1. 快速统计的前提与模型设计
1.1 定义部门与人员表的关系
在企业人事系统中，部门与人员之间通常是一对多关系。通过在 Employee 模型中添加 department_id 外键，以及在 Department 模型中定义 employees() 关联，可以让后续的统计变得简单高效。
设计要点包括确保外键字段有 索引，以及采用 hasMany 与 belongsTo 的关系方法，以便让 Eloquent 能够进行优化查询。
1.2 索引与字段设计
对于统计场景，department_id 字段应该被索引，尤其是在员工表中。这样在按部门统计人数时，数据库就能快速定位目标记录。
另外，保持字段命名的一致性和外键约束，有助于后续使用 withCount 或聚合查询时的代码清晰度与性能。
// migration 示例
Schema::table('employees', function (Blueprint $table) {$table->unsignedBigInteger('department_id')->index();$table->foreign('department_id')->references('id')->on('departments')->onDelete('cascade');
});
2. 使用 Laravel 的 Eloquent 快速统计方法
2.1 直接统计某部门人数
最简单的方法是直接在 Employee 模型上按 department_id 过滤并调用 count()。这是一种轻量级的实现，适合对性能没有非常严格要求的场景。
在企业人事系统中，这种方法可以快速响应前端请求，避免加载整表数据，只返回数量。
// 直接统计某部门人数
$departmentId = 5;
$count = \App\Models\Employee::where('department_id', $departmentId)->count();
2.2 使用 withCount 统计关联
如果你已经通过关系预加载了部门信息，withCount 可以在一次查询中返回每个部门的人员数量，减少 N+1 查询问题。
通过 withCount('employees')，你可以获得 employees_count 字段，适合在列表视图中展示全部部门的人员规模。
// 使用 withCount 来统计所有部门的人员数
$departments = App\Models\Department::withCount('employees')->get();foreach ($departments as $dept) {echo $dept->name . '：' . $dept->employees_count . ' 人';
}
2.3 仅返回数量的高效聚合查询
对于仅需要数量而不需要员工数据的场景，聚合查询可以显著降低 I/O。你可以通过 selectRaw 或者 count 的子查询来实现。
该方式在大规模组织结构下尤为有用，因为它能把数据处理成本降到最低。
// 高效聚合查询示例：只返回部门人数
$result = App\Models\Department::select('departments.*')->selectRaw('(SELECT COUNT(*) FROM employees WHERE employees.department_id = departments.id) as employees_count')->where('id', $departmentId)->first();echo $result->name . ' ' . $result->employees_count;
3. 性能优化与缓存策略
3.1 为统计结果添加缓存
在企业级应用中，为避免重复计算，可以把统计结果缓存起来，缓存键 应该包含 部门ID、统计时间戳 等因素。
使用 Laravel 的 cache 功能可以显著降低数据库压力，例如记忆 5 分钟，或使用记忆周期更长的键。
// 缓存某部门人数统计
$departmentId = 5;
$cacheKey = 'dept_' . $departmentId . '_count';
$count = Cache::remember($cacheKey, 300, function () use ($departmentId) {return App\Models\Employee::where('department_id', $departmentId)->count();
});
3.2 使用缓存的失效策略
你需要在员工变动时（如员工入职、离职、转岗）清理或更新缓存，通过模型事件 或 MVC 层的刷新逻辑实现。
将缓存失效与数据变更绑定，可以确保统计数据的准确性，不产生过时数据。
// 当员工新增或修改时，刷新相关部门缓存
Employee::creating(function ($employee) {Cache::forget('dept_' . $employee->department_id . '_count');
});
Employee::deleted(function ($employee) {Cache::forget('dept_' . $employee->department_id . '_count');
});
4. 实战示例与代码片段
4.1 示例：获取某部门人数
以下示例展示了最常见的请求路径：前端传入 部门ID，后端返回对应人数。
在实现中，优先考虑 withCount 的方式获取结果，以便后续扩展接口的灵活性。
// 示例：获取某部门人数（首选 withCount）
// 假设 $departmentId 从请求中获取
$department = App\Models\Department::withCount('employees')->findOrFail($departmentId);
$count = $department->employees_count;
4.2 示例：获取所有部门的人数分布
当前端需要展示所有部门的人数分布时，使用 withCount 可以一次查询完成。
// 获取所有部门及员工人数
$departments = App\Models\Department::withCount('employees')->get();
foreach ($departments as $d) {echo $d->name . ' - ' . $d->employees_count . ' 人
';
}
4.3 示例：将统计结果转为 API 返回格式
将统计结果整合到 API 响应中，避免暴露内部实现细节，同时确保传输数据体积最优。
// API 返回结构示例
return response()->json(['status' => 'success','data' => $departments->map(function ($d) {return ['department_id' => $d->id,'name' => $d->name,'count' => $d->employees_count,];}),
]);
