Packages et helpers

1. Introduction

Une des forces de Laravel réside dans ses packages. On peut d’ailleurs considérer Laravel comme étant un assemblage de packages. En effet, lors d’une nouvelle installation de Laravel, de nombreuses bibliothèques développées par d’autres éditeurs ou des particuliers sont installées en même temps. En voici quelques exemples  :

Le système de gestion des fichiers s’appuie sur Flysystem, la bibliothèque d’abstraction développée par The League of Extraordinary Packages, un groupe de développeurs qui créent et maintiennent des bibliothèques de qualité (https://thephpleague.com/).

La gestion de requête et de réponses s’appuie sur HttpFoundation, une couche orientée objet pour la spécification HTTP, créée pour le Framework Symfony (https://github.com/symfony/http-foundation).

Le système de gestion des logs est construit au-dessus de Monolog, un outil développé par Jordi Boggiano et maintenu par de nombreux contributeurs pour envoyer des logs vers des fichiers, des bases de données, des sockets et un grand nombre d’autres services (https://seldaek.github.io/monolog/).

Laravel possède donc des fondations solides, et ajoute simplement la surcouche nécessaire qui permet d’appeler framework cet ensemble de packages. 

Bien qu’offrant de nombreuses fonctionnalités prêtes à l’emploi, une application Laravel a rapidement besoin d’intégrer d’autres packages pour répondre aux besoins métier. Tout au long de cet ouvrage, divers packages ont d’ailleurs été installés pour ajouter des fonctionnalités  : Guzzle, par exemple, pour émettre des requêtes HTTP vers l’extérieur, ou encore Predis pour utiliser une connexion vers un serveur Redis.

L’intégralité des dépendances est présente sous la forme de fichiers dans le dossier vendor de l’application. En parcourant ce dossier, on peut en apprendre davantage sur le fonctionnement de Laravel et son interaction avec ses packages. 

2. Choisir un package

Avant d’installer un package, il est important d’essayer d’évaluer sa qualité....

1. Transformer des chaînes

echo Str::snake('BonjourToutLeMonde'); 
// Affiche  : bonjour_tout_le_monde  

echo Str::kebab('BonjourToutLeMonde'); 
// Affiche  : bonjour-tout-le-monde  

echo Str::camel('bonjour-tout-le-monde'); 
// Affiche  : bonjourToutLeMonde  

1. Récupérer des éléments

La fonction Arr::first récupère uniquement le premier élément d’un tableau passé en premier paramètre, qui remplit la condition décrite dans une fonction de rappel passée en deuxième paramètre, comme dans l’exemple suivant.

Fonction Arr::first

$array = [1, 2, 3, 4]; 
 
echo Arr::first($array, function (int $value, int $key) { 
 
    return $value > 2; 
 
}); 
 
// Affiche  : 3  

La fonction Arr::last fonctionne à l’inverse et retournera la dernière occurrence qui remplit la condition.

Fonction Arr::last

$array = [1, 2, 3, 4]; 
 
echo Arr::last($array, function (int $value, int $key) { 
 
    return $value > 2; 
 
}); 
 
// Affiche  :...

1. Chemins et dossiers

Il est possible d’obtenir le chemin complet vers les différents dossiers d’une application Laravel grâce aux fonctions assistantes *_path.

Fonctions *_path

echo base_path(); 
// Chemin complet vers la racine de l'application 
 
echo app_path(); 
// Chemin complet vers le dossier « app  » de l'application 
 
echo database_path(); 
// Chemin complet vers le dossier « database  » de l'application 
 
echo config_path(); 
// Chemin complet vers le dossier « config  » de l'application 
 
echo resource_path(); 
// Chemin complet vers le dossier « resources  » de l'application 
 
echo public_path(); 
// Chemin complet vers le dossier « public  » de l'application 
 
echo storage_path(); 
// Chemin complet vers le dossier « storage  » de l'application  

Ces fonctions sont souvent plus pratiques que d’utiliser des chemins relatifs comme « ../../  », qui sont amenés à varier en fonction de l’évolution de l’application.

2. URL

La fonction url permet de créer une URL complète à partir d’une chaîne de caractères....

1. Introduction

Les collections sont une composante puissante de Laravel  : certains les qualifient de tableaux avec des super-pouvoirs. Autrement dit, une collection est une instance de classe représentant une liste d’éléments qui possède de nombreuses méthodes pour la manipuler.

Utiliser des collections permet par certains aspects de se rapprocher de la programmation fonctionnelle, telle qu’elle est parfois décrite de manière réductrice en JavaScript par exemple, en ajoutant des méthodes map, reduce et filter sur des listes d’éléments.

2. Transformer un tableau en collection

La première étape pour commencer à utiliser les collections est de transformer un tableau en collection. Pour cela, Laravel met à disposition la fonction assistante collect, qui prend en paramètre un tableau (ou une collection) et le transforme en collection. Il est possible de faire appel à cette fonction n’importe où dans une application.

Créer une collection

$collection = collect([1, 2, 3]);  

Une fois la collection créée, il est possible de la manipuler comme dans l’exemple suivant.

Inverser l’ordre des éléments puis prendre le premier

$collection = collect([1, 2, 3]); 
 
echo $collection->reverse()->first(); 
 
// Affiche  : 3  

Dans cet exemple...