PHP连接本地MySQL数据库教程

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《PHP连接本地MySQL数据库步骤详解》，文章讲解的知识点主要包括，如果你对文章方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

本地无法连接 MySQL 的核心原因依次为：MySQL 未启动或端口非默认；PHP 未启用 mysqli/PDO_MySQL 扩展；连接时误用 localhost 导致走 socket 而非 TCP；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';
<p>$mysqli = new mysqli($host, $user, $pass, $db, $port);
if ($mysqli->connect_error) {
die('连接失败: ' . $mysqli->connect_error);
}</p>

注意点：

• $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 代码快得多。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。