PHP连接数据库代码怎么写？新手入门教程步骤详解

在PHP中连接数据库是Web开发中常见的操作,不同数据库（如MySQL、MariaDB、PostgreSQL等）有不同的连接方式，但核心逻辑相似，以下以MySQL为例，详细介绍PHP连接数据库的代码实现、注意事项及最佳实践。

连接数据库的基本步骤

1. 选择连接方式
   PHP提供了多种连接MySQL数据库的方式，推荐使用PDO（PHP Data Objects），因为它支持多种数据库类型，且具有更好的安全性和灵活性，传统方式如mysql_connect（已废弃）和mysqli扩展仍可使用，但PDO是更现代的选择。

2. 编写连接代码
   使用PDO连接MySQL的基本代码如下：

   <?php
   // 数据库配置信息
   $host = 'localhost';    // 数据库主机地址
   $dbname = 'test_db';   // 数据库名称
   $username = 'root';    // 数据库用户名
   $password = 'password'; // 数据库密码
   $charset = 'utf8mb4';  // 字符集（推荐utf8mb4支持emoji）
   // 数据源名称（DSN）
   $dsn = "mysql:host=$host;dbname=$dbname;charset=$charset";
   // PDO选项设置
   $options = [
       PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // 抛出异常
       PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,       // 默认关联数组获取
       PDO::ATTR_EMULATE_PREPARES   => false,                  // 禁用预处理模拟
   ];
   try {
       // 创建PDO实例并连接数据库
       $pdo = new PDO($dsn, $username, $password, $options);
       echo "数据库连接成功！";
   } catch (PDOException $e) {
       // 连接失败时输出错误信息（生产环境应记录日志而非直接显示）
       die("数据库连接失败: " . $e->getMessage());
   }
   ?>

关键参数说明

参数	说明
$host	数据库服务器地址，如localhost或IP地址
$dbname	要连接的数据库名称
$username	数据库用户名
$password	数据库密码
$charset	字符集，推荐utf8mb4以支持完整Unicode字符
$dsn	数据源名称，格式为驱动名:host=主机;dbname=数据库名;charset=字符集
$options	PDO选项数组，用于配置连接行为（如错误模式、获取模式等）

执行SQL查询

连接成功后,可通过PDO对象执行SQL查询：

// 1. 准备SQL语句（使用预处理语句防止SQL注入）
$stmt = $pdo->prepare("SELECT * FROM users WHERE age > :age");
// 2. 绑定参数
$age = 18;
$stmt->bindParam(':age', $age, PDO::PARAM_INT);
// 3. 执行查询
$stmt->execute();
// 4. 获取结果
$results = $stmt->fetchAll(); // 获取所有行（关联数组）
foreach ($results as $row) {
    echo $row['name'] . "<br>";
}

关闭连接

PDO连接会在脚本执行结束后自动关闭,但手动关闭可释放资源：

$pdo = null; // 销毁PDO对象

常见问题及解决方案

1. 连接失败

   • 检查数据库服务是否运行（如MySQL的systemctl status mysql）。
   • 验证$host、$username、$password是否正确。
   • 确认数据库用户是否有远程访问权限（如GRANT ALL PRIVILEGES ON test_db.* TO 'root'@'%'）。

2. 字符集乱码

   • 确保$charset设置为utf8mb4，并在数据库创建时指定字符集。
   • 检查HTML页面编码是否为UTF-8（<meta charset="UTF-8">）。

最佳实践

1. 使用环境变量存储敏感信息
   避免在代码中硬编码数据库凭据，可通过.env文件或服务器环境变量管理：

   $host = getenv('DB_HOST');
   $password = getenv('DB_PASSWORD');

2. 统一封装数据库操作类
   将连接、查询、关闭等操作封装为类，提高代码复用性：

   

   class Database {
       private static $pdo = null;
       public static function getConnection() {
           if (self::$pdo === null) {
               // 连接逻辑...
           }
           return self::$pdo;
       }
   }

3. 事务处理
   对于需要原子性操作的场景（如转账），使用事务：

   $pdo->beginTransaction();
   try {
       $pdo->exec("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
       $pdo->exec("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
       $pdo->commit();
   } catch (Exception $e) {
       $pdo->rollBack();
   }

---

相关问答FAQs

Q1: 为什么推荐使用PDO而不是mysqli？
A1: PDO支持多种数据库（如MySQL、PostgreSQL、SQLite），而mysqli仅支持MySQL，PDO提供统一的API接口，切换数据库时只需修改DSN，代码改动更小，PDO的预处理语句机制更安全，能有效防止SQL注入。

Q2: 如何优化数据库连接性能？
A2: 可通过以下方式优化：

• 使用连接池（如PHP的PDO::ATTR_PERSISTENT持久连接，但需注意长连接可能导致内存泄漏）。
• 减少connect和disconnect次数，尽量复用连接对象。
• 对高频查询结果进行缓存（如使用Redis或Memcached）。
• 确保SQL语句高效，避免全表扫描（合理使用索引）。