ci框架database.php中必须配置的五个硬性参数是hostname、username、password、database、dbdriver；缺一则$this->db为null，调用query()时直接报fatal error。

database.php 里必须填的五个参数

不设这五个值，$this->db 根本连不上库，直接报 Fatal error: Call to a member function query() on null。它们是硬性依赖项，缺一不可：

• hostname：数据库服务器地址，本地开发常用 "localhost" 或 "127.0.0.1"；Docker 环境注意别写 localhost（容器内解析不到宿主机）
• username：MySQL 用户名，CI3 默认用 "root"，但生产环境必须换专用账号
• password：对应用户的密码，空字符串 "" 在本地可行，上线前必须删掉或加密读取
• database：要连接的具体库名，不是 MySQL 实例名；如果库不存在，CI 不会自动创建，会报 Unknown database 'xxx'
• dbdriver：驱动类型，CI3 必须用 "mysqli"（不是 "mysql"，后者已废弃且 PHP 7+ 不支持）

db_debug 和 pconnect 这两个开关怎么选

它们看着小，但直接影响开发效率和线上稳定性：

• db_debug：设为 TRUE 时，SQL 错误会直接显示完整语句和错误码（比如 Column 'xxx' not found），开发阶段必须开；但上线后若仍为 TRUE，可能泄露表结构或查询逻辑，应改为 FALSE 或用 (ENVIRONMENT !== 'production') 动态控制
• pconnect：设为 TRUE 启用持久连接，看似能省开销，但在 Apache prefork 模式下容易导致连接数爆满、MySQL 报 Too many connections；CI3 官方文档明确建议设为 FALSE，除非你清楚自己在做什么

char_set 和 dbcollat 配置不对会导致中文乱码

即使数据库和表本身是 utf8mb4，CI 层没对齐照样存出问号或 Mojibake：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• char_set 必须和数据库实际字符集一致，推荐 "utf8mb4"（不是 "utf8"，后者只支持 3 字节 Unicode）
• dbcollat 要匹配排序规则，常见搭配是 "utf8mb4_unicode_ci" 或 "utf8mb4_general_ci"；若设成 "utf8_general_ci" 而库是 utf8mb4，插入 emoji 会失败并静默截断
• 这两个值必须和 CREATE DATABASE 语句里的声明一致，否则 CI 发送的 SET NAMES 命令会失效

dbprefix 和 swap_pre 的区别与误用风险

很多人以为它们是同一个功能，其实作用时机和范围完全不同：

• dbprefix 是全局前缀，所有模型调用 $this->db->get('users') 时，CI 自动拼成 SELECT * FROM `ci_users`（假设值为 "ci_"）；但它不会影响原生查询，比如 $this->db->query("SELECT * FROM users") 就不会加前缀
• swap_pre 是替换标记，用于在 SQL 字符串里写占位符，比如设 swap_pre = '{pre}'，再写 $this->db->query("SELECT * FROM {pre}users")，CI 才会把 {pre} 替换成 dbprefix 值；不设 swap_pre，这种写法就只是字面字符串
• 常见坑：在 migration 或原始 SQL 中混用两者，结果查不到表却找不到原因

真正容易被忽略的是 failover 数组和 save_queries —— 前者极少有人配（但高可用场景必须考虑），后者默认 TRUE 会在内存里存全部 SQL 日志，大并发时可能撑爆内存，CI3 项目跑着跑着变慢，八成是它没关。