# PHP mysqli_real_connect() 函数
[![PHP MySQLi 参考手册](/images/up.gif) PHP MySQLi 参考手册](php-ref-mysqli.html)
## 实例
打开一个到 MySQL 服务器的新连接:
$con=mysqli_init();
if (!$con)
{
die("mysqli_init failed");
}
if (!mysqli_real_connect($con,"localhost","my_user","my_password","my_db"))
{
die("Connect Error: " . mysqli_connect_error());
}
mysqli_close($con);
---
## 定义和用法
mysqli_real_connect() 函数打开一个到 MySQL 服务器的新连接。
mysqli_real_connect() 函数与 [mysqli_connect()](func-mysqli-connect.html) 函数在以下几个方面存在差异:
- mysqli_real_connect() 要求一个由 [mysqli_init()](func-mysqli-init.html) 创建的有效的对象。
- mysqli_real_connect() 可以与 mysqli_options() 一同使用来设置连接的不同选项。
- mysqli_real_connect() 有一个 flag 参数。
---
## 语法
mysqli_real_connect(*connection,host,username,password,dbname,port,socket,flag*)*;*
| 参数 | 描述 |
|---|---|
| *connection* | 必需。规定要使用的 MySQL 连接。 |
| *host* | 可选。规定主机名或 IP 地址。 |
| *username* | 可选。规定 MySQL 用户名。 |
| *password* | 可选。规定 MySQL 密码。 |
| *dbname* | 可选。规定要使用的默认数据库。 |
| *port* | 可选。规定尝试连接到 MySQL 服务器的端口号。 |
| *socket* | 可选。规定 socket 或要使用的已命名 pipe。 |
| *flag* | 可选。规定不同的连接选项。可能的值: - MYSQLI_CLIENT_COMPRESS - 使用压缩协议 - MYSQLI_CLIENT_FOUND_ROWS - 返回匹配的行数(不是受影响的行数) - MYSQLI_CLIENT_IGNORE_SPACE - 在函数名后允许空格,使函数名保留字 - MYSQLI_CLIENT_INTERACTIVE - 在关闭连接之前允许不活动的 interactive_timeout 秒 - MYSQLI_CLIENT_SSL - 使用 SSL 加密 |
## 技术细节
| 返回值: | 如果成功则返回 TRUE,如果失败则返回 FALSE。 |
|:--|---|
| PHP 版本: | 5+ |
---
[![PHP MySQLi 参考手册](/images/up.gif) PHP MySQLi 参考手册](php-ref-mysqli.html)