sasezaki/backbeard

yet another DSLish minimum oriented framework for PHP

0.8.0 2019-06-15 03:31 UTC

Requires

• php: >=7.2.0
• nikic/fast-route: ^0.6
• psr/http-factory: ^1.0
• psr/http-message: ^1.0.0
• struggle-for-php/sfp-stream-view: ^0.1.0

Requires (Dev)

• phpunit/phpunit: ^7
• zendframework/zend-coding-standard: ~1.0.0
• zendframework/zend-diactoros: ^2

BSD-3-Clause

• sasezaki

• router
• psr-7
• psr7

README

Backbeard is yet another DSLish minimum oriented framework for PHP.

Principle

yield $router($request) => $action();

Usage

<?php
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Message\ResponseInterface;
use Backbeard\Dispatcher;
use Backbeard\ValidationError;

$routingFactory = function ($container) {
    yield '/hello' => 'hello';

    $error = (yield ['POST' => '/entry/{id:[0-9]}'] => function ($id) {
        if ($this->getRequest()->getPost()['NAME'] == 'wtf') {
            return ['var1' => 'baz']; // will be render entry.phtml
        } else {
            return new ValidationError(['error message!']);
        }
    });

    yield '/entry/{id:[0-9]}' => function ($id) use ($error) {
        $message = $error ? htmlspecialchars(current($error->getMessages())) :'';
        return "Hello $id ".$message.
        '<form method="POST" action="/entry/'.$id.'">'.
            'NAME<input type="text" name="NAME">'.
        '</form>';
    };

    yield [
      'GET' => '/foo',
      'Header' => [
        'User-Agent' => function($headers){
          if (!empty($headers) && strpos(current($headers), 'Coffee') === 0) {
            return true;
          }
        }
      ]
    ] => function () {
        return $this->getResponseFactory()->createResponse(418);
    }; // status code "I'm a teapot"

    yield (ServerRequestInterface $request) {
		return true;
    } => function () {
    	/** @var ResponseInterface $this */
    	return $this;
    };
};

(new Dispatcher($routingFactory($container)))->dispatch(new Request);

Install with composer

• composer require sasezaki/backbeard dev-master

Using As Middleware for zend-stratigility

https://github.com/struggle-for-php/sfp-stratigility-skeleton

• php composer.phar create-project -s dev struggle-for-php/sfp-stratigility-skeleton path/to/install

  When install finished, you can try running with php built-in web server

• php -S localhost:8080 -t public/ public/index.php

NOTES

THIS PROJECT IS A PROOF OF CONCEPT FOR GENERATOR BASED ROUTER, AND NOT INTENDED FOR PRODUCTION USE. PLEASE USE AT YOUR OWN RISK.