PHPackages                             pnz/messenger-filesystem-transport - 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. [Queues & Workers](/categories/queues)
4. /
5. pnz/messenger-filesystem-transport

AbandonedArchivedLibrary[Queues & Workers](/categories/queues)

pnz/messenger-filesystem-transport
==================================

Symfony Messenger transport for the filesystem.

v0.1.3(7y ago)111.9k2[1 PRs](https://github.com/thePanz/messenger-filesystem-transport/pulls)MITPHPPHP ^7.1

Since Jun 8Pushed 6y agoCompare

[ Source](https://github.com/thePanz/messenger-filesystem-transport)[ Packagist](https://packagist.org/packages/pnz/messenger-filesystem-transport)[ RSS](/packages/pnz-messenger-filesystem-transport/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (4)Dependencies (5)Versions (5)Used By (0)

Filesystem Transport for Symfony Messenger
==========================================

[](#filesystem-transport-for-symfony-messenger)

[![Latest Stable Version](https://camo.githubusercontent.com/fd8be475ad993384d8aa28785adfd7e3e6b0a8c844ca35a2703bd8d42309c156/68747470733a2f2f706f7365722e707567782e6f72672f706e7a2f6d657373656e6765722d66696c6573797374656d2d7472616e73706f72742f76657273696f6e)](https://packagist.org/packages/pnz/messenger-filesystem-transport)[![Total Downloads](https://camo.githubusercontent.com/043ac4c8f6bdf292ad26cd0e480af92a00e5b883f313a7fbbe276137bff0646e/68747470733a2f2f706f7365722e707567782e6f72672f706e7a2f6d657373656e6765722d66696c6573797374656d2d7472616e73706f72742f646f776e6c6f616473)](https://packagist.org/packages/pnz/messenger-filesystem-transport)[![License](https://camo.githubusercontent.com/010db079ec39e1b230accb5102e8b2e0894e730509582437a9a40fcd0a1d902f/68747470733a2f2f706f7365722e707567782e6f72672f706e7a2f6d657373656e6765722d66696c6573797374656d2d7472616e73706f72742f6c6963656e7365)](https://packagist.org/packages/pnz/messenger-filesystem-transport)[![Latest Unstable Version](https://camo.githubusercontent.com/88904015303d0f277eed1460bfed4344853fb1a51962d61399e527972e08696f/68747470733a2f2f706f7365722e707567782e6f72672f706e7a2f6d657373656e6765722d66696c6573797374656d2d7472616e73706f72742f762f756e737461626c65)](//packagist.org/packages/pnz/messenger-filesystem-transport)[![Build Status](https://camo.githubusercontent.com/e80d34c77c7c58d4b2793f7e56fc33e5053175bfd18b7b3138ccdaa2ae4783d7/68747470733a2f2f7472617669732d63692e636f6d2f74686550616e7a2f6d657373656e6765722d66696c6573797374656d2d7472616e73706f72742e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/thePanz/messenger-filesystem-transport)

Extends the [Symfony Messenger](https://symfony.com/doc/master/components/messenger.html) component to handle the filesystem transport. Queues are processed locally by storing and retrieving messages from the filesystem.

The queuing is implemented as a *LIFO* (Last-In, First-Out) list, this to optimize the filesystem usage and the r/w operations.

Install
-------

[](#install)

```
composer require pnz/messenger-filesystem-transport
```

This transport handles the `filesystem://` schema, use the `FilesystemTransportFactory`to create the transport.

Symfony configuration: use the [Filesystem Transport Bundle](https://packagist.org/packages/pnz/messenger-filesystem-transport-bundle) Bundle.

### Install without the Symfony Bundle:

[](#install-without-the-symfony-bundle)

1. Register the transport factory:

```
#  config/services.yaml
Pnz\Messenger\FilesystemTransport\FilesystemTransportFactory:
    arguments:
        $serializer: '@messenger.transport.symfony_serializer'
        # The following lines are not needed if "autowire" is enabled
        $filesystem: '@filesystem'
        $lockFactory: '@lock.factory'
    # Enable the `filesystem://` transport to be auto-discovered, this is not needed when "autoconfigure" is enabled
    tags: ['messenger.transport_factory']
```

2. Configure the Filesystem transport:

```
#  config/packages/messenger.yaml
parameters:
  # The path *MUST* specify an absolute path of the directory where the queue will be stored
  # Example1: the queue messages will be stored in the project's `var/queue` directory
  env(MESSENGER_TRANSPORT_DSN): "filesystem://%kernel.project_dir%/var/queue"
  # Example2: use the `/tmp/queue` directory (note the triple `/`)
  env(MESSENGER_TRANSPORT_DSN): "filesystem:///tmp/queue"

framework:
    messenger:
        transports:
            filesystem: '%env(resolve:MESSENGER_TRANSPORT_DSN)%'

        routing:
            App\Message\MyMessage: filesystem
```

Configuration
-------------

[](#configuration)

The DSN includes the following query parameters:

- `compress`: Enable/Disable compression of messages storage (gzinflate/gzdeflate), use `compress=true` (default: false)
- `loop_sleep`: Define the sleep interval between loops in micro-seconds, use `loop_sleep=MICRO-SECONDS` (default: 500000)

Example:

```
# .env

# Enable compression, and sleep for 0.8 seconds during loops if the queue is empty
MESSENGER_TRANSPORT_DSN="filesystem://%kernel.project_dir%/var/queue/default?compress=true&loop_sleep=800000"
```

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96% 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 ~69 days

Total

4

Last Release

2689d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4a788c96bbcf89371ff0c614ad9f1655363369cb8e17ffd7afbebf046da6dad8?d=identicon)[thepanz](/maintainers/thepanz)

---

Top Contributors

[![thePanz](https://avatars.githubusercontent.com/u/226021?v=4)](https://github.com/thePanz "thePanz (24 commits)")[![matthieumota](https://avatars.githubusercontent.com/u/2427947?v=4)](https://github.com/matthieumota "matthieumota (1 commits)")

---

Tags

filesystemqueuessymfony-messengersymfony4symfonyfilesystemqueueMessenger

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pnz-messenger-filesystem-transport/health.svg)

```
[![Health](https://phpackages.com/badges/pnz-messenger-filesystem-transport/health.svg)](https://phpackages.com/packages/pnz-messenger-filesystem-transport)
```

###  Alternatives

[koco/messenger-kafka

Symfony Messenger Kafka Transport

931.1M1](/packages/koco-messenger-kafka)[jwage/phpamqplib-messenger

Symfony messenger transport for the php-amqplib/php-amqplib library.

84149.7k1](/packages/jwage-phpamqplib-messenger)[bref/symfony-messenger

Symfony Messenger bridge to run with SQS and SNS on AWS Lambda with Bref

721.2M6](/packages/bref-symfony-messenger)[petitpress/gps-messenger-bundle

Google Pub/Sub transport for Symfony Messenger

29491.0k3](/packages/petitpress-gps-messenger-bundle)

PHPackages © 2026

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