PHPmysqli连接数据库详细教程

本文深入剖析了PHP中使用mysqli连接MySQL数据库时最常见的“连不上”问题，明确指出这几乎总是由环境配置或权限设置不当引发，而非代码逻辑错误；文章系统梳理了MySQL服务状态、端口与主机名差异（localhost vs 127.0.0.1）、用户授权范围、PHP mysqli扩展启用、SSL与字符集配置、错误信息显示缺失等核心排查点，并强调了mysqli_set_charset()必须在连接后立即调用以避免中文乱码、务必通过mysqli_connect_errno()/mysqli_connect_error()捕获真实错误、以及警惕那些看似连接成功实则因细节错配导致的“偶发性异常”——这些正是开发者最易忽视却又最难调试的痛点。

mysqli_connect() 连不上 MySQL 就是配置或权限问题

连不上不是代码写错，大概率是 mysqli_connect() 的参数没对上服务状态。本地开发常见：MySQL 没启动、端口被改过、用户没授权访问目标数据库，或者 PHP 没装 mysqli 扩展。

• mysqli_connect() 第一个参数默认是 'localhost'，但很多环境（比如 Docker 或远程服务器）得换成 '127.0.0.1' —— 因为 localhost 会走 Unix socket，而 127.0.0.1 走 TCP，失败时错误信息常是 Connection refused
• 检查 phpinfo() 页面里有没有 mysqli 模块，没看到就说明扩展没启用，Linux 下通常要 sudo phpenmod mysqli，Windows 则需在 php.ini 里取消 ;extension=mysqli 前的分号
• 用命令行验证 MySQL 是否可访问：mysql -u root -p -h 127.0.0.1 -P 3306，能进才说明服务、端口、账号都 OK；如果提示 Access denied，重点查用户权限，尤其是 host 是 'localhost' 还是 '%'

mysqli_real_connect() 和 mysqli_connect() 本质一样，但更可控

mysqli_real_connect() 是面向对象风格的底层连接方式，和过程式 mysqli_connect() 功能完全一致，只是把参数拆开传、支持复用连接对象。日常开发用哪个都行，但调试时它能让你更早捕获连接前的配置错误。

• 用 mysqli_init() 初始化后，必须调用 mysqli_options() 设置选项（比如 MYSQLI_OPT_CONNECT_TIMEOUT），否则超时等行为可能不符合预期
• 如果设置了 MYSQLI_CLIENT_SSL，但 MySQL 服务没配 SSL，连接会静默失败，错误信息可能是空或 SSL connection error，此时应先关掉 SSL 尝试
• 连接成功后，务必用 mysqli_connect_errno() 或 $mysqli->connect_errno 检查返回值，不能只靠 if ($conn) —— 某些网络抖动下连接对象存在但实际不可用

mysqli_set_charset() 必须在连接后立刻调用

中文乱码不是数据库字符集设错了，而是 PHP 连接层没告诉 MySQL “我要用 utf8mb4”。即使表和字段都是 utf8mb4_unicode_ci，只要连接时没设置字符集，INSERT 或 SELECT 都可能出问题。

• 必须在 mysqli_connect() 或 mysqli_real_connect() 成功之后、执行任何 SQL 之前调用 mysqli_set_charset($conn, 'utf8mb4')；放在后面等于白设
• 不要用 SET NAMES utf8mb4 替代，它不保证后续所有操作都生效，尤其在预处理语句中容易失效
• 如果用的是 PDO，对应的是 PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"，但 mysqli 没这个机制，只能靠 mysqli_set_charset()

连接失败时的错误信息往往藏在 mysqli_connect_error() 里

很多人只看浏览器空白页或 500 错误，却没打开 PHP 错误报告，导致根本看不到 mysqli_connect_error() 返回的具体内容。没有错误信息，就等于蒙眼修车。

• 开发阶段务必确保 display_errors = On 且 error_reporting = E_ALL 在 php.ini 中启用，否则 mysqli_connect_error() 的输出会被吞掉
• 错误信息里出现 Host 'xxx' is not allowed to connect，说明 MySQL 用户权限限制了来源 IP，要用 GRANT ... ON *.* TO 'user'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES; 放宽（生产环境慎用 '%'）
• 出现 Too many connections 不代表代码漏关连接，而是 MySQL 的 max_connections 设太小，或者连接池没复用、短连接高频创建，得查 SHOW STATUS LIKE 'Threads_connected';

真正麻烦的不是连不上，而是连上了却因为字符集、超时、SSL 或权限细节没对齐，让查询结果看起来“偶尔出错”——这种问题最难定位，也最容易被当成业务逻辑 bug 去瞎调。

本篇关于《PHPmysqli连接数据库详细教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！