PHPackages                             melia/object-storage - 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. [Caching](/categories/caching)
4. /
5. melia/object-storage

ActiveLibrary[Caching](/categories/caching)

melia/object-storage
====================

Lightweight PHP file-based object store with UUID persistence, lazy-loading references, in-memory cache, file locking, safe mode, and a simple viewer UI.

0.0.5(3d ago)132AGPL-3.0PHPPHP &gt;=8.5

Since Dec 9Pushed 3d agoCompare

[ Source](https://github.com/marvinGitHub/object-storage)[ Packagist](https://packagist.org/packages/melia/object-storage)[ RSS](/packages/melia-object-storage/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (9)Versions (6)Used By (0)

[![Object Storage](assets/logo.svg)](assets/logo.svg)

ObjectStorage
=============

[](#objectstorage)

A lightweight, file-based object store for PHP that persists object graphs by UUID, supports lazy loading, parent auto-updates, and handles deeply nested structures. Includes a simple viewer UI for exploring stored objects.

- Persistent storage by UUID (data + metadata + stubs)
- Lazy loading of references with transparent replacement in parents
- Safe mode, locking, in-memory caching
- Class stubs for fast listing, class registry
- Automatic class aliasing if a class is unknown at load time
- Simple object storage viewer (view.php)
- Directory sharding for large datasets
- Handling of circular references
- Event-driven lifecycle events

Changelog
---------

[](#changelog)

Changes for each release will be documented in the [Changelog](Changelog.md) file.

Installation
------------

[](#installation)

- Copy the library or require it via Composer in your project.
- Ensure the storage directory is writable.
- PHP 8.5+ recommended.

Quick Start
-----------

[](#quick-start)

```
