Forum und email
mysqli
PHP Manual

mysqli_real_connect

mysqli->real_connect

(PHP 5)

mysqli->real_connect — Abre una conexión a un servidor de MySQL

Descripción

Estilo por procedimientos

bool mysqli_real_connect ( mysqli $link [, cadena $equipo_huésped [, cadena $usuario [, cadena $contraseña [, cadena $nombre_de_bd [, int $puerto [, cadena $socket [, int $banderas ]]]]]]] )

Estilo orientado a objetos (método)

mysqli
bool real_connect ([ cadena $equipo_huésped [, cadena $usuario [, cadena $contraseña [, cadena $nombre_de_bd [, int $puerto [, cadena $socket [, int $banderas ]]]]]]] )

mysqli_real_connect() Intenta establecer una conexión con un equipo que tiene ejecutando un servidor de MySQL representado por el parámetro equipo_huésped .

Esta función es diferente de mysqli_connect() en lo siguiente:

  • mysqli_real_connect() necesita un objeto valido el cual tiene que ser creado por la función mysqli_init()

  • Con la función mysqli_options() tu puedes fijar varias opciones por conexión.

  • Con el parámetro banderas tu puedes fijar diferentes opciones de la conexión:

    Banderas soportadas
    Nombre Descripción
    MYSQLI_CLIENT_COMPRESS Usa el protocolo de compresión
    MYSQLI_CLIENT_FOUND_ROWS Regresa el número de filas encontradas, no el número de filas afectadas
    MYSQLI_CLIENT_IGNORE_SPACE Permite espacios despues de los nombres de las funciones. Hace palabras reservadas los nombres de las funciones.
    MYSQLI_CLIENT_INTERACTIVE Permite los segundos interactive_timeout (en vez de wait_timeout) de inactividad antes de cerrar la conexión
    MYSQLI_CLIENT_SSL Usa SSL (encriptación)

    Note: Por razones de seguridad la bandera MULTI_STATEMENT no es permitida en PHP. Si quiere ejecutar consultas múltiples use la función mysqli_multi_query().

Valores retornados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ver también

mysqli_connect(), mysqli_init(), mysqli_options(), mysqli_ssl_set(), y mysqli_close().

Ejemplos

Example#1 Estilo orientado a objetos

<?php

/* create a connection object which is not connected */
$mysqli = mysqli_init();

/* set connection options */
$mysqli->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();
?>

Example#2 Estilo por procedimientos

<?php

/* create a connection object which is not connected */
$link = mysqli_init();

/* set connection options */
mysqli_options($link, MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);

/* connect to server */
mysqli_real_connect($link, '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_get_host_info($link));

mysqli_close($link);
?>

El resultado del ejemplo seria:

Connection: Localhost via UNIX socket
mysqli
PHP Manual