一、环境与依赖配置
系统与版本要求
在开始这个 PHP 连接 MySQL 的完整教程 前，需确认服务器环境符合要求。一般建议使用 PHP 8.x+MySQL 8.x，或等效的 MariaDB。为了获得稳定的性能与最新特性，重点关注 PDO_MYSQL 驱动 是否已启用。
本教程覆盖从环境配置到高效查询的完整流程，专注于 PHP 连接 MySQL 并执行查询，因此要确保开发与生产环境的一致性，避免版本差异带来的问题。为字符集兼容性考虑，请设置 字符集 utf8mb4 支持，以正确处理各类中文字符。
常用依赖与安装
通过包管理器安装相关组件时，请优先安装 php-mysql 或 php-pdo_mysql，并确认 Web 服务器/脚本处理器（如 Apache、Nginx+PHP-FPM）已就绪。
下面给出在 Ubuntu/Debian 下的常见安装命令，确保 PHP 与 MySQL 模块已就绪。
sudo apt-get update
sudo apt-get install php-mysql
# 如果使用 php-fpm/fastcgi，请按实际环境重启服务
sudo systemctl restart apache2
# 如果使用 PHP-FPM，请重启
sudo systemctl restart php7.4-fpm
二、连接方式与初始化
PDO 与 MySQLi 的对比
在本教程的核心部分，推荐使用 PDO，因为它提供一致的接口、跨数据库支持，以及 命名参数绑定 与更好的错误处理。相比之下，MySQLi 尽管性能可能略高，但在可移植性和代码可维护性方面欠缺。
另一个要点是 异常处理，通过在 PDO 中开启 ERRMODE_EXCEPTION，可以让错误直接抛出，便于捕获与日志记录，提升后续运维效率。
数据库连接示例
下面展示一个最小可用的 PDO 连接示例，包含常见的错误处理与字符集设置。要点在于 DSN 中明确 host、port、dbname 与 charset，以及使用 选项 控制行为。
示例代码演示了一个稳定的连接流程，便于后续扩展为完整的查询框架。
PDO::ERRMODE_EXCEPTION,PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,PDO::ATTR_EMULATE_PREPARES => false
];try {$pdo = new PDO($dsn, $user, $pass, $options);echo '连接成功';
} catch (PDOException $e) {die('连接失败: '.$e->getMessage());
}
?>三、查询与数据处理
预处理语句与参数绑定
为了实现安全的 查询，需要使用 预处理语句，并通过 参数绑定 防止 SQL 注入。在本教程中，优先采用 PDO 的 prepare 与 execute 组合。
在设计查询时，尽量分离 SQL 与数据，将过滤条件作为参数绑定，避免将用户输入直接拼接到 SQL 中。注意对 整型参数 使用强绑定，以避免类型混淆。
结果集处理
执行查询后，通过 fetch、fetchAll 或逐行遍历的方式处理结果集。为了减少内存占用，建议对大数据集采用 游标式遍历，并在需要时进行分页。
prepare('SELECT id, username, email FROM users WHERE status = :status ORDER BY created_at DESC LIMIT :limit');
$paramStatus = 1;
$paramLimit = 20;
$stmt->bindParam(':status', $paramStatus, PDO::PARAM_INT);
$stmt->bindParam(':limit', $paramLimit, PDO::PARAM_INT);
$stmt->execute();
$rows = $stmt->fetchAll();
foreach ($rows as $row) {// 处理每行数据echo htmlspecialchars($row['username']).' - '.$row['email'].'
';
}
?>四、性能优化与安全
索引、分页与批量插入
高效查询的核心之一是数据库端的索引设计。对高筛选条件的字段，如 status、created_at 等，优先建立 索引。对于大数据量的写入，批量插入 可以显著降低网络往返与事务开销。
对于分页查询，优先采用 LIMIT 与 OFFSET 的组合，但要警惕大 OFFSET 的性能下降。更好的做法是基于 自增主键 或时间戳范围进行“基于键的分页”。
防注入与错误处理
在生产环境中，必须对错误进行恰当的处理与日志记录，并确保 版本控制中的 数据库连接信息 不被外泄。通过 PDO 的异常处理，可以把错误统一到一个捕获点进行记录，并返回安全的错误信息给前端。
beginTransaction();
$insert = $pdo->prepare('INSERT INTO logs (message, created_at) VALUES (?, NOW())');
foreach ($messages as $m) {$insert->execute([$m]);
}
$pdo->commit();/* 注意：使用事务可以显著降低每次写入的开销，确保数据一致性。 */
?>五、实战案例：简单的用户管理接口
案例设计要点
在实际应用中，常见需求包括分页列表、搜索过滤、以及对用户状态的变更。该案例将展示一个简单的 用户管理接口 的后端实现，核心是 PDO 连接与预处理查询。
要点包括：统一的错误处理、参数校验、以及通过 准备语句 进行 CRUD 操作。所有示例都以 utf8mb4 编码为前提，确保多语言字符正常处理。
实现代码演示
prepare($sql);if ($query !== '') {$like = '%' . $query . '%';$stmt->bindValue(':q', $like, PDO::PARAM_STR);}$stmt->bindValue(':offset', (int)$offset, PDO::PARAM_INT);$stmt->bindValue(':size', (int)$size, PDO::PARAM_INT);$stmt->execute();return $stmt->fetchAll();
}
?> 六、部署与迁移
部署注意要点
上线前，请确保数据库服务器的 防火墙、连接上限、以及 慢查询日志都处于可控状态。使用 环境变量 或 配置文件 来管理连接信息，避免把明文密码写入代码。
另外，建议将应用部署在 容器化或虚拟环境中，以便于扩展与回滚。对于高并发场景，确保 连接池 或合适的并发限制策略。
迁移策略
在数据库 schema 变更时，应采用 向前兼容 的迁移策略，例如使用版本化的迁移脚本、逐步应用字段变更，以及保持旧版本的向后兼容性。
-- 示例 SQL 迁移片段：添加新的索引
CREATE INDEX idx_users_status_created_at ON users (status, created_at);
