jafaripur/php-microservice-application

php-microservice skeleton console application starter for microservice node

dev-master 2022-08-18 11:06 UTC

Requires

• php: ^8.1
• jafaripur/php-microservice: dev-master
• jafaripur/php-microservice-user-service: dev-master
• monolog/monolog: ^2.3
• sentry/sdk: ^3.1
• spiral/dotenv-bridge: ^2.8
• spiral/framework: ^2.8
• spiral/roadrunner: ^2.7
• spiral/sentry-bridge: ^1.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.5
• overtrue/phplint: ^4.0
• phpunit/phpunit: ^9.4
• vimeo/psalm: ^4.18

MIT

• Araz J

• template
• rabbitmq
• AMQP
• Microservice
• spiral
• microservice-starter

README

Spiral console application used to write our processors of methods to responsible to client calling.

This application a template for microservice application and implement four methods of jafaripur/php-microservice. Another library created for using this microservice methods jafaripur/php-microservice-user-service.

For consuming and receiving data:

php app.php user-service/listen

For sending tests messages, By using this client library (jafaripur/php-microservice-user-service):

php app.php user-service/send-test

Create project

composer create-project "jafaripur/php-microservice-application dev-master" micro3

Production Build

This application can be run with roadrunner service plugin in production with Dockerfile docker/Dockerfile.prod, Production build with docker:

export DOCKER_BUILDKIT=1 && docker build -f "./docker/Dockerfile.prod" -t "micro3-prod:latest" .

After building, we can create a container or docker swarm service. The production docker image runs with RoadRunner. In this example we use this configuration for RoadRunner, config exist in .rr.yaml file.

version: "2.7"

service:
  topics:
    command: "php ./app.php user-service/listen first-consumer"
    process_num: 10
    exec_timeout: 0
    remain_after_exit: true
    restart_sec: 5

  emits:
    command: "php ./app.php user-service/listen second-consumer"
    process_num: 2
    exec_timeout: 0
    remain_after_exit: true
    restart_sec: 5

logs:
  mode: production
  encoding: console

With this RoadRunner service plugin we can run several consumer with several instance.

For creating docker container from builded image:

docker run -d --init \
    --name micro3-container \
    --restart unless-stopped \
    micro3-prod:latest

And for swarm service:

docker service create --name "micro3-service" \
    --replicas 2 \
    --update-delay 10s \
    micro3-prod:latest

Test

# Run test
docker-compose up --build micro

# Stop and remove created containers
docker-compose down