F3 SQL Mapper：为映射表不存在字段赋值时错误信息误导

在Fat-Free Framework中，当使用Mapper对象为数据表不存在的字段赋值并执行插入操作时，返回的错误信息存在严重误导。

测试代码 #

$mapper->reset();
$mapper->set( 'foo', 'bar' ); // <--- 错误点：`foo`并非数据表字段
$mapper->insert();

错误提示 #

Internal Server Error

SQLSTATE[42S22]: Column not found:
1054 Unknown column 'bar' in 'field list'
[/var/www/example.com/html/lib/php/fatfreeframework/DB/SQL.php:230]

实际不存在的字段是foo，但错误提示却指向值bar，完全颠倒了问题根源。

环境信息 #

• PHP 8.1.9
• pdo_mysql Client API版本：mysqlnd 8.1.9
• MySQL 8.0.30

原因 #

问题出在Fat-Free Framework的DB\SQL类生成插入SQL的逻辑上。当传入不存在的字段时，框架错误地将字段名和对应值的位置搞反，生成了类似INSERT INTO 表名 ('bar') VALUES (foo)的错误SQL语句。MySQL执行这条语句时，会把'bar'当成字段名，自然报错找不到该列，从而产生了误导性的错误信息。

修复方法 #

1. 提前校验字段合法性（推荐） #

在执行插入前手动过滤非法字段，只保留数据表存在的字段：

// 获取目标表的所有合法字段
$fieldInfo = $mapper->db->exec("DESCRIBE {$mapper->table}");
$validFields = array_column($fieldInfo, 'Field');

// 待插入数据
$data = ['foo' => 'bar'];
// 过滤出仅合法的字段数据
$validData = array_filter($data, fn($key) => in_array($key, $validFields), ARRAY_FILTER_USE_KEY);

// 赋值并插入
foreach ($validData as $key => $val) {
    $mapper->set($key, $val);
}
$mapper->insert();

2. 修正框架源码 #

定位到DB/SQL.php中报错的230行附近（插入语句生成逻辑），检查字段与值的拼接代码：

• 确保SQL语句中，字段列表使用的是字段名数组，值列表使用的是对应的值数组，避免两者颠倒。
• 正确的插入语句结构应为：INSERT INTO 表名 (字段1, 字段2) VALUES ('值1', '值2')，修正后即可让错误信息准确指向不存在的字段foo。

3. 自定义Mapper白名单 #

通过继承DB\SQL\Mapper类，添加字段白名单校验，自动拦截非法字段：

class CustomMapper extends DB\SQL\Mapper {
    // 定义数据表存在的字段
    private $allowedFields = ['id', 'username', 'email'];

    public function set($key, $value) {
        if (in_array($key, $this->allowedFields)) {
            parent::set($key, $value);
        }
    }
}

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