首页
/ 正文

PHP PDO（手把手讲解）

更新时间: 2025-04-01 09:06:09

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

什么是 PHP PDO？

PHP 数据对象（PHP Data Objects，简称 PDO）是 PHP 内置的一个数据库抽象层扩展。它允许开发者通过统一的面向对象接口，连接并操作多种不同类型的数据库，例如 MySQL、PostgreSQL、SQLite 等。可以将其想象为一个“翻译官”，将 PHP 代码的数据库操作指令，转化为特定数据库系统能够理解的语言。

PDO 的核心优势在于其跨平台兼容性和安全性。与传统的 mysql_ 函数或 mysqli 扩展相比，PDO 的设计更现代化，支持预处理语句（防止 SQL 注入），并且通过对象化的方式简化了代码结构。对于刚接触数据库操作的开发者而言，PDO 是一个友好且高效的起点。

安装与配置

在开始使用 PDO 之前，需确保 PHP 环境已启用该扩展。大多数现代 PHP 版本（如 PHP 7.x 及以上）默认已安装 PDO，但可能需要手动开启特定数据库驱动。例如，若要连接 MySQL 数据库，需在 php.ini 文件中取消注释以下两行：

extension=pdo
extension=pdo_mysql

保存配置后重启 Web 服务器即可生效。可以通过以下代码验证 PDO 是否可用：

if (class_exists('PDO')) {
    echo "PDO 已成功安装！";
} else {
    echo "请检查 PHP 配置。";
}

连接数据库的多种方式

连接数据库是使用 PDO 的第一步。根据需求不同，开发者可以选择不同的连接模式：

1. 基础连接语法

$dsn = "mysql:host=localhost;dbname=test_db;charset=utf8";
$username = "root";
$password = "your_password";

try {
    $pdo = new PDO($dsn, $username, $password);
    echo "数据库连接成功！";
} catch (PDOException $e) {
    die("连接失败： " . $e->getMessage());
}

$dsn：数据源名称（Data Source Name），包含数据库类型、主机地址、数据库名等信息。
charset：指定字符集，避免中文乱码问题。

2. 配置连接选项

通过 PDO::__construct() 的第三个参数，可以传递一个关联数组设置连接选项：

$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 启用异常模式
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // 默认返回关联数组
];

$pdo = new PDO($dsn, $username, $password, $options);

关键选项说明

选项常量	作用描述	示例值
`PDO::ATTR_ERRMODE`	错误处理模式	`PDO::ERRMODE_SILENT`
		`PDO::ERRMODE_WARNING`
		`PDO::ERRMODE_EXCEPTION`
`PDO::ATTR_DEFAULT_FETCH_MODE`	默认获取数据的方式	`PDO::FETCH_ASSOC`
		`PDO::FETCH_OBJ`
`PDO::ATTR_EMULATE_PREPARES`	是否模拟预处理语句	`true` 或 `false`

执行基础查询

1. 查询数据（SELECT）

使用 PDO::query() 方法执行无需参数的简单查询：

$stmt = $pdo->query("SELECT * FROM users WHERE active = 1");
$users = $stmt->fetchAll(PDO::FETCH_ASSOC);
foreach ($users as $user) {
    echo "用户名：" . $user['username'] . "<br>";
}

fetchAll()：获取所有结果行，默认返回二维数组。
fetch()：逐行获取结果，适合大数据量场景。

2. 插入与更新数据（INSERT/UPDATE）

对于动态参数的查询，推荐使用预处理语句（Prepared Statements）：

// 准备 SQL 语句
$stmt = $pdo->prepare("INSERT INTO users (username, email) VALUES (:username, :email)");

// 绑定参数
$stmt->bindParam(':username', $username);
$stmt->bindParam(':email', $email);

// 执行并返回布尔结果
if ($stmt->execute()) {
    echo "数据插入成功！";
}

预处理的优势

预处理语句通过将 SQL 语句和参数分离，有效防止 SQL 注入攻击。例如，假设用户输入的 username 包含恶意代码：

$username = "hacker'; DROP TABLE users; --";

由于参数被安全地转义，数据库会将其视为普通字符串，而非执行危险操作。

错误处理与调试

1. 异常模式 vs. 错误模式

在连接时设置 PDO::ERRMODE_EXCEPTION 后，PDO 会抛出 PDOException 异常，便于集中处理错误：

