PHP连接MySQL并查询数据方法

本文深入解析了PHP连接MySQL并执行查询的常见陷阱与最佳实践，直击开发者最常遇到的“连不上”“查不到”“取不对”三大痛点：从确认mysqli扩展启用、MySQL服务运行和账号权限匹配等基础环境检查，到正确使用mysqli_error()捕获真实错误原因，再到推荐使用mysqli_fetch_assoc()高效安全地获取数据，同时特别强调localhost与127.0.0.1在底层通信机制上的本质区别——Unix socket vs TCP/IP，以及PHP 8.0+废弃旧mysql扩展、MySQL 8.0+默认认证插件兼容性等易被忽视的关键细节，帮你避开90%的线上调试弯路，真正实现稳定、可维护的数据库交互。

mysqli_connect() 连不上？先确认这三件事

连不上不是代码写错，大概率是环境或权限没配对。PHP 8.0+ 默认禁用 mysql_connect()，必须用 mysqli 或 PDO；但很多老教程还在讲前者，容易踩坑。

• 检查 mysqli 扩展是否启用：运行 php -m | grep mysqli，没输出就去 php.ini 解开 extension=mysqli
• 确认 MySQL 服务在运行：systemctl status mysql（Linux）或看 XAMPP/MAMP 是否已启动
• 用户名密码要对应 MySQL 实际账号，不是系统登录名；本地开发常用 root + 空密码，但 MySQL 8.0+ 默认用 caching_sha2_password 认证，mysqli 旧版本不兼容——此时要么降级认证插件，要么升级 PHP 到 7.4+

mysqli_query() 返回 false？查 mysqli_error() 别硬猜

执行查询失败时，mysqli_query() 直接返回 false，但错误原因藏在 mysqli_error() 里。不打印它，等于蒙眼调试。

• 必须搭配 mysqli_error($conn) 使用，$conn 是 mysqli_connect() 的返回值
• 常见错误如：Unknown database 'xxx'（库不存在）、No database selected（没调 mysqli_select_db() 或连接时没指定库名）、Column 'xxx' not found（字段名拼错）
• 注意：如果连接本身失败，$conn 是 false，再调 mysqli_error($conn) 会报 Warning——得先判断 $conn 是否有效

$conn = mysqli_connect('localhost', 'user', 'pass', 'db_name');
if (!$conn) {
    die('连接失败: ' . mysqli_connect_error());
}
$result = mysqli_query($conn, 'SELECT * FROM users');
if (!$result) {
    die('查询失败: ' . mysqli_error($conn));
}

查出来的数据怎么取？别直接 mysqli_fetch_array() 就完事

mysqli_fetch_array() 默认返回数字索引 + 关联索引的混合数组，内存多占一倍，且容易混淆字段访问方式。实际用得多的是 mysqli_fetch_assoc()。

• mysqli_fetch_assoc() 只返回关联数组（$row['id']），语义清晰，推荐作为默认选择
• mysqli_fetch_row() 只返回数字索引（$row[0]），适合简单循环或性能敏感场景
• 每次调用只取一行，要遍历结果集必须用 while ($row = mysqli_fetch_assoc($result))，漏掉 while 就只拿到第一行
• 记得 mysqli_free_result($result) 释放结果集内存，尤其在长连接或大量查询时

为什么本地能跑，上线就报错？看清楚 localhost 和 127.0.0.1 的区别

MySQL 对 localhost 和 127.0.0.1 的处理机制不同：前者走 Unix socket（Linux/macOS），后者走 TCP/IP。部分虚拟主机或 Docker 环境禁用 socket，只认 IP。

• 如果用 localhost 连不上，换成 127.0.0.1 常能解决
• 云数据库（如阿里云 RDS、腾讯云 CDB）必须用外网地址或内网地址，不能填 localhost
• 某些容器网络中，localhost 指向容器自身，而非宿主机 MySQL——这时得用宿主机 IP 或 Docker 自定义网络别名

连接和查询本身不难，难的是错误路径没覆盖全。尤其是认证方式、socket/TCP 差异、以及错误信息不打印这三点，90% 的“连不上”问题都卡在这儿。

终于介绍完啦！小伙伴们，这篇关于《PHP连接MySQL并查询数据方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！