PHP连接MySQL需环境与代码双层匹配：确保MySQL服务运行并监听正确端口，php.ini启用mysqli/pdo_mysql扩展，连接时显式设置charset=utf8mb4，优先选用PDO（支持多库、异常处理）或MySQLi（仅MySQL、性能优），避免混用。
PHP项目能连上MySQL，前提是环境层和代码层都配对了——缺一不可。光写对 new mysqli() 没用，如果 php.ini 里没启用扩展，或者 MySQL 服务根本没跑起来，连接会直接报错或超时。
确认MySQL服务正在运行且可访问
很多“连接失败”其实卡在这一步：PHP没毛病，但数据库压根没启动，或监听地址/端口不对。
- Linux/macOS 下执行
systemctl status mysql或sudo service mysql status，看是否显示active (running) - 检查 MySQL 是否监听本地（默认
127.0.0.1:3306）：运行ss -tuln | grep :3306，有输出才说明端口已就绪 - 如果用的是 Docker，确认容器在运行：
docker ps | grep mysql，并检查-p 3306:3306是否映射正确 - 远程连接需额外验证：MySQL 用户权限是否允许从该 IP 登录（
host字段不能是localhost，得是具体 IP 或%），且防火墙放行 3306
检查并启用PHP的MySQL扩展
PHP 8.5.5 默认不自动启用 mysqli 或 PDO_MySQL，即使安装了也得手动打开，否则 new mysqli() 会报 Class 'mysqli' not found。
- 运行
php --ini找到生效的php.ini路径，再用grep -i "extension=mysqli\|pdo_mysql" /path/to/php.ini查看是否启用 - 若被注释（如
;extension=mysqli），去掉分号；若整行缺失，手动添加extension=mysqli和extension=pdo_mysql - 改完后必须重启 Web 服务：Apache 用
sudo systemctl restart apache2，PHP-FPM 用sudo systemctl restart php8.5-fpm - 验证是否生效：
php -m | grep -E "mysqli|pdo_mysql"应有输出；或写个<?php phpinfo(); ?>页面搜索 “mysqli”
连接字符串里的charset必须显式设为utf8mb4
不写 charset=utf8mb4，哪怕数据库、表、字段全是 utf8mb4，PHP 读写时仍可能用 latin1 编码通信，导致中文乱码或插入失败（尤其 emoji）。
立即学习“PHP免费学习笔记（深入）”；
- mysqli 面向对象方式：
new mysqli($host, $user, $pass, $db, $port)后立刻调用$conn->set_charset('utf8mb4') - PDO 方式必须在 DSN 中声明：
"mysql:host=$host;dbname=$db;charset=utf8mb4"—— 光靠SET NAMES utf8mb4不够，DSN 里漏掉就无效 - 注意不是
utf8：MySQL 的utf8是阉割版（最多 3 字节），utf8mb4才支持完整 Unicode（含 emoji） - 如果 PDO 连接后执行
SELECT @@character_set_client, @@collation_connection，结果应为utf8mb4和utf8mb4_unicode_ci
用PDO还是mysqli？关键看错误处理和复用需求
两者都能用，但选错会导致调试困难或资源泄漏。别只看语法顺不顺眼，得看项目实际约束。
- 选 PDO：需要事务嵌套、多数据库兼容（比如将来可能切 PostgreSQL）、或依赖异常捕获（
PDO::ERRMODE_EXCEPTION）来统一错误流 - 选 mysqli：项目只用 MySQL、要精细控制连接生命周期（比如长连接池）、或已有大量面向过程旧代码需最小改动
- 避免混用：一个项目里同时用
mysqli_query()和$pdo->query()容易让字符集、错误模式、连接状态管理失控 - 真实坑点：mysqli 面向对象模式下，
$conn->close()不是必须的（脚本结束自动释放），但若在循环中反复 new mysqli，不 close 可能触发连接数超限（Too many connections）
最常被忽略的是：配置文件里的密码硬编码、测试环境用 root 连接、以及没做连接失败的降级处理（比如重试或返回友好的 503）。这些不会让连接“立刻失败”，但会让线上故障排查变成盲人摸象。
