Skip to main content
Le SDK Auth0-PHP s’intègre à vos applications PHP et simplifie la connexion et l’inscription des utilisateurs. Il prend en charge les sociaux comme Facebook, Google ou X, ainsi que les fournisseurs d’entreprise comme Active Directory. Le SDK fournit des méthodes pratiques pour accéder aux points de terminaison d’authentification et de gestion d’Auth0. Le dépôt Auth0-PHP est open source et hébergé sur GitHub. Nous apprécions toutes les contributions, y compris les signalements de bogues, les propositions d’amélioration et les pull requests.

​
Prérequis

​
Installation

L’installation du SDK PHP d’Auth0 nécessite Composer, l’outil standard de gestion des dépendances pour PHP. Composer vous permet de déclarer les bibliothèques dont votre projet a besoin et les installe pour vous. Assurez-vous que Composer est installé et accessible depuis votre shell avant de continuer. Ensuite, exécutez la commande shell suivante dans le répertoire de votre projet pour installer le SDK : 
composer require auth0/auth0-php
Cette opération créera un sous-dossier vendor dans votre projet et téléchargera toutes les dépendances nécessaires à l’utilisation du SDK PHP. Elle créera également un fichier vendor/autoload.php, nécessaire au bon fonctionnement du SDK avec votre application, que nous importerons plus tard.

​
Pour commencer

Pour utiliser les API Authentication et Management API d’Auth0, vous aurez besoin d’un compte Auth0 gratuit et d’une application :
  1. Accédez à auth0.com/signup et créez votre compte.
  2. Une fois dans l’Auth0 Dashboard, accédez à Applications, puis à Create Application.
  3. Donnez un nom à votre application, sélectionnez Regular Web Application, puis Create
  4. Cliquez sur l’onglet Settings pour obtenir les identifiants requis ci-dessous. Pour en savoir plus, consultez Paramètres de l’application.

​
Configurer le SDK

Utilisez des variables d’environnement pour stocker et charger des identifiants Auth0 sensibles. Vous éviterez ainsi d’avoir à les coder en dur dans votre application. Créons un fichier .env à la racine du répertoire de votre projet pour y stocker les identifiants de votre application : Le moyen le plus simple d’utiliser des variables d’environnement dans votre projet consiste à utiliser une bibliothèque comme PHP Dotenv avec un fichier .env local. Créez un fichier .env (assurez-vous qu’il n’est pas accessible publiquement et qu’il est exclu du contrôle de version) et ajoutez les valeurs suivantes : Vous ne devez jamais enregistrer ce fichier dans le système de contrôle de version ni le partager de façon non sécurisée. Son contenu doit être manipulé avec soin et traité comme un mot de passe. Comme PHP ne peut pas lire notre fichier .env nativement, vous devrez installer une bibliothèque PHP pour le faire. Dans cette documentation, nous utiliserons vlucas/phpdotenv, mais n’importe quelle bibliothèque “dotenv” fera l’affaire. À partir du répertoire de votre projet, exécutez la commande shell suivante pour installer la bibliothèque : 
composer require vlucas/phpdotenv

​
Initialiser le SDK

Nous sommes prêts à configurer et à initialiser une instance du SDK dans notre nouvelle application PHP. Commençons par créer le fichier source PHP que nous utiliserons pour cette démonstration, index.php, puis servons-nous de l’extrait suivant pour démarrer : 
<?php

// Importer le chargeur automatique Composer pour rendre les classes du SDK accessibles :
require 'vendor/autoload.php';

// Charger nos variables d'environnement depuis le fichier .env :
(Dotenv\Dotenv::createImmutable(__DIR__))->load();

// Instancier maintenant la classe Auth0 avec notre configuration :
$auth0 = new \Auth0\SDK\Auth0([
    'domain' => $_ENV['AUTH0_DOMAIN'],
    'clientId' => $_ENV['AUTH0_CLIENT_ID'],
    'clientSecret' => $_ENV['AUTH0_CLIENT_SECRET'],
    'cookieSecret' => $_ENV['AUTH0_COOKIE_SECRET']
]);
Félicitations ! Votre application est maintenant configurée et prête à être utilisée avec Auth0. Vous pouvez désormais passer à la création d’une application exemple à l’aide de l’un de nos guides de démarrage rapide PHP. Choisissez le type d’application que vous souhaitez créer pour suivre un guide de démarrage rapide adapté à vos besoins :

​
En savoir plus