idealo / php-rdkafka-ffi

PHP Kafka client - binding librdkafka via FFI

PHP Kafka Client

This is a Kafka client library for PHP ^7.4 and ^8.0 with a slim librdkafka binding via FFI.

It supports the same interfaces as the PHP RdKafka extension ^5.0 and ^6.0.

Supported Features

• Consumer (low and high level)
• Producer (with support for transactional producing)
• Admin Client
• Mock Cluster to simplify integration tests (even with error situations)
• Support for error handling and logging via callbacks

Runtime Requirements

• PHP ^7.4 or ^8.0 with extensions FFI enabled
• librdkafka ^1.0.0 or ^2.0.0
• Conflicts: RdKafka extension
• Suggested:
  • zend opcache extension for preloading
  • pcntl extension for faster shutdown in request/response context

Note: Support for macOS and Windows is experimental.

Installation

composer require idealo/php-rdkafka-ffi

Note: Expect breaking changes along all 0.* pre-releases. This changes may depend on upcoming major releases of the RdKafka extension or improved interfaces for the experimental features like transactional producer, mock cluster and admin client.

Documentation

https://idealo.github.io/php-rdkafka-ffi/

Changelog

See Changelog for details.

Contributing

We welcome all kinds of contributions. See the Contribution guide for more details.

License

See License for details.

php-rdkafka-ffi's Issues

Question: Benchmark

Hey @dirx

Cool project, i will check it out on the weekend 👍
I was actually about to do the same 😄
Out of curiosity, have you done some inital benchmarking against the extension?
I am very interested in how this roughly compares (probably others are too).

Cheers,
Nick

Add usage documentation

• Consumer low level
• Consumer high level
• Producer
• Configuration
• Topic Configuration
• Admin Client
• Mock Cluster
• librdkafka Version Handling
• FFI and librdkafka
• Preload

Do Message payload support binary data?

Benchmarking ConsumerTopic:consumeBatch fails with "zend_mm_heap corrupted"

https://github.com/dirx/php-ffi-librdkafka/blob/daede23268fb25699838115ce5b0b42c83510ffa/benchmarks/ConsumerBench.php#L95