本地PHP连接MySQL需启用mysqli或pdo_mysql扩展，配置正确参数并创建数据库与用户，使用面向对象方式连接并设置utf8mb4字符集，排查时依次检查MySQL服务、账号信息、host及端口。
本地 PHP 环境连接 MySQL 数据库，核心是确保 PHP 能通过 MySQL 扩展（如 mysqli 或 PDO_MySQL）与数据库通信。只要环境已安装并启用对应扩展，配置好数据库参数，就能正常连接。
确认 PHP 已启用 MySQL 扩展
PHP 默认可能未开启 MySQL 支持。需检查并启用：
- 打开
php.ini文件（可通过php --ini命令定位） - 查找并取消注释以下行（Windows 下为
php_mysqli.dll，Linux/macOS 一般已内置）：;extension=mysqli→ 改为extension=mysqli;extension=pdo_mysql→ 改为extension=pdo_mysql - 保存后重启 Web 服务（如 Apache/Nginx）或 PHP 内置服务器
- 新建
info.php，写入<?php phpinfo(); ?>，浏览器访问，搜索mysqli或PDO，确认模块已加载
创建 MySQL 数据库和用户（本地常用方式）
使用命令行或 phpMyAdmin 操作：
- 登录 MySQL：
mysql -u root -p（默认 root 密码为空或你设置的密码） - 创建数据库：
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; - 创建专用用户（更安全）：
CREATE USER 'myuser'@'localhost' IDENTIFIED BY 'mypass123';GRANT ALL PRIVILEGES ON myapp.* TO 'myuser'@'localhost';FLUSH PRIVILEGES;
PHP 中编写连接代码（推荐 mysqli 面向对象方式）
在项目中新建 db_connect.php，内容如下：
立即学习“PHP免费学习笔记（深入）”；
<?php
$host = '127.0.0.1'; // 或 'localhost'
$port = 3306; // MySQL 默认端口
$dbname = 'myapp';
$username = 'myuser';
$password = 'mypass123';
<p>$mysqli = new mysqli($host, $username, $password, $dbname, $port);</p><p>if ($mysqli->connect_error) {
die("连接失败: " . $mysqli->connect_error);
}</p><p>$mysqli->set_charset('utf8mb4'); // 防止中文乱码
echo "连接成功！";
?>直接运行该文件，若输出“连接成功！”，说明配置完成。
常见连接失败原因与快速排查
遇到报错时，按顺序检查：
-
MySQL 服务未启动：终端执行
mysqladmin ping -u root -p，或查看系统服务（如 Windows 服务列表、macOS 的brew services list） - 用户名/密码/数据库名错误：确认与创建时完全一致（注意大小写和空格）
-
host 不匹配：本地开发建议统一用
127.0.0.1（避免localhost触发 socket 连接异常） - 防火墙或端口被占：确认 3306 端口未被其他程序（如另一个 MySQL 实例）占用
