codeigniter 3 数据库配置文件位于 application/config/database.php，需修改 $db['default'] 数组中的 hostname、username、password、database、dbdriver（必须为 'mysqli'）、db_debug 等字段，并注意 mariadb 权限、严格模式、扩展启用及文件权限等部署细节。
数据库配置文件在哪、怎么改
CodeIgniter 3 的数据库配置统一放在 application/config/database.php，不是环境变量或 .env 文件。打开后找到 $db['default'] 数组，关键字段必须显式填对：
-
'hostname'：通常是'localhost'，但 MariaDB 在 Docker 或云主机上可能要用'127.0.0.1'（localhost在某些系统下会走 socket，而 socket 路径未配置时直接失败） -
'username'和'password'：确保是 MariaDB 中已创建的用户，且该用户有对应数据库的SELECT/INSERT/UPDATE/DELETE权限（仅USAGE不够） -
'database'：库名必须已存在，CI 不会自动建库；大小写敏感，Linux 下mydb和MyDB是两个库 -
'dbdriver'：CI3 必须设为'mysqli'（不是'mysql'，后者已废弃且 PHP 7.0+ 不支持） -
'db_debug'：开发阶段建议设为TRUE，否则连接失败时只返回空页面，无任何提示
连接失败时怎么快速定位
别靠猜，加一行测试代码到任意控制器方法里（比如 Home 的 index()）：
$this->load->database();
if ($this->db->conn_id) {
echo '✅ 连接成功';
} else {
echo '❌ 连接失败：' . print_r($this->db->error(), TRUE);
}
常见错误信息及对应动作：
-
Access denied for user 'xxx'@'localhost'→ 用户密码错，或用户没被授权访问该库（用GRANT ALL ON mydb.* TO 'xxx'@'localhost'; FLUSH PRIVILEGES;重授） -
Connection refused或php_network_getaddresses: getaddrinfo failed→ MariaDB 服务没启动，或hostname填成了不可达地址（如容器名但未在 docker-compose.yml 中配 network） -
Unknown database 'xxx'→ 库不存在，用mysql -u root -p -e "CREATE DATABASE xxx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"手动建
MariaDB 特性适配要点
CI3 默认不启用严格模式，但新版 MariaDB（10.3+）默认开启 STRICT_TRANS_TABLES，会导致插入空字符串到 NOT NULL 字段时报错。解决方式有两个：
- 在
database.php的$db['default']中加：'stricton' => FALSE（快速绕过，适合开发） - 更推荐：在 MariaDB 配置文件（
/etc/mysql/mariadb.conf.d/50-server.cnf）中修改sql_mode，去掉STRICT_TRANS_TABLES（生产环境需评估业务逻辑是否依赖严格校验）
另外，如果要用 GROUP_CONCAT()（比如查多作者图书），记得在 CI 查询前手动执行：$this->db->query("SET SESSION group_concat_max_len = 1000000");，否则默认 1024 字节会被截断。
权限与路径容易被忽略的细节
CI 框架本身不关心数据库类型，但实际部署时几个硬性条件常被跳过：
- PHP 必须装
php-mysqlnd或php-mysqli扩展（Debian/Ubuntu 上运行sudo apt install php-mysqlnd，然后重启 php-fpm 或 Apache） - 若用 Nginx + PHP-FPM，确认
fastcgi_param SCRIPT_FILENAME指向的是真实index.php路径，否则数据库类根本加载不了（错误表现为Call to a member function query() on null） -
application/config/database.php文件权限不能是600（CI 无法读取），推荐644；目录application/config/也不能是700（Web 用户无权进入）
最隐蔽的问题：有些云虚拟主机（如百度 BCH）把 MariaDB 地址设为内网域名（如 rm-xxx.mysql.rds.aliyuncs.com），但 DNS 解析超时默认只有 1 秒，CI 连接会静默失败。此时必须在 database.php 中加 'connect_timeout' => 10 参数。
