PHP 和 MySQL 需分离安装并显式配置扩展连接,非一体包;须启用 mysqli/pdo_mysql 扩展、确保 MySQL 服务运行、匹配认证插件(如 MySQL 8.0+ 的 caching_sha2_password),再验证连接链路。

PHP 和 MySQL 不是“一起安装”的,得分开配通
PHP 本身不带 MySQL,MySQL 也不依赖 PHP。所谓“搭配”,本质是让 PHP 能通过 mysqli 或 PDO 扩展连上 MySQL 服务。常见错误是直接下个“PHP+MySQL 一体包”,结果版本不匹配、路径混乱、启动冲突——尤其 Windows 上用 XAMPP/MAMP 后改配置却找不到 php.ini 在哪,或 Linux 下装了 mysql-server 却没开 mysqld 进程。
推荐做法:系统级分离安装 + 显式启用扩展 + 验证连接链路。
- Windows:用官方
php.net的线程安全(TS)ZIP 包 + MySQL 官方 MSI 安装器,别用旧版 WampServer -
macOS:用
brew install php mysql,它自动处理 socket 路径和扩展加载 - Linux(Ubuntu/Debian):
apt install php php-mysql mysql-server,注意php-mysql是元包,实际加载的是mysqli和pdo_mysql
php.ini 里必须打开 mysqli 和 pdo_mysql 扩展
装完 PHP 后,php --ini 查出加载的 php.ini 路径,打开它,确认以下两行没被注释(即前面没有分号 ;):
extension=mysqli extension=pdo_mysql
如果用的是 PHP 8.2+,mysql 扩展早已移除,只留 mysqli 和 PDO;若看到 extension=mysql,删掉或注释它,否则启动 PHP 会报 PHP Warning: Module 'mysql' is deprecated。
立即学习“PHP免费学习笔记(深入)”;
改完后重启 Web 服务(Apache/Nginx)或 CLI 环境,用 php -m | grep -i mysql 检查是否生效。
MySQL 服务必须运行,且 PHP 要能访问到 socket 或 TCP 端口
很多人卡在这步:PHP 扩展开着,但 new mysqli('localhost', 'root', '', 'test') 报错 Connection refused 或 No such file or directory。这不是 PHP 问题,是 MySQL 没跑,或 PHP 连错了地址。
- 先确认 MySQL 在运行:
systemctl status mysql(Linux)、brew services list | grep mysql(macOS)、任务管理器看mysqld.exe(Windows) - 查 MySQL 监听方式:
mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';"(Unix socket)或"SHOW VARIABLES LIKE 'port';"(TCP 端口,默认 3306) - PHP 连接时注意:
'localhost'在 mysqli 中会优先走 Unix socket(Linux/macOS),而'127.0.0.1'强制走 TCP;Windows 下二者等价,但若 MySQL 配置了skip-networking,就得用命名管道或本地 socket 路径
简单验证脚本:
权限和用户认证插件容易导致连接失败
MySQL 8.0+ 默认用 caching_sha2_password 插件,而老版本 PHP(Authentication plugin 'caching_sha2_password' cannot be loaded。
- 临时解决:用 MySQL 命令重置用户认证方式:
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 长期建议:升级 PHP 到 7.4+,它原生支持该插件;或在 MySQL 配置文件
my.cnf中加default_authentication_plugin=mysql_native_password(需重启 mysqld) - 别忽略 host 限制:新建用户时写
'user'@'localhost'和'user'@'%'权限完全不同;PHP 用127.0.0.1连,就对应'user'@'127.0.0.1',不是localhost
环境联动的关键不在“装得多快”,而在每层是否可验证、可隔离。比如改了 php.ini 却没重启 Apache,或 MySQL 启动了但 bind-address 设成 127.0.0.1 却在 PHP 里填了服务器内网 IP,这种细节比选什么集成包重要得多。











