__toString

__toString

5.10.14 Méthodes magiques
5.10 Les classes et les objets (PHP 5)
5 Référence du langage
Manuel PHP

5.10.14.2 __toString

La méthode __toString détermine comment la classe doit réagir lorsqu'elle est convertie en chaîne de caractères.

Exemple simple


<?php
// Déclaration d'une classe simple
class ClasseTest
{
    public $foo;

    public function __construct($foo) {
        $this->foo = $foo;
    }

    public function __toString() {
        return $this->foo;
    }
}

$class = new ClasseTest('Bonjour');
echo $class;
?>

Il est important de noter que la méthode __toString ne sera appelée que si elle est directement combinée avec echo ou print .

Cas où __toString est appelée


<?php
// __toString appelée
echo $class;

// __toString appelée (reste un paramètre normal pour echo)
echo 'text', $class;

// __toString non appelée (opérateur de concaténation utilisé en premier)
echo 'text' . $class;

// __toString non appelée (convertion en une chaîne de caractères en premier)
echo (string) $class;

// __toString non appelée (convertion en une chaîne de caractères en premier)
echo "text $class";
?>

<<	__toString	>>
__sleep et __wakeup	Méthodes magiques	Les classes et les objets (PHP 5)