prooph / event-store-client
异步 TCP 连接的事件存储客户端
Requires
- php: ^7.2
- ext-json: *
- amphp/amp: ^2.1.2
- amphp/artax: ^3.0.14
- amphp/byte-stream: ^1.6
- amphp/file: ^0.3.5
- amphp/socket: ^0.10.12
- google/protobuf: ^3.9
- prooph/event-store: v8.0.0-RC-1
- ramsey/uuid: ^3.8
Requires (Dev)
- amphp/log: ^1.0
- doctrine/instantiator: ^1.1
- php-coveralls/php-coveralls: ^2.1
- phpspec/prophecy: ^1.7.2
- phpunit/phpunit: ^8.2.2
- prooph/php-cs-fixer-config: ^0.3
- sebastian/object-enumerator: ^3.0.3
Suggests
- ext/protobuf: for protobuf PHP extension (pecl)
- dev-master
- v1.0.0-RC-1
- v1.0.0-beta-10
- v1.0.0-beta-9
- v1.0.0-beta-8
- v1.0.0-beta-7
- v1.0.0-beta-6
- v1.0.0-beta-5
- v1.0.0-beta-4
- v1.0.0-beta-3
- v1.0.0-beta-2
- v1.0.0-beta-1
- dev-dependabot/composer/google/protobuf-tw-v3.24.3or-tw-4.0.0
- dev-feature/unreference-heartbeat
- dev-better-test
- dev-unreferenced_heartbeat
This package is auto-updated.
Last update: 2024-08-31 19:05:50 UTC
README
PHP 8.1 事件存储客户端实现。
概述
Prooph 事件存储客户端支持通过 TCP 异步非阻塞通信与 EventStore。
EventStoreConnection
在客户端和事件存储服务器之间维护一个全双工连接。
扩展
推荐使用 Google 的 protobuf
扩展,但不是必需的。
当缺少此扩展时,客户端将回退到使用通过 composer 可安装的 google/protobuf
。
allegro/php-protobuf 扩展不兼容。
如果您的应用程序需要大量并发套接字连接,则需要额外的扩展。
安装
客户端
您可以通过将 "prooph/event-store-client": "dev-master"
添加到 composer.json 中的需求来通过 composer 安装 prooph/event-store-client。
服务器
使用 docker
docker run --name eventstore-node -it -p 2113:2113 -p 1113:1113 eventstore/eventstore
请参阅 eventstore.org 的文档。
请参阅 服务器部分。
在 docker 文件夹中,您将找到三个不同的 docker-compose 设置(单节点、3 节点集群和 3 节点 DNS 集群)。
快速入门
请参阅 examples
文件夹以获取简要概述。
单元测试
纯 PHP
运行带有内存数据库的服务器
注意:这是 Event Store 数据库的启动脚本,不是由该库提供的!
./run-node.sh --run-projections=all --mem-db
您需要忽略 ignore
组
./vendor/bin/phpunit --exclude-group=ignore
这些测试仅在针对空数据库运行时才有效,并且只能手动运行。
在下次运行之前,请重新启动服务器。这样,您始终可以从一个干净的服务器开始。
使用 Docker
请参阅:https://github.com/prooph/event-store-client/tree/master/docker/unittest
文档
文档在 prooph 网站 上。
支持
- 在带有 #prooph 标签的 Stack Overflow 上提问。
- 在 https://github.com/prooph/event-store-client/issues 上提交问题。
- 在 prooph gitter 聊天中打个招呼。
贡献
请随时 fork 并扩展现有的插件或添加新的插件,并通过带有您的更改的拉取请求发送!为了建立一致的代码质量,请为您的所有更改提供单元测试,并可能调整文档。
许可
在 New BSD 许可证 下发布。