honeylex/honeylex-cmf

Honeybee CQRS & ES integration with the Silex framework.

Installs: 3

Dependents: 0

Suggesters: 0

Security: 0

Stars: 8

Watchers: 4

Forks: 0

Open Issues: 1

Language:HTML

Type:project

dev-master 2017-04-02 21:50 UTC

This package is not auto-updated.

Last update: 2024-11-09 19:51:11 UTC


README

Project CMF template for building rapidly scalable applications based on the integration of the Honeybee CQRS & ES framework with the Silex micro framework based on Symfony components.

Alternative Honeybee Integrations

Installation

Docker

You can have Honeylex-CMF running very quickly with Docker and Composer.

If you do not already have Docker, first install it then create a machine with Virtualbox if required.

Bring up the Honeylex-CMF project on Docker as follows:

git clone git@github.com:honeylex/honeylex-cmf.git your-project
cd your-project
composer install --ignore-platform-reqs
# don't forget to connect your shell with `eval $(docker-machine env default)`
composer docker:up

Now you can run commands to setup the project:

composer honeylex project:configure
composer honeylex migrate:up
composer honeylex fixture:import # import a default administrator account

Once containers are running your project will be ready and provisioned!

Run docker-machine ip default to find the IP (typically http://192.168.99.100)

Login as a default administrator with email admin@honeylex.dev and password admin to access the user administration interface.

You can add application secrets in the var/secrets folder of your docker machine. The .env and var/docker/docker-compose.yml files also contain additional global project environment and secrets configuration.

The following docker commands are available via composer from your host machine:

composer docker:up     # create and start containers
composer docker:down   # stop and remove containers
composer docker:start  # start previously stopped containers
composer docker:stop   # stop/suspend running containers
composer docker:prune  # remove dangling volumes and stopped containers

Console

Honeylex-CMF comes with a number of convenient tools to help project setup and maintenance. A complete list of commands can be found by running:

composer honeylex  # alias of docker-compose run --rm php_cli ./bin/honeylex

A useful set of commands are provided for managing the following system features:

  • Configuration
  • Crates (portable code context bundles)
  • Resources (entities such as aggregate roots & projections)
  • Migrations
  • Fixtures
  • Workers (long running asynchronous background processes)
  • Events (managing the event store)
  • Routing

Registered Silex service providers

The bootstrapped Silex app is configured with support for the following service providers:

Additional security services are provided in the included Hlx\Security crate:

Read the Providers documentation for more details about Silex Service Providers.

Questions?

Join us in building awesome scalable applications or ask questions here: