mysqli::real_connect

mysqli::real_connect

mysqli_real_connect

Establece una conexión con un servidor MySQL

Descripción#

Estilo orientado a objetos

public #[\SensitiveParameter] mysqli::real_connect([string $hostname], [string $username], [string $password], [string $database], [int $port], [string $socket], [int $flags]): bool
```php

Estilo procedimental

```php
#[\SensitiveParameter] mysqli_real_connect(mysqli $mysql, [string $hostname], [string $username], [string $password], [string $database], [int $port], [string $socket], [int $flags]): bool

Abre una conexión al servidor de base de datos MySQL con opciones de conexión opcionales.

Esta función difiere de mysqli_connect:

• mysqli_real_connect requiere un objeto válido que debe ser creado por mysqli_init.

• Existe un parámetro adicional flags.

Parámetros#

mysql
Solo estilo procedimental: Un objeto mysqli devuelto por mysqli_connect o mysqli_init

hostname
Puede ser un nombre de host o una dirección IP. Al pasar null, el valor se recupera desde mysqli.default_host. Si es posible, se utilizarán pipes en lugar del protocolo TCP/IP. El protocolo TCP/IP se utiliza si se proporciona un nombre de host y un número de puerto juntos, por ejemplo localhost:3308.

username
El nombre de usuario MySQL o null para asumir el nombre de usuario según la opción ini mysqli.default_user.

password
La contraseña MySQL o null para asumir la contraseña según la opción ini mysqli.default_pw.

database
La base de datos por defecto a utilizar al ejecutar consultas o null.

port
El número de puerto al que intentar conectarse al servidor MySQL o null para asumir el puerto según la opción ini mysqli.default_port.

socket
El socket o el pipe nombrado que debería utilizarse, o null para asumir el socket según la opción ini mysqli.default_socket.

[!NOTE] Especificar explícitamente el parámetro socket no determina el tipo de método utilizado al conectarse a MySQL. El método se determina por el parámetro hostname.

flags
Con el parámetro flags, se pueden configurar diferentes directivas de conexión:

Opciones soportadas {#mysqli.real-connect.flags}

[!NOTE] Por razones de seguridad, la opción MULTI_STATEMENT no es soportada en PHP. Si se desea ejecutar múltiples comandos, utilice la función mysqli_multi_query.

Valores devueltos#

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones#

Si el informe de errores de mysqli está habilitado (MYSQLI_REPORT_ERROR) y la operación solicitada falla, se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT, se lanza una mysqli_sql_exception en su lugar.

Historial de cambios#

Ejemplos#

Ejemplo con mysqli::real_connect

Estilo orientado a objetos

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = mysqli_init();

$mysqli->options(MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0');
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);

$mysqli->real_connect('localhost', 'my_user', 'my_password', 'my_db', null, null, MYSQLI_CLIENT_COMPRESS|MYSQLI_CLIENT_FOUND_ROWS);

echo 'Éxito... ' . $mysqli->host_info . "\n";

Estilo orientado a objetos, con extensión de la clase mysqli

<?php

class foo_mysqli extends mysqli {
    public function __construct($host, $user, $pass, $db)
    {
        parent::__construct();

        parent::options(MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0');
        parent::options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);

        parent::real_connect($host, $user, $pass, $db, null, null, MYSQLI_CLIENT_COMPRESS|MYSQLI_CLIENT_FOUND_ROWS);
    }
}

$db = new foo_mysqli('localhost', 'my_user', 'my_password', 'my_db');

echo 'Éxito... ' . $db->host_info . "\n";

Estilo procedimental

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_init();

mysqli_options($link, MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0');
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);

mysqli_real_connect($link, 'localhost', 'my_user', 'my_password', 'my_db', null, null, MYSQLI_CLIENT_COMPRESS|MYSQLI_CLIENT_FOUND_ROWS);

echo 'Éxito... ' . mysqli_get_host_info($link) . "\n";
?>

Los ejemplos anteriores mostrarán:

Éxito... MySQL host info: localhost via TCP/IP

Notas#

[!NOTE] MySQLnd siempre asume el juego de caracteres predeterminado del servidor. Este juego de caracteres es enviado durante el intercambio de conexión/autenticación, el cual mysqlnd utilizará.

Libmysqlclient utiliza el juego de caracteres predeterminado establecido en el my.cnf o mediante una llamada explícita a mysqli_options antes de llamar a mysqli_real_connect, pero después de mysqli_init.

Véase también#

mysqli_connect, mysqli_init, mysqli_options, mysqli_ssl_set, mysqli_close