PHP连接数据库的语句怎么写，PHP连接MySQL代码示例

2026年2月23日 19:22 • 云服务器 • 阅读 193

PHP连接数据库的核心在于选择合适的扩展并正确配置连接参数，目前业界的标准做法是使用PDO（PHP Data Objects）扩展，因为它提供了数据库无关性和强大的防SQL注入机制，相比于传统的mysqli或已废弃的mysql_函数，PDO能够通过统一的接口连接多种数据库系统（如MySQL、PostgreSQL等），并且支持异常处理，使得代码更加健壮和易于维护，在编写连接语句时，必须包含DSN（数据源名称）、用户名、密码以及错误处理模式,确保连接失败时能够优雅地降级或报错。

为什么首选PDO进行数据库连接

在PHP开发中，连接MySQL数据库主要有三种方式：mysql_、mysqli和PDO。mysql_扩展已在PHP 5.5.0中被弃用并在7.0.0中被移除，绝对不应在新项目中使用，mysqli是MySQL的增强版，专门针对MySQL优化，性能极佳，但仅限于MySQL数据库。PDO则提供了数据访问抽象层，这意味着无论使用哪种数据库，连接和查询的代码逻辑基本保持一致,极大提高了代码的可移植性。

更重要的是，PDO默认支持预处理语句，这是防止SQL注入的最有效手段之一，从专业角度来看，使用PDO进行数据库连接不仅符合现代编程规范，还能显著降低安全风险，在构建高性能、高安全性的Web应用时,PDO是唯一推荐的连接方式。

标准的PDO连接代码实现

编写PDO连接语句时，首先需要构建DSN字符串，该字符串定义了数据库类型、主机地址、数据库名称以及字符集。字符集的设置至关重要，通常建议使用utf8mb4以支持完整的Unicode字符,包括emoji表情。

以下是一个生产环境级别的PDO连接示例：

<?php
$dsn = "mysql:host=127.0.0.1;port=3306;dbname=your_database_name;charset=utf8mb4";
$username = "your_username";
$password = "your_password";
try {
    // 实例化PDO对象
    $pdo = new PDO($dsn, $username, $password);
    // 设置错误模式为抛出异常，便于捕获和处理
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    // 设置默认的获取模式，虽然可以在查询时指定，但设置默认值可减少重复代码
    $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
    // 禁用预处理语句的模拟，确保使用MySQL原生预处理，增强安全性
    $pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
} catch (PDOException $e) {
    // 记录详细的错误日志到服务器文件，避免直接向用户展示敏感信息
    error_log("Database connection failed: " . $e->getMessage());
    // 向用户展示友好的错误提示
    die("系统繁忙，请稍后再试。");
}
?>

在这段代码中，setAttribute方法的调用是关键，将错误模式设置为ERRMODE_EXCEPTION允许我们使用try-catch块捕获数据库错误，而不是让PHP输出堆栈跟踪信息，这有助于防止泄露数据库结构等敏感信息，关闭模拟预处理（ATTR_EMULATE_PREPARES）可以确保PDO利用MySQL底层的预处理机制,这是防御SQL注入的重要一环。

酷番云实战经验：云数据库连接优化

在酷番云的云服务器环境中部署PHP应用时，我们经常遇到开发者因为数据库连接配置不当导致性能瓶颈。一个典型的经验案例是关于长连接与连接池的权衡，在传统的LAMP架构中，PHP脚本执行完毕后连接会立即销毁，但在高并发场景下,频繁建立TCP连接和进行MySQL握手会消耗大量资源。

针对这一问题，酷番云建议在云环境下优化PDO连接策略，虽然PHP-FPM模式下持久连接（PDO::ATTR_PERSISTENT => true）可能导致连接数耗尽，但在特定的容器化或Serverless架构中，合理利用数据库代理层的连接池功能更为高效，在使用酷番云的云数据库产品时，我们建议开发者将数据库地址配置为内网地址，并调整PHP-FPM的pm.max_children参数，使其与数据库的最大连接数（max_connections）相匹配。这种配置能够有效避免“Too many connections”错误，确保在流量高峰期系统的稳定性，通过酷番云控制台开启慢查询日志，可以结合PDO的错误处理机制,快速定位并优化那些因连接等待过久而变慢的SQL语句。

安全配置与最佳实践

除了基本的连接语句，凭证管理也是专业开发中不可忽视的一环，绝对不要将数据库密码硬编码在代码库中，尤其是如果代码将托管在Git等版本控制系统上，最佳实践是将数据库配置信息放在网站根目录之外的配置文件中，或者使用环境变量（Environment Variables）。

可以在Apache或Nginx配置文件中设置环境变量，然后在PHP中通过getenv()函数读取：

$dbHost = getenv('DB_HOST');
$dbName = getenv('DB_NAME');
$dbUser = getenv('DB_USER');
$dbPass = getenv('DB_PASS');

SSL/TLS加密连接也是保障数据安全的重要措施，如果PHP应用与数据库不在同一台服务器上，或者数据传输经过公网，必须在DSN中启用SSL，例如在DSN中添加sslmode=require或ssl-ca=/path/to/ca-cert.pem,确保数据在传输过程中不被窃听或篡改。

常见连接错误及排查

在编写连接语句时，开发者常会遇到“Access denied”或“Unknown host”等错误。“Access denied for user”通常意味着用户名、密码错误，或者该用户没有从当前主机IP连接的权限，在云服务器环境下，这往往是因为数据库的防火墙或白名单设置不正确,只允许了特定IP访问。

“Can’t connect to MySQL server on”错误则通常指向网络层面的问题，可能是数据库服务未启动，或者防火墙拦截了3306端口，在排查时，应首先使用telnet或ping命令测试网络连通性，再检查PHP的连接代码。专业的排查思路是：先网络，后权限，再代码，利用PDO异常对象中的getCode()方法可以获取具体的SQLSTATE错误码,这比单纯的错误信息更能精准定位问题。