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