Los métodos mágicos son funciones especiales predefinidas en PHP que se ejecutan de forma automática cuando ocurren determinadas acciones sobre los objetos. No necesitas llamarlos explícitamente; el motor de PHP los invoca «por arte de magia» bajo circunstancias específicas, permitiéndote personalizar el comportamiento de tus clases (sobrecarga de propiedades y métodos, serialización, clonación, etc.).
Todos los nombres de los métodos mágicos comienzan obligatoriamente con un doble guion bajo (__).
Listado completo de métodos mágicos en PHP
-
__construct(): Constructor del objeto (se ejecuta al instanciar connew). -
__destruct(): Destructor (se ejecuta cuando el objeto es destruido o finaliza el script). -
__call($nombre, $argumentos): Se invoca al intentar llamar a un método inaccesible o inexistente en un contexto de objeto. -
__callStatic($nombre, $argumentos): Se invoca al intentar llamar a un método estático inaccesible o inexistente. -
__get($propiedad): Se activa al intentar leer el valor de una propiedad inaccesible o no definida. -
__set($propiedad, $valor): Se activa al intentar escribir o asignar un valor a una propiedad inaccesible. -
__isset($propiedad): Se dispara automáticamente al evaluarisset()oempty()sobre una propiedad inaccesible. -
__unset($propiedad): Se dispara al utilizarunset()sobre una propiedad inaccesible. -
__sleep(): Se ejecuta antes de serializar un objeto (serialize()), útil para limpiar recursos o cerrar conexiones. -
__wakeup(): Se ejecuta al deserializar un objeto (unserialize()), útil para restablecer conexiones a bases de datos. -
__toString(): Permite definir cómo debe comportarse un objeto cuando se intenta tratar directamente como una cadena de texto (por ejemplo, en unecho). -
__invoke(): Se activa cuando se intenta utilizar un objeto como si fuera una función (ej:$objeto()). -
__set_state(): Se invoca al utilizar la funciónvar_export()sobre una clase. -
__clone(): Se ejecuta automáticamente al clonar un objeto (clone $objeto). -
__debugInfo(): Personaliza la información que se muestra al volcar el objeto con la funciónvar_dump().
Ejemplo práctico: El método mágico __isset()
El método __isset() es especialmente útil para controlar cómo responde tu clase cuando se comprueba la existencia de propiedades privadas, protegidas o que no han sido declaradas explícitamente, evitando que el código falle o devuelva resultados inesperados.
class Usuario {
private $datos = ['nombre' => 'Ana', 'email' => 'ana@ejemplo.com'];
// Se ejecuta automáticamente al usar isset() o empty() sobre propiedades inaccesibles
public function __isset($propiedad) {
echo "Comprobando si existe la propiedad privada: '{$propiedad}'<br>";
return isset($this->datos[$propiedad]);
}
}
$usuario = new Usuario();
// Al evaluar isset sobre una propiedad privada, salta el método __isset()
if (isset($usuario->nombre)) {
echo "La propiedad existe y está definida.<br>";
}
if (!isset($usuario->telefono)) {
echo "La propiedad 'telefono' no existe en el array interno.";
}
Salida resultante al ejecutar el código:
Comprobando si existe la propiedad privada: 'nombre'
La propiedad existe y está definida.
Comprobando si existe la propiedad privada: 'telefono'
La propiedad 'telefono' no existe en el array interno.