Récupérer des données simples avec Eloquent (par exemple, `Model::all()`, `Model::find()`)

Premiers pas dans la récupération de données avec Eloquent

Une fois que vos modèles Eloquent sont définis et que la structure de votre base de données est en place grâce aux migrations, l'étape suivante naturelle est de commencer à interagir avec les données stockées. Eloquent ORM de Laravel brille par sa capacité à rendre ces interactions simples et intuitives. Ce sous-chapitre se concentre sur les méthodes les plus fondamentales pour récupérer des données : Model::all() pour obtenir tous les enregistrements d'une table, et Model::find() (ainsi que ses variantes comme findOrFail()) pour récupérer un enregistrement spécifique par sa clé primaire. Maîtriser ces commandes est essentiel pour construire les fonctionnalités de base de toute application nécessitant un accès à une base de données.

Model::all() : Récupérer tous les enregistrements d'une table

La méthode statique all() est l'une des plus simples pour récupérer des données avec Eloquent. Lorsqu'elle est appelée sur une classe de modèle, elle exécute une requête SQL pour sélectionner tous les enregistrements de la table associée à ce modèle. Le résultat est retourné sous forme d'une instance de Illuminate\Database\Eloquent\Collection, qui est une classe améliorée de tableau PHP, offrant de nombreuses méthodes utiles pour manipuler les ensembles de données.

Supposons que nous ayons un modèle Post qui est lié à une table posts. Pour récupérer tous les articles de blog, vous écririez :

// Assurez-vous d'importer votre modèle au début de votre fichier PHP
use App\Models\Post;

// Récupère tous les enregistrements de la table 'posts'
$posts = Post::all();

// Vous pouvez ensuite itérer sur la collection pour afficher les données
foreach ($posts as $post) {
    echo 'Titre : ' . $post->title . '<br>';
    echo 'Contenu : ' . $post->content . '<br>';
    // Les colonnes de la table sont accessibles comme des propriétés publiques de l'objet modèle
}

Il est important de noter que l'utilisation de Model::all() peut être inefficace si la table contient un très grand nombre d'enregistrements, car cela chargera tous les enregistrements en mémoire. Pour les grandes tables, il est préférable d'utiliser des méthodes de pagination (comme paginate()) ou de filtrer les résultats pour ne récupérer que les données nécessaires. Cependant, pour les tables de taille petite à moyenne ou pour des opérations simples, all() est très pratique.

La collection retournée par all() est très puissante. Vous pouvez, par exemple, compter le nombre d'éléments, filtrer la collection en PHP, la transformer, etc. :

use App\Models\User;

$users = User::all();

$nombreUtilisateurs = $users->count(); // Nombre total d'utilisateurs

// Filtrer les utilisateurs actifs (en PHP, après la requête SQL)
$utilisateursActifs = $users->where('is_active', true);

// Obtenir uniquement les emails
$emails = $users->pluck('email'); // Retourne une collection d'emails

Model::find() : Récupérer un enregistrement par sa clé primaire

Lorsque vous avez besoin de récupérer un seul enregistrement spécifique et que vous connaissez sa clé primaire (généralement la colonne id), la méthode statique find() est la solution la plus directe. Elle prend en argument la valeur de la clé primaire et retourne une unique instance du modèle si un enregistrement correspondant est trouvé. Si aucun enregistrement n'est trouvé, find() retourne null.

use App\Models\Product;

// Récupère le produit avec l'ID 15
$product = Product::find(15);

if ($product) {
    // Le produit a été trouvé
    echo 'Nom du produit : ' . $product->name;
    echo 'Prix : ' . $product->price;
} else {
    // Aucun produit trouvé avec cet ID
    echo 'Produit non trouvé.';
}

Cette méthode est très efficace car elle se traduit par une requête SQL simple ciblant directement la clé primaire (qui est généralement indexée).

Vous pouvez également passer un tableau d'IDs à find() pour récupérer une collection de modèles correspondants à ces clés primaires :

use App\Models\Category;

$categoryIds = [1, 3, 7];
$categories = Category::find($categoryIds);

foreach ($categories as $category) {
    echo $category->name . '<br>';
}
// Si un ID n'est pas trouvé, il ne sera simplement pas inclus dans la collection résultante.

Gérer les cas où l'enregistrement n'est pas trouvé : `findOrFail()` et `firstOrFail()`

Dans de nombreux scénarios, en particulier lors de la construction d'APIs ou de pages web dynamiques, si un enregistrement demandé par son ID n'existe pas, vous souhaiterez probablement retourner une erreur 404 (Not Found) plutôt que de continuer avec une variable null. Eloquent fournit des méthodes pratiques pour gérer ce cas de figure automatiquement.

La méthode findOrFail() fonctionne comme find(), mais si aucun modèle n'est trouvé pour l'ID donné, elle lèvera automatiquement une exception Illuminate\Database\Eloquent\ModelNotFoundException. Laravel intercepte par défaut cette exception et génère une réponse HTTP 404.

use App\Models\Order;

// Dans un contrôleur, par exemple :
public function show($orderId)
{
    // Si la commande avec $orderId n'existe pas, une page 404 sera retournée.
    $order = Order::findOrFail($orderId);

    return view('orders.show', ['order' => $order]);
}

C'est une pratique courante et recommandée pour simplifier la gestion des erreurs "ressource non trouvée".

De manière similaire, lorsque vous construisez des requêtes plus complexes avec des conditions (ce que nous verrons plus en détail plus tard), vous pouvez utiliser firstOrFail(). Cette méthode exécute la requête et tente de récupérer le premier enregistrement correspondant. Si aucun enregistrement ne correspond aux conditions, elle lèvera également une ModelNotFoundException.

use App\Models\User;

// Tente de trouver le premier utilisateur avec l'email spécifié.
// Si non trouvé, lève une ModelNotFoundException.
$user = User::where('email', 'utilisateur.inexistant@example.com')->firstOrFail();

L'utilisation de findOrFail() et firstOrFail() rend votre code plus concis et robuste en gérant de manière standardisée les cas où les données attendues ne sont pas présentes.

Ces méthodes de base, all(), find(), et leurs variantes *_OrFail, constituent le fondement de la récupération de données avec Eloquent. Bien qu'Eloquent offre des capacités de requêtage bien plus avancées, ces outils simples sont souvent tout ce dont vous avez besoin pour de nombreuses opérations courantes, vous permettant de lire les informations de votre base de données avec facilité et élégance.