Classi di eccezione

Fa parte della sezione Programmazione orientata agli oggetti del percorso PHP di Coddy. Lezione 66 di 91.

In PHP, le eccezioni sono oggetti usati per segnalare che qualcosa è andato storto durante l'esecuzione. La classe base di tutte le eccezioni è Exception e comprenderne la struttura ti aiuta a gestire efficacemente gli errori nelle tue applicazioni OOP.

Quando lanci un'eccezione, crei un'istanza della classe Exception (o di una sottoclasse) con un messaggio che descrive cosa è andato storto:

<?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);

Questo produrrebbe un errore di eccezione non intercettata con il messaggio "Insufficient funds".

PHP fornisce diverse classi di eccezione integrate per situazioni diverse. InvalidArgumentException segnala un input non valido, RuntimeException indica errori durante l’esecuzione e LogicException rappresenta errori di programmazione:

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

Ogni oggetto eccezione contiene informazioni utili: getMessage() restituisce il messaggio di errore, getCode() restituisce un codice di errore facoltativo, getFile() e getLine() indicano dove è stata generata l'eccezione. Usare tipi di eccezione specifici rende più chiaro l'intento del codice e consente una gestione degli errori più precisa.

Sfida

Facile

Costruiamo un sistema di gestione dell'inventario che utilizza le classi di eccezione integrate di PHP per segnalare diversi tipi di problemi. Creerai un inventario di prodotti in cui le operazioni possono fallire in modi specifici e significativi.

Organizzerai il codice in tre file:

Product.php: crea una classe Product che rappresenta un articolo nell'inventario. Usa la promozione delle proprietà del costruttore per $sku pubblico (stringa), $name pubblico (stringa) e $quantity privato (int). La classe deve avere:
- Un metodo getQuantity(): int che restituisce la quantità attuale
- Un metodo addStock(int $amount): void che aumenta la quantità. Se l'importo è inferiore a 1, lancia un'InvalidArgumentException con il messaggio "Amount must be positive"
- Un metodo removeStock(int $amount): void che diminuisce la quantità. Se l'importo è inferiore a 1, lancia un'InvalidArgumentException con il messaggio "Amount must be positive". Se l'importo supera la quantità attuale, lancia una RuntimeException con il messaggio "Insufficient stock"
Inventory.php: crea una classe Inventory che gestisce una raccolta di prodotti. Includi il file Product. La classe deve avere:
- Un array privato in cui memorizzare i prodotti, indicizzati per SKU
- Un metodo addProduct(Product $product): void che aggiunge un prodotto. Se esiste già un prodotto con lo stesso SKU, lancia una LogicException con il messaggio "Product already exists: [sku]"
- Un metodo getProduct(string $sku): Product che restituisce un prodotto in base allo SKU. Se non viene trovato, lancia un'InvalidArgumentException con il messaggio "Product not found: [sku]"
main.php: includi il file Inventory. Riceverai tre input: uno SKU, il nome di un prodotto e un'operazione ("add", "remove" o "duplicate").
Crea un'istanza di Inventory e aggiungi un nuovo Product con lo SKU e il nome specificati e una quantità iniziale di 10.

In base all'operazione:
- "add": chiama addStock(5) sul prodotto, quindi stampa "Stock updated: [quantity]"
- "remove": chiama removeStock(15) sul prodotto (questo dovrebbe lanciare un'eccezione)
- "duplicate": prova ad aggiungere un altro prodotto con lo stesso SKU (questo dovrebbe lanciare un'eccezione)
Quando viene lanciata un'eccezione, stampa il nome della classe dell'eccezione seguito da ": " e dal messaggio dell'eccezione. Usa la funzione get_class() di PHP per ottenere il nome della classe.

Questa sfida mostra come diversi tipi di eccezione comunichino diversi tipi di problemi — input non valido, errori di runtime ed errori logici — rendendo la gestione degli errori nel tuo codice più precisa e significativa.

Provalo tu

<?php

require_once 'Inventory.php';

// Read inputs
$sku = trim(fgets(STDIN));
$name = trim(fgets(STDIN));
$operation = trim(fgets(STDIN));

try {
    // TODO: Create an Inventory
    // TODO: Create a Product with the given SKU, name, and initial quantity of 10
    // TODO: Add the product to the inventory
    
    // TODO: Based on the operation:
    // - "add": Call addStock(5) on the product, then print "Stock updated: [quantity]"
    // - "remove": Call removeStock(15) on the product
    // - "duplicate": Try to add another product with the same SKU
    
} catch (Exception $e) {
    // TODO: Print the exception class name followed by ": " and the message
    // Hint: Use get_class($e) to get the class name
}

?>