Kafka-PHP 开源项目教程

1. 项目的目录结构及介绍

Kafka-PHP 项目的目录结构如下：

kafka-php/
├── examples/
│   ├── consumer.php
│   ├── producer.php
│   └── ...
├── src/
│   ├── Client.php
│   ├── Consumer.php
│   ├── Producer.php
│   └── ...
├── tests/
│   ├── ClientTest.php
│   ├── ConsumerTest.php
│   ├── ProducerTest.php
│   └── ...
├── .gitignore
├── composer.json
├── LICENSE
├── README.md
└── ...

目录介绍

• examples/: 包含一些示例代码，如消费者和生产者的示例。
• src/: 项目的核心源代码，包括客户端、消费者和生产者的实现。
• tests/: 单元测试文件，用于测试核心功能的正确性。
• .gitignore: Git 忽略文件列表。
• composer.json: Composer 依赖管理文件。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

Kafka-PHP 项目的启动文件主要是 examples/ 目录下的示例文件。以下是两个主要的启动文件：

consumer.php

<?php
require '../vendor/autoload.php';

use Kafka\Consumer;
use Kafka\ConsumerConfig;

$config = ConsumerConfig::getInstance();
$config->setMetadataBrokerList('127.0.0.1:9092');
$config->setGroupId('test');
$config->setTopics(['test']);

$consumer = new Consumer();
$consumer->start(function($topic, $part, $message) {
    var_dump($message);
});

producer.php

<?php
require '../vendor/autoload.php';

use Kafka\Producer;
use Kafka\ProducerConfig;

$config = ProducerConfig::getInstance();
$config->setMetadataBrokerList('127.0.0.1:9092');

$producer = new Producer();
$producer->send([
    [
        'topic' => 'test',
        'value' => 'test message',
        'key' => 'test-key',
    ],
]);

3. 项目的配置文件介绍

Kafka-PHP 项目的配置主要通过 ConsumerConfig 和 ProducerConfig 类来完成。以下是一些常用的配置项：

ConsumerConfig

$config = ConsumerConfig::getInstance();
$config->setMetadataBrokerList('127.0.0.1:9092');
$config->setGroupId('test');
$config->setTopics(['test']);
$config->setOffsetReset('earliest');

ProducerConfig

$config = ProducerConfig::getInstance();
$config->setMetadataBrokerList('127.0.0.1:9092');
$config->setRequiredAck(1);

配置项介绍

• setMetadataBrokerList: 设置 Kafka broker 的地址列表。
• setGroupId: 设置消费者组的 ID。
• setTopics: 设置消费者订阅的主题。
• setOffsetReset: 设置消费者偏移量重置策略。
• setRequiredAck: 设置生产者请求的确认模式。

以上是 Kafka-PHP 开源项目的教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！