PHPackages                             dlunire/dlstorage - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. dlunire/dlstorage

ActiveLibrary[File & Storage](/categories/file-storage)

dlunire/dlstorage
=================

Librería de almacenamiento de datos binarios, optimizada para su integración con el framework DLUnire. Permite almacenar, gestionar y recuperar datos en formatos binarios de manera eficiente."version": "v0.1.0"

v0.1.3(8mo ago)0284↓88.2%1MITPHP

Since Jul 27Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/dlunire/dlstorage)[ Packagist](https://packagist.org/packages/dlunire/dlstorage)[ RSS](/packages/dlunire-dlstorage/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (5)Used By (1)

DLStorage
=========

[](#dlstorage)

**DLStorage** es una biblioteca desarrollada por **David E Luna M**, creador del proyecto **Códigos del Futuro**, ahora **Código Entrópico** como parte del ecosistema del **DLUnire Framework**. Su objetivo principal es ofrecer una solución eficiente para el almacenamiento y gestión de datos binarios, tanto dentro como fuera del framework.

---

Guía de uso
-----------

[](#guía-de-uso)

### Índice de contenido

[](#índice-de-contenido)

1. [DataStorage](./doc/DataStorage.md "Define una base para almacenar datos transformados")
2. [SaveData](./doc/SaveData.md "La clase `SaveData` extiende `DataStorage` y proporciona una solución lista para usar")
3. [FastArray](./doc/FastArray.md)

📌 Propósito
-----------

[](#-propósito)

**DLStorage** permite almacenar, manipular y recuperar datos binarios de forma segura y eficiente. Está especialmente diseñada para escenarios donde se requieren operaciones sobre archivos binarios, como configuraciones, cachés u otros recursos que necesitan persistencia de bajo nivel.

Aunque está optimizada para el framework **DLUnire**, **DLStorage** puede utilizarse de manera independiente en cualquier proyecto PHP moderno.

---

Funcionalidades
---------------

[](#funcionalidades)

- 🔒 **Almacenamiento binario estructurado**: gestión eficiente de datos binarios.
- 🔀 **Compatibilidad directa con DLUnire Framework**.
- 📈 **Diseño escalable y modular**, ideal para proyectos de distintos tamaños.
- 📂 **Lectura y escritura optimizada en archivos `.dlstorage`**.

---

Instalación
-----------

[](#instalación)

Instalación mediante **Composer**:

```
composer require dlunire/dlstorage
```

> Composer se encargará de descargar automáticamente todas las dependencias necesarias.

---

Requisitos
----------

[](#requisitos)

- PHP 8.2 o superior
- Composer
- (Opcional) DLUnire Framework para integración directa

---

Documentación
-------------

[](#documentación)

La documentación técnica de las clases principales está disponible en el directorio `doc/`:

- [DataStorage](doc/DataStorage.md) – Documentación base del sistema de almacenamiento binario.
- [SaveData](doc/SaveData.md) – Clase concreta para guardar y recuperar datos con control de cabecera.

> Nuevos archivos y módulos serán añadidos conforme avance el desarrollo.

---

🛠️ Uso
------

[](#️-uso)

> Este proyecto se encuentra en etapa inicial. Las interfaces y métodos pueden cambiar en futuras versiones.

Actualmente, se recomienda revisar los archivos de documentación para entender la estructura y firma de las clases.

---

🤝 Contribuciones
----------------

[](#-contribuciones)

Se agradece cualquier contribución. Puedes:

- Abrir un *pull request*.
- Reportar un *issue* para errores o sugerencias.
- Proponer mejoras o nuevas funcionalidades.

---

👤 Autor
-------

[](#-autor)

**David E Luna M** – Fundador de **Códigos del Futuro** y autor del **DLUnire Framework**.

📧 Contacto:

---

📄 Licencia
----------

[](#-licencia)

**DLStorage** está licenciado bajo la [MIT License](LICENSE).

---

📁 Estructura del Proyecto
-------------------------

[](#-estructura-del-proyecto)

```
src/
├─ Storage/       # Clases de almacenamiento principal
├─ Interfaces/    # Interfaces para implementación extensible
doc/
├─ DataStorage.md
├─ SaveData.md

```

---

FastArray
---------

[](#fastarray)

`FastArray` es una clase abstracta de **DLStorage** que proporciona una interfaz avanzada para manipulación de arrays, integrando iteradores, acceso seguro y métodos inspirados en estructuras de alto nivel.

---

### 🗂️ Métodos actuales de FastArray

[](#️-métodos-actuales-de-fastarray)

MétodoParámetrosModifica arrayRetornoDescripción`__construct(array $data = [])`Array inicial opcionalSí`void`Inicializa el array y su longitud.`push(mixed $value)`Valor a insertarSí`void`Agrega un elemento al final.`pop()`—Sí`mixed`Elimina y devuelve el último elemento.`shift()`—Sí`mixed`Elimina y devuelve el primer elemento.`clear()`—Sí`void`Vacía el array y reinicia la longitud.`get()`—No`array`Devuelve una copia del array interno.`length()`—No`int`Devuelve la cantidad de elementos.`add(array $data)`Array de elementosSí`void`Agrega múltiples elementos al final.`item(int $index)`Índice a obtenerNo`mixed`Devuelve un elemento por índice, lanza excepción si es inválido.`first()`—No`mixed`Devuelve el primer elemento, lanza excepción si está vacío.`last()`—No`mixed`Devuelve el último elemento, lanza excepción si está vacío.`splide(int $offset, ?int $length = null, mixed $replacement = [])`Offset, longitud opcional, reemplazo opcionalSí`FastArray`Elimina/reemplaza elementos y devuelve los eliminados en un nuevo `FastArray`.`slice(int $offset, ?int $length = null, bool $preserve_keys = false)`Offset, longitud opcional, preserva índicesNo`FastArray`Devuelve una porción del array como un nuevo `FastArray`.`to_array()`—No`array`Devuelve el array interno crudo.`get_iterator()`—No`\Traversable`Devuelve un iterador (`ArrayIterator`) del array interno.`getIterator()`—No`\Traversable`Implementación de `IteratorAggregate`, devuelve `get_iterator()`.---

### 🔮 Métodos planeados para futuras versiones

[](#-métodos-planeados-para-futuras-versiones)

- `filter(callable $callback): FastArray` – Filtra elementos según condición.
- `map(callable $callback): FastArray` – Aplica función a cada elemento.
- `reduce(callable $callback, mixed $initial = null): mixed` – Reduce a un único valor.
- `unique(): FastArray` – Elimina elementos duplicados.
- `shuffle(): FastArray` – Reordena elementos aleatoriamente.
- `concat(FastArray|array $other): FastArray` – Concatena otro array o FastArray.
- `join(string $glue = ','): string` – Devuelve string concatenado de los elementos.
- `contains(mixed $value): bool` – Verifica si existe un valor.
- `keys(): FastArray` – Devuelve los índices.
- `values(): FastArray` – Devuelve los valores.
- `indexOf(mixed $value): int|null` – Devuelve el índice de un valor, `null` si no existe.
- `includes(mixed $value): bool` – Retorna `true` si el valor está contenido.

---

📌 Notas Finales
---------------

[](#-notas-finales)

- Próximamente se incluirán módulos adicionales como validadores, conversores y controladores de versión de datos.
- Para soporte personalizado o consultas, contactar al autor vía correo electrónico.

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance61

Regular maintenance activity

Popularity12

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~31 days

Total

4

Last Release

247d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/28575628?v=4)[DLUnire Runtime](/maintainers/dlunire)[@dlunire](https://github.com/dlunire)

---

Top Contributors

[![dlunire](https://avatars.githubusercontent.com/u/28575628?v=4)](https://github.com/dlunire "dlunire (56 commits)")

### Embed Badge

![Health badge](/badges/dlunire-dlstorage/health.svg)

```
[![Health](https://phpackages.com/badges/dlunire-dlstorage/health.svg)](https://phpackages.com/packages/dlunire-dlstorage)
```

###  Alternatives

[ericnorris/amazon-s3-php

A lightweight and fast S3 client for PHP.

2147.0k](/packages/ericnorris-amazon-s3-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)