使用 CodeIgniter 查询构建器高效统计各班级男女学生人数-php教程-PHP中文网

使用 CodeIgniter 查询构建器高效统计各班级男女学生人数

聖光之護

发布： 2025-11-11 11:27:01

原创

241人浏览过

使用 CodeIgniter 查询构建器高效统计各班级男女学生人数

本文详细介绍了如何利用 codeigniter 的查询构建器，结合 sql 的条件聚合功能，在一个查询中高效统计出每个班级的男性和女性学生总数。通过实际代码示例，展示了从数据库表结构定义到原生 sql 查询，再到 codeigniter 方法实现的完整过程，旨在帮助开发者掌握复杂分组统计的技巧。

在数据分析和报表生成中，经常需要对特定组别的数据进行多维度统计。例如，在一个学生管理系统中，我们可能需要获取每个班级（或称“ सेक्शन”）的男女学生总数。传统的做法可能涉及多次查询或复杂的子查询，但通过巧妙利用 SQL 的条件聚合（Conditional Aggregation）功能，并结合 CodeIgniter 的查询构建器，我们可以在一个高效的查询中完成这项任务。

数据库表结构

为了演示，我们假设存在以下两个关联的数据库表：

tbl_section: 存储班级信息。
- section_id (主键): 班级ID
- section_name: 班级名称
tbl_student: 存储学生信息。
- stud_id (主键): 学生ID
- stud_name: 学生姓名
- gender: 性别（例如 'M' 代表男性，'F' 代表女性）
- section_id (外键): 学生所属班级的ID，关联 tbl_section.section_id

核心概念：条件聚合

要在一个查询中同时统计男性和女性学生数量，关键在于使用条件聚合。在 SQL 中，SUM(CASE WHEN condition THEN 1 ELSE 0 END) 或更简洁的 SUM(condition)（在某些数据库中，如 MySQL，布尔表达式 condition 为真时会被隐式转换为 1，为假时转换为 0）可以用来实现条件计数。

例如，SUM(gender = 'M') 会对当前分组中所有 gender 为 'M' 的记录求和，从而得到男性学生的数量。同理，SUM(gender = 'F') 用于统计女性学生。

原生 SQL 查询示例

首先，我们来看一下如何用原生 SQL 实现这个需求。我们将连接 tbl_section 和 tbl_student 表，然后按班级名称进行分组，并在选择列表中使用条件聚合来计算男女学生数。

SELECT
    sec.section_name AS section,
    SUM(stu.gender = 'M') AS males,
    SUM(stu.gender = 'F') AS females
FROM
    tbl_section AS sec
JOIN
    tbl_student AS stu ON sec.section_id = stu.section_id
GROUP BY
    sec.section_name;

登录后复制

解析：

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

SELECT sec.section_name AS section: 选择班级名称，并为其设置别名 section。
SUM(stu.gender = 'M') AS males: 统计性别为 'M' 的学生数量，并命名为 males。
SUM(stu.gender = 'F') AS females: 统计性别为 'F' 的学生数量，并命名为 females。
FROM tbl_section AS sec JOIN tbl_student AS stu ON sec.section_id = stu.section_id: 通过 section_id 连接两个表，并为它们设置别名 sec 和 stu，以简化查询。
GROUP BY sec.section_name: 按照班级名称对结果进行分组，这样 SUM 函数就会对每个班级内部的数据进行聚合。

CodeIgniter 查询构建器实现

现在，我们将上述原生 SQL 转换为 CodeIgniter 的查询构建器方法。CodeIgniter 提供了一套直观的方法来构建 SQL 查询，使得代码更具可读性和可维护性。

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Student_model extends CI_Model {

    public function __construct() {
        parent::__construct();
        $this->load->database(); // 确保数据库已加载
    }

    /**
     * 获取每个班级的男女学生数量统计
     *
     * @return array 包含班级名称、男性数量、女性数量的数组
     */
    public function get_gender_counts_by_section() {
        return $this->db
            ->select("sec.section_name AS section, SUM(stu.gender = 'M') AS males, SUM(stu.gender = 'F') AS females")
            ->from('tbl_section AS sec')
            ->join('tbl_student AS stu', 'sec.section_id = stu.section_id')
            ->group_by('sec.section_name')
            ->get()
            ->result(); // 或者 result_array() 根据需求选择返回对象或数组
    }
}

登录后复制

代码解析：

$this-youjiankuohaophpcndb->select(...): select() 方法用于指定要查询的列。这里，我们将条件聚合的 SQL 片段直接作为字符串传入。CodeIgniter 会将其作为表达式处理。
- 注意，为了清晰和避免潜在的歧义，我们为 tbl_section 和 tbl_student 表使用了别名 sec 和 stu。
$this->db->from('tbl_section AS sec'): 指定查询的主表及其别名。
$this->db->join('tbl_student AS stu', 'sec.section_id = stu.section_id'): 执行 JOIN 操作，连接 tbl_student 表，并指定连接条件。
$this->db->group_by('sec.section_name'): 指定按 section_name 字段进行分组。
$this->db->get(): 执行构建好的查询。
->result(): 返回查询结果，通常是一个对象数组。每个对象将包含 section、males 和 females 属性。如果需要关联数组，可以使用 ->result_array()。

结果解读与使用

调用 get_gender_counts_by_section() 方法后，您将获得一个类似以下结构的数组（如果使用 result()）：

[
    (object) [
        'section' => '一年级一班',
        'males' => '15',
        'females' => '12'
    ],
    (object) [
        'section' => '一年级二班',
        'males' => '10',
        'females' => '18'
    ],
    // ... 更多班级
]

登录后复制

您可以在视图层遍历这个数组，将数据展示给用户。

注意事项与最佳实践

别名使用: 在复杂的查询中，为表和列使用别名（如 sec, stu, section, males, females）可以显著提高 SQL 语句的可读性。
条件聚合的通用性: 这种条件聚合的方法不仅限于性别统计，它可以灵活应用于任何需要在一个分组内统计多个分类数量的场景。例如，统计不同考试成绩等级的人数，或者不同状态的订单数量。
数据库性能: 对于包含大量学生记录的数据库，确保 tbl_student.section_id 和 tbl_student.gender 列上存在适当的索引，这将大大提高查询的执行效率。
错误处理: 在实际应用中，建议对数据库查询操作进行错误处理，例如检查 get() 方法是否返回了有效结果，以增强代码的健壮性。
CodeIgniter 版本: 本教程基于 CodeIgniter 3.x 的查询构建器语法。CodeIgniter 4.x 的查询构建器在某些方面有所不同，但核心思想和条件聚合的 SQL 语法保持一致。

总结

通过本教程，我们学习了如何利用 CodeIgniter 的查询构建器结合 SQL 的条件聚合功能，在一个单一且高效的数据库查询中，统计出每个班级的男性和女性学生数量。这种方法不仅减少了数据库交互次数，提高了性能，也使得代码更加简洁和易于维护。掌握条件聚合是进行复杂数据统计和报表生成的强大工具，值得开发者深入理解和应用。

以上就是使用 CodeIgniter 查询构建器高效统计各班级男女学生人数的详细内容，更多请关注php中文网其它相关文章！