怎么在PHP中连接MySQL数据库？，php怎么连接数据库

在PHP中连接MySQL数据库服务器，优先用PDO或mysqli扩展，准备好主机、端口、库名、用户名、密码，建立连接后捕获异常并设置字符集，就能执行SQL。 真正影响成败的通常不是代码本身，而是扩展是否开启、账号权限、网络端口和字符集这些细节。

怎么在PHP中连接MySQL数据库服务器：先搞清连接方式和前提

PHP连接MySQL不是单一函数,而是一套组合动作，你需要让PHP进程找到MySQL服务，拿到合法身份，再通过协议发送SQL，MySQL默认监听3306端口，PHP端常用PDO或mysqli扩展，两者都能完成连接，但适用场景不同。

加载中

【PHP】教你10分钟快速学会php连接数据库

fitnessCoder

6.3万68866

原视频地址

环境检查：PHP扩展和MySQL服务是否就绪

先别急着写代码,很多“连不上”其实是环境没准备好。

• 查看PHP已加载的数据库扩展：php -m | grep -E 'mysqli|pdo_mysql'
• 查看PHP版本和配置文件路径：php -v、php --ini
• 确认MySQL服务运行：Linux用systemctl status mysql，Windows在服务管理器查看。
• 检查配置文件,php.ini中需取消注释：extension=mysqli、extension=pdo_mysql。
• 如果使用宝塔、phpstudy、XAMPP，面板里一般有“安装扩展”入口，路径和命令行环境可能不同。

PHP官方手册明确说明,PDO_MYSQL是PDO的MySQL驱动，mysqli则专门面向MySQL，扩展没开，代码写得再漂亮也会报“Class not found”或“could not find driver”。

PHP连接MySQL数据库用mysqli还是PDO好

这个问题没有绝对答案,但可以从项目需求判断。

业内专家指出,生产环境应优先使用预处理语句，避免把用户输入拼进SQL，新项目用PDO更省心；如果只连MySQL且已有mysqli代码，继续用mysqli也没问题。

最小可用连接代码：mysqli与PDO各一段

mysqli面向对象写法：

$mysqli = new mysqli('127.0.0.1', 'app_user', '强密码', 'app_db', 3306);
$mysqli->set_charset('utf8mb4');
$result = $mysqli->query('SELECT id, name FROM users LIMIT 5');
while ($row = $result->fetch_assoc()) {
    echo $row['name'];
}
$mysqli->close();

PDO写法：

$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=app_db;charset=utf8mb4';
$pdo = new PDO($dsn, 'app_user', '强密码', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
]);
$stmt = $pdo->prepare('SELECT id, name FROM users WHERE email = ?');
$stmt->execute([$email]);
$user = $stmt->fetch();

注意utf8mb4，它能存emoji和更多字符，只写utf8在部分MySQL版本里是“不完全UTF-8”，容易出乱码。

PHP连接远程MySQL数据库失败怎么办：权限、网络与安全组

本地连接成功,远程却失败，问题通常集中在三处：MySQL账号不允许远程、网络端口不通、云平台安全组没放行，按顺序排查，比反复改代码有效。

检查MySQL用户授权和host限制

MySQL用户由“用户名@主机”共同定义。app_user@localhost只能本机登录，远程连接会报1045。

登录MySQL后执行：

CREATE USER 'app_user'@'%' IDENTIFIED BY '强密码';
GRANT SELECT, INSERT, UPDATE, DELETE ON app_db. TO 'app_user'@'%';
FLUSH PRIVILEGES;

生产环境不建议长期用,可以改成'app_user'@'10.0.0.5'，只允许应用服务器内网IP。

检查bind-address、防火墙和云服务器安全组

MySQL可能只监听127.0.0.1，编辑配置文件，常见路径是/etc/mysql/mysql.conf.d/mysqld.cnf，找到bind-address，改为0.0.0或指定内网IP，改完重启：

sudo systemctl restart mysql

然后检查系统防火墙,Ubuntu可用sudo ufw allow from 应用服务器IP to any port 3306，云服务器还要看安全组入方向规则，北京地区的PHP项目连接云MySQL数据库时，通常优先走内网地址，延迟更低，也少暴露公网端口。

常见报错与排查路径

