SPLOBJECTSTORAGE EN PHP: QUÉ ES Y CÓMO UTILIZARLO

La clase SplObjectStorage en PHP es una estructura de datos que permite almacenar objetos como claves y asociarles valores arbitrarios, funcionando como un mapa o conjunto de objetos. A diferencia de WeakMap, las claves en SplObjectStorage no son referenciadas débilmente, por lo que los objetos permanecen en memoria mientras estén en el almacenamiento, incluso si no hay otras referencias externas. Implementa las interfaces Countable, Iterator, ArrayAccess y Serializable, lo que la hace versátil para manejar colecciones de objetos. SplObjectStorage es una herramienta útil para trabajar con colecciones de objetos en PHP, especialmente cuando se necesita un mapa o conjunto de objetos con valores asociados. Es más robusto que un array asociativo para manejar objetos como claves, pero carece de la gestión automática de memoria que ofrece WeakMap. Es ideal para casos donde los objetos deben persistir en el almacenamiento, como en sistemas de caché o mapeos de metadatos.

Características principales

  • Claves como objetos: Los objetos se usan como claves, y cada objeto puede tener un valor asociado (o null si no se especifica).
  • No referencias débiles: Los objetos en SplObjectStorage no se eliminan automáticamente por el recolector de basura si pierden referencias externas, a diferencia de WeakMap.
  • Uso como conjunto: Si no se asocia ningún valor, SplObjectStorage puede actuar como un conjunto de objetos únicos.
  • Iteración: Al iterar, las claves son índices numéricos (no los objetos), pero puedes acceder al objeto actual con current().

Métodos principales

  • attach($object, $data = null): Agrega un objeto al almacenamiento, opcionalmente con un valor asociado.
  • detach($object): Elimina un objeto del almacenamiento.
  • contains($object): Verifica si un objeto existe en el almacenamiento.
  • offsetSet($object, $data): Asocia un valor a un objeto (similar a attach).
  • offsetGet($object): Obtiene el valor asociado a un objeto.
  • offsetExists($object): Verifica si un objeto está en el almacenamiento.
  • offsetUnset($object): Elimina un objeto del almacenamiento.
  • count(): Devuelve el número de objetos almacenados.
  • getIterator(): Permite iterar sobre los objetos.
Ejemplo clave-valor: 

$storage = new SplObjectStorage();

$obj1 = new stdClass();
$obj2 = new stdClass();

$storage[$obj1] = "Datos de obj1";
$storage[$obj2] = "Datos de obj2";

echo $storage[$obj1]; // Salida: Datos de obj1
echo $storage[$obj2]; // Salida: Datos de obj2
echo count($storage); // Salida: 2

unset($obj1); // El objeto sigue en $storage
echo count($storage); // Salida: 2 (no se elimina automáticamente)
El siguiente ejemplo muestra como Iterar sobre SplObjectStorage

$storage = new SplObjectStorage();

$obj1 = new stdClass();
$obj2 = new stdClass();
$storage[$obj1] = "Valor 1";
$storage[$obj2] = "Valor 2";

foreach ($storage as $index => $object) {
    echo "Índice: $index, Valor: " . $storage[$object] . "\n";
}

Consideraciones

  • Memoria: Como SplObjectStorage no libera objetos automáticamente, puede causar un mayor uso de memoria si no se gestiona explícitamente la eliminación de objetos con detach o offsetUnset.
  • Casos de uso: Es útil para escenarios donde necesitas una colección de objetos únicos o asociar datos a objetos sin preocuparte por referencias débiles, como en caché persistente o mapeos que deben mantenerse durante toda la ejecución.
  • Limitaciones: Solo acepta objetos como claves, no tipos primitivos como cadenas o enteros.