Classes d’exceptions

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy. Leçon 66 sur 91.

En PHP, les exceptions sont des objets utilisés pour signaler qu’un problème est survenu pendant l’exécution. La classe de base de toutes les exceptions est Exception, et comprendre sa structure vous aide à gérer efficacement les erreurs dans vos applications orientées objet.

Lorsque vous lancez une exception, vous créez une instance de la classe Exception (ou d’une sous-classe) avec un message décrivant ce qui s’est mal passé :

<?php
class BankAccount {
    public function __construct(private float $balance = 0) {}
    
    public function withdraw(float $amount): float {
        if ($amount > $this->balance) {
            throw new Exception("Insufficient funds");
        }
        $this->balance -= $amount;
        return $amount;
    }
}

$account = new BankAccount(100);
$account->withdraw(150);

Cela produirait une erreur d’exception non interceptée avec le message « Insufficient funds ».

PHP fournit plusieurs classes d’exception intégrées pour différentes situations. InvalidArgumentException signale une entrée incorrecte, RuntimeException indique des erreurs lors de l’exécution, et LogicException représente des erreurs de programmation :

<?php
class Calculator {
    public function divide(int $a, int $b): float {
        if ($b === 0) {
            throw new InvalidArgumentException("Cannot divide by zero");
        }
        return $a / $b;
    }
}

Chaque objet exception contient des informations utiles : getMessage() renvoie le message d’erreur, getCode() renvoie un code d’erreur facultatif, et getFile() ainsi que getLine() vous indiquent où l’exception a été levée. L’utilisation de types d’exception spécifiques rend l’intention de votre code plus claire et permet une gestion des erreurs plus précise.

Défi

Facile

Construisons un système de gestion des stocks qui utilise les classes d’exception intégrées de PHP pour signaler différents types de problèmes. Vous créerez un inventaire de produits où les opérations peuvent échouer de manière précise et significative.

Vous organiserez votre code dans trois fichiers :

Product.php : créez une classe Product qui représente un article en stock. Utilisez la promotion des propriétés du constructeur pour un $sku public (string), un $name public (string) et un $quantity privé (int). Votre classe doit comporter :
- Une méthode getQuantity(): int qui renvoie la quantité actuelle
- Une méthode addStock(int $amount): void qui augmente la quantité. Si le montant est inférieur à 1, lancez une InvalidArgumentException avec le message "Amount must be positive"
- Une méthode removeStock(int $amount): void qui diminue la quantité. Si le montant est inférieur à 1, lancez une InvalidArgumentException avec le message "Amount must be positive". Si le montant dépasse la quantité actuelle, lancez une RuntimeException avec le message "Insufficient stock"
Inventory.php : créez une classe Inventory qui gère une collection de produits. Incluez le fichier Product. Votre classe doit comporter :
- Un tableau privé pour stocker les produits indexés par SKU
- Une méthode addProduct(Product $product): void qui ajoute un produit. Si un produit avec le même SKU existe déjà, lancez une LogicException avec le message "Product already exists: [sku]"
- Une méthode getProduct(string $sku): Product qui renvoie un produit par SKU. S’il n’est pas trouvé, lancez une InvalidArgumentException avec le message "Product not found: [sku]"
main.php : incluez le fichier Inventory. Vous recevrez trois entrées : un SKU, un nom de produit et une opération ("add", "remove" ou "duplicate").
Créez un Inventory et ajoutez un nouveau Product avec le SKU, le nom et une quantité initiale de 10 indiqués.

Selon l’opération :
- "add" : appelez addStock(5) sur le produit, puis affichez "Stock updated: [quantity]"
- "remove" : appelez removeStock(15) sur le produit (cela doit lancer une exception)
- "duplicate" : essayez d’ajouter un autre produit avec le même SKU (cela doit lancer une exception)
Lorsqu’une exception est lancée, affichez le nom de sa classe suivi de ": " et du message de l’exception. Utilisez la fonction PHP get_class() pour obtenir le nom de la classe.

Ce défi montre comment différents types d’exceptions communiquent différents types de problèmes — entrées invalides, échecs à l’exécution et erreurs logiques —, ce qui rend la gestion des erreurs de votre code plus précise et plus pertinente.

Essayez vous-même

<?php

require_once 'Inventory.php';

// Lire les entrées
$sku = trim(fgets(STDIN));
$name = trim(fgets(STDIN));
$operation = trim(fgets(STDIN));

try {
    // TODO: Créer un Inventory
    // TODO: Créer un Product avec le SKU, le name donnés et une quantité initiale de 10
    // TODO: Ajouter le product à l'inventory
    
    // TODO: Selon l'opération :
    // - "add": Call addStock(5) on the product, then print "Stock updated: [quantity]"
    // - "remove": Appeler removeStock(15) sur le product
    // - "duplicate": Essayer d'ajouter un autre product avec le même SKU
    
} catch (Exception $e) {
    // TODO: Afficher le nom de la classe de l'exception suivi de ": " et du message
    // Hint: Utiliser get_class($e) pour obtenir le nom de la classe
}

?>