r3oath / hive

Hexagonal architecture framework for Laravel

Deprecated

Hive has now been deprecated in favour of the more robust and framework agnostic Enzyme/Axiom package. Axiom is unfortunately not backwards compatible with Hive. But don't worry, it still plays great with Laravel! So if you're just starting out with a new project, try it out! 🎉

Current Build

Installation

Installation is simple, simply issue the following composer command

composer require r3oath/hive

Example App

Want to have a play around with an example implementation of Hive? Check out the example-app branch.

Docs

Check out the documentation at ReadTheDocs

Quick-fire

Hive comes with its own Service Provider that exposes a few new Artisan commands that make generating concrete implementations faster.

To enable it, simply append the following line to the 'providers' array inside config\app.php.

R\Hive\Providers\HiveServiceProvider::class,

The quickest way to setup a new collection of resources for a model is to fire off the the following command

php artisan hive:assemble X

In the example above, replace X with the name of your model. hive:assemble will create a new model, migration, mutator, validator, repo, factory and controller for Model.

Implementations can also be generated seperately through artisan with the following Hive commands:

• hive:command
• hive:controller
• hive:factory
• hive:handler
• hive:instance
• hive:repo
• hive:validator
• hive:mutator

The Hive specific classes will be placed in the app\Lib directory, while the rest will be located in standard Laravel locations.

Example

To play with an example implementation of Hive, check out the example-app branch of this repo.

hive's Issues

Support config?

Is it possible to support config to flexibly set up folder structure?

Refactor/Enhance Observatory Contract & Implementations.

Images for README.md