如何为PHP项目配置MySQL

PHP连接MySQL需环境与代码双层匹配：确保MySQL服务运行并监听正确端口，php.ini启用mysqli/pdo_mysql扩展，连接时显式设置charset=utf8mb4，优先选用PDO（支持多库、异常处理）或MySQLi（仅MySQL、性能优），避免混用。

PHP项目能连上MySQL，前提是环境层和代码层都配对了——缺一不可。光写对 new mysqli() 没用，如果 php.ini 里没启用扩展，或者 MySQL 服务根本没跑起来，连接会直接报错或超时。

确认MySQL服务正在运行且可访问

很多“连接失败”其实卡在这一步：PHP没毛病，但数据库压根没启动，或监听地址/端口不对。

1. Linux/macOS 下执行 systemctl status mysql 或 sudo service mysql status，看是否显示 active (running)
2. 检查 MySQL 是否监听本地（默认 127.0.0.1:3306）：运行 ss -tuln | grep :3306，有输出才说明端口已就绪
3. 如果用的是 Docker，确认容器在运行：docker ps | grep mysql，并检查 -p 3306:3306 是否映射正确
4. 远程连接需额外验证：MySQL 用户权限是否允许从该 IP 登录（host 字段不能是 localhost，得是具体 IP 或 %），且防火墙放行 3306

检查并启用PHP的MySQL扩展

PHP 8.5.5 默认不自动启用 mysqli 或 PDO_MySQL，即使安装了也得手动打开，否则 new mysqli() 会报 Class 'mysqli' not found。

1. 运行 php --ini 找到生效的 php.ini 路径，再用 grep -i "extension=mysqli|pdo_mysql" /path/to/php.ini 查看是否启用
2. 若被注释（如 ;extension=mysqli），去掉分号；若整行缺失，手动添加 extension=mysqli 和 extension=pdo_mysql
3. 改完后必须重启 Web 服务：Apache 用 sudo systemctl restart apache2，PHP-FPM 用 sudo systemctl restart php8.5-fpm
4. 验证是否生效：php -m | grep -E "mysqli|pdo_mysql" 应有输出；或写个 <?php phpinfo(); ?> 页面搜索 “mysqli”

连接字符串里的charset必须显式设为utf8mb4

不写 charset=utf8mb4，哪怕数据库、表、字段全是 utf8mb4，PHP 读写时仍可能用 latin1 编码通信，导致中文乱码或插入失败（尤其 emoji）。

1. mysqli 面向对象方式：new mysqli($host, $user, $pass, $db, $port) 后立刻调用 $conn->set_charset('utf8mb4')
2. PDO 方式必须在 DSN 中声明："mysql:host=$host;dbname=$db;charset=utf8mb4" —— 光靠 SET NAMES utf8mb4 不够，DSN 里漏掉就无效
3. 注意不是 utf8：MySQL 的 utf8 是阉割版（最多 3 字节），utf8mb4 才支持完整 Unicode（含 emoji）
4. 如果 PDO 连接后执行 SELECT @@character_set_client, @@collation_connection，结果应为 utf8mb4 和 utf8mb4_unicode_ci

用PDO还是mysqli？关键看错误处理和复用需求

两者都能用，但选错会导致调试困难或资源泄漏。别只看语法顺不顺眼，得看项目实际约束。

1. 选 PDO：需要事务嵌套、多数据库兼容（比如将来可能切 PostgreSQL）、或依赖异常捕获（PDO::ERRMODE_EXCEPTION）来统一错误流
2. 选 mysqli：项目只用 MySQL、要精细控制连接生命周期（比如长连接池）、或已有大量面向过程旧代码需最小改动
3. 避免混用：一个项目里同时用 mysqli_query() 和 $pdo->query() 容易让字符集、错误模式、连接状态管理失控
4. 真实坑点：mysqli 面向对象模式下，$conn->close() 不是必须的（脚本结束自动释放），但若在循环中反复 new mysqli，不 close 可能触发连接数超限（Too many connections）

最常被忽略的是：配置文件里的密码硬编码、测试环境用 root 连接、以及没做连接失败的降级处理（比如重试或返回友好的 503）。这些不会让连接“立刻失败”，但会让线上故障排查变成盲人摸象。