[函数]mysqli::real_connect()函数—用法及示例

函数：mysqli::real_connect()

适用版本：PHP 5, PHP 7

用法：

mysqli::real_connect() 函数用于与数据库建立持久连接，并返回一个表示连接状态的布尔值。它是mysqli类的一个方法，用于连接到MySQL数据库服务器。

语法：

bool mysqli::real_connect(
   [string $host = ini_get("mysqli.default_host")],
   [string $username = ini_get("mysqli.default_user")],
   [string $passwd = ini_get("mysqli.default_pw")],
   [string $dbname = ""],
   [int $port = ini_get("mysqli.default_port")],
   [string $socket = ini_get("mysqli.default_socket")]
)

参数：

• $host（可选）：数据库主机名，默认为 PHP 配置文件中 mysqli.default_host 的值。
• $username（可选）：连接数据库的用户名，默认为 PHP 配置文件中 mysqli.default_user 的值。
• $passwd（可选）：连接数据库的密码，默认为 PHP 配置文件中 mysqli.default_pw 的值。
• $dbname（可选）：要连接的数据库名，默认为空。
• $port（可选）：数据库端口号，默认为 PHP 配置文件中 mysqli.default_port 的值。
• $socket（可选）：数据库套接字，默认为 PHP 配置文件中 mysqli.default_socket 的值。

返回值：

• 成功时返回 true，表示连接已建立。
• 失败时返回 false，并在出错时生成一个警告。可以通过调用 mysqli_connect_error() 函数获取详细错误信息。

示例：

<?php
$mysqli = new mysqli("localhost", "username", "password", "mydatabase");

if ($mysqli->real_connect()) {
   echo "连接成功！";
} else {
   echo "连接失败：" . $mysqli->connect_error;
}

$mysqli->close();
?>

以上示例中，我们首先创建了一个 mysqli 对象，然后使用 real_connect() 方法尝试连接到名为 "mydatabase" 的数据库。如果连接成功，则输出 "连接成功！"；如果连接失败，则输出连接错误信息。最后，我们使用 close() 方法关闭数据库连接。

请注意，示例中的用户名和密码应替换为实际的数据库用户名和密码，并确保数据库服务器正常运行并且具有正确的连接参数。