Rechercher une fonction PHP

MongoDB::authenticate

(PECL mongo >=1.0.1)

MongoDB::authenticateIdentification à une base de données

Description

public MongoDB::authenticate ( string $username , string $password ) : array

Cette méthode permet de s'identifier sur une connexion. Si l'identification est activée sur le serveur de base de données (ce n'est pas le cas par défaut), vous devez vous y identifier avant de faire une quelconque opération.

En général, vous devriez utiliser l'authentification intégrée à MongoClient::__construct() au lieu de cette méthode. Si vous vous authentifiez sur une connexion et que celle-ci se perd et se reconnecte pendant votre session, vous serez réauthentifié. Si vous vous étiez authentifié manuellement au moyen de cette méthode et que la connexion se perd, vous devrez alors rappeler cette méthode une fois reconnecté.

Cette méthode revient à exécuter :

<?php

$salted 
"${username}:mongo:${password}";
$hash md5($salted);

$nonce $db->command(array("getnonce" => 1));

$saltedHash md5($nonce["nonce"]."${username}${hash}");

$result $db->command(array("authenticate" => 1
    
"user" => $username,
    
"nonce" => $nonce["nonce"],
    
"key" => $saltedHash
));

?>

Une fois la connexion authentifiée, elle ne peut être non-authentifiée qu'en utilisant la commande de la base de données "logout" :

<?php

$db
->command(array("logout" => 1));

?>

Retour à la première page de Manuel PHP  Table des matières Haut

Liste de paramètres

username

Le nom d'utilisateur.

password

Le mot de passe (en texte plein).

Retour à la première page de Manuel PHP  Table des matières Haut

Valeurs de retour

Retourne la réponse de la base de données. Si l'identification a réussi, la méthode retournera

<?php
array("ok" => 1);
?>
Si une erreur survient, elle retournera
<?php
array("ok" => 0"errmsg" => "auth fails");
?>
("auth fails" peut être un message différent, suivant la version de la base de données et le type d'erreur rencontré).

Retour à la première page de Manuel PHP  Table des matières Haut

Voir aussi

Documentation principale MongoDB sur l' » authentification.

Retour à la première page de Manuel PHP  Table des matières Haut

Historique

Version Description
1.2.11 Lance une alerte de niveau E_DEPRECATED lorsqu'utilisé. Veuillez passer les détails d'authentification au constructeur.

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-mongodb.authenticate.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut