pharmanity/event-store-client
异步TCP连接的事件存储客户端
Requires
- php: ^7.4
- ext-json: *
- amphp/amp: ^2.4.4
- amphp/byte-stream: ^1.6.3
- amphp/file: ^1.0.0 || ^2.0.0
- amphp/http-client: ^4.2.2
- amphp/socket: ^1.1.1
- google/protobuf: ^3.11.4
- pharmanity/event-store: dev-master
- psr/log: ^1.1.3
Requires (Dev)
- amphp/log: ^1.1
- amphp/phpunit-util: ^2.0
- doctrine/instantiator: ^1.3
- php-coveralls/php-coveralls: ^2.2
- phpspec/prophecy: ^1.10.3
- phpunit/phpunit: ^9.1
- prooph/php-cs-fixer-config: ^0.4.0
- vimeo/psalm: ^4.0.1
Suggests
- ext/protobuf: for protobuf PHP extension (pecl)
This package is not auto-updated.
Last update: 2024-09-20 17:48:11 UTC
README
PHP 7.4 事件存储客户端实现。
概述
Prooph Event Store Client 支持通过 TCP 异步非阻塞通信与 EventStore。
EventStoreConnection
在客户端和事件存储服务器之间维护全双工连接。
扩展
推荐使用 Google 的 protobuf
扩展,但不是必需的。
当缺少此扩展时,客户端将回退到使用 composer 安装的 google/protobuf
。
扩展 allegro/php-protobuf 不兼容。
如果您的应用程序需要大量并发套接字连接,则可能需要额外的扩展。
安装
客户端
您可以通过在 composer.json 中添加 "prooph/event-store-client": "dev-master"
作为需求来通过 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
运行具有内存数据库的服务器
注意:这是事件存储数据库的启动脚本,不是由该库提供的!
./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 聊天中打招呼。
贡献
请随意分支和扩展现有功能或添加新插件,并提交包含您更改的拉取请求!为了建立一致的代码质量,请为所有更改提供单元测试,并可能修改文档。
许可
在 New BSD License 下发布。