本地php环境怎么连接数据库_mysql连接配置步骤【教程】

本地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，内容如下：

$mysqli = new mysqli($host, $username, $password, $dbname, $port);
if ($mysqli->connect_error) {
die("连接失败: " . $mysqli->connect_error);
}
$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 实例）占用