Métodos mágicos + symfony 2

[GatorV]

Pues ya te puso uno @masterpuppet, pero algo sencillo:

Código PHP:

class Persona {
       private $nombre;
       private $apellidoPaterno;
       private $apellidoMaterno;
 
       // gets y sets etc.
 
       public function __toString()
       {
                 return sprintf('%s %s %s', $this->nombre, $this->apellidoPaterno, $this->apellidoMaterno);
       }
}
 
$juan = new Persona('Juan', 'Perez', 'Gomez');
echo $juan; // Juan Perez Gomez
echo $juan->getNombre(); // Juan
echo $juan->getApellidoPaterno(); // Perez
 

En corto, sirve para tener una representación directa de tu objeto como string en caso de que lo necesites, por ejemplo, en una persona, la mayoría de las veces necesitas el nombre completo, no las partes, aunque es bueno tener las partes y __toString() te ayuda a tratar el objeto como string cuando lo necesites sin perder las partes del string, otro ejemplo:

Código PHP:

$sql = new SqlQuery();
$sql->from('personas')->cols('nombre, apellido, edad');
$sql->where('edad > ?', 10)->where('apellido LIKE ?', 'p%');
 
echo $sql; // SELECT nombre, apellido, edad FROM personas WHERE...
 

Saludos.