PHP mysqli_connect() 函数（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 PHP 开发中，与数据库的交互是构建动态 Web 应用的核心环节。而 mysqli_connect() 函数作为 PHP 连接 MySQL 数据库的基石，是开发者必须掌握的关键技能之一。无论是搭建个人博客、电商平台，还是处理复杂的数据管理系统，理解这一函数的用法与原理，都能为后续开发打下坚实的基础。本文将从基础概念、参数详解、实际案例到高级技巧，系统性地解析 PHP mysqli_connect() 函数的使用方法，并通过形象比喻与代码示例，帮助读者快速上手并深入理解其实现逻辑。

一、什么是 mysqli_connect() 函数？

mysqli_connect() 是 PHP 中用于建立与 MySQL 数据库连接的核心函数。它类似于早期的 mysql_connect()，但功能更强大且支持更多特性（如预处理语句、事务处理等）。可以将其想象为一座桥梁：这座桥梁的两端分别是 PHP 程序与 MySQL 数据库，而 mysqli_connect() 就是建造这座桥梁的“工程师”。只有这座桥梁成功建立后，我们才能通过它向数据库发送查询请求并获取数据。

函数原型：

mysqli_connect(string $host, string $username, string $password, string $database = "", int $port = 3306, string $socket = "")  

核心参数说明：
| 参数名 | 作用描述 | 必填性 | 默认值 |
|--------------|---------------------------------------|--------|-------------|
| $host | 数据库服务器地址（如 "localhost"） | 是 | 无 |
| $username | 数据库用户名 | 是 | 无 |
| $password | 数据库密码 | 是 | 无 |
| $database | 需要连接的数据库名称 | 否 | 空字符串 |
| $port | 数据库服务器端口 | 否 | 3306 |
| $socket | Unix 域套接字路径 | 否 | 空字符串 |

二、基础用法：如何连接数据库？

1. 最简连接示例

假设我们的 MySQL 服务器位于本地，用户名为 "root"，密码为空，且需要连接到名为 "mydb" 的数据库，可以这样写代码：

<?php  
// 创建连接  
$conn = mysqli_connect("localhost", "root", "", "mydb");  

// 检查连接是否成功  
if ($conn->connect_error) {  
    die("连接失败: " . $conn->connect_error);  
}  
echo "成功连接到数据库！";  
?>  

关键点解释：

• $conn 是一个 mysqli 对象，它保存了连接的所有信息，后续操作（如查询、关闭连接）都需要通过它进行。
• connect_error 是 mysqli 对象的属性，用于检测连接是否失败。如果失败，connect_error 会返回具体的错误信息。

2. 逐步拆解参数

• $host：通常为 "localhost"（本地服务器），但如果是远程数据库，需填写服务器 IP 或域名。
• $username 和 $password：建议使用独立账号而非 root，以提升安全性。
• $database：可选参数。如果省略，需在后续查询时指定数据库名，例如 USE mydb。
• $port：MySQL 默认端口是 3306，若修改过端口需在此处指定。

三、错误处理：如何避免连接失败？

1. 常见连接失败原因与解决方案

2. 改进后的连接代码（增强错误处理）

<?php  
// 定义连接参数  
$host = "localhost";  
$user = "root";  
$pass = "";  
$dbname = "mydb";  

// 尝试连接  
$conn = mysqli_connect($host, $user, $pass);  

if ($conn) {  
    // 连接成功后选择数据库  
    if (mysqli_select_db($conn, $dbname)) {  
        echo "数据库连接成功！";  
    } else {  
        echo "选择数据库失败: " . mysqli_error($conn);  
    }  
} else {  
    echo "连接服务器失败: " . mysqli_connect_error();  
}  
?>  

改进点：

• 将连接服务器和选择数据库分开操作，便于精准定位错误。
• 使用 mysqli_error() 和 mysqli_connect_error() 获取具体错误信息。

四、进阶技巧：让代码更健壮

1. 使用配置文件管理敏感信息

将数据库连接参数集中存储在单独的配置文件中，避免代码中硬编码敏感数据：

