mysqli_real_connect
mysqli->real_connect
Opens a connection to a mysql server
Description
Procedural style
boolmysqli_real_connect
objectlink
stringhostname
stringusername
stringpasswd
stringdbname
intport
stringsocket
intflags
Object oriented style (method)
mysqli
bool
real_connect
stringhostname
stringusername
stringpasswd
stringdbname
intport
stringsocket
intflags
mysqli_real_connect attempts to establish a
connection to a MySQL database engine running on
hostname.
This function differs from mysqli_connect:
mysqli_real_connect needs a valid object which has
to be created by function mysqli_init
With function mysqli_options you can set various options for connection.
With the parameter flags you can set different connection options:
Supported flags
Name
Description
MYSQLI_CLIENT_COMPRESS
Use compression protocol
MYSQLI_CLIENT_FOUND_ROWS
return number of matched rows, not the number of affected rows
MYSQLI_CLIENT_IGNORE_SPACE
Allow spaces after function names. Makes all function names reserved words.
MYSQLI_CLIENT_INTERACTIVE
Allow interactive_timeout seconds (instead of
wait_timeout seconds) of inactivity before closing the connection
MYSQLI_CLIENT_SSL
Use SSL (encryption)
For security reasons the MULTI_STATEMENT flag is not supported in
PHP. If you want to execute multiple queries use the
mysqli_multi_query function.
&reftitle.returnvalues;
&return.success;
&reftitle.seealso;
mysqli_connect,
mysqli_init,
mysqli_options,
mysqli_ssl_set,
mysqli_close.
Example
Object oriented style
options(MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* connect to server */
$mysqli->real_connect('localhost', 'my_user', 'my_password', 'world');
/* check connection */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
printf ("Connection: %s\n.", $mysqli->host_info);
$mysqli->close();
?>
]]>
Procedural style
]]>
The above examples would produce the following output: