使用PHP连接MySQL数据库中的多种方及错误处理实例

腾逍技术发布于 2025-11-25 01:24 阅读：11 PHP

以下是使用PHP连接MySQL数据库的详细指南，涵盖多种方法、错误处理及最佳实践，供不同需求的开发者参考：

一、连接MySQL的常见方法

PHP支持多种方式连接MySQL数据库，主要推荐使用 MySQLi扩展（面向MySQL优化）和 PDO扩展（支持多数据库）。以下分别介绍具体实现：

1. 使用MySQLi扩展

MySQLi支持面向过程和面向对象两种编程风格，且兼容MySQL最新特性（如预处理语句）。

1.1 面向过程方式

<?php
$servername = "localhost";  // 数据库服务器地址
$username = "root";        // 数据库用户名
$password = "";            // 数据库密码
$dbname = "test";          // 数据库名称
 
// 创建连接
$conn = mysqli_connect($servername, $username, $password, $dbname);
 
// 检查连接状态
if (!$conn) {
    die("连接失败: " . mysqli_connect_error()); // 输出错误信息并终止脚本
}
echo "连接成功";
 
// 关闭连接（可选，脚本结束会自动关闭）
mysqli_close($conn);
?>

关键点：

mysqli_connect() 参数依次为服务器地址、用户名、密码、数据库名（可选）。
mysqli_connect_error() 返回详细的连接错误信息。

1.2 面向对象方式

<?php
$servername = "localhost";
$username = "root";
$password = "";
$dbname = "test";
 
// 创建连接对象
$conn = new mysqli($servername, $username, $password, $dbname);
 
// 检查连接状态
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
 
// 关闭连接
$conn->close();
?>

优势：

更符合现代面向对象编程习惯。
支持事务处理、预处理等高级功能。

2. 使用PDO扩展

PDO（PHP Data Objects）提供统一的接口支持多种数据库（如MySQL、PostgreSQL），适合需要跨数据库兼容性的项目。

<?php
$servername = "localhost";
$username = "root";
$password = "";
$dbname = "test";
 
try {
    // 创建PDO实例
    $conn = new PDO("mysql:host=$servername;dbname=$dbname", $username, $password);
     
    // 设置错误模式为异常捕获
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "连接成功";
} catch(PDOException $e) {
    echo "连接失败: " . $e->getMessage(); // 捕获并输出异常信息
}
 
// 关闭连接（置为null即可）
$conn = null;
?>

关键点：

连接字符串格式：mysql:host=主机名;dbname=数据库名。
setAttribute() 设置错误处理模式，推荐使用异常机制提高代码健壮性。

二、错误处理与调试

连接失败可能由多种原因引起，需针对性处理：

1. 常见错误原因

MySQL服务未启动
用户名/密码错误
权限不足（如远程连接未授权）
PHP未启用MySQL扩展

2. 错误捕获方法

MySQLi：通过返回值检查或异常捕获：

if (!$conn) {
    die("错误代码: " . mysqli_connect_errno() . "，详细信息: " . mysqli_connect_error());
}

PDO：通过try-catch捕获异常：

try {
    // 连接代码
} catch (PDOException $e) {
    echo "错误信息: " . $e->getMessage();
}

3. 环境检查

检查扩展是否启用：在PHP文件中运行phpinfo()，查看是否存在mysqli或pdo_mysql模块。
修改php.ini：取消注释extension=mysqli和extension=pdo_mysql，重启Web服务。

三、安全与最佳实践

1：避免使用已弃用的mysql扩展

PHP 7+已移除mysql_connect()，需使用MySQLi或PDO。

2：使用预处理语句防止SQL注入

示例（MySQLi预处理）：

$stmt = $conn->prepare("SELECT * FROM users WHERE email = ?");
$stmt->bind_param("s", $email);
$stmt->execute();

3：敏感信息保护

将数据库凭据存储在独立配置文件中，并设置文件权限禁止外部访问。

4：连接池与持久连接

高并发场景可使用连接池（如Swoole）或PDO持久连接（new PDO(..., [PDO::ATTR_PERSISTENT => true])）优化性能。

四、进阶操作示例

1. 执行查询（MySQLi面向对象）

$sql = "SELECT id, name FROM users";
$result = $conn->query($sql);
 
if ($result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        echo "ID: " . $row["id"]. " - Name: " . $row["name"]. "<br>";
    }
} else {
    echo "0 结果";
}

2. 事务处理（PDO）

try {
    $conn->beginTransaction();
    // 执行多条SQL
    $conn->exec("UPDATE accounts SET balance = balance - 100 WHERE user_id = 1");
    $conn->exec("UPDATE accounts SET balance = balance + 100 WHERE user_id = 2");
    $conn->commit();
} catch (Exception $e) {
    $conn->rollBack();
    echo "事务失败: " . $e->getMessage();
}

五、总结

方法	适用场景	优势
MySQLi	纯MySQL项目、需使用MySQL特性	高性能、支持预处理和事务
PDO	多数据库支持、强调代码可移植性	统一接口、强大的错误处理机制

推荐选择：

新手或小型项目：从MySQLi面向过程入手，简单直接。
中大型或跨数据库项目：优先使用PDO，提升安全性和扩展性。

通过合理选择连接方式、严格错误处理、遵循安全规范，可构建高效稳定的PHP数据库应用。

到此这篇关于使用PHP连接MySQL数据库的多种方及错误处理的文章就介绍到这了,更多相关PHP连接MySQL数据库内容请搜索腾逍技术以前的文章或继续浏览下面的相关文章希望大家以后多多支持腾逍技术！

MySQL数据库