php连接mysql数据库代码|完整指南与常见问题解析

从零开始掌握PHP与MySQL连接的核心技术:mysqli、PDO、mysqlnd、错误诊断、性能调优与安全加固全流程详解

一、php连接mysql数据库代码入门指南

在Web开发中,PHP与MySQL的组合是全球最主流的动态网站技术栈之一。掌握其连接机制是构建可扩展、高可用应用的基石。本节将系统梳理连接前的准备、核心参数配置及通用连接模式。

PHP连接MySQL数据库的底层依赖于MySQL驱动。当前主流驱动有三种:mysqlnd(MySQL Native Driver)、libmysqlclient(MySQL Client Library)以及抽象层如mysqli与PDO_mysql。自PHP 5.5起,mysql扩展已被废弃;PHP 7.0起完全移除。因此,所有新项目必须使用mysqli或PDO扩展。

⚡ 连接前必查项

  • MySQL服务是否运行:mysql -u root -p测试登录
  • PHP是否启用扩展:php -m | grep -E 'mysqli|pdo_mysql'
  • 数据库用户权限:GRANT ALL ON mydb.* TO 'appuser'@'localhost';
  • 防火墙与端口:3306是否开放(云数据库注意安全组)

⚙️ 核心连接参数详解

  • host:服务器地址(localhost、127.0.0.1、远程IP、域名)
  • port:端口号(默认3306,云数据库可能为3307/3308)
  • username:数据库用户名(避免使用root)
  • password:密码(生产环境建议使用密钥管理)
  • database:目标数据库名
  • charset:字符集(必须设为utf8mb4)

〔示例〕标准连接初始化模板(通用结构)

<?php
// 配置文件 config.php
return [
    'host'     => '127.0.0.1',
    'port'     => 3306,
    'username' => 'webapp',
    'password' => 'SecurePass2026!',
    'database' => 'php_mysqli_demo',
    'charset'  => 'utf8mb4',
    'options'  => [
        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES   => false,
    ]
];

〔注意〕常见误区

二、mysqli扩展连接mysql数据库代码详解

mysqli(MySQL Improved)是PHP官方推出的MySQL扩展,支持面向对象与过程式两种风格,提供预处理语句、事务、存储过程等高级特性。

〔方式1〕面向对象风格(推荐)

<?php
$host     = '127.0.0.1';
$port     = 3306;
$username = 'webapp';
$password = 'SecurePass2026!';
$database = 'php_mysqli_demo';
$charset  = 'utf8mb4';
// 创建连接
$mysqli = new mysqli($host, $username, $password, $database, $port);
// 检查连接
if ($mysqli->connect_error) {
    error_log("连接失败: " . $mysqli->connect_error);
    die("数据库连接失败,请联系管理员");
}
// 设置字符集(防止乱码)
if (!$mysqli->set_charset($charset)) {
    error_log("字符集设置失败: " . $mysqli->error);
}
echo "✅ 成功连接到数据库:{$database}(mysqli方式)

"; // 示例:执行查询 $result = $mysqli->query("SELECT id, title FROM articles LIMIT 5"); if ($result) { while ($row = $result->fetch_assoc()) { echo "ID: {$row['id']} | 标题: {$row['title']}
"; } $result->free(); } // 关闭连接 $mysqli->close();

〔方式2〕过程式风格

