本地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,写入,浏览器访问,搜索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免费学习笔记(深入)”;
$mysqli = new mysqli($host, $username, $password, $dbname, $port);if ($mysqli->connect_error) { die("连接失败: " . $mysqli->connect_error); }
$mysqli->set_charset('utf8mb4'); // 防止中文乱码 echo "连接成功!"; ?>
直接运行该文件,若输出“连接成功!”,说明配置完成。
常见连接失败原因与快速排查
遇到报错时,按顺序检查:











