PHPackages                             petitpress/gps-messenger-bundle - 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. petitpress/gps-messenger-bundle

ActiveSymfony-bundle[Queues & Workers](/categories/queues)

petitpress/gps-messenger-bundle
===============================

Google Pub/Sub transport for Symfony Messenger

4.0.0(1mo ago)30553.5k↓44.2%21[2 issues](https://github.com/petitpress/gps-messenger-bundle/issues)[2 PRs](https://github.com/petitpress/gps-messenger-bundle/pulls)2MITPHPPHP >=8.2CI passing

Since Nov 11Pushed 1mo ago7 watchersCompare

[ Source](https://github.com/petitpress/gps-messenger-bundle)[ Packagist](https://packagist.org/packages/petitpress/gps-messenger-bundle)[ Docs](https://www.petitpress.sk)[ RSS](/packages/petitpress-gps-messenger-bundle/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (32)Versions (32)Used By (2)

Google Pub/Sub transport implementation for Symfony Messenger
=============================================================

[](#google-pubsub-transport-implementation-for-symfony-messenger)

This bundle provides a simple implementation of Google Pub/Sub transport for Symfony Messenger.

The bundle requires only `symfony/messenger`, `google/cloud-pubsub` and `symfony/options-resolver` packages. In contrast with [Enqueue GPS transport](https://github.com/php-enqueue/gps), it doesn't require [Enqueue](https://github.com/php-enqueue)and [some bridge](https://github.com/sroze/messenger-enqueue-transport#readme).

Features
--------

[](#features)

- **Compatible with the latest `google/cloud-pubsub` 2.**\*.
- **Zero extra dependencies** beyond core Symfony (e.g. `Symfony Messenger`) and Pub/Sub libraries.
- **Flexible and extensive configuration**, available via options or DSN (Data Source Name), including `deadLetterPolicy`, `enableMessageOrdering`, `ackDeadlineSeconds`).
- **Automatic Pub/Sub Topic and Subscription creation**, with the ability to disable it if needed.
- **Message ordering support** using the `OrderingKeyStamp`.
- **Keep-alive support** for long-running Messenger workers.

Support
-------

[](#support)

VersionStatusSymfony Versions[3.x](https://github.com/petitpress/gps-messenger-bundle/tree/3.x)Actively Supported>= 5.4, <8.0[4.x](https://github.com/petitpress/gps-messenger-bundle/tree/master)Actively Supported>= 7.4Installation
------------

[](#installation)

### Step 1: Install the Bundle

[](#step-1-install-the-bundle)

From within container execute the following command to download the latest version of the bundle:

```
$ composer require petitpress/gps-messenger-bundle --no-scripts
```

### Step 2: Configure environment variables

[](#step-2-configure-environment-variables)

Official [Google Cloud PubSub SDK](https://github.com/googleapis/google-cloud-php-pubsub)requires some globally accessible environment variables.

You might need to change default Symfony DotEnv instance to use `putenv`as Google needs to access some variables through `getenv`. To do so, use putenv method in `config/bootstrap.php`:

```
(new Dotenv())->usePutenv()->...
```

List of Google Pub/Sub configurable variables :

```
# use these for production environment:
GOOGLE_APPLICATION_CREDENTIALS='google-pubsub-credentials.json'
GCLOUD_PROJECT='project-id'

# use these for development environment (if you have installed Pub/Sub emulator):
PUBSUB_EMULATOR_HOST=http://localhost:8538
```

or if you have credentials in a base64 encoded env variable:

```
# config/packages/messenger.yaml

framework:
    messenger:
        transports:
            gps_transport:
                dsn: 'gps://default'
                options:
                    client_config:
                        credentials: '%env(json:base64:GOOGLE_PUBSUB_KEY)%'
```

### Step 3: Configure Symfony Messenger

[](#step-3-configure-symfony-messenger)

```
# config/packages/messenger.yaml

framework:
    messenger:
        transports:
            gps_transport:
                dsn: 'gps://default'
                options:
                    client_config: # optional (default: [])
                        apiEndpoint: 'https://europe-west3-pubsub.googleapis.com'
                    topic: # optional (default name: messages)
                        name: 'messages'
                        options: # optional create options if not exists (default: []), for all options take at look at https://cloud.google.com/php/docs/reference/cloud-pubsub/latest/Topic#_Google_Cloud_PubSub_Topic__create__
                            labels:
                                - label1
                                - label2
                    subscription: # optional (default the same as topic.name)
                        name: 'messages'
                        options: # optional create options if not exists (default: []), for all options take a look at https://cloud.google.com/php/docs/reference/cloud-pubsub/latest/Subscription#_Google_Cloud_PubSub_Subscription__create__
                            enableExactlyOnceDelivery: true
                            labels:
                                - label1
                                - label2
                        pull:
                            maxMessages: 10 # optional (default: 10)
```

or:

```
# config/packages/messenger.yaml

framework:
    messenger:
        transports:
            gps_transport:
                dsn: 'gps://default/messages?client_config[apiEndpoint]=https://europe-west3-pubsub.googleapis.com&subscription[pull][maxMessages]=10'
```

to use emulator in local:

```
# config/packages/dev/messenger.yaml

framework:
    messenger:
        transports:
            gps_transport:
                options:
                    client_config:
                        hasEmulator: true
                        emulatorHost: '%env(PUBSUB_EMULATOR_HOST)%'
```

### Step 4: Configure PetitPressGpsMessengerBundle (optional)

[](#step-4-configure-petitpressgpsmessengerbundle-optional)

Configure the cache service where authentication tokens are stored. The default is `cache.app`.

```
# config/packages/petit_press_gps_messenger.yaml

petit_press_gps_messenger:
    auth_cache: 'cache.app'
```

### Step 5: Use available stamps if needed

[](#step-5-use-available-stamps-if-needed)

- `OrderingKeyStamp`: use for keeping messages of the same context in order. For more information, read an [official documentation](https://cloud.google.com/pubsub/docs/publisher#using_ordering_keys).
- `AttributesStamp`: use to add contextual metadata to serialized messages. For more information, read an [official documentation](https://cloud.google.com/pubsub/docs/publisher#using-attributes). Can be very useful when used together with [subscription filters](https://cloud.google.com/pubsub/docs/subscription-message-filter).
- `GpsSenderOptionsStamp`: use to specify options for the second parameter of the `publish` method in the Pub/Sub client.

### Step 6: Create topics from config

[](#step-6-create-topics-from-config)

```
bin/console messenger:setup-transports
```

License
-------

[](#license)

This bundle is released under the [MIT License](LICENSE).

###  Health Score

65

—

FairBetter than 99% of packages

Maintenance88

Actively maintained with recent releases

Popularity50

Moderate usage in the ecosystem

Community33

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 52.8% 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 ~100 days

Recently: every ~115 days

Total

21

Last Release

53d ago

Major Versions

0.1.2 → 1.0.02021-01-06

1.6.0 → 2.0.02024-01-03

2.1.0 → 3.0.02024-06-04

3.x-dev → 4.0.02026-05-11

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

2.0.0PHP >=8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/19769026?v=4)[Ronald Márföldi](/maintainers/marforon)[@marforon](https://github.com/marforon)

![](https://avatars.githubusercontent.com/u/18593654?v=4)[Lubomir Stanko](/maintainers/stankolubomir)[@stankolubomir](https://github.com/stankolubomir)

![](https://www.gravatar.com/avatar/6e0eb41fcebd2cea5ea138010e8e7782bb92ad57037aa0652ec18d15661ae3f3?d=identicon)[PetitPress a.s.](/maintainers/PetitPress%20a.s.)

---

Top Contributors

[![pulzarraider](https://avatars.githubusercontent.com/u/960844?v=4)](https://github.com/pulzarraider "pulzarraider (28 commits)")[![marforon](https://avatars.githubusercontent.com/u/19769026?v=4)](https://github.com/marforon "marforon (10 commits)")[![vilain-corentin](https://avatars.githubusercontent.com/u/26303058?v=4)](https://github.com/vilain-corentin "vilain-corentin (3 commits)")[![Creeperface01](https://avatars.githubusercontent.com/u/10363500?v=4)](https://github.com/Creeperface01 "Creeperface01 (2 commits)")[![mickprev](https://avatars.githubusercontent.com/u/17760158?v=4)](https://github.com/mickprev "mickprev (2 commits)")[![damienfern](https://avatars.githubusercontent.com/u/22883097?v=4)](https://github.com/damienfern "damienfern (2 commits)")[![DamienLinux](https://avatars.githubusercontent.com/u/60408700?v=4)](https://github.com/DamienLinux "DamienLinux (1 commits)")[![sontungpham](https://avatars.githubusercontent.com/u/101813519?v=4)](https://github.com/sontungpham "sontungpham (1 commits)")[![HeahDude](https://avatars.githubusercontent.com/u/10107633?v=4)](https://github.com/HeahDude "HeahDude (1 commits)")[![sakulb](https://avatars.githubusercontent.com/u/95277083?v=4)](https://github.com/sakulb "sakulb (1 commits)")[![jon-ht](https://avatars.githubusercontent.com/u/17051512?v=4)](https://github.com/jon-ht "jon-ht (1 commits)")[![kilatib](https://avatars.githubusercontent.com/u/2750628?v=4)](https://github.com/kilatib "kilatib (1 commits)")

---

Tags

googlegoogle-cloud-pubsubgoogle-cloud-sdkmessage-queuephpsymfonysymfony-bundlesymfony-messengersymfonygoogleMessengerpubsub

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/petitpress-gps-messenger-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/petitpress-gps-messenger-bundle/health.svg)](https://phpackages.com/packages/petitpress-gps-messenger-bundle)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)

PHPackages © 2026

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