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免费学习笔记（深入）”；
构建并排查Microsoft Word邮件合并及DOCX模板工作流，使用合并域、内容控件、文档属性、重复区块、数据等
改完后重启 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 路径
简单验证脚本：
<?php
$host = '127.0.0.1';
$port = 3306;
$link = mysqli_connect($host, 'root', '', '', $port);
if (!$link) {
die('Connect Error: ' . mysqli_connect_error());
}
echo "Connected OK\n";
mysqli_close($link);
?>
权限和用户认证插件容易导致连接失败
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，这种细节比选什么集成包重要得多。
