如何用 PHP 高效实现按字母分组的双列歌曲索引（零代码重复）-php教程-PHP中文网

如何用 php 高效实现按字母分组的双列歌曲索引（零代码重复）

本文介绍一种基于单次数据库查询与数组分组的优雅方案，将歌曲按首字母自动归类并均分为左右两列显示，彻底避免为26个字母重复编写SQL和HTML逻辑。

本文介绍一种基于单次数据库查询与数组分组的优雅方案，将歌曲按首字母自动归类并均分为左右两列显示，彻底避免为26个字母重复编写SQL和HTML逻辑。

在构建在线歌本（Songbook）系统时，常需将海量歌曲按首字母索引展示，如左列显示 A–M、右列显示 N–Z，每列13个字母头。若沿用原始做法——为每个字母单独写一条 LIKE 'A%' 查询、声明独立变量（$songTitleA, $songTitleB…）、复制26遍HTML表格结构——不仅维护成本极高，更易引发逻辑不一致与SQL注入风险。

以下是一套专业、可扩展、安全且零重复的实现方案，核心思想是：一次查询 + 内存分组 + 动态渲染。

✅ 第一步：一次性获取全部数据并按标题排序

<?php require_once 'config.php';

// ✅ 仅执行一次查询，获取全部歌曲并按字母序排列
$sql = "SELECT id, title, chord FROM song ORDER BY title ASC";
$stmt = $conn->prepare($sql);
$stmt->execute();
$songs = $stmt->fetchAll(PDO::FETCH_ASSOC);
?>

⚠️ 注意：务必移除原代码中带占位符 ['title' => $title] 的无效绑定（因 SQL 中无 :title 占位符），避免 PDO 报错。

btpanel phpsite 宝塔面板PHP网站
宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 第二步：内存中按首字母分组（关键优化）

<?php // 初始化空分组数组
$grouped = [];

foreach ($songs as $song) {
    // 安全提取首字母（兼容中文/空格/符号场景）
    $firstChar = trim($song['title'])[0] ?? '';
    $initial = ctype_alpha($firstChar) ? strtoupper($firstChar) : '#'; // 非字母归入 '#' 组

    // 按首字母键聚合（自动创建子数组）
    $grouped[$initial][] = $song;
}

// 可选：按字母顺序排序键名，确保 A→Z 显示顺序
ksort($grouped);
?>

该循环将原始扁平数组转换为关联嵌套结构：

[
  'A' => [['id'=>1,'title'=>'All the way',...], ...],
  'B' => [['id'=>2,'title'=>'Bought to you',...], ...],
  'M' => [['id'=>15,'title'=>'North start',...], ...],
  // ...
]

✅ 第三步：均分两列（支持动态字母数）

<?php // 将分组后的键值对均分为左右两部分（保留键名）
$allKeys = array_keys($grouped);
$midIndex = (int) ceil(count($allKeys) / 2);

$leftKeys  = array_slice($allKeys, 0, $midIndex);
$rightKeys = array_slice($allKeys, $midIndex);

// 构建左右列数据（保持原始分组结构）
$leftColumn  = array_intersect_key($grouped, array_flip($leftKeys));
$rightColumn = array_intersect_key($grouped, array_flip($rightKeys));
?>

? 优势：无论数据库中实际存在多少个首字母（如只有 A/B/C/M/N/Z），都能智能均分，无需硬编码 A–M 和 N–Z。

✅ 第四步：封装可复用的 HTML 渲染函数

<?php function renderColumn(array $letterGroups, string $className = 'column'): string {
    $html = "<div class=\"{$className}\">\n<div class='\"table-wrapper\"'>\n<table class='\"fl-table\"'>\n";

    foreach ($letterGroups as $letter => $songs) {
        // 表头：字母行
        $html .= "  <tr>
<th style='\"color:black;' width:80>{$letter}</th>
<th style='\"color:white;\"'></th>
</tr>\n";

        // 歌曲行
        foreach ($songs as $song) {
            $html .= "  <tr>\n";
            $html .= "    <td><a style='\"margin-left:10px\"' href="%5C%22details.php?id=%7B%24song['id']%7D%5C%22">{$song['title']}</a></td>\n";
            $html .= "    <td><span style='\"margin-left:10px\"'>{$song['chord']}</span></td>\n";
            $html .= "  </tr>\n";
        }
    }

    $html .= "</table>\n</div>\n";
    return $html;
}
?>

✅ 第五步：最终输出（简洁、清晰、无重复）

<!-- 主容器：双列布局 -->
<div class="song-columns">
    = renderColumn($leftColumn, 'column-left') ?>
    = renderColumn($rightColumn, 'column-right') ?>
</div>