How to use Thumper with Laravel or Symfony?

Integrate Thumper by setting up the connection in your framework's service container or dependency injection. Use the producer and consumer classes as shown in examples, adapting them to fit the framework's event or queue systems for seamless operation.

Thumper vs Laravel Queues: which is better for PHP?

Thumper is ideal for learning RabbitMQ patterns or prototyping with clean abstractions, while Laravel Queues offers a more polished, production-ready solution with multiple backends (Redis, database) and built-in features like jobs and failures. Choose based on project maturity and broker preference.

How to handle message retries in Thumper?

Thumper does not provide built-in retry logic; you must implement it manually in your consumer callbacks. For example, catch exceptions, re-publish messages with delays, or use external libraries to manage retries and dead-letter queues.

Is Thumper good for high-volume messaging?

While Thumper abstracts RabbitMQ efficiently, performance depends on RabbitMQ configuration and PHP setup. For high throughput, optimize connection pooling, consumer concurrency, and message serialization, but consider more mature libraries for critical workloads.

Can Thumper work with Dockerized RabbitMQ?

Yes, Thumper is compatible with any RabbitMQ instance, including Docker containers. Ensure the connection settings (host, port, credentials) are correctly configured to point to your Docker service, similar to the local setup in examples.

What are the main drawbacks of Thumper?

Key drawbacks include its experimental nature, limited documentation beyond examples, and tight coupling to RabbitMQ without support for other brokers. It's best for prototyping or educational purposes rather than production systems.

How to set up parallel processing with multiple consumers?

Use the parallel processing example as a guide: spawn multiple consumer instances with the same queue or exchange settings. Adjust consumer counts and message routing in RabbitMQ to distribute tasks efficiently across processes.

Open-Awesome

Thumper

MITPHP

A PHP library that abstracts common messaging patterns for RabbitMQ, including RPC, pub/sub, and parallel processing.

GitHub

277 stars62 forks0 contributors

What is Thumper?

Thumper is a PHP library that abstracts several messaging patterns for RabbitMQ, such as RPC, publish/subscribe, and parallel processing. It simplifies building message-driven applications by providing high-level interfaces to common RabbitMQ use cases, reducing the need to work directly with low-level AMQP protocols.

Target Audience

PHP developers building distributed systems, microservices, or applications requiring asynchronous communication and task processing with RabbitMQ.

Value Proposition

Developers choose Thumper for its straightforward abstraction of complex RabbitMQ patterns, enabling rapid implementation of messaging workflows without deep AMQP expertise, and its experimental approach to demonstrating RabbitMQ's capabilities in PHP.

Overview

PHP Library that implements several messaging patterns for RabbitMQ

Use Cases

Best For

Implementing RPC communication between PHP microservices
Building publish/subscribe systems for event-driven architectures
Parallel processing of expensive tasks to reduce execution time
Creating job queues for asynchronous background processing
Debugging or monitoring RabbitMQ exchanges with temporary queues
Learning RabbitMQ messaging patterns in PHP through practical examples

Not Ideal For

Production systems requiring stable, long-term support and extensive maintenance
Projects using message brokers other than RabbitMQ, such as Apache Kafka or Redis
Teams needing comprehensive documentation and active community support for complex deployments
Applications where fine-grained control over AMQP features or low-level protocol adjustments is essential

Pros & Cons

Pros

Abstracted Messaging Patterns

Provides high-level interfaces for RPC, publish/subscribe, and parallel processing, as demonstrated in the examples folder, reducing the need for deep AMQP knowledge.

Simple API Design

Offers straightforward producer and consumer classes with clear methods, like publish() and consume(), making it easy to implement basic messaging workflows quickly.

Educational Examples

Includes well-documented examples for common use cases, such as queue servers and topic-based logging, which serve as practical learning tools for RabbitMQ patterns.

Flexible Consumer Callbacks

Supports any valid PHP callback for message processing, allowing developers to integrate custom logic seamlessly, as shown in the consumer setup code.

Cons

Experimental Status

The README explicitly states 'This code is experimental,' indicating it may lack stability, thorough testing, and long-term support for production environments.

Limited Documentation

Beyond basic examples, there is minimal comprehensive documentation, which could hinder debugging, advanced configuration, and understanding edge cases.

RabbitMQ Version Lock-in

Tested only with RabbitMQ 2.1.1, an outdated version, potentially leading to compatibility issues or missing features with modern RabbitMQ releases.

No Built-in Error Handling

Lacks native support for retries, dead-letter queues, or robust error management, requiring developers to implement custom solutions for reliability.

Frequently Asked Questions

Related Projects

PHP AMQP

The most widely used PHP client for RabbitMQ

Stars4,599

Forks1,025

Last commit6 months ago

Enqueue

Message Queue, Job Queue, Broadcasting, WebSockets packages for PHP, Symfony, Laravel, Magento. DEVELOPMENT REPOSITORY - provided by Forma-Pro

Stars2,218

Forks431

Last commit7 months ago

Pheanstalk

PHP client for beanstalkd queue

Stars1,924

Forks281

Last commit4 months ago

BunnyPHP

Performant pure-PHP AMQP (RabbitMQ) sync/async (ReactPHP) library

Stars747

Forks107

Last commit11 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub