CodeIgniter连接远程MySQL数据库有哪些配置要点

风浩君_7203

风浩君_7203

2026-09-23

926人浏览

原创

远程MySQL连接需显式指定IP/域名和端口,确保bind-address非127.0.0.1、账号授权来源IP、防火墙放行3306、DSN含charset=utf8mb4,CI4须用PDO或MySQLi并清理缓存。

codeigniter连接远程mysql数据库有哪些配置要点

远程MySQL地址和端口必须显式指定,不能只写localhost

本地开发时用 localhost 可能连得上,但远程数据库服务器几乎从不响应这个地址——它实际走的是 Unix socket,而远程连接必须走 TCP。你得填真实 IP 或域名,比如 10.12.34.56 或 db.example.com;如果 MySQL 不在默认 3306 端口,必须在配置里加 port 字段(CI3)或 'port' => 3307(CI4),否则会卡在“Connection refused”。

常见错误现象:mysqli_connect(): (HY000/2002): Connection refused 或 SQLSTATE[HY000] [2002] No such file or directory——后者其实是 PHP 尝试连本地 socket 的典型表现,说明地址没配对。

  • CI3:在 application/config/database.php 中补全 $db['default']['port'] = 3306;
  • CI4:在 app/Config/Database.php 的 $default 数组里加 'port' => 3306
  • 确认远程 MySQL 的 bind-address 没锁死为 127.0.0.1(需改为 0.0.0.0 或具体网卡 IP)

账号权限必须允许从网站服务器IP登录

MySQL 默认只允许 root@localhost,远程连接必须显式授权来源 IP。比如你的网站服务器公网 IP 是 203.0.113.42,就得执行:

CREATE USER 'webuser'@'203.0.113.42' IDENTIFIED BY 'strong_password';
GRANT ALL ON mydb.* TO 'webuser'@'203.0.113.42';
FLUSH PRIVILEGES;

别用 'webuser'@'%',除非测试阶段且网络可控;生产环境暴露通配符账号是高危操作。

  • 若网站和数据库都在内网(如阿里云 VPC),用内网 IP 授权,更安全也更快
  • 检查 MySQL 错误日志,出现 Access denied for user 'xxx'@'yyy' 说明账号或来源限制没过
  • 某些云数据库(如腾讯云 CDB)还需在控制台白名单里添加网站服务器 IP

CI4 必须用 PDO 或 MySQLi,且 DSN 要完整

CI4 已彻底移除 mysql 驱动,填 'DBDriver' => 'mysql' 会静默失败。用 PDO 时,'DSN' 字段不是可选项——它决定了字符集、时区等关键行为,漏写会导致中文乱码或时间错位。

win可用的mysql指令skill
win可用的mysql指令skill

安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。

下载

正确示例(CI4):

'DSN' => 'mysql:host=10.12.34.56;port=3306;dbname=mydb;charset=utf8mb4;timezone=+08:00'
  • charset=utf8mb4 必须带上,否则 emoji 和四字节 UTF-8 字符存不进去
  • 不用 PDO 时选 'DBDriver' => 'MySQLi',但无法用命名参数(:name),prepare 绑定只能用问号占位
  • 配完务必运行 php spark cache:clear,CI4 缓存配置极强,改了不清理等于没改

防火墙和安全组经常被忽略

数据库连不通,80% 情况下不是代码或配置问题,而是网络链路被拦。MySQL 默认只监听 3306,但这个端口常被云服务商安全组、服务器 iptables 或 Windows 防火墙封掉。

  • 在数据库服务器上执行 ss -tuln | grep :3306,确认监听的是 *:3306 而非 127.0.0.1:3306
  • 从网站服务器执行 telnet 10.12.34.56 3306,能通才说明网络层没问题
  • 阿里云/腾讯云后台的安全组规则,要放行「入方向」的 3306 端口,源地址填网站服务器 IP 段

字符集、账号权限、网络通路这三环只要断一环,DBDebug => true 报的错就只会是模糊的“连接失败”,而不是具体原因——所以别跳过验证步骤。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
PHP CodeIgniter框架
PHP CodeIgniter框架

本专题专注于 PHP 轻量级框架 CodeIgniter 的学习与应用,系统讲解 MVC 模型、路由与控制器、数据库操作、表单验证、安全机制以及 REST API 开发。通过博客系统、内容管理平台和小型电商等实战项目,帮助学员快速掌握 CodeIgniter 的开发方法与实践技能。

2025.08.28

4119

16

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

160

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

180

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程