The Narration PHP Framework - Empowering everyone to build reliable and loosely coupled web apps.
Branch: master
Clone or download
Latest commit 391527a Feb 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config wip Feb 18, 2019
database wip Jan 13, 2019
docs wip Jan 12, 2019
public wip Jan 23, 2019
src wip Feb 19, 2019
tests/Unit upgrade phpstan Jan 17, 2019
.editorconfig wip Jan 11, 2019
.gitattributes wip Jan 11, 2019
.gitignore wip Jan 11, 2019
.scrutinizer.yml wip Jan 11, 2019
.styleci.yml wip Jan 11, 2019
.travis.yml wip Jan 23, 2019
CHANGELOG.md wip Jan 11, 2019
CONTRIBUTING.md wip Jan 11, 2019
LICENSE.md wip Jan 11, 2019
README.md wip Feb 8, 2019
composer.json wip Feb 18, 2019
narrative
phpstan.neon.dist wip Feb 8, 2019
phpunit.xml.dist wip Jan 11, 2019
serve.php wip Jan 11, 2019

README.md

THIS PACKAGE HASN'T BEEN RELEASED, DO NOT USE YET

Build Status Quality Score Total Downloads Latest Version License

This is a work in progress.

Narration is the source for modern PHP - It enforces the implementation of proven patterns to bring resilience, reliability, and coordination to your web application.

Philosophies

  • DDD oriented code architecture
  • Zero coupling to the framework
  • Strong PHPStan rules to ensure the quality of the code
  • For Scalable PSR-7 and PSR-15 compliant REST services.

Quick start

Requires PHP 7.1.3+

Create your project using Composer:

composer create-project narration/narration blog --stability=dev --prefer-source

Then, serve the appplication at http://127.0.0.1:8000/:

php -S 127.0.0.1:8000 serve.php

Structure

Presentation

This presentation layer should contain everythin related to User Interface. TODO...

Application

The application logic is where you implement all use cases that depend on a given front end. It delegates the execution of business rules to the domain layer. Keep this layer thin.

Application > Http > Request Handlers

HTTP request handlers are a fundamental part of any web application. Server-side code receives a request message, processes it, and produces a response message:

final class Index
{
    /**
     * Handle the given request.
     *
     * @param  \Psr\Http\Message\ServerRequestInterface $request
     *
     * @return array
     */
    public function __invoke(ServerRequestInterface $request): array
    {
        return [
            'quote' => 'Intellectuals solve problems, geniuses prevent them.',
        ];
    }
}

Request handlers should be placed at Appplication/Http/RequestHandlers. The routes are defined within the config/routes/http.php file.

This convention leads code that is easier to maintain, refactor and test.

Application > Http > Middleware

An HTTP middleware component participates in processing an HTTP message. It acts on the request, generating the response, or forwarding the request to a subsequent middleware and possibly acting on its response. It provides a convenient mechanism for filtering HTTP requests entering your application:

final class TrimStrings implements MiddlewareInterface
{
    /**
     * Filters the given request before or after sending it to the handler.
     *
     * @param  \Psr\Http\Message\ServerRequestInterface $request
     * @param  \Psr\Http\Server\RequestHandlerInterface $handler
     *
     * @return \Psr\Http\Message\ResponseInterface
     */
    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        foreach ($request->getAttributes() as $name => $value) {
            if (is_string($value)) {
                $request = $request->withAttribute($name, trim($value));
            }
        }

        return $handler->handle($request);
    }
}

The middleware are defined within the config/routes/http.php file.

Application > Injectors

We provide a simple, yet powerful, IOC container. The framework doesn’t couple you to our container, feel free to swap to another PSR-11 implementation on the ‘config/container.php’ file.

The container is used by the default PSR-7 router of the framework to inject the necessary dependencies on the request handlers.

An injector injects the dependencies of the application on the container. They should be placed at Appplication/Injectors.

Injectors are defined within the config/container.php file.

Domain

Responsible for representing concepts of the business rules. This layer is the heart of business software.

Infrastructure

The infrastructure layer is how the data that is initially held in domain entities (in memory) is persisted in databases or another persistent store. An example is using Doctrine code to implement the Repository pattern classes that use Entities to persist data in a relational database.

Contributing

Thank you for considering to contribute to Narration. All the contribution guidelines are mentioned here.

You can have a look at the CHANGELOG for constant updates & detailed information about the changes. You can also follow the twitter account for latest announcements or just come say hi!: @enunomaduro

Support the development

Do you like this project? Support it by donating

Credits

Lot of this readme is based on Design a DDD-oriented microservice by Microsoft.

License

Narration is an open-sourced software licensed under the MIT license.