PHP新手：如何通过单个文件统一管理MySQL连接？

作为过来人，我当初刚接触PHP开发时也踩过重复写数据库连接代码的坑，这种集中管理连接逻辑的方式绝对是你的最优解，能彻底解决重复代码和批量修改的麻烦。下面一步步教你实现：

第一步：创建单独的数据库连接文件 #

新建一个名为db_connect.php的文件，把所有数据库连接相关的代码都放在这里。这里给你两种常用的实现方式，选一种适合你的就行：

方式1：使用MySQLi（面向对象风格） #

<?php
// db_connect.php
// 定义数据库连接参数
$db_host = '你的新服务器地址';
$db_name = '你的数据库名';
$db_user = '数据库用户名';
$db_pass = '数据库密码';

// 创建连接
$conn = new mysqli($db_host, $db_user, $db_pass, $db_name);

// 检查连接是否成功
if ($conn->connect_error) {
    die("数据库连接失败: " . $conn->connect_error);
}

// 设置字符集，避免中文乱码
$conn->set_charset("utf8mb4");
?>

方式2：使用PDO（更通用，支持多数据库） #

如果你以后可能切换数据库（比如从MySQL到PostgreSQL），PDO会更灵活：

<?php
// db_connect.php
$db_host = '你的新服务器地址';
$db_name = '你的数据库名';
$db_user = '数据库用户名';
$db_pass = '数据库密码';

try {
    $conn = new PDO(
        "mysql:host=$db_host;dbname=$db_name;charset=utf8mb4",
        $db_user,
        $db_pass,
        [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 开启异常错误模式
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // 默认关联数组返回结果
        ]
    );
} catch(PDOException $e) {
    die("数据库连接失败: " . $e->getMessage());
}
?>

第二步：在其他PHP文件中调用这个连接文件 #

在需要操作数据库的PHP文件开头，用require_once()引入db_connect.php，这样就能直接使用文件里定义的$conn变量来操作数据库了：

<?php
// 比如你的某个业务文件：user_list.php
// 引入连接文件（注意路径要正确，如果db_connect.php在上级目录，就写'../db_connect.php'）
require_once('db_connect.php');

// 现在直接用$conn执行SQL查询
$sql = "SELECT id, username FROM users";
$result = $conn->query($sql); // MySQLi方式
// 如果你用PDO的话，就是$result = $conn->query($sql);

// 处理查询结果示例（MySQLi）
if ($result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        echo "ID: " . $row["id"]. " - 用户名: " . $row["username"]. "<br>";
    }
} else {
    echo "没有数据";
}

// 可选：显式关闭连接（PHP脚本结束后会自动关闭，显式关闭更规范）
$conn->close(); // MySQLi方式
// PDO的话用$conn = null;
?>

关键注意事项 #

• 安全第一：把db_connect.php放在网站根目录以外的位置（比如上级目录），或者给文件设置严格的权限，避免被浏览器直接访问泄露数据库账号密码。
• 避免重复引入：用require_once()而不是include()或require()，它会确保文件只被引入一次，防止重复定义变量导致错误。
• 后续修改更轻松：下次再换服务器或者修改数据库参数，只需要修改db_connect.php这一个文件，所有引入它的业务文件都会自动生效，不用逐个修改10个文件啦！

内容的提问来源于stack exchange，提问作者Cruwiel