// config.php  
<?php  
return [  
    "host" => "localhost",  
    "user" => "app_user",  
    "pass" => "secure_password",  
    "db"   => "mydb"  
];  

// index.php  
<?php  
require "config.php";  
$config = include "config.php";  

$conn = mysqli_connect(  
    $config["host"],  
    $config["user"],  
    $config["pass"],  
    $config["db"]  
);  
// 后续操作...  

2. 预处理语句与 SQL 注入防范

直接拼接 SQL 语句（如 mysqli_query("SELECT * FROM users WHERE id=$_GET['id']")）存在 SQL 注入风险。应改用预处理语句：

// 安全的查询示例  
$stmt = $conn->prepare("SELECT username FROM users WHERE id = ?");  
$stmt->bind_param("i", $id); // "i" 表示整数类型  
$id = $_GET["id"];  
$stmt->execute();  
$result = $stmt->get_result();  

比喻：预处理语句如同快递包裹的安检流程，它将数据与 SQL 语句的结构分开处理，确保“包裹”内容不会破坏“运输通道”。

五、实际案例：构建用户注册功能

1. 需求与设计

• 用户提交注册表单，包含用户名、邮箱、密码。
• 需要验证邮箱唯一性，并将数据存入数据库。

2. 完整代码示例

<?php  
// 配置连接  
$conn = mysqli_connect("localhost", "root", "", "user_system");  

// 处理表单提交  
if ($_SERVER["REQUEST_METHOD"] === "POST") {  
    $username = $_POST["username"];  
    $email = $_POST["email"];  
    $password = password_hash($_POST["password"], PASSWORD_DEFAULT);  

    // 检查邮箱是否已存在  
    $check_query = "SELECT id FROM users WHERE email = ?";  
    $stmt = $conn->prepare($check_query);  
    $stmt->bind_param("s", $email);  
    $stmt->execute();  
    $result = $stmt->get_result();  

    if ($result->num_rows > 0) {  
        echo "该邮箱已被注册！";  
    } else {  
        // 插入新用户  
        $insert_query = "INSERT INTO users (username, email, password) VALUES (?, ?, ?)";  
        $stmt_insert = $conn->prepare($insert_query);  
        $stmt_insert->bind_param("sss", $username, $email, $password);  
        if ($stmt_insert->execute()) {  
            echo "注册成功！";  
        } else {  
            echo "插入数据失败: " . $conn->error;  
        }  
    }  
    $stmt->close();  
    $stmt_insert->close();  
}  
?>  

<!-- HTML 表单 -->  
<form method="post">  
    用户名：<input type="text" name="username" required><br>  
    邮箱：<input type="email" name="email" required><br>  
    密码：<input type="password" name="password" required><br>  
    <button type="submit">注册</button>  
</form>  

3. 代码亮点解析

• 密码加密：使用 password_hash() 函数对密码进行哈希处理，避免明文存储。
• 事务管理：通过 bind_param 和 execute 分离 SQL 语句与数据，防止注入攻击。
• 错误反馈：在插入失败时，直接输出数据库错误信息以便调试。

六、最佳实践总结

1. 连接参数分离：将敏感信息存储在配置文件中，并通过 require 引入。
2. 错误处理分层：区分服务器连接与数据库选择的不同错误场景，针对性处理。
3. 预处理语句优先：始终使用 prepare() 和 bind_param() 替代直接拼接 SQL。
4. 资源释放：在操作完成后，调用 close() 显式关闭连接，释放服务器资源。

结论

PHP mysqli_connect() 函数是开发者通往数据库世界的通行证，其掌握程度直接影响项目的安全性与可靠性。通过本文的逐步解析，读者应能理解其核心原理、参数含义，并通过实际案例掌握从基础连接到高级安全防护的完整流程。在后续开发中，建议持续关注 MySQL 的新特性（如 MySQLi 的异步连接、SSL 加密等），以进一步提升代码的健壮性和性能。

提示：若遇到连接问题，可通过 mysqli_debug() 启用调试模式，或在服务器日志中查找 MySQL 的具体报错信息。