Download the PHP package rarg27/laravel-google-cloud-tasks-queue without Composer
On this page you can find all versions of the php package rarg27/laravel-google-cloud-tasks-queue. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package laravel-google-cloud-tasks-queue
Introduction
This package allows Google Cloud Tasks to be used as the queue driver.
Requirements
This package requires Laravel 6 or higher and supports MySQL 8 and PostgreSQL 14. Might support older database versions too, but package hasn't been tested for it. Please check the table below for supported Laravel and PHP versions: |Laravel Version| PHP Version | |---|---| | 6.x | 7.4 or 8.0 | 7.x | 7.4 or 8.0 | 8.x | 7.4 or 8.0 or 8.1 | 9.x | 8.0 or 8.1
Installation
Require the package using Composer Add a new queue connection to `config/queue.php` Update the `QUEUE_CONNECTION` environment variable Now that the package is installed, the final step is to set the correct environment variables. Please check the table below on what the values mean and what their value should be. | Environment variable | Description |Example --------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--- | `STACKKIT_CLOUD_TASKS_PROJECT` | The project your queue belongs to. |`my-project` | `STACKKIT_CLOUD_TASKS_LOCATION` | The region where the project is hosted |`europe-west6` | `STACKKIT_CLOUD_TASKS_QUEUE` | The default queue a job will be added to |`emails` | `STACKKIT_CLOUD_TASKS_SERVICE_EMAIL` | The email address of the service account. Important, it should have the correct roles. See the section below which roles. |`[email protected]` | `STACKKIT_CLOUD_TASKS_HANDLER` (optional) | The URL that Cloud Tasks will call to process a job. This should be the URL to your Laravel app. By default we will use the URL that dispatched the job. |`https://
How it works
Using Cloud Tasks as a Laravel queue driver is fundamentally different than other Laravel queue drivers, like Redis. Typically a Laravel queue has a worker that listens to incoming jobs using the `queue:work` / `queue:listen` command. With Cloud Tasks, this is not the case. Instead, Cloud Tasks will schedule the job for you and make an HTTP request to your application with the job payload. There is no need to run a `queue:work/listen` command.
Dashboard (beta)
The package comes with a beautiful dashboard that can be used to monitor all queued jobs. --- _Experimental_ The dashboard works by storing all outgoing tasks in a database table. When Cloud Tasks calls the application and this package handles the task, we will automatically update the tasks' status, attempts and possible errors. There is probably a (small) performance penalty because each task dispatch and handling does extra database read and writes. Also, the dashboard has not been tested with high throughput queues. --- To make use of it, enable it through the `.env` file: Then publish its assets and migrations: The dashboard is accessible at the URI: /cloud-tasks
Authentication
Set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable with a path to the credentials file. More info: https://cloud.google.com/docs/authentication/production If you're not using your master service account (which has all abilities), you must add the following roles to make it works: 1. App Engine Viewer 2. Cloud Tasks Enqueuer 3. Cloud Tasks Viewer 4. Cloud Tasks Task Deleter 5. Service Account User
Security
The job handler requires each request to have an OpenID token. In the installation step we set the service account email, and with that service account, Cloud Tasks will generate an OpenID token and send it along with the job payload to the handler. This package verifies that the token is digitally signed by Google. Only Google Tasks will be able to call your handler. More information about OpenID Connect: https://developers.google.com/identity/protocols/oauth2/openid-connect
Upgrading
Read [UPGRADING.MD](UPGRADING.md) on how to update versions.
All versions of laravel-google-cloud-tasks-queue with dependencies
PHP Build Version
Package Version
Requires
ext-json Version
*
phpseclib/phpseclib Version ~2.0
google/cloud-tasks Version ^1.10
thecodingmachine/safe Version ^1.0|^2.0
firebase/php-jwt Version ^5.0
phpseclib/phpseclib Version ~2.0
google/cloud-tasks Version ^1.10
thecodingmachine/safe Version ^1.0|^2.0
firebase/php-jwt Version ^5.0
The package rarg27/laravel-google-cloud-tasks-queue contains the following files
Loading the files please wait ....