array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'mysqli.real-connect.php', 1 => 'mysqli::real_connect', 2 => 'Ouvre une connexion à un serveur MySQL', ), 'up' => array ( 0 => 'class.mysqli.php', 1 => 'mysqli', ), 'prev' => array ( 0 => 'mysqli.query.php', 1 => 'mysqli::query', ), 'next' => array ( 0 => 'mysqli.real-escape-string.php', 1 => 'mysqli::real_escape_string', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mysqli/mysqli/real-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysqli::real_connect

mysqli_real_connect

(PHP 5, PHP 7, PHP 8)

mysqli::real_connect -- mysqli_real_connect — Ouvre une connexion à un serveur MySQL

Description

Style orienté objet

public mysqli::real_connect(
    ?string $hostname = null,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?string $database = null,
    ?int $port = null,
    ?string $socket = null,
    int $flags = 0
): bool

Style procédural

mysqli_real_connect(
    mysqli $mysql,
    ?string $hostname = null,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?string $database = null,
    ?int $port = null,
    ?string $socket = null,
    int $flags = 0
): bool

Ouvre une connexion au serveur de base de données MySQL avec des options de connexion optionnelles.

Cette fonction diffère de mysqli_connect() :

Liste de paramètres

mysql

Seulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou mysqli_init().

hostname

Peut-être un nom d'hôte ou une adresse IP. Lorsqu'on passe null, la valeur est récupérée depuis mysqli.default_host. Si possible, des pipes seront utilisés au lieu du protocole TCP/IP. Le protocole TCP/IP est utilisé si un nom d'hôte et un numéro de port sont fournis ensemble, par exemple localhost:3308.

username

Le nom d'utilisateur MySQL ou null pour supposer le nom d'utilisateur en fonction de l'option ini mysqli.default_user.

password

Le mot de passe MySQL ou null pour supposer le mot de passe en fonction de l'option ini mysqli.default_pw.

database

La base de données par défaut à utiliser lors de l'exécution de requêtes ou null.

port

Le numéro de port auquel tenter de se connecter au serveur MySQL ou null pour supposer le port en fonction de l'option ini mysqli.default_port.

socket

Le socket ou le pipe nommé qui devrait être utilisé, ou null pour supposer le socket en fonction de l'option ini mysqli.default_socket.

Note:

Spécifier explicitement le paramètre socket ne détermine pas le type de méthode utilisée lors de la connexion à MySQL. La méthode est déterminée par le paramètre hostname.

flags

Avec le paramètre flags, il est possible de configurer différentes directives de connexion :

Options supportées
Nom Description
MYSQLI_CLIENT_COMPRESS Utilise le protocole compressé
MYSQLI_CLIENT_FOUND_ROWS Retourne le nombre de lignes trouvées, pas le nombre de lignes affectées.
MYSQLI_CLIENT_IGNORE_SPACE Autorise les espaces entre les noms de fonctions et les arguments. Cela force les noms de fonctions à être des mots réservés.
MYSQLI_CLIENT_INTERACTIVE Autorise interactive_timeout secondes (au lieu de wait_timeout secondes) d'inactivité avant de fermer la connexion.
MYSQLI_CLIENT_SSL Utilise le chiffrement SSL
MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT Identique à MYSQLI_CLIENT_SSL, mais désactive la validation des certificats SSL fournis. Cette constante n'est prévue que pour les installations utilisant le driver MySQL natif et MySQL 5.6 ou supérieur.

Note:

Pour des raisons de sécurité, l'option MULTI_STATEMENT n'est pas supportée en PHP. Pour exécuter plusieurs commandes, utiliser la fonction mysqli_multi_query().

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Erreurs / Exceptions

Si le rapport d'erreurs mysqli est activé (MYSQLI_REPORT_ERROR) et que l'opération demandée échoue, un avertissement est généré. Si, en plus, le mode est défini sur MYSQLI_REPORT_STRICT, une mysqli_sql_exception est lancée à la place.

Historique

Version Description
7.4.0 Tous les paramètres sont désormais nullable.

Exemples

Exemple #1 Exemple avec mysqli::real_connect()

Style orienté objet

<?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 'Succès... ' . $mysqli->host_info . "\n";

Style orienté objet, avec extension de la classe 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 'Succès... ' . $db->host_info . "\n";

Style procédural

<?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 'Succès... ' . mysqli_get_host_info($link) . "\n";

Les exemples ci-dessus vont afficher :

Succès... MySQL host info: localhost via TCP/IP

Notes

Note:

MySQLnd s'occupe toujours du jeu de caractères par défaut du serveur. Celui-ci est envoyé durant la négociation de la connexion ou l'authentification.

Libmysqlclient utilise le jeu de caractères par défaut de my.cnf ou via par un appel à mysqli_options() avant mysqli_real_connect(), mais après mysqli_init().

Voir aussi