如何通过PHP/SQL动态将数据库字段注释设为列表头？

一、正确的SQL查询（MySQL环境） #

你之前的SQL存在语法错误（缺少FROM关键字），而且获取字段注释需要查询MySQL的系统表INFORMATION_SCHEMA.COLUMNS。正确的查询语句如下：

SELECT COLUMN_NAME, COLUMN_COMMENT 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA = '你的数据库名' 
  AND TABLE_NAME = 'interview'
ORDER BY ORDINAL_POSITION;

注意替换你的数据库名为实际使用的数据库名称，这条SQL会按字段在表中的顺序，返回列名和对应的注释。

二、PHP完整实现代码 #

1. 建立数据库连接并获取字段映射 #

先执行上述SQL，把列名和对应的注释存入关联数组，方便后续匹配：

// 替换为你的数据库连接信息
$db_host = 'localhost';
$db_user = '数据库用户名';
$db_pass = '数据库密码';
$db_name = '你的数据库名';

$mysqli = new mysqli($db_host, $db_user, $db_pass, $db_name);
if ($mysqli->connect_error) {
    die('数据库连接失败: ' . $mysqli->connect_error);
}

// 获取列名与注释的映射关系
$sql_columns = "SELECT COLUMN_NAME, COLUMN_COMMENT 
                FROM INFORMATION_SCHEMA.COLUMNS 
                WHERE TABLE_SCHEMA = '$db_name' 
                  AND TABLE_NAME = 'interview'
                ORDER BY ORDINAL_POSITION";
$result_columns = $mysqli->query($sql_columns);

$columnMap = [];
while ($row = $result_columns->fetch_assoc()) {
    // 如果字段无注释，默认使用列名
    $columnMap[$row['COLUMN_NAME']] = !empty($row['COLUMN_COMMENT']) ? $row['COLUMN_COMMENT'] : $row['COLUMN_NAME'];
}

$result_columns->free();

2. 查询数据并生成带注释表头的表格 #

接着查询interview表的数据，利用之前的映射数组替换表头：

// 查询表内数据
$sql_data = "SELECT * FROM interview";
$result_data = $mysqli->query($sql_data);

// 生成HTML表格
echo "<table border='1'>";
// 输出表头
echo "<tr>";
foreach ($result_data->fetch_fields() as $field) {
    echo "<th>" . htmlspecialchars($columnMap[$field->name]) . "</th>";
}
echo "</tr>";

// 输出数据行
while ($row = $result_data->fetch_assoc()) {
    echo "<tr>";
    foreach ($row as $value) {
        echo "<td>" . htmlspecialchars($value) . "</td>";
    }
    echo "</tr>";
}
echo "</table>";

// 释放资源并关闭连接
$result_data->free();
$mysqli->close();

三、注意事项 #

• 务必替换代码中的数据库连接参数为实际值
• 使用htmlspecialchars()转义输出内容，防止XSS安全问题
• 若字段未设置注释，会自动用列名作为表头，避免空值显示
• 按ORDINAL_POSITION排序保证表头顺序与表字段顺序一致

内容的提问来源于stack exchange，提问作者Iram