https://github.com/php-mq/server

The PHP Message Queue Server
https://github.com/php-mq/server

async message-queue php7 server socket

Last synced: 3 months ago
JSON representation

The PHP Message Queue Server

• Host: GitHub
• URL: https://github.com/php-mq/server
• Owner: php-mq
• License: mit
• Created: 2017-05-07T16:36:13.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2018-01-01T21:48:31.000Z (about 7 years ago)
• Last Synced: 2024-10-01T18:10:07.382Z (3 months ago)
• Topics: async, message-queue, php7, server, socket
• Language: PHP
• Size: 629 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.org/php-mq/server.svg?branch=master)](https://travis-ci.org/php-mq/server)

[![Latest Stable Version](https://poser.pugx.org/php-mq/server/v/stable)](https://packagist.org/packages/php-mq/server) 

[![Total Downloads](https://poser.pugx.org/php-mq/server/downloads)](https://packagist.org/packages/php-mq/server) 

[![Coverage Status](https://coveralls.io/repos/github/php-mq/server/badge.svg?branch=master)](https://coveralls.io/github/php-mq/server?branch=master)

# PHPMQ\MessageQueueServer

A lightweight PHP message queue

At the moment this is a proof-of-concept implementation.

## Description

This implementation aims to implement the following requirements.

For details of the client-endpoint-communication see the message [protocol documentation](https://github.com/php-mq/protocol/blob/master/README.md).

### Message endpoint

* Establish a communication endpoint via network or unix domain socket. (both should be possible)

* Accept connections to that endpoint and constantly receive messages from clients

### Message senders

* Can connect/disconnect to/from the message endpoint

* Can request a named queue

* Can send arbitrary amount of messages to the queue

### Message queues

* Create named queues as they are requested by the sender

* Flush queues on demand

* Releases acknowledged messages

* Give status feedback on existing queues

* First in - First out

### Message persistence

 

* Persist incoming messages to an SQLite3 memory storage

* Mirror the SQLite3 memory storage to a SQLite3 file storage to keep messages beyond a reboot

* Mirror to file storage in background to keep persistence fast 

### Message consumers

* Can connect/disconnect to/from the message endpoint

* Can consume a variable amount of messages from one or multiple named queues

* Must acknowledge the consumed message to release it from the queue 

### Message distribution

* Distribute messages equally to all connected consumers

* Reallocates distribution on dis-/connect of consumers

* Dispatches a message to other consumer, if message was dispatched but not acknowledged and the respective consumer disconnected

## Contributing

Contributions are welcome and will be fully credited. Please see the [contribution guide](.github/CONTRIBUTING.md) for details.