PHP 和 MySQL 需分离安装并显式配置扩展连接,非一体包;须启用 mysqli/pdo_mysql 扩展、确保 MySQL 服务运行、匹配认证插件(如 MySQL 8.0+ 的 caching_sha2_password),再验证连接链路。
PHP 本身不带 MySQL,MySQL 也不依赖 PHP。所谓“搭配”,本质是让 PHP 能通过 mysqli 或 PDO 扩展连上 MySQL 服务。常见错误是直接下个“PHP+MySQL 一体包”,结果版本不匹配、路径混乱、启动冲突——尤其
Windows 上用 XAMPP/MAMP 后改配置却找不到 php.ini 在哪,或 Linux 下装了 mysql-server 却没开 mysqld 进程。
推荐做法:系统级分离安装 + 显式启用扩展 + 验证连接链路。
php.net 的线程安全(TS)ZIP 包 + MySQL 官方 MSI 安装器,别用旧版 WampServerbrew install php mysql,它自动处理 socket 路径和扩展加载apt install php php-mysql mysql-server,注意 php-mysql 是元包,实际加载的是 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。
改完后重启 Web 服务(Apache/Nginx)或 CLI 环境,用 php -m | grep -i mysql 检查是否生效。
很多人卡在这步:PHP 扩展开着,但 new mysqli('localhost', 'root', '', 'test') 报错 Connection refused 或 No such file or directory。这不是 PHP 问题,是 MySQL 没跑,或 PHP 连错了地址。
systemctl status mysql(Linux)、brew services list | grep mysql(macOS)、任务管理器看 mysqld.exe(Windows)mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';"(Unix socket)或 "SHOW VARIABLES LIKE 'port';"(TCP 端口,默认 3306)'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。
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
my.cnf 中加 default_authentication_plugin=mysql_native_password(需重启 mysqld)'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,这种细节比选什么集成包重要得多。