


BUSCARDOR

mysqli_real_connect

Manual de PHP
Anterior		Siguiente

mysqli_real_connect

(PHP 5)

mysqli_real_connect

(no version information, might be only in CVS)

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)

class 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:

Tabla 1. 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)

Nota: 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

Ejemplo 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();
?>

Ejemplo 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

Anterior	Inicio	Siguiente
mysqli_query	Subir	mysqli_real_escape_string