PHP - Manual: mysqli::real_connect

2025-10-24

mysqli::real_escape_string »

« mysqli::query

mysqli::real_connect

mysqli_real_connect

(PHP 5, PHP 7, PHP 8)

mysqli::real_connect -- mysqli_real_connect — 建立一个 MySQL 服务器连接

说明

面向对象风格

public mysqli::real_connect(
    ?string $hostname = null,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?string $database = null,
    ?int $port = null,
    ?string $socket = null,
    int $flags = 0
): bool

过程化风格

mysqli_real_connect(
    mysqli $mysql,
    ?string $hostname = null,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?string $database = null,
    ?int $port = null,
    ?string $socket = null,
    int $flags = 0
): bool

建立一个到 MySQL 服务器的链接。

与 mysqli_connect() 的不同点：

mysqli_real_connect() 需要一个由 mysqli_init() 创建的有效对象。
可以使用 mysqli_options() 设置各种连接设置。
提供 flags 参数。

参数

mysql

仅以过程化样式：由 mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象。

hostname

可以使用域名、IP 地址。如果传递 null，值将从 mysqli.default_host 中检索。如果可能，将使用管道代替 TCP/IP 协议。如果同时提供主机名和端口号，则使用 TCP/IP 协议，例如 localhost:3308。

username

MySQL 登录用户名，为 null 时则假设是基于 mysqli.default_user ini 选项的用户名。

password

MySQL 密码，为 null 时则假设是基于 mysqli.default_pw ini 选项的密码。

database

执行查询语句的默认数据库或为 null。

port

MySQL 服务器的端口，为 null 时则假设是基于 mysqli.default_port ini 选项的端口。

socket

指定使用的 socket 或者命名通道，为 null 时则假设是基于 mysqli.default_socket ini 选项的套接字。

注意:
指定 socket 参数并不能说明要采用何种方式连接数据库。连接数据的方式由 hostname 设定。

flags

这里可以设置连接参数：

**Supported flags**
Name	Description
`MYSQLI_CLIENT_COMPRESS`	使用压缩协议
`MYSQLI_CLIENT_FOUND_ROWS`	返回语句匹配的行数，而不是影响的行数
`MYSQLI_CLIENT_IGNORE_SPACE`	允许函数名称后有空格，这将使所有的函数名称成为保留字。
`MYSQLI_CLIENT_INTERACTIVE`	在关闭连接之前允许等待 `interactive_timeout` 秒，他替代 `wait_timeout` 设定。
`MYSQLI_CLIENT_SSL`	使用 SSL 加密
`MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT`	跟 `MYSQLI_CLIENT_SSL` 类似，但禁用对提供的 SSL 证书的验证。这仅适用于使用 MySQL Native Driver 和 MySQL 5.6 及其后续版本的安装。

注意:
从安全角度考虑，在 PHP 中不可以使用 MULTI_STATEMENT，若要执行多查询语句，请使用 mysqli_multi_query()。

返回值

成功时返回 true，或者在失败时返回 false。

错误／异常

If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR) and the requested operation fails, a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT, a mysqli_sql_exception is thrown instead.

更新日志

版本	说明
7.4.0	所有的参数都可为 null。

示例

示例 #1 mysqli::real_connect() 示例

面向对象风格

<?php

$mysqli = mysqli_init();
if (!$mysqli) {
    die('mysqli_init failed');
}

if (!$mysqli->options(MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0')) {
    die('Setting MYSQLI_INIT_COMMAND failed');
}

if (!$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5)) {
    die('Setting MYSQLI_OPT_CONNECT_TIMEOUT failed');
}

if (!$mysqli->real_connect('localhost', 'my_user', 'my_password', 'my_db')) {
    die('Connect Error (' . mysqli_connect_errno() . ') '
. mysqli_connect_error());
}

echo 'Success... ' . $mysqli->host_info . "\n";

$mysqli->close();
?>

面向对象风格 when extending mysqli class

<?php

class foo_mysqli extends mysqli {
    public function __construct($host, $user, $pass, $db) {
parent::__construct();

        if (!parent::options(MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0')) {
            die('Setting MYSQLI_INIT_COMMAND failed');
        }

        if (!parent::options(MYSQLI_OPT_CONNECT_TIMEOUT, 5)) {
            die('Setting MYSQLI_OPT_CONNECT_TIMEOUT failed');
        }

        if (!parent::real_connect($host, $user, $pass, $db)) {
            die('Connect Error (' . mysqli_connect_errno() . ') '
. mysqli_connect_error());
        }
    }
}

$db = new foo_mysqli('localhost', 'my_user', 'my_password', 'my_db');

echo 'Success... ' . $db->host_info . "\n";

$db->close();
?>

过程化风格

<?php

$link = mysqli_init();
if (!$link) {
    die('mysqli_init failed');
}

if (!mysqli_options($link, MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0')) {
    die('Setting MYSQLI_INIT_COMMAND failed');
}

if (!mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5)) {
    die('Setting MYSQLI_OPT_CONNECT_TIMEOUT failed');
}

if (!mysqli_real_connect($link, 'localhost', 'my_user', 'my_password', 'my_db')) {
    die('Connect Error (' . mysqli_connect_errno() . ') '
. mysqli_connect_error());
}

echo 'Success... ' . mysqli_get_host_info($link) . "\n";

mysqli_close($link);
?>

以上示例会输出：

Success... MySQL host info: localhost via TCP/IP

注释

注意:
MySQLnd 总是使用服务器的默认字符集。此字符集在连接握手／认证时发送，并被 mysqlnd 使用。
Libmysqlclient 使用 my.cnf 中的默认字符集或者由在调用 mysqli_init() 之后，mysqli_real_connect() 之前先调用 mysqli_options() 来指定。

参见

mysqli_connect() - 别名 mysqli::__construct
mysqli_init() - 初始化 MySQLi 并返回用于 mysqli_real_connect() 的对象
mysqli_options() - 设置选项
mysqli_ssl_set() - 用于使用 SSL 建立安全连接
mysqli_close() - 关闭先前打开的数据库连接

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注

此页面尚无用户贡献的备注。

官方地址：https://www.php.net/manual/en/mysqli.real-connect.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言开发编程 Linux 科技 Elasticsearch HTML/CSS/XML 面试数据库网络 JAVA NoSQL C/C++ Golang 操作系统 Git 算法正则表达式 Redis 互联网 MySql 软件运维 JavaScript 国际架构设计 Mac OS Excel TCP/IP Windows Oracle Socket Vim VR 运营 MongoDB Python MemCache 商业硬件电子娱乐设计摄影 nginx WordPress 游戏 HTTP 团建数码电器 Docker

php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象常用的php ADODB使用方法集锦 ADOConnection 公用函数利用php soap实现web service adodb连接mysql多个数据库的问题 opcache预加载 php $_SERVER中的SERVER_NAME 和HTTP_HOST的区别 php扩展开发 PHPstorm 里面Terminal 不能使用 esc键吗退出编辑模式吗 mysql面试题

略微加速

PHP官方手册 - 互联网笔记