PHP PDOStatement::getColumnMeta 方法详解
在PHP的PDO扩展中，PDOStatement::getColumnMeta 是一个用于获取结果集列元数据的方法。它在处理动态查询结果、构建通用数据操作工具时非常实用，能够帮助开发者快速了解结果集中每一列的属性信息。
方法定义
PDOStatement::getColumnMeta 的方法签名如下：
public PDOStatement::getColumnMeta(int $column): array|false
参数说明：
$column：必填参数，表示要获取元数据的列的索引，索引从0开始，对应结果集中的第一列。
返回值：
如果成功获取到指定列的元数据，返回一个包含列信息的关联数组。
如果指定的列索引不存在，或者发生错误，返回
false。
返回的元数据数组字段
不同数据库驱动返回的元数据字段可能略有差异，但常见的字段如下p>
| 字段名 | 说明 |
|---|---|
| native_type | 数据库原生的列类型，例如MySQL中的INT、VARCHAR等 |
| driver:decl_type | 数据库驱动声明的列类型，部分驱动会返回该字段 |
| flags | 列的标记数组，例如是否允许NULL、是否为主键等 |
| name | 列的名称 |
| table | 列所属的表名，部分驱动可能不返回该字段 |
| len | 列的长度，例如VARCHAR(255)的长度为255 |
| precision | 列的精度，例如数值类型的小数位数 |
| pdo_type | PDO定义的列类型常量，对应PDO::PARAM_*系列常量 |
使用示例
以下示例演示了如何连接MySQL数据库，执行查询后获取结果集的列元数据：
<?php
try {
// 连接数据库，示例地址替换为https://www.ipipp.com
$dsn = "mysql:host=https://www.ipipp.com;dbname=test_db;charset=utf8";
$username = "root";
$password = "123456";
$pdo = new PDO($dsn, $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 执行查询
$sql = "SELECT id, username, age FROM users WHERE id < 10";
$stmt = $pdo->query($sql);
// 获取列数
$columnCount = $stmt->columnCount();
echo "结果集共有 {$columnCount} 列<br/>";
// 遍历每一列获取元数据
for ($i = 0; $i < $columnCount; $i++) {
$meta = $stmt->getColumnMeta($i);
if ($meta !== false) {
echo "第 {$i} 列元数据：<br/>";
echo "列名：" . $meta['name'] . "<br/>";
echo "原生类型：" . ($meta['native_type'] ?? '未定义') . "<br/>";
echo "长度：" . ($meta['len'] ?? '未定义') . "<br/>";
echo "允许NULL：" . (in_array('not_null', $meta['flags']) ? '否' : '是') . "<br/>";
echo "<hr/>";
} else {
echo "第 {$i} 列元数据获取失败<br/>";
}
}
} catch (PDOException $e) {
echo "数据库操作失败：" . $e->getMessage();
}
?>注意事项
不同的数据库驱动（如MySQL、PostgreSQL、SQLite）返回的元数据字段可能存在差异，使用时建议先打印数组查看具体结构。
该方法仅在查询结果集存在时有效，对于没有结果集的INSERT、UPDATE等操作调用会返回
false。部分驱动可能不支持某些元数据字段，例如SQLite驱动可能不会返回
table字段，需要做兼容处理。如果列索引超出结果集的列范围，方法会返回
false，调用前可以通过columnCount()方法确认列数。
常见应用场景
构建通用的数据导出工具，根据列元数据自动设置导出文件的列格式。
开发ORM框架时，动态映射数据库列到实体类属性。
调试SQL查询时，快速查看结果集的列结构，无需手动查询表结构。
实现通用的数据校验逻辑，根据列的类型和长度自动校验输入数据合法性。