Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/petitpress/gps-messenger-bundle
The bundle provides a simple implementation of Google Pub/Sub transport for Symfony Messenger.
https://github.com/petitpress/gps-messenger-bundle
google google-cloud-pubsub google-cloud-sdk message-queue symfony symfony-bundle symfony-messenger
Last synced: 10 days ago
JSON representation
The bundle provides a simple implementation of Google Pub/Sub transport for Symfony Messenger.
- Host: GitHub
- URL: https://github.com/petitpress/gps-messenger-bundle
- Owner: petitpress
- License: mit
- Created: 2020-11-11T16:12:06.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-23T09:14:05.000Z (6 months ago)
- Last Synced: 2024-05-23T09:51:33.628Z (6 months ago)
- Topics: google, google-cloud-pubsub, google-cloud-sdk, message-queue, symfony, symfony-bundle, symfony-messenger
- Language: PHP
- Homepage:
- Size: 88.9 KB
- Stars: 17
- Watchers: 6
- Forks: 15
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - petitpress/gps-messenger-bundle - The bundle provides a simple implementation of Google Pub/Sub transport for Symfony Messenger. (PHP)
README
Google Pub/Sub 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).
It supports ordering messages with `OrderingKeyStamp` and it's not outdated.
## Installation
### Step 1: Install the Bundle
From within container execute the following command to download the latest version of the bundle:
```console
$ composer require petitpress/gps-messenger-bundle --no-scripts
```
### 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`:
```php
(new Dotenv())->usePutenv()->...
```
List of Google Pub/Sub configurable variables :
```dotenv
# use these for production environemnt:
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:
```yaml
# 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
```yaml
# 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://googleapis.github.io/google-cloud-php/#/docs/google-cloud/v0.188.0/pubsub/topic?method=create
labels:
- label1
- label2
subscription: # optional (default the same as topic.name)
name: 'messages'
options: # optional create options if not exists (default: []), fol all options take a look at https://googleapis.github.io/google-cloud-php/#/docs/google-cloud/v0.188.0/pubsub/subscription?method=create
enableExactlyOnceDelivery: true
labels:
- label1
- label2
pull:
maxMessages: 10 # optional (default: 10)
```
or:
```yaml
# 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:
```yaml
# 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)
Configure the cache service where authentication tokens are stored. The default is `cache.app`.
```yaml
# config/packages/petit_press_gps_messenger.yaml
petit_press_gps_messenger:
auth_cache: 'cache.app'
```
### 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).
### Step 6: Create topics from config
```bash
bin/console messenger:setup-transports
```