php怎么下载安装搭配mysql数据库_环境联动配置【指南】

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

PHP 和 MySQL 不是“一起安装”的,得分开配通

PHP 本身不带 MySQL,MySQL 也不依赖 PHP。所谓“搭配”,本质是让 PHP 能通过 mysqliPDO 扩展连上 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 是元包,实际加载的是 mysqlipdo_mysql

php.ini 里必须打开 mysqli 和 pdo_mysql 扩展

装完 PHP 后,php --ini 查出加载的 php.ini 路径,打开它,确认以下两行没被注释(即前面没有分号 ;):

extension=mysqli
extension=pdo_mysql

如果用的是 PHP 8.2+,mysql 扩展早已移除,只留 mysqliPDO;若看到 extension=mysql,删掉或注释它,否则启动 PHP 会报 PHP Warning: Module 'mysql' is deprecated

改完后重启 Web 服务(Apache/Nginx)或 CLI 环境,用 php -m | grep -i mysql 检查是否生效。

MySQL 服务必须运行,且 PHP 要能访问到 socket 或 TCP 端口

很多人卡在这步:PHP 扩展开着,但 new mysqli('localhost', 'root', '', 'test') 报错 Connection refusedNo 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,这种细节比选什么集成包重要得多。