首先确认并启用PHP的mysqli和PDO扩展，编辑php.ini文件取消extension=mysqli和extension=pdo_mysql前的分号，保存后重启Web服务器；接着创建info.php文件并访问以验证扩展是否加载成功；然后编写test_conn.php脚本测试MySQL连接，确保能输出连接成功信息；若使用PDO方式，需启用pdo_mysql并用相应代码测试连接；最后检查MySQL服务是否运行、3306端口是否开放及防火墙设置，并确保用户有远程连接权限。
如果您在使用PHP开发Web应用时需要与MySQL数据库进行交互，但发现无法建立连接，则可能是由于数据库扩展未正确配置。以下是完成PHP连接MySQL数据库配置的详细步骤。
本文运行环境：Dell XPS 13，Windows 11
一、确认并启用MySQL扩展模块
PHP通过扩展模块与MySQL通信，最常用的是mysqli和PDO扩展。必须确保这些扩展已在php.ini配置文件中启用。
1、打开PHP安装目录，找到php.ini配置文件，使用文本编辑器进行编辑。
立即学习“PHP免费学习笔记（深入）”；
2、搜索以下两行内容：
extension=mysqli
extension=pdo_mysql
3、如果前面有分号（;），请将其删除以取消注释。
4、保存文件并重启Web服务器（如Apache或Nginx）使更改生效。
二、验证扩展是否成功加载
通过创建一个PHP信息页可以检查MySQL相关扩展是否已正确加载。
1、在Web服务器根目录下创建一个名为info.php的文件。
2、写入以下代码：
<?php phpinfo(); ?>
3、在浏览器中访问http://localhost/info.php。
4、在页面中搜索“mysqli”和“PDO MySQL”，若显示已启用，则表示扩展加载成功。
三、测试数据库连接脚本
编写一个简单的PHP脚本来尝试连接MySQL服务器，以验证配置是否生效。
1、创建一个名为test_conn.php的文件。
2、输入以下代码：
<?php
$servername = "localhost";
$username = "root";
$password = "";
$conn = new mysqli($servername, $username, $password);
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
echo "成功连接到MySQL服务器";
?>
3、根据实际数据库用户名和密码修改变量值。
4、在浏览器中运行该文件，查看是否输出连接成功信息。
四、配置PDO方式连接MySQL
PDO提供更灵活的数据库访问接口，支持多种数据库类型，适合需要兼容性的项目。
1、确保php.ini中已启用extension=pdo_mysql。
2、使用以下代码测试PDO连接：
<?php
$host = 'localhost';
$dbname = 'testdb';
$user = 'root';
$pass = '';
try {
$pdo = new PDO("mysql:host=$host;dbname=$dbname", $user, $pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "PDO连接成功";
} catch (PDOException $e) {
echo "连接失败: " . $e->getMessage();
}
?>
3、调整主机地址、数据库名、用户名和密码以匹配您的环境。
五、检查MySQL服务状态与网络设置
即使PHP扩展已启用，若MySQL服务未运行或端口被阻止，连接仍会失败。
1、确认MySQL服务正在运行。可在命令行执行：
net start mysql
（Windows）或使用systemctl命令（Linux）启动服务。
2、检查MySQL监听端口，默认为3306。使用以下命令测试端口连通性：
telnet localhost 3306
3、若连接被拒，检查防火墙设置是否放行3306端口。
4、确认MySQL用户具有从当前主机连接的权限，必要时使用GRANT语句授权。