try {
    $pdo = new PDO($dsn, $username, $password);
    // 执行其他操作
} catch (PDOException $e) {
    echo "错误：" . $e->getMessage();
}

若未启用异常模式，可通过 PDO::errorInfo() 获取错误信息：

if (!$stmt->execute()) {
    print_r($stmt->errorInfo());
}

2. 事务管理（Transactions）

事务确保多个数据库操作的原子性。例如，在用户注册时同时插入用户数据和初始化权限：

$pdo->beginTransaction();
try {
    $pdo->exec("INSERT INTO users (username) VALUES ('Alice')");
    $pdo->exec("INSERT INTO permissions (user_id) VALUES (LAST_INSERT_ID())");
    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    echo "事务失败：" . $e->getMessage();
}

高级用法：游标与绑定

1. 游标（Cursor）控制

默认情况下，PDO 的结果集是“一次性”的，无法重复遍历。通过设置 PDO::ATTR_CURSOR 可开启滚动游标：

$pdo->setAttribute(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL);
$stmt = $pdo->query("SELECT * FROM products");
// 使用滚动游标定位到最后一行
$row = $stmt->fetch(PDO::FETCH_ASSOC, PDO::FETCH_ORI_LAST);

2. 绑定列与绑定变量

绑定列（PDOStatement::bindColumn）可直接将查询结果映射到变量：

$stmt = $pdo->query("SELECT id, name FROM categories");
$stmt->bindColumn('id', $category_id);
$stmt->bindColumn('name', $category_name);

while ($stmt->fetch()) {
    echo "ID: $category_id，名称：$category_name<br>";
}

实战案例：用户注册功能

以下代码演示了使用 PDO 实现用户注册功能，包含参数绑定、事务处理和错误处理：

// 连接数据库
$dsn = "mysql:host=localhost;dbname=users_db;charset=utf8";
$pdo = new PDO($dsn, "root", "password", [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);

// 处理表单提交
if ($_SERVER["REQUEST_METHOD"] === "POST") {
    $username = $_POST['username'];
    $email = $_POST['email'];
    $password = password_hash($_POST['password'], PASSWORD_DEFAULT);

    $pdo->beginTransaction();
    try {
        // 检查用户名是否已存在
        $checkStmt = $pdo->prepare("SELECT COUNT(*) FROM users WHERE username = ?");
        $checkStmt->execute([$username]);
        if ($checkStmt->fetchColumn() > 0) {
            throw new Exception("用户名已存在");
        }

        // 插入用户数据
        $insertStmt = $pdo->prepare("INSERT INTO users (username, email, password) VALUES (?, ?, ?)");
        $insertStmt->execute([$username, $email, $password]);

        $pdo->commit();
        echo "注册成功！";
    } catch (Exception $e) {
        $pdo->rollBack();
        echo "错误：" . $e->getMessage();
    }
}

总结与展望

PHP PDO 作为数据库交互的标准工具，其简洁的接口和强大的功能使其成为开发者的重要选择。通过本文，我们掌握了从基础连接到事务管理的完整流程，并通过实战案例巩固了 PDO 的核心用法。对于进阶开发者，可进一步探索以下方向：

性能优化：使用 PDO::prepare() 缓存预处理语句。
扩展功能：结合 ORM 框架（如 Eloquent）提升开发效率。
安全加固：结合 HTTPS 和令牌验证，构建更健壮的 Web 应用。

掌握 PDO 不仅是技术上的提升，更是构建可靠系统的基石。希望本文能帮助你在 PHP 开发之路上走得更远！

PHP PDO（手把手讲解）

什么是 PHP PDO？

安装与配置

连接数据库的多种方式

1. 基础连接语法

2. 配置连接选项

关键选项说明

执行基础查询

1. 查询数据（SELECT）

2. 插入与更新数据（INSERT/UPDATE）

预处理的优势

错误处理与调试

1. 异常模式 vs. 错误模式

2. 事务管理（Transactions）

高级用法：游标与绑定

1. 游标（Cursor）控制

2. 绑定列与绑定变量

实战案例：用户注册功能

总结与展望

最新发布

Cursor @ 符号（千字长文）

POP3 协议（一文讲透）

IMAP 协议（保姆级教程）

RDP 协议（建议收藏）

SFTP 协议（保姆级教程）

UDP 协议（长文解析）

SSL 协议（手把手讲解）

TLS 协议（超详细）

ARP 协议（保姆级教程）

RARP 协议（建议收藏）