PHP download

Download the PHP package stream-lib/rabbitmq-super-stream without Composer

On this page you can find all versions of the php package stream-lib/rabbitmq-super-stream. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download stream-lib/rabbitmq-super-stream
More information about stream-lib/rabbitmq-super-stream
Files in stream-lib/rabbitmq-super-stream

Vendor stream-lib
Package rabbitmq-super-stream
Short Description PHP client for publishing to RabbitMQ Super Streams via an internal Go helper.
License MIT
Homepage https://github.com/standard-librarian/rabbitmq-super-stream

Keywords php rabbitmq messaging Streams laravel super-stream

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of stream-lib/rabbitmq-super-stream

Informations about the package rabbitmq-super-stream

RabbitMQ Super Stream Publisher for PHP

stream-lib/rabbitmq-super-stream gives PHP applications a native-feeling API for publishing to RabbitMQ Super Streams while delegating stream-specific work to an internal Go helper binary.

The PHP package is the public surface. The Go helper is an implementation detail that is started and managed automatically.

Features

Native PHP API with no FFI and no custom PHP extension
RabbitMQ Super Stream publishing powered by the official Go stream client
Local HTTP+JSON protocol over Unix domain sockets when available
Automatic fallback to 127.0.0.1 TCP for local helper transport
Helper reuse across PHP requests per effective config hash
Connects to an existing RabbitMQ super stream; production code does not declare streams
Publish confirmations, helper health checks, retries, and structured error mapping
Plain PHP and Laravel integration

Requirements

PHP ^8.2
proc_open, flock, json, and stream_socket_client
Supported bundled helper targets:
- linux-amd64
- linux-arm64
- darwin-amd64
- darwin-arm64

Windows is not supported in v1. The protocol already supports TCP fallback, so Windows support can be added later without changing the public PHP API.

Installation

End users do not need Go installed if they use one of the bundled binary targets above.

If you want to override the bundled helper binary:

Basic Usage

publish() waits for broker confirmation by default and throws a typed PHP exception on failure.

Configuration

Supported options:

host
port
username
password
vhost
super_stream
use_tls
verify_tls
tls_server_name
connect_timeout_ms
confirm_timeout_ms
helper_rpc_timeout_ms
helper_startup_timeout_ms
helper_shutdown_timeout_ms
helper_max_queue_size
helper_transport_preference
helper_runtime_dir
helper_binary

The helper endpoint is managed internally by the library. Normal application configuration should not set it.

Laravel

The package includes a Laravel service provider and facade. See examples/laravel.md.

Internal Architecture

PHP resolves or launches one helper per config hash.
The helper listens on a Unix socket when it can. If not, it binds a random localhost TCP port.
By default on Unix hosts, helper runtime files live under /tmp/ssrs to keep Unix socket paths short enough for macOS and Linux limits.
PHP talks to the helper with raw HTTP+JSON over stream_socket_client.
The helper owns one RabbitMQ environment and a per-partition producer set for the configured super stream.
On startup, the helper queries the configured super stream partitions and connects only to the partitions that already exist.
Publish requests are serialized through a bounded in-memory queue.
Confirmation callbacks map broker confirms back to the originating PHP request id.

Local Development

Install PHP dependencies:
Build the helper for your local machine:
Start RabbitMQ:
Run unit tests:
Run integration tests:
Run the end-to-end example:

Troubleshooting

HelperBinaryNotFoundException:
- Build the helper with make build-helper or point SUPER_STREAM_HELPER_BINARY at a valid binary.
HelperStartupException:
- Inspect the helper log in the runtime directory. By default this is /tmp/ssrs on Unix hosts.
AuthenticationException:
- Check RabbitMQ stream credentials and vhost permissions.
PublishIndeterminateException:
- The helper could not prove whether the broker confirmed the publish before the timeout. Your application should treat this as potentially published and make its own idempotency decision.
Stale runtime files:
- Remove the relevant runtime directory under /tmp/ssrs on Unix, or your configured helper_runtime_dir.

Packaging Notes

End users consume the package through Composer.
The Go helper is bundled as a standalone binary.
scripts/release-binaries.sh cross-compiles the supported targets and places them under resources/bin/....
scripts/package-release-assets.sh creates .tar.gz release assets plus SHA256SUMS from the bundled helper binaries.

Publishing To Packagist

Sign in to Packagist and submit the GitHub repository URL:
After the package is created on Packagist, copy your Packagist API token from your Packagist profile.
Add a GitHub webhook on this repository:
Keep SSL verification enabled and use the default push event.
For every new package version:

Packagist should auto-update from the webhook. If it does not, use the package page on Packagist and trigger a manual update.

Verification Summary

The repo includes:

PHP unit tests for config validation, binary resolution, manifest persistence, transport framing, and helper error mapping
Go unit tests for config validation, manifest writing, and stream error mapping
Docker-based integration tests that declare a super stream, publish through PHP, and verify the message is observable through a Go consumer

All versions of rabbitmq-super-stream with dependencies

PHP Build Version

Package Version

Version v0.1.5 Release 21. Apr 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of rabbitmq-super-stream from vendor stream-lib

Requires php Version ^8.2

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package stream-lib/rabbitmq-super-stream contains the following files

Loading the files please wait ...