PHP连接本地MySQL数据库步骤详解

本文深入解析了PHP连接本地MySQL数据库时最常见的五大障碍：MySQL服务未启动或端口配置异常、PHP缺失mysqli/PDO扩展、误用localhost导致socket连接失败、MySQL 8.0+认证插件与旧版PHP不兼容，以及用户权限未正确授予127.0.0.1——并提供从服务验证、扩展启用、连接代码优化、认证降级到权限重置的完整排查链路和可直接复用的实操命令与代码片段，帮你快速定位并彻底解决“明明装好了却连不上”的顽固问题。

确认 MySQL 服务已运行且端口可用

本地连不上，90% 的情况是 MySQL 根本没启动，或者监听了非默认端口。Windows 下打开服务管理器查 MySQL80（或你安装时起的名字）是否“正在运行”；macOS/Linux 运行 brew services list 或 sudo systemctl status mysql。别只看图标——用命令验证端口：netstat -an | grep :3306（Linux/macOS）或 netstat -ano | findstr :3306（Windows）。如果没输出，说明 MySQL 没在监听 3306，得去配置文件 my.cnf 或 my.ini 检查 bind-address 和 port 设置。

PHP 必须启用 mysqli 或 PDO_MySQL 扩展

很多本地环境（如 XAMPP、MAMP、Docker）默认不开启 MySQL 扩展，phpinfo() 页面里搜不到 mysqli 就等于 PHP “看不见” MySQL。Windows 用户检查 php.ini 中这两行是否取消注释：extension=mysqli 和 extension=pdo_mysql；macOS 用 Homebrew 安装的 PHP，可能需要手动执行 brew install php@8.2-mysql（版本号按需替换）。改完必须重启 Web 服务（Apache/Nginx/PHP内置服务器），否则无效。

连接代码里别硬写 root 密码，用 127.0.0.1 而非 localhost

这是最常踩的坑：用 localhost 会让 MySQL 尝试走 Unix socket（Linux/macOS）或命名管道（Windows），而 socket 路径不对或权限不足就直接报 Connection refused 或 Access denied。换成 127.0.0.1 强制走 TCP/IP，更可控。
示例（mysqli 面向对象）：

$host = '127.0.0.1';
$port = 3306;
$user = 'root';
$pass = 'your_password_here'; // 别写明文！开发环境也建议用 .env
$db   = 'test_db';
$mysqli = new mysqli($host, $user, $pass, $db, $port);
if ($mysqli->connect_error) {
die('连接失败: ' . $mysqli->connect_error);
}

注意点：

• $port 参数不能省略，即使默认 3306 —— 否则 mysqli 可能忽略 host 直接走 socket
• 密码为空时传空字符串 ''，不是 null 或省略
• 如果用的是 MySQL 8.0+ 默认的 caching_sha2_password 认证插件，PHP 7.4+ 才原生支持；旧版 PHP 会报 Client does not support authentication protocol，得在 MySQL 里给用户切回 mysql_native_password：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'xxx';

测试连接前先用命令行验证账号密码和权限

别一上来就跑 PHP 脚本。先终端里敲：mysql -h 127.0.0.1 -P 3306 -u root -p，输入密码看能否登录。如果连这步都失败，问题一定出在 MySQL 用户权限或网络层，跟 PHP 无关。
常见权限问题：

• 用户只允许从 localhost 登录，但 PHP 用 127.0.0.1 连，算不同主机 —— 解决：创建用户时用 'root'@'127.0.0.1' 或通配 'root'@'%'（仅开发）
• 数据库不存在，或用户对该库没 SELECT/INSERT 权限 —— 用 SHOW GRANTS FOR 'root'@'127.0.0.1'; 看实际权限
• MySQL 8.0 默认禁用远程 root 登录，本地也要显式授权：CREATE DATABASE IF NOT EXISTS test_db; GRANT ALL ON test_db.* TO 'root'@'127.0.0.1'; FLUSH PRIVILEGES;

socket 路径、认证插件、host 匹配规则、扩展开关——这几个点只要漏一个，连接就会静默失败或报错晦涩。调试时按顺序逐层排除，比反复改 PHP 代码快得多。

到这里，我们也就讲完了《PHP连接本地MySQL数据库步骤详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！