<?php
$host     = 'localhost';
$username = 'webapp';
$password = 'SecurePass2026!';
$database = 'php_mysqli_demo';
$connection = mysqli_connect($host, $username, $password, $database, 3306);
if (!$connection) {
    die("连接失败: " . mysqli_connect_error());
}
mysqli_set_charset($connection, "utf8mb4");
echo "✅ 已建立mysqli连接(过程式)";
// 查询示例
$sql = "SELECT id, content FROM comments WHERE status = ?";
$stmt = mysqli_prepare($connection, $sql);
$status = 'active';
mysqli_stmt_bind_param($stmt, "s", $status);
mysqli_stmt_execute($stmt);
$result = mysqli_stmt_get_result($stmt);
while ($row = mysqli_fetch_assoc($result)) {
    echo htmlspecialchars($row['content']) . "
"; } mysqli_stmt_close($stmt); mysqli_close($connection);

〔技巧〕启用持久连接(谨慎使用)

在高并发场景下,可启用持久连接减少TCP握手开销:

$mysqli = new mysqli("p:".$host, $username, $password, $database, $port);

但需注意:

三、PDO扩展连接mysql数据库代码详解

PDO(PHP Data Objects)是统一数据库抽象层,支持多种数据库(MySQL、PostgreSQL、SQLite等),具备更完善的预处理支持与错误处理机制,是现代PHP应用的首选。

〔标准连接〕PDO + DSN配置

<?php
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=php_mysqli_demo;charset=utf8mb4';
$username = 'webapp';
$password = 'SecurePass2026!';
try {
    $pdo = new PDO($dsn, $username, $password, [
        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // 抛出异常
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,       // 默认关联数组
        PDO::ATTR_EMULATE_PREPARES   => false,                  // 禁用模拟预处理
        PDO::ATTR_PERSISTENT         => false,                  // 可选:启用持久连接
    ]);
    echo "✅ PDO连接成功!数据库:" . $pdo->query("SELECT DATABASE()")->fetchColumn();
    // 示例:安全查询(防止SQL注入)
    $stmt = $pdo->prepare("SELECT id, title, created_at FROM articles WHERE status = :status ORDER BY created_at DESC");
    $stmt->execute(['status' => 'published']);
    $articles = $stmt->fetchAll();
    foreach ($articles as $article) {
        printf("• [%s] %s\n", $article['created_at'], $article['title']);
    }
} catch (PDOException $e) {
    error_log("PDO连接错误: " . $e->getMessage());
    die("系统繁忙,请稍后重试");
}

〔进阶〕自定义DSN与连接选项

DSN(Data Source Name)支持更精细的控制:

$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=php_mysqli_demo;charset=utf8mb4;sslmode=required;sslca=/path/to/ca.pem;sslcert=/path/to/client-cert.pem;sslkey=/path/to/client-key.pem';

适用于云数据库(如阿里云RDS、腾讯云CDB)的SSL加密连接场景。

〔对比〕mysqli vs PDO

特性 mysqli PDO
支持数据库 仅MySQL 12种(MySQL/PG/SQLite/Oracle等)
预处理支持 支持(需手动绑定) 原生支持(更简洁)
命名参数 不支持 支持(如 :status)
异常处理 需手动检查错误 自动抛出PDOException
持久连接 支持(需加"p:"前缀) 支持(设置ATTR_PERSISTENT)
事务支持 支持(autocommit控制) 支持(beginTransaction/commit)
性能 略快(专为MySQL优化) 稍慢(抽象层开销)

〔最佳实践〕PDO连接池模拟(单例模式)

class DB {
    private static $instance = null;
    private function __construct() {}
    public static function getInstance() {
        if (self::$instance === null) {
            $config = require 'config.php';
            $dsn = "mysql:host={$config['host']};port={$config['port']};dbname={$config['database']};charset={$config['charset']}";
            self::$instance = new PDO($dsn, $config['username'], $config['password'], $config['options']);
        }
        return self::$instance;
    }
    public function query($sql, $params = []) {
        $stmt = self::getInstance()->prepare($sql);
        $stmt->execute($params);
        return $stmt;
    }
}
// 使用示例
$db = DB::getInstance();
$stmt = $db->query("SELECT * FROM users WHERE email = ?", ['test@example.com']);
$user = $stmt->fetch();

四、php连接mysql数据库时的常见错误排查指南

连接失败是PHP初学者最常遇到的问题。本节系统梳理10大高频错误及其解决方案。

〔错误1〕Connection refused (111)

Warning: mysqli_connect(): (HY000/2002): Connection refused in /var/www/index.php on line 5

原因分析:

解决方案:

在容器环境中,host应设为服务名(如mysql),而非127.0.0.1。

〔错误2〕Access denied for user

Warning: mysqli_connect(): (HY000/1045): Access denied for user 'webapp'@'localhost' (using password: YES)

原因分析:

解决方案:

-- 授予远程访问权限
GRANT ALL PRIVILEGES ON *.* TO 'webapp'@'%' IDENTIFIED BY 'SecurePass2026!';
FLUSH PRIVILEGES;

〔错误3〕Unknown database

Warning: mysqli_select_db(): Couldn't fetch result in /var/www/index.php on line 10

原因分析:

〔错误4〕Client does not support authentication protocol

Warning: mysqli_connect(): The server requested authentication method unknown to the client [caching_sha2_password]

原因分析:

MySQL 8.0默认使用caching_sha2_password认证插件,而旧版PHP客户端不支持。

解决方案:

-- 方案1:修改用户认证方式
ALTER USER 'webapp'@'localhost' IDENTIFIED WITH mysql_native_password BY 'SecurePass2026!';
-- 方案2:升级PHP(7.4+已支持)
-- 方案3:在my.cnf中全局设置
[mysqld]
default_authentication_plugin=mysql_native_password

〔错误5〕SSL连接失败

Warning: mysqli_real_connect(): SSL connection error: error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure

解决方案:

〔错误6〕Too many connections

Warning: mysqli_connect(): (HY000/1040): Too many connections

原因分析:

解决方案:

-- 临时调高限制(重启后失效)
SET GLOBAL max_connections = 500;
-- 永久修改(my.cnf)
[mysqld]
max_connections = 500

〔错误7〕MySQL server has gone away

原因分析:

解决方案:

ini_set('mysqli.allow_persistent', 'Off'); // 禁用持久连接
ini_set('default_socket_timeout', 60);    // 设置超时

〔错误8〕Character set 'utf8mb4' is not supported

原因分析:

解决方案:

-- 检查支持的字符集
SHOW CHARACTER SET LIKE 'utf8mb4';
-- 升级MySQL或使用utf8(不推荐)
SET NAMES utf8;

〔错误9〕Undefined variable / Notice: Trying to get property of non-object

原因分析:

解决方案:

$result = $mysqli->query("SELECT * FROM users WHERE id = 999");
if (!$result) {
    error_log("Query failed: " . $mysqli->error);
    die("查询失败");
}
if ($result->num_rows > 0) {
    $row = $result->fetch_assoc();
    echo $row['name'];
} else {
    echo "未找到用户";
}

〔错误10〕Headers already sent

原因分析:

连接错误后输出内容导致header已发送,无法设置session或重定向。

解决方案:

五、php连接mysql数据库的安全最佳实践

数据库连接安全是Web应用安全的基石。本节涵盖防SQL注入、权限最小化、连接加密等关键措施。

〔核心原则〕最小权限原则

〔防注入〕预处理语句(Prepared Statements)

// ❌ 危险写法(字符串拼接)
$sql = "SELECT * FROM users WHERE email = '" . $_GET['email'] . "'";
$mysqli->query($sql); // 可能被注入:email=' OR '1'='1
// ✅ 安全写法(预处理)
$stmt = $mysqli->prepare("SELECT id, name FROM users WHERE email = ?");
$stmt->bind_param("s", $_GET['email']);
$stmt->execute();
$result = $stmt->get_result();

〔配置安全〕环境变量管理

// .env 文件(需加入.gitignore)
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=webapp
DB_PASS=SecurePass2026!
DB_NAME=php_mysqli_demo
// config.php
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();
$db_host = $_ENV['DB_HOST'];

部署时通过CI/CD注入环境变量,避免敏感信息写入代码库。

〔连接加密〕启用SSL/TLS

生产环境必须启用SSL连接,防止中间人攻击:

$mysqli = new mysqli();
$mysqli->ssl_set(
    '/etc/ssl/client-key.pem',
    '/etc/ssl/client-cert.pem',
    '/etc/ssl/ca-cert.pem',
    null,
    MYSQLI_CLIENT_SSL
);
$mysqli->real_connect('db.example.com', 'webapp', 'pass', 'appdb');

〔审计追踪〕记录连接日志

register_shutdown_function(function() use ($mysqli) {
    if ($mysqli && $mysqli->ping()) {
        $log = [
            'time' => date('Y-m-d H:i:s'),
            'host' => $_SERVER['REMOTE_ADDR'],
            'user' => 'webapp',
            'action' => 'db_close'
        ];
        error_log(json_encode($log));
    }
});

〔防爆破〕连接频率限制

在应用层限制数据库连接尝试频率:

function rate_limit_db($key, $max_attempts = 5, $window = 300) {
    $cache_key = 'db_conn_attempts_' . $key;
    $attempts = apcu_fetch($cache_key);
    if ($attempts === false) {
        apcu_store($cache_key, 1, $window);
        return true;
    }
    if ($attempts >= $max_attempts) {
        throw new Exception("连接尝试过多,请5分钟后重试");
    }
    apcu_inc($cache_key);
    return true;
}
// 使用
rate_limit_db($_SERVER['REMOTE_ADDR']);
$mysqli = new mysqli(...);

六、php连接mysql数据库的性能优化方案

连接性能直接影响网站响应速度。本节从连接复用、查询优化、索引设计等维度提供实战方案。

〔方案1〕连接池(Connection Pooling)

使用Swoole或ReactPHP构建异步连接池:

// Swoole连接池示例
class MySQLPool {
    private $pool;
    private $config;
    public function __construct($config) {
        $this->config = $config;
        $this->pool = new SplQueue();
        for ($i = 0; $i < 10; $i++) {
            $this->pool->push($this->createConnection());
        }
    }
    private function createConnection() {
        return new mysqli(
            $this->config['host'],
            $this->config['username'],
            $this->config['password'],
            $this->config['database']
        );
    }
    public function getConnection() {
        if ($this->pool->isEmpty()) {
            return $this->createConnection();
        }
        return $this->pool->pop();
    }
    public function releaseConnection(mysqli $conn) {
        $conn->ping() && $this->pool->push($conn);
    }
}

〔方案2〕持久连接(Persistent Connection)

适用于低并发场景,需配合连接池管理:

$options = [
    PDO::ATTR_PERSISTENT => true,
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
];
$pdo = new PDO($dsn, $username, $password, $options);

注意:需配置pdo_mysql.default_socket避免socket冲突。

〔方案3〕查询缓存

function getCachedArticles() {
    $cache_key = 'articles_list_' . md5('published');
    $cache = new Redis();
    $cache->connect('127.0.0.1', 6379);
    if ($data = $cache->get($cache_key)) {
        return json_decode($data, true);
    }
    $pdo = new PDO(...);
    $stmt = $pdo->query("SELECT * FROM articles WHERE status='published'");
    $data = $stmt->fetchAll(PDO::FETCH_ASSOC);
    $cache->set($cache_key, json_encode($data), 3600);
    return $data;
}

〔方案4〕慢查询日志分析

-- 开启慢查询日志
SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 1;
SET GLOBAL slow_query_log_file = '/var/log/mysql/slow.log';
-- 分析工具:mysqldumpslow
mysqldumpslow -s c -t 10 /var/log/mysql/slow.log

〔方案5〕连接参数优化

⏱️ 连接超时设置

  • connect_timeout:连接超时(默认10秒)
  • wait_timeout:空闲超时(建议300秒)
  • interactive_timeout:交互超时

🛡️ 安全选项

  • MYSQLI_CLIENT_SSL:启用SSL
  • MYSQLI_CLIENT_FOUND_ROWS:返回匹配行数而非影响行数

〔方案6〕连接监控与告警

// 监控连接数
function checkDbConnections() {
    $pdo = new PDO(...);
    $stmt = $pdo->query("SHOW PROCESSLIST");
    $connections = $stmt->fetchAll();
    $active = count(array_filter($connections, function($row) {
        return $row['State'] !== 'Sleep';
    }));
    if ($active > 100) {
        error_log("⚠️ 连接数异常:" . $active);
        // 触发告警:钉钉/企业微信
    }
}