Premiers pas avec Auth0-PHP

Installez et configurez le SDK Auth0-PHP, créez une application Auth0 et préparez votre projet PHP à authentifier des utilisateurs.

Le SDK Auth0-PHP s’intègre à vos applications PHP et offre des fonctionnalités simples de connexion et d’inscription des utilisateurs. Il prend en charge les fournisseurs d’identité sociaux comme Facebook, Google ou X, ainsi que des fournisseurs d’entreprise comme Active Directory. Le SDK fournit des méthodes pratiques pour accéder aux endpoints 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

• PHP 8.2+
• Composer
• L’extension PHP mbstring
• Une implémentation de client HTTP PSR-18
• Une implémentation de fabrique HTTP PSR-17
• Une implémentation de messages HTTP PSR-7

​

Installation

L’installation de l’Auth0 PHP SDK 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 à partir de 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

Cela créera un sous-dossier vendor dans votre projet et téléchargera toutes les dépendances nécessaires à l’utilisation du SDK PHP. Cela créera aussi le fichier vendor/autoload.php, nécessaire pour que le SDK fonctionne avec votre application, que nous importerons plus tard.

​

Pour commencer

Pour utiliser les API d’authentification et de gestion d’Auth0, vous aurez besoin d’un compte Auth0 gratuit et d’une application :

1. Allez à auth0.com/signup et créez votre compte.
2. Une fois dans le 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 Application Settings.

​

Configurer le SDK

Il est recommandé d’utiliser des variables d’environnement pour stocker et charger les identifiants sensibles d’Auth0. Vous éviterez ainsi de les coder en dur dans votre application. Créons un fichier .env à la racine du répertoire de notre projet pour y stocker les identifiants de l’application :

La façon la 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 au public et qu’il est exclu du contrôle de version) et ajoutez les valeurs suivantes :

Vous ne devriez jamais enregistrer ce fichier dans le contrôle de version ni le partager de façon non sécurisée. Son contenu doit être manipulé avec précaution et traité comme un mot de passe. Comme PHP ne peut pas lire nativement notre fichier .env, vous devrez installer une bibliothèque PHP pour ce faire. Aux fins de cette documentation, nous utiliserons vlucas/phpdotenv, mais n’importe quelle bibliothèque “dotenv” fera l’affaire. Dans le répertoire de votre projet, exécutez la commande suivante dans le shell 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 utilisons l’extrait de code suivant pour commencer :

<?php

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

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

// Instanciation de 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'],
// L’élément `AUTH0_BASE_URL` doit correspondre exactement à l’URL de rappel configurée dans votre application Auth0.
    'redirectUri' => $_ENV['AUTH0_BASE_URL'],
]);

Félicitations ! Votre application est maintenant configurée et prête à être utilisée avec Auth0. Vous pouvez maintenant passer à la création d’une application exemple à l’aide de l’un de nos Quickstarts PHP. Choisissez le type d’application que vous souhaitez créer afin de suivre un Quickstart adapté à vos besoins :

• Application Web PHP
• API backend PHP

​

En savoir plus

• Gérer le Login, le Logout et les profils utilisateur
• Utiliser l’Authentication API
• Utiliser la Management API
• Valider les JWT (JSON Web Tokens)
• Résoudre les problèmes liés à votre intégration Auth0-PHP