一、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,
]
];
〔注意〕常见误区
- 在生产环境硬编码密码 → 应从环境变量或配置中心读取
- 未设置字符集导致中文乱码 → 必须显式调用
SET NAMES 'utf8mb4'或使用charset参数 - 连接失败后无日志 → 应记录
error_log()并返回用户友好提示 - 频繁创建连接 → 应启用持久连接或连接池(见性能优化章节)
二、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
原因分析:
- MySQL服务未启动:
systemctl status mysql - 端口被防火墙拦截:
ufw allow 3306 - 绑定地址限制:
bind-address = 127.0.0.1(需改为0.0.0.0或注释) - 容器网络问题:Docker中需用服务名而非localhost
解决方案:
在容器环境中,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)
原因分析:
- 密码错误(注意大小写与特殊字符转义)
- 用户权限不足:
SELECT User, Host FROM mysql.user; - 用户不存在:
CREATE USER 'webapp'@'localhost' IDENTIFIED BY 'xxx'; - 主机名不匹配(如使用'webapp'@'%'但连接来自192.168.1.100)
解决方案:
-- 授予远程访问权限
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
原因分析:
- 数据库名拼写错误
- 数据库未创建:
CREATE DATABASE php_mysqli_demo; - 权限未授权到该库:
GRANT ALL ON php_mysqli_demo.* TO 'webapp'@'localhost';
〔错误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
解决方案:
- 禁用SSL(仅测试环境):
mysqli_real_connect($conn, $host, $user, $pass, $db, $port, '', MYSQLI_CLIENT_SSL_DONT_CHECK_SERVER_CERT) - 提供证书:
mysqli_options($conn, MYSQLI_SSL_KEY, '/path/to/client-key.pem'); - 云数据库:使用其提供的SSL证书包
〔错误6〕Too many connections
Warning: mysqli_connect(): (HY000/1040): Too many connections
原因分析:
- 连接数超过
max_connections限制(默认151) - 未及时关闭连接(忘记
close()) - 应用层未复用连接(每次请求新建连接)
解决方案:
-- 临时调高限制(重启后失效)
SET GLOBAL max_connections = 500;
-- 永久修改(my.cnf)
[mysqld]
max_connections = 500
〔错误7〕MySQL server has gone away
原因分析:
- 超时断开:
wait_timeout(默认28800秒) - 包过大:
max_allowed_packet(默认4MB) - 持久连接中残留事务状态
解决方案:
ini_set('mysqli.allow_persistent', 'Off'); // 禁用持久连接
ini_set('default_socket_timeout', 60); // 设置超时
〔错误8〕Character set 'utf8mb4' is not supported
原因分析:
- MySQL版本过低(<5.5.3)
- 未安装utf8mb4支持
解决方案:
-- 检查支持的字符集
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或重定向。
解决方案:
- 在连接前启用
output_buffering = On - 使用
error_log()而非echo记录错误 - 在连接失败时立即
exit或http_response_code(503)
五、php连接mysql数据库的安全最佳实践
数据库连接安全是Web应用安全的基石。本节涵盖防SQL注入、权限最小化、连接加密等关键措施。
〔核心原则〕最小权限原则
- 禁止使用root账户连接应用数据库
- 为不同应用创建独立账号(如
blog_app、api_service) - 仅授予必要权限:
GRANT SELECT, INSERT, UPDATE ON app_db.* TO 'app_user'@'localhost'; - 禁用危险权限:
GRANT ALL PRIVILEGES→ 仅保留所需权限
〔防注入〕预处理语句(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:启用SSLMYSQLI_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);
// 触发告警:钉钉/企业微信
}
}