PHPackages                             spazzmarticus/tus-server - 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. [API Development](/categories/api)
4. /
5. spazzmarticus/tus-server

ActiveLibrary[API Development](/categories/api)

spazzmarticus/tus-server
========================

Tus.io-protocol server implementation using PSR standards

2.0.0(2y ago)821.4k↓42.1%2GPL-3.0-or-laterPHPPHP ^8.2|^8.3CI failing

Since Mar 10Pushed 1y ago2 watchersCompare

[ Source](https://github.com/SpazzMarticus/TusServer)[ Packagist](https://packagist.org/packages/spazzmarticus/tus-server)[ RSS](/packages/spazzmarticus-tus-server/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (18)Versions (23)Used By (0)

Tus - Server
============

[](#tus---server)

A **server** implementation of the [*"tus.io Resumable File Uploads"*](https://tus.io/) protocol using PSR HTTP standards.

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

[](#installation)

Use [composer](https://getcomposer.org/) to install:

```
composer require spazzmarticus/tus-server
```

Don't forget to install a [PSR-7](https://packagist.org/providers/psr/http-message-implementation) and [PSR-17](https://packagist.org/providers/psr/http-factory-implementation) implementation you want to use.

[PSR](https://www.php-fig.org/)
-------------------------------

[](#psr)

### Implements

[](#implements)

- [PSR-15: HTTP Server Request Handlers](https://www.php-fig.org/psr/psr-15/) - `TusServer` implements `Psr\Http\Server\RequestHandlerInterface`

### Uses

[](#uses)

- [PSR-3: Logger Interface](https://www.php-fig.org/psr/psr-3/) - *(optional)* Pass a `Psr\Log\LoggerInterface` to `TusServer`
- [PSR-7: HTTP Message Interface](https://www.php-fig.org/psr/psr-7) - An instance of `Psr\Http\Message\ServerRequestInterface` must be passed to `TusServer` .
- [PSR-17: HTTP Factories](https://www.php-fig.org/psr/psr-17) - Responses are created by using a ` Psr\Http\Message\ResponseFactoryInterface`
- [PSR-16: Simple Cache](https://www.php-fig.org/psr/psr-16) - Is used to **store** metadata (path to the file, `Upload-Metadata` passed by client, ... ) while uploading. \[see ["Cache as storage?!"](#cache-as-storage) below\]
- [PSR-12: Extended Coding Style Guide](https://www.php-fig.org/psr/psr-12) - Code is written and formatted according to PSR-12.

Demo
----

[](#demo)

You can demo `TusServer` by installing the dev-dependencies ( `composer install` ) and running the provided `server.php` :

```
php -S localhost:8000 example/server.php
```

Open your browser, surf to [localhost:8000/](http://localhost:8000/) and use ([Uppy](https://uppy.io/)) to upload.

Uploads are stored at `example/uploads/...` , the filesystem cache is at `example/cache/` .

Surf to [localhost:8000/reset](http://localhost:8000/reset) to **permanently delete** *uploads*, *intermediate chunks* and the *metadata-storage*. There might be an error log at `example/log/php-error.php` and a server log at `example/log/tus-server.log` containing some additional information.

Test
----

[](#test)

Automated testing is done with:

- [PHPUnit](https://github.com/sebastianbergmann/phpunit) - unit- and integration-tests
- [newman](https://github.com/postmanlabs/newman) - Verify `TusServer` meets the tus. io-protocol.

Examples
--------

[](#examples)

- [Slim v4](https://github.com/SpazzMarticus/TusServer-Example-Slim) - Slim routes allow to directly call this tus-server implementation.

> 👋 This is how I use tus-server.

Cache as storage?!
------------------

[](#cache-as-storage)

`TusServer` needs something fast to store metadata about uploads. Since the payload is small and performance is important, caches can be used.

Instead of using a volatile cache only, you should use a chain containing both a fast volatile **and** a slower non-volatile cache. (Losing the metadata mid-upload does not allow for resuming uploads. )

> 👋 I use [symfony/cache](https://github.com/symfony/cache):
>
> ```
>  $volatileCache = new Symfony\Component\Cache\Adapter\ApcuAdapter('...');
>  $nonVolatileCache = new Symfony\Component\Cache\Adapter\FilesystemAdapter('', 0, __DIR__ . '/...');
>
>  $cacheChain = new Symfony\Component\Cache\Adapter\ChainAdapter([$volatileCache, $nonVolatileCache]);
>
>  $storage = new Symfony\Component\Cache\Psr16Cache($cacheChain);
> ```

Alternatives
------------

[](#alternatives)

- [ankitpokhrel/tus-php](https://github.com/ankitpokhrel/tus-php) - Did not provide enough flexibility for my needs and is the reason I decided to start my own implementation. (Provides a php tus-client, if you are looking for that.)

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 90.7% 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 ~89 days

Recently: every ~79 days

Total

21

Last Release

522d ago

Major Versions

0.2.3 → 1.0.02020-08-13

1.2.0 → 2.0.0-rc12024-03-12

1.2.1 → 2.1.0-rc12025-01-16

PHP version history (2 changes)0.2.3PHP >=7.4.0

2.0.0-rc1PHP ^8.2|^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/7671dde90009502e4cdb4576dba1a34d1db8aecd12a2eed1dbbf72b7d27a8e87?d=identicon)[SpazzMarticus](/maintainers/SpazzMarticus)

---

Top Contributors

[![SpazzMarticus](https://avatars.githubusercontent.com/u/5716457?v=4)](https://github.com/SpazzMarticus "SpazzMarticus (78 commits)")[![darthf1](https://avatars.githubusercontent.com/u/17253332?v=4)](https://github.com/darthf1 "darthf1 (6 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")

---

Tags

phpresumable-uploadtustus-protocol

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/spazzmarticus-tus-server/health.svg)

```
[![Health](https://phpackages.com/badges/spazzmarticus-tus-server/health.svg)](https://phpackages.com/packages/spazzmarticus-tus-server)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[cakephp/cakephp

The CakePHP framework

8.9k19.5M1.8k](/packages/cakephp-cakephp)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)

PHPackages © 2026

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