mysqli_connect

(PHP 5)

mysqli_connect

(no version information, might be only in CVS)

mysqli() -- Abre una nueva conexión al servidor MySQL

Descripción

Estilo por procedimientos

mysqli mysqli_connect ( [cadena equipo_anfitrión [, cadena usuario [, cadena contraseña [, cadena base_de_datos [, int puerto [, cadena socket]]]]]] )

Estilo orientado a objetos (constructor):

class mysqli {

__construct ( [cadena equipo_anfitrión [, cadena usuario [, cadena contraseña [, cadena base_de_datos [, int puerto [, cadena socket]]]]]] )

}

La función mysqli_connect() intenta abrir una conexión al servidor MySQL que se está ejecutando en equipo_afitrión el cual puede ser el nombre de un equipo o una dirección IP. Pasando el valor NULL o la cadena "localhost" a este parámetro, se asume que está en el mismo equipo. Cuando sea posible se usarán "pipes" en vez del protocolo TCP/IP. En caso exitoso, la función mysqli_connect() regresará un objeto representando la conexión a la base de datos, o FALSE en caso contrario.

En los parámetros usuario y contraseña se específica el nombre de usuario y contraseña con los cuales se debe conectar al servidor MySQL. Si no se da contraseña el valor NULL es tomado, el servidor MySQL intentará verificar al usuario contra los registros de usuarios que esten sin contraseña. Esto permite que un usuario pueda ser usado con diferentes permisos (dependiendo si se provee contraseña o no).

Si se específica el parámetro base_de_datos especificará la base de datos a usar por defecto cuando se ejecuten consultas.

Los parámetros puerto y socket son usados junto con el parámetro equipo_anfitrión para controla a futuro como conectar al servidor de base de datos. El parámetro puerto específica el número de puerto al que se intenta conectar en el servidor MySQL, mientras que el parámetro socket específica el socket o la pipa nombrada "pipe" que debe ser usada.

Nota: Especificar el parámetro socket no determina explícitamente el tipo de conexión a ser usado cuando se conecta al servidor MySQL. El parámetro equipo_anfitrión determina como se hace la conexión a la base de datos MySQL.

Valores retornados

Regresa un objeto el cuál representa la conexión al servidor MySQL o FALSE en caso contrario.

Ejemplos

Ejemplo 1. Estilo orientado a objetos

<?php
$mysqli
= new mysqli("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

printf("Host information: %s\n", $mysqli->host_info);

/* close connection */
$mysqli->close();
?>

Ejemplo 2. Estilo por procedimientos

<?php
$link
= mysqli_connect("localhost", "my_user", "my_password", "world");

/* check connection */
if (!$link) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

printf("Host information: %s\n", mysqli_get_host_info($link));

/* close connection */
mysqli_close($link);
?>

El resultado del ejemplo seria:

Host information: Localhost via UNIX socket

Hosting by: hurra.com
Generated: 2007-01-26 18:01:02