PHPackages                             quillstack/local-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. [File & Storage](/categories/file-storage)
4. /
5. quillstack/local-storage

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

quillstack/local-storage
========================

The library to manage files in local storage.

v0.1.0(4y ago)01.3k2MITPHPPHP ^8.0

Since Aug 10Pushed 4y agoCompare

[ Source](https://github.com/quillstack/local-storage)[ Packagist](https://packagist.org/packages/quillstack/local-storage)[ Docs](https://quillstack.org/storage)[ RSS](/packages/quillstack-local-storage/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (2)Versions (9)Used By (2)

Quillstack Local Storage
========================

[](#quillstack-local-storage)

[![Build Status](https://camo.githubusercontent.com/fc2cca7495276d418c798649556f20e8e8505239d0139384663c7d5ed3cce50e/68747470733a2f2f6170702e7472617669732d63692e636f6d2f7175696c6c737461636b2f6c6f63616c2d73746f726167652e7376673f6272616e63683d6d61696e)](https://app.travis-ci.com/quillstack/local-storage)[![Downloads](https://camo.githubusercontent.com/6524053520a53d6a3410afe68a25871081056cba230696ee3ade3c779fd75370/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7175696c6c737461636b2f6c6f63616c2d73746f726167652e737667)](https://packagist.org/packages/quillstack/local-storage)[![Coverage](https://camo.githubusercontent.com/c40bb4dd56093e1bb9db0f0e5801778fd3d4ebb761756e364e471db6d34f74f3/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d7175696c6c737461636b5f6c6f63616c2d73746f72616765266d65747269633d636f766572616765)](https://sonarcloud.io/dashboard?id=quillstack_local-storage)[![Lines of Code](https://camo.githubusercontent.com/8fb64021ad20bec125bc625315630ec22e1f3889d3d612c28b800147e1157c71/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d7175696c6c737461636b5f6c6f63616c2d73746f72616765266d65747269633d6e636c6f63)](https://sonarcloud.io/dashboard?id=quillstack_local-storage)[![StyleCI](https://camo.githubusercontent.com/8ef3582f55d077b30f76c29360f4b9ea797b4c77bcab3350d22836dcc6a142b3/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3339343737393936382f736869656c643f6272616e63683d6d61696e)](https://github.styleci.io/repos/394779968?branch=main)[![CodeFactor](https://camo.githubusercontent.com/e2e59518fa69d4a95b99ab83af9272df1ac9543aedd7064a5f1b8b978d448fa0/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f7175696c6c737461636b2f6c6f63616c2d73746f726167652f6261646765)](https://www.codefactor.io/repository/github/quillstack/local-storage)[![Packagist License](https://camo.githubusercontent.com/2300daa7e833771c81df236fe56463e78c7998ce4be9ad581a5873ca5a2f6cac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7175696c6c737461636b2f6c6f63616c2d73746f72616765)](https://camo.githubusercontent.com/2300daa7e833771c81df236fe56463e78c7998ce4be9ad581a5873ca5a2f6cac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7175696c6c737461636b2f6c6f63616c2d73746f72616765)[![Reliability Rating](https://camo.githubusercontent.com/3d1aecb82926916ba69383806a4e7bed0c34ae7eb3687ec3fa4627fa040799a4/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d7175696c6c737461636b5f6c6f63616c2d73746f72616765266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/dashboard?id=quillstack_local-storage)[![Maintainability](https://camo.githubusercontent.com/b942aa7b523c595b0c962f1c9bd78b04cb00070d60207ffadff12bfe2e16c925/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f64336662643039663135383035333462306330652f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/quillstack/local-storage/maintainability)[![Security Rating](https://camo.githubusercontent.com/bf381a068e42d76a85268eede72aababec2c27b1be22c14dbba841bad4d52a97/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d7175696c6c737461636b5f6c6f63616c2d73746f72616765266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/dashboard?id=quillstack_local-storage)[![Packagist PHP Version Support](https://camo.githubusercontent.com/a7986b76081e821610ef5e183a6d57d534234b0348bd98aa06c0c1f709fee5d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7175696c6c737461636b2f6c6f63616c2d73746f72616765)](https://camo.githubusercontent.com/a7986b76081e821610ef5e183a6d57d534234b0348bd98aa06c0c1f709fee5d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7175696c6c737461636b2f6c6f63616c2d73746f72616765)

The package to manage files on the local storage.

### Installation

[](#installation)

To install this package, run the standard command using *Composer*:

```
composer require quillstack/local-storage

```

### Usage

[](#usage)

Create a class or inject it as a dependency:

```
use Quillstack\LocalStorage\LocalStorage;

$storage = new LocalStorage();
$storage->save('var/cache/token.txt', 'muHaloosPps23sKkdsaaBBcei');
```

If you want to use it as a dependency:

```
use Quillstack\LocalStorage\LocalStorage;

public function __construct(private LocalStorage $storage)
{
    //
}

public function getTokenFromCache()
{
    $this->storage->get('var/cache/token.txt');
}
```

### Storage interface

[](#storage-interface)

This package implements `quillstack/storage-interface`:

with methods:

- `get()` Retrieves the contents of a file.
    This method opens a file and return its contents, it throws an exception if file doesn't exist.
- `exists()` Checks if the file exists on the storage.
- `missing()` Checks if the file is missing from the storage.
- `save()` Saves the contents to the file.
    This method throws an exception if there are any troubles with saving a file (e.g. no space left on device).
- `delete()` Deletes one or more files.
    This method deletes one or many files and throws an exception if error occurs during deleting a file.

### Unit tests

[](#unit-tests)

Run tests using a command:

```
phpdbg -qrr ./vendor/bin/unit-tests

```

### Docker

[](#docker)

```
$ docker-compose up -d
$ docker exec -w /var/www/html -it quillstack_local-storage sh
```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 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 ~26 days

Recently: every ~2 days

Total

7

Last Release

1583d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2fa2ce7331aba0b089a6397b0f2304a912963d7bd6b2fdda457864abdfd810ec?d=identicon)[radek-ziemniewicz](/maintainers/radek-ziemniewicz)

---

Top Contributors

[![radek-ziemniewicz](https://avatars.githubusercontent.com/u/44390595?v=4)](https://github.com/radek-ziemniewicz "radek-ziemniewicz (18 commits)")

---

Tags

localphp8quillstackstoragestoragelocalphp8quillstack

### Embed Badge

![Health badge](/badges/quillstack-local-storage/health.svg)

```
[![Health](https://phpackages.com/badges/quillstack-local-storage/health.svg)](https://phpackages.com/packages/quillstack-local-storage)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[google/cloud

Google Cloud Client Library

1.2k16.2M53](/packages/google-cloud)[league/flysystem-local

Local filesystem adapter for Flysystem.

226231.8M39](/packages/league-flysystem-local)[sylius/resource-bundle

Resource component for Sylius.

23410.2M173](/packages/sylius-resource-bundle)[microsoft/azure-storage-blob

This project provides a set of PHP client libraries that make it easy to access Microsoft Azure Storage Blob APIs.

5516.0M60](/packages/microsoft-azure-storage-blob)

PHPackages © 2026

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