Introduction

Pour rappel, composer est un gestionnaire de dépendances Libre, écrit en PHP. Il permet à ses utilisateurs de déclarer et d'installer les bibliothèques (packages) dont le projet principal a besoin. Une bibliothèque est un ensemble de scripts écrits en PHP mettant à disposition des fonctions, constantes et classes afin de faciliter et d'accélérer les développements.

Composer embarque également un système d’autoloading pour tes classes.

Cette quête va t’apprendre à charger automatiquement tes classes en utilisant l’autoload de Composer. Tu verras l'installation des packages dans la quête suivante.

🤓 À la fin de cette quête, tu seras capable de :

• ✅ Comprendre comment les classes sont chargées en PHP
• ✅ Utiliser l’autoloader de composer

Initialisation d'un projet Composer

Avant toute utilisation de Composer, il faut vérifier si tu utilises bien une version à jour. Pour cela, Composer te fournit une méthode pour se mettre à jour automatiquement.

TODO: Lance la commande suivante :

composer self-update

Afin d'initialiser un projet qui va utiliser Composer, place toi à la racine de ton projet et lance la commande :

composer init

Cette commande est interactive. Elle va donc te demander de renseigner des informations spécifiques à ton projet.

Une fois que tu as répondu à toutes les questions, Composer te crée un fichier très important : composer.json

Ce fichier contient toutes les informations relatives à ton projet que tu as renseignées dans ton terminal. Il contiendra également la liste des dépendances à gérer.

Voici le contenu de ce fichier :

{
    "name": "wild/app",
    "description": "Wild composer quest",
    "autoload": {
        "psr-4": {
            "App\\": "src/"
    },
    "authors": [
        {
            "name": "wilderName",
            "email": "wilder@email.com"
        }
    ],
    "require": {}
}

Chargement des classes (Autoloading)

Maintenant que tu as vu la POO (Programmation Orienté Objet), tu veux utiliser des objets !

Pour utiliser les classes dans ton projet tu vas devoir importer un à un les fichiers .php qui les contiennent (avec include ou require).

À mesure que le nombre de fichiers grandit, cela devient vite ingérable ! C'est pour cela que PHP propose un système d'autoloading.

Tu ne vas pas l'utiliser directement, car le paramétrage peut devenir fastidieux. Tu vas donc utiliser le système d'autoloading de Composer.

Résultat: Composer va se charger d'importer automatiquement tous les fichiers PHP de ton projet et de les rassembler sous un seul namespace racine que tu auras défini dans ton fichier composer.json.

Lors de la dernière phase d'initialisation de ta commande composer init  L'invite de commande te propose automatiquement de bénéficier de l'autoloading en intégrant une entrée autoload: à l'interieur de ton fichier composer.json. Pour en savoir plus, jette un oeil à la documentation Composer autoloading.

Si tu as décidé de générer l'autoload de manière automatique, tu pourras accèder au dossier vendor/. Dans ce dossier, un fichier autoload.php est généré. C'est lui qui va se charger d'importer tes classes, etc. Il est nécessaire de require le fichier autoload.php dans ton index.php, pour pouvoir utiliser les namespaces.

true|||true|||true
# Quelle commande permet de générer un fichier composer.json ?
[x] composer init
[] composer install
[] composer update
# Si vous venez de récupérer un projet et que vous constatez qu’il comporte un fichier composer.json mais pas de vendor, que devez vous faire ?
[] télécharger le vendor sur packagist
[x] taper la commande composer install
[] créer un dossier vendor dans le projet
# Qu’est ce que le FQCN ?
[] Le chemin exacte dans le répertoire vers la classe, par exemple : src/controller/HomeController
[x] Le nom composé du namespace et du nom de la classe, par exemple App\Controller\HomeController
[] Le nom composé du namespace et du nom de la classe, par exemple App/Controller/HomeController
# Il est possible d'avoir deux classes ayant exactement le même nom dans un même projet
[x] vrai
[] faux
# Dans quel ordre faudrait-il exécuter ces commandes pour créer un nouveau projet utilisant Composer ?
[] composer init / composer install / composer self-update
[] composer install / composer init / composer self-update
[x] composer self-update / composer init / composer install

💪 Challenge

Créer une architecture de projet

Tu dois créer une architecture minimaliste de projet.

L'arborescence des dossiers doit être la suivante :

public/
    index.php
src/
    Hello.php

• le fichier index.php est l'entrée de l'application.
• le fichier Hello.php contient une classe nommée Hello qui devra posséder une méthode talk. Cette dernière devra retourner "Hello World !".
• le vendor n'est pas versionné (ne le add pas avec git ou ajoute le dans le .gitignore)