__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 autorise une classe de décider comme elle doit réagir lorsqu'elle est convertie en chaîne de caractères.

Exemple simple


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

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

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

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

Il est important de noter que la méthode __toString ne peut être appelée que lorsqu'elle est combiné avec echo ou print .

Cas où __toString est appelé


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

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

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

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

// __toString non appelé (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)