• SQLSTATE[HY000] [2002] Connection refused：服务没启动、端口不通、bind-address限制。
• SQLSTATE[28000] [1045] Access denied：用户名、密码、host权限不匹配。
• caching_sha2_password认证失败：旧PHP的mysqlnd可能不支持MySQL 8默认插件，升级PHP或调整认证方式，长期方案是升级客户端。
• localhost与0.0.1不同，PDO中host=localhost可能走Unix socket，host=127.0.0.1走TCP，远程连接统一写IP或域名。

本地PHP环境连接MySQL数据库的步骤与不同场景

本地PHP环境连接MySQL数据库的步骤

本地开发最常见的是集成环境,XAMPP、phpstudy、MAMP、Docker都行。

• 启动MySQL服务,确认端口是3306。
• 用phpMyAdmin或命令行创建数据库：CREATE DATABASE app_db DEFAULT CHARACTER SET utf8mb4;
• 创建专用账号,不要直接用root跑应用。
• PHP连接参数：主机0.0.1，端口3306，库名app_db。
• 如果PHP跑在Docker里,MySQL在宿主机，主机名可能不是localhost，而是host.docker.internal或宿主机内网IP。

云服务器与容器场景的配置重点

容器里连接另一个MySQL容器,主机名用服务名，比如Docker Compose中MySQL服务叫mysql，PHP的DSN就写host=mysql，前提是它们在同一个自定义网络，用默认bridge网络时，服务名解析可能失效。

云数据库通常提供内网地址和白名单,把应用服务器内网IP加入白名单，开启SSL后，PDO DSN可加ssl_ca等参数，连接串不要写死在代码里，放进环境变量。

虚拟主机PHP连接MySQL数据库要多少钱

虚拟主机方案通常已经包含MySQL数据库,费用随空间大小、流量、数据库数量变化，入门套餐年费可能较低，独立云数据库则按实例规格、存储、备份和时长计费，若只是个人博客或小型展示站，虚拟主机够用，若涉及高并发、事务和远程访问，云数据库或自建云服务器更合适，价格不是唯一指标，连接数、备份、内网延迟更影响体验。

让连接更稳：字符集、异常处理、预处理与生产建议

行业共识认为,数据库密码不应写进公开仓库，用.env、配置中心或云密钥管理，Web目录下不要放含密码的PHP文件。

字符集统一为utf8mb4

连接后执行SET NAMES utf8mb4，或PDO DSN写charset=utf8mb4，mysqli用set_charset('utf8mb4')，数据库、表、字段也统一，否则中文、emoji、特殊符号可能乱码。

用预处理抵挡SQL注入

不要写"SELECT FROM users WHERE id = " . $_GET['id']，用：

$stmt = $pdo->prepare('SELECT  FROM users WHERE id = ?');
$stmt->execute([$id]);

mysqli也支持prepare和bind_param。PDO::ATTR_EMULATE_PREPARES => false可让MySQL执行真正的预处理，通常更安全。

配置异常处理与超时

PDO设置PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，用try-catch捕获PDOException，mysqli在PHP 8.1+默认错误模式更严格，也可显式设置mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);，设置连接超时，避免页面卡死。

连接生命周期与性能

PHP-FPM通常每个请求新建连接，请求结束释放，持久连接能减少握手，但可能占用MySQL连接数，使用不当会拖垮数据库，优先优化SQL索引、减少查询次数，连接数上限、max_connections、wait_timeout要结合业务调整。

怎么在PHP中连接MySQL数据库服务器常见问题

PDO连接MySQL和mysqli连接MySQL能同时开吗？

能,它们是独立扩展，同一项目不同模块可以分别使用，但同一业务层最好统一，避免维护两套错误处理和连接配置。

PHP连接MySQL数据库失败提示2002怎么排查？

先确认MySQL进程存在,再用telnet 主机 3306或nc -vz 主机 3306测端口，端口不通就查bind-address、系统防火墙、云安全组，端口通但报1045，再查账号host和密码。

PHP 8连接MySQL 8报认证错误怎么办？

MySQL 8默认常用caching_sha2_password，PHP需使用较新的mysqlnd驱动，升级PHP和MySQL客户端库是首选，临时可改用户认证插件，但长期看升级环境更稳妥，确认php -i | grep mysqlnd能看到mysqlnd信息。

结论很直接：用PDO或mysqli建立连接，设置utf8mb4和异常模式，远程访问时打通账号权限与网络端口，再用预处理执行SQL。 把这几步做扎实，PHP连接MySQL数据库服务器就不再是反复踩坑的环节。