Download the PHP package arefshojaei/job-queue-system without Composer

PHP Job Queue

A lightweight and simple Job Queue system built with pure PHP and MySQL.

This project allows you to dispatch, store, and process background jobs through a command-line worker. It is designed for developers who need a simple background task mechanism without using external queue services.

Features

• Lightweight and simple architecture
• MySQL-based job storage engine
• Command-line queue worker
• Job dispatching system
• Event listener support
• Job lifecycle and status management
• Exception and failure handling
• Environment configuration using .env
• Eloquent Query Builder integration

Requirements

• PHP 8.2 or higher
• MySQL 8.0 or higher
• Composer

Installation

Install via Composer (Recommended)

Clone the Repository

Project Setup

1. Move into the project directory

2. Install dependencies

3. Environment Configuration

Rename the .env.example file to .env and update the environment variables with your actual project configuration.

4. Database Setup

Running the Queue Worker

The worker continuously watches the jobs table and processes available jobs.

Available Commands

List all jobs

Dispatch a test job

Remove all jobs

Remove tables

Creating a Custom Job

Every job must implement the Job interface:

Example:

Understanding How Jobs Work

This project includes example jobs inside the app/Jobs directory. These jobs exist only as examples to help you understand the workflow and architecture of the queue system.

You can use this queue system in two different ways:

1. Local Jobs (Same Project)

You can create your jobs directly inside the app/Jobs directory and let the queue worker process them.

This is the simplest approach and is recommended for learning and small applications.

2. External PHP Applications as Background Tasks

You may also use this project as a standalone background task processor for another PHP application.

In this architecture, your main application and this queue system run as independent applications, similar to separating services in a microservice architecture. However, this project itself is not a separate service or a message broker.

The external application must be written in PHP and must create jobs that follow the same contract:

The job object is then serialized and stored inside the queue database, where the worker application can retrieve and execute it.

Because both applications need to understand the same job classes, it is strongly recommended to share the same Composer dependencies, especially the job classes and their namespaces, between the producer application and this queue worker.

A common approach is to extract shared jobs and interfaces into a separate Composer package and install it in both projects. This guarantees compatibility and prevents serialization or class-loading issues.

Important Notes

• This is not a replacement for distributed queue systems like RabbitMQ or Kafka.
• Jobs are PHP objects, so the producer and consumer must understand the same PHP classes.
• Both applications should maintain compatible Composer dependencies.
• The queue worker must always be running to process pending jobs.

Done.