La interfaz Stringable

(PHP 8)

Introducción

La interfaz Stringable designa una clase que posee un método __toString(). A diferencia de la mayoría de las interfaces, Stringable está implícitamente presente en cualquier clase para la cual el método mágico __toString() está definido, aunque puede y debe ser declarada explícitamente.

Su valor principal es permitir a las funciones verificar el tipo en comparación con el tipo de unión string|Stringable para aceptar ya sea un string primitivo, ya sea un objeto que pueda ser convertido a string.

Sinopsis de la Interfaz

interface Stringable {

/* Métodos */

public __toString(): string

}

Ejemplos de Stringable

Ejemplo #1 Ejemplo simple

Esto utiliza la promoción de propiedades del constructor.

<?php
class IPv4Address implements Stringable {
    public function __construct(
        private string $oct1,
        private string $oct2,
        private string $oct3,
        private string $oct4,
    ) {}

    public function __toString(): string {
        return "$this->oct1.$this->oct2.$this->oct3.$this->oct4";
    }
}

function showStuff(string|Stringable $value) {
    // Para un Stringable, esto llamará implícitamente a __toString().
    print $value;
}

$ip = new IPv4Address('123', '234', '42', '9');

showStuff($ip);
?>

Resultado del ejemplo anterior es similar a:

123.234.42.9

Tabla de contenidos

Stringable::__toString — Devuelve la representación del objeto en forma de string