Introduzione ai metodi magici

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

I metodi magici sono metodi speciali in PHP che iniziano con due trattini bassi (__) e vengono chiamati automaticamente da PHP in risposta a determinati eventi o azioni. Ne hai già usati due: __construct() e __destruct().

Questi metodi ti permettono di agganciarti al comportamento interno di PHP e di personalizzare il modo in cui i tuoi oggetti rispondono alle operazioni comuni.

Ad esempio, cosa succede quando provi a stampare un oggetto? O ad accedere a una proprietà che non esiste? I metodi magici ti danno il controllo su queste situazioni.

Ecco una rapida panoramica dei metodi magici più utilizzati:

Metodo	Si attiva quando
`__construct()`	Viene creato un oggetto
`__destruct()`	Un oggetto viene distrutto
`__toString()`	Un oggetto viene usato come stringa
`__get()`	Si accede a una proprietà non definita
`__set()`	Si imposta una proprietà non definita
`__call()`	Si chiama un metodo non definito
`__clone()`	Un oggetto viene clonato

<?php
class Book {
    public function __construct(
        private string $title
    ) {}
    
    public function __toString(): string {
        return "Book: " . $this->title;
    }
}

$book = new Book("PHP Mastery");
echo $book;

Output:

Book: PHP Mastery

Senza __toString(), provare a stampare un oggetto causerebbe un errore. Il metodo magico intercetta questa azione e restituisce invece una rappresentazione in forma di stringa. Nelle prossime lezioni, esploreremo nel dettaglio ogni metodo magico.

Sfida

Facile

Costruiamo un sistema di catalogo di film che ti introduce ai metodi magici. Creerai una classe Movie che usa __construct() per inizializzare i dati dei film e __toString() per fornire una rappresentazione sotto forma di stringa chiara quando l'oggetto viene stampato.

Organizzerai il codice in due file:

Movie.php: crea una classe Movie che rappresenta i film nel tuo catalogo. Usa la promozione del costruttore per definire le proprietà private $title (stringa), $director (stringa) e $year (intero). Implementa il metodo magico __toString() per restituire una stringa formattata: "[title] ([year]) - Directed by [director]". Questo permette di inviare direttamente in output gli oggetti film senza chiamare un metodo separato.
main.php: includi il file Movie. Riceverai tre input: il titolo di un film, il nome di un regista e l'anno di uscita. Crea un'istanza di Movie usando questi valori (converti l'anno in un intero). Poi invia semplicemente l'oggetto film direttamente in output: il metodo __toString() verrà chiamato automaticamente per produrre l'output.

La magia di __toString() sta nel fatto che PHP lo chiama automaticamente ogni volta che il tuo oggetto viene usato in un contesto di stringa. Invece di scrivere echo $movie->getInfo();, puoi semplicemente scrivere echo $movie; e PHP si occupa della conversione. Questo rende i tuoi oggetti più intuitivi da usare.

Provalo tu

<?php

require_once 'Movie.php';

// Leggi l'input
$title = trim(fgets(STDIN));
$director = trim(fgets(STDIN));
$year = intval(fgets(STDIN));

// TODO: Crea un'istanza di Movie usando i valori di input

// TODO: Stampa direttamente l'oggetto movie (il metodo __toString() verrà chiamato automaticamente)

?>