本文介绍一种基于单次数据库查询与数组分组的优雅方案，将歌曲按首字母自动归类并均分为左右两列显示，彻底避免为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 报错。
立即学习“PHP免费学习笔记（深入）”；
✅ 第二步：内存中按首字母分组（关键优化）
<?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=\"details.php?id={$song['id']}\">{$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</div>";
return $html;
}
?>✅ 第五步：最终输出（简洁、清晰、无重复）
<!-- 主容器：双列布局 -->
<div class="song-columns">
<?= renderColumn($leftColumn, 'column-left') ?>
<?= renderColumn($rightColumn, 'column-right') ?>
</div>? 关键注意事项与进阶建议
- 性能友好：全程仅 1 次数据库查询，PHP 数组操作复杂度 O(n)，远优于 26 次查询；
- 健壮性增强：ctype_alpha() + strtoupper() 确保首字母标准化；非字母标题统一归入 # 组，可后续单独展示；
- 样式解耦：将 <th> 样式移至 CSS 文件，避免内联样式污染逻辑；
- SEO 优化：可为每列添加 <h2>A–M Songs</h2> 和 <h2>N–Z Songs</h2> 语义化标题；
- 扩展性预留：如需支持多语言首字母（如中文拼音），可引入 iconv('UTF-8', 'ASCII//TRANSLIT', $title) 预处理；
- 缓存建议：歌曲库变动不频繁，可将 $grouped 序列化后缓存至 Redis 或文件，进一步降低数据库压力。
通过以上重构，你将获得一个可维护、高性能、符合现代 PHP 实践的字母索引模块——从此告别复制粘贴，专注内容与体验。
