答案：PHP通过PDO或MySQLi扩展连接数据库，需配置主机、用户名、密码等参数。推荐使用PDO，因其支持多种数据库、预处理防注入且代码更安全灵活。常见错误包括权限拒绝、连接超时、数据库不存在等，可通过try-catch捕获异常、检查服务状态与权限排查。敏感信息应通过环境变量管理，配置文件放Web目录外，启用SSL加密及错误日志保护数据安全。
PHP代码连接数据库，核心在于通过PHP内置的数据库扩展（比如PDO或MySQLi）建立一个与数据库服务器的通信通道。这需要提供数据库服务器的地址、端口、用户名、密码以及要连接的数据库名称等信息。一旦连接成功，我们就可以执行SQL查询语句，进行数据的增删改查操作了。这是一个程序与数据交互的基础，也是任何动态Web应用不可或缺的一环。
解决方案
连接PHP与数据库，我通常会推荐使用PDO（PHP Data Objects），因为它提供了一个轻量级、一致的接口来访问多种数据库。以下是连接MySQL数据库并执行查询的基本步骤：
首先，定义你的数据库连接参数。把这些参数集中管理是个好习惯，避免硬编码散落在代码各处。
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 "数据库连接成功！
";
// --- 执行查询示例 ---
// 1. SELECT 查询
$stmt = $pdo->query("SELECT id, name, email FROM users LIMIT 5");
$users = $stmt->fetchAll();
echo "用户列表：
";
foreach ($users as $user) {
echo "ID: " . $user['id'] . ", 姓名: " . $user['name'] . ", 邮箱: " . $user['email'] . "
";
}
// 2. INSERT 插入 (使用预处理语句，防止SQL注入)
$name = "新用户";
$email = "newuser@example.com";
$stmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->execute([$name, $email]);
echo "
成功插入新用户: " . $name . "
";
// 3. UPDATE 更新 (使用命名占位符)
$newEmail = "updated@example.com";
$userId = 1;
$stmt = $pdo->prepare("UPDATE users SET email = :email WHERE id = :id");
$stmt->execute([':email' => $newEmail, ':id' => $userId]);
echo "成功更新用户ID " . $userId . " 的邮箱。
";
// 4. DELETE 删除
$userIdToDelete = 2;
$stmt = $pdo->prepare("DELETE FROM users WHERE id = ?");
$stmt->execute([$userIdToDelete]);
echo "成功删除用户ID " . $userIdToDelete . "。
";
} catch (PDOException $e) {
// 捕获PDO连接或查询过程中的异常
die("数据库连接失败或查询错误: " . $e->getMessage());
}
?>这段代码展示了如何建立连接，并用PDO的预处理语句执行了常见的增删改查操作。预处理语句是防止SQL注入的关键，它将SQL逻辑与数据分离，让数据库在执行前预编译SQL模板。
PHP数据库连接时常见的错误有哪些？如何排查？
在PHP连接数据库的过程中，遇到错误是家常便饭，我几乎每次搭建新环境都会碰到点小麻烦。最常见的错误无非就是那么几种，但排查起来有时真的需要一点耐心和经验。
"Access denied for user 'xxx'@'localhost' (using password: YES/NO)": 这是最常见的身份验证失败。简单来说，就是你提供的用户名或密码不对，或者这个用户没有权限从你连接的主机（比如'localhost'）访问数据库。我记得有次就因为数据库用户权限被不小心改了，结果代码没动，突然就连接不上了，排查了半天发现是数据库管理员的锅。排查时，首先确认
$user
和$pass
是否正确。接着，登录到你的数据库管理工具（如phpMyAdmin、Navicat或MySQL命令行），检查对应用户是否有从localhost
（或你的PHP服务器IP）连接的权限，以及是否拥有访问目标数据库的权限。-
"SQLSTATE[HY000] [2002] Connection refused" / "Can't connect to MySQL server on 'xxx' (111)": 这通常意味着PHP程序无法找到或连接到数据库服务器。可能的原因有：
-
主机地址错误:
$host
参数可能写错了，比如写成了127.0.0.1
但数据库只监听localhost
，或者反之。 - 数据库服务器未运行: 数据库服务可能根本就没启动。
-
端口错误: 默认MySQL端口是3306，但如果数据库配置了其他端口，你需要在
$dsn
中明确指定，如mysql:host=localhost;port=3307;...
。 - 防火墙阻挡: 服务器防火墙可能阻止了PHP程序访问数据库端口。需要检查服务器防火墙规则，确保3306端口（或其他自定义端口）是开放的。
- 网络问题: 如果数据库在另一台服务器上，检查两台机器之间的网络连通性。
-
主机地址错误:
"Unknown database 'xxx'": 这个错误很直接，就是你
$db
参数里写的数据库名不存在。检查拼写，或者确认这个数据库是否真的被创建了。字符集问题: 虽然不直接导致连接失败，但错误的字符集配置会导致乱码。例如，如果你的数据库是
utf8mb4
，而PHP连接时用了latin1
，那么中文或表情符号就会显示为问号或乱码。确保$charset
与数据库和你的数据实际使用的字符集一致。
排查建议：
-
利用
try-catch
块: 像上面示例那样，用try-catch
捕获PDOException
是最佳实践。它会告诉你具体的错误信息，这是解决问题的第一步。 -
查看PHP错误日志: 如果错误信息没有直接显示在浏览器上（可能被
display_errors=Off
隐藏了），请检查PHP的错误日志文件（通常在php.ini
中配置error_log
）。 - 检查数据库日志: 数据库服务器（如MySQL）也有自己的错误日志，可以提供连接尝试和失败的详细信息。
-
命令行测试: 在PHP服务器上，尝试使用命令行工具（如
mysql -h localhost -u your_username -p
）连接数据库。如果命令行也连不上，那问题肯定不在PHP代码，而是数据库服务或网络配置。 - 简化代码: 逐步排除法。先只尝试建立连接，不执行任何查询，确保连接本身没问题。
如何安全地配置PHP数据库连接？避免敏感信息泄露？
数据库连接配置包含敏感信息，比如用户名和密码，一旦泄露，后果不堪设想。我个人在处理这个问题时，最看重的就是“不把鸡蛋放在一个篮子里”，并且尽量让敏感信息远离Web根目录。
-
使用环境变量: 这是我最推荐的方式。将数据库连接参数（主机、用户、密码等）存储在服务器的环境变量中，而不是直接写在PHP代码或配置文件里。PHP可以通过
getenv()
函数来获取这些变量。- 优点: 代码和配置分离，敏感信息不会出现在版本控制系统中；在不同部署环境（开发、测试、生产）切换时，只需要修改环境变量，代码无需改动。
-
实现方式:
- 对于Linux/Unix系统，可以在Web服务器（如Apache或Nginx）的配置文件中设置
SetEnv
，或者在php-fpm
的配置文件中设置env
变量。 - 使用
.env
文件和dotenv
库（如vlucas/phpdotenv
）在开发环境中模拟环境变量，但在生产环境仍建议使用系统级别的环境变量。
- 对于Linux/Unix系统，可以在Web服务器（如Apache或Nginx）的配置文件中设置
配置文件置于Web根目录之外: 如果你选择使用配置文件（比如一个
config.php
文件），请确保它被放置在Web服务器无法直接访问的目录中。例如，如果你的Web根目录是/var/www/html
，那么配置文件可以放在/var/www/config
。这样，即使Web服务器配置错误，也无法通过URL直接访问到这个文件。数据库用户最小权限原则: 给数据库用户分配权限时，只授予其完成任务所需的最小权限。例如，如果某个应用只需要读取数据，就只给它
SELECT
权限，不要给INSERT
,UPDATE
,DELETE
等权限。这能有效限制潜在攻击造成的损害。禁用
display_errors
: 在生产环境中，务必在php.ini
中将display_errors
设置为Off
，并将log_errors
设置为On
。这样，即使发生连接错误，也不会在用户界面上直接暴露敏感的错误信息（如数据库路径、用户名等），而是记录到服务器日志中。使用SSL/TLS加密数据库连接: 如果你的PHP应用和数据库服务器不在同一台机器上，或者在不安全的网络环境中，强烈建议使用SSL/TLS加密数据库连接。这可以防止数据在传输过程中被窃听或篡改。PDO和MySQLi都支持SSL连接，你需要在连接参数中指定SSL证书路径。
定期审计和更新: 定期检查数据库用户的权限，删除不再需要的用户。保持PHP和数据库软件的最新版本，以修补已知的安全漏洞。
PHP中PDO和MySQLi扩展有什么区别？什么时候选择哪个？
在PHP中，连接MySQL数据库主要有两种主流的扩展：PDO (PHP Data Objects) 和 MySQLi (MySQL Improved Extension)。我个人在新的项目里几乎都会选择PDO，但MySQLi在某些场景下也有它的优势。
-
PDO (PHP Data Objects)
- 多数据库支持: 这是PDO最大的特点。它提供了一个统一的接口来访问多种数据库，比如MySQL, PostgreSQL, SQLite, SQL Server等。这意味着如果你将来需要更换数据库类型，大部分数据库操作代码可以保持不变，只需要修改DSN（数据源名称）和一些特定的驱动选项。对我来说，这种灵活性是巨大的吸引力。
- 面向对象: PDO完全是面向对象的，这使得代码结构更清晰，更易于维护。
- 预处理语句: PDO原生支持预处理语句，这是防止SQL注入攻击的关键。它强制将SQL逻辑和数据分离，提高了安全性。
-
错误处理: 提供了强大的错误处理机制，通常通过抛出
PDOException
来处理错误，这符合现代PHP的异常处理模式。 - 获取模式灵活: 可以非常灵活地设置结果集的获取模式，例如关联数组、数字索引数组、对象等。
-
MySQLi (MySQL Improved Extension)
- 专为MySQL设计: 顾名思义，MySQLi是专门为MySQL数据库设计的。它提供了MySQL特有的功能，比如存储过程、多语句查询等，在某些情况下可能会比PDO更直接。
-
两种接口: MySQLi同时提供了面向对象和面向过程两种编程接口，这对于习惯了传统
mysql_*
函数的开发者来说，过渡成本较低。 - 性能: 在某些非常特定的基准测试中，MySQLi在纯MySQL操作上可能会有微小的性能优势，但这在大多数实际应用中几乎可以忽略不计。
- 预处理语句: MySQLi也支持预处理语句，同样能有效防止SQL注入。
什么时候选择哪个？
-
选择PDO:
- 新项目或需要数据库可移植性: 如果你的项目未来可能需要支持多种数据库，或者你希望代码更具通用性，PDO是毫无疑问的首选。
- 追求代码一致性和现代化: PDO的面向对象设计和统一接口让代码更易于维护和扩展。
- 安全性考量: 它的预处理机制和错误处理模式非常健壮。
- 团队偏好: 如果你的团队更熟悉面向对象编程和使用统一的数据库抽象层，PDO会更受欢迎。
-
选择MySQLi:
- 纯MySQL项目且不考虑未来更换: 如果你确定项目永远只使用MySQL，并且不考虑未来更换其他数据库，MySQLi是个可行的选择。
-
维护旧代码: 如果你正在维护一个使用
mysql_*
函数的旧项目，并且需要逐步升级，MySQLi的面向过程接口可能让你更容易过渡。 - 特定MySQL功能: 如果你需要频繁使用MySQL特有的高级功能，MySQLi可能会提供更直接的API。
总的来说，我个人是强烈推荐使用PDO的。它的灵活性、安全性以及对多种数据库的统一支持，让我在开发时能少操很多心，也为项目未来的发展留下了更多可能。除非有非常特殊的理由，否则PDO通常是更优的选择。
