honeylex/honeylex

Honeybee CQRS & ES integration with the Silex framework.

Honeylex

Project 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., _(*1)

, _(*2)

Alternative Honeybee Integrations

• Honeylex-CMF (Honeylex + CMS tooling)
• Honeyquip (Honeybee + Equip)
• Honeygavi (Honeybee + Agavi)

Installation

Docker

You can have Honeylex running very quickly with Docker and Composer., _(*3)

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

Bring up the Honeylex project on Docker as follows:, _(*5)

git clone git@github.com:honeylex/honeylex.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:, _(*6)

composer honeylex project:configure
composer honeylex migrate:up

Once containers are running your project will be ready and provisioned!, _(*7)

Run docker-machine ip default to find the IP (typically http://192.168.99.100) - Secure site https://192.168.99.100 (untrusted certs in dev mode) - Elasticsearch admin at http://192.168.99.100:9100 - CouchDB admin at http://192.168.99.100:5984/_utils - RabbitMQ admin at http://192.168.99.100:15672, _(*8)

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., _(*9)

The following docker commands are available via composer from your host machine:, _(*10)

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 comes with a number of convenient tools to help project setup and maintenance. A complete list of commands can be found by running:, _(*11)

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, _(*12)

Registered Silex service providers

The bootstrapped Silex app is configured with support for the following service providers:, _(*13)

• AssetServiceProvider
• FormServiceProvider
• LocaleServiceProvider
• MonologServiceProvider
• SessionServiceProvider
• SerializerServiceProvider
• ServiceControllerServiceProvider
• SwiftmailerServiceProvider
• TranslationServiceProvider
• TwigServiceProvider
• UrlGeneratorServiceProvider
• ValidatorServiceProvider
• WebProfilerServiceProvider

Additional security services are provided in Hlx\Security crate:, _(*14)

• RememberMeServiceProvider
• SecurityServiceProvider

Read the Providers documentation for more details about Silex Service Providers., _(*15)

Questions?

Join us in building awesome scalable applications or ask questions here: - Gitter honeybee #Lobby - IRC freenode #honeybee, _(*16)