Binds icanboogie/http to ICanBoogie
Domain dispatchers may be defined using configuration fragments. One actually define dispatcher constructors as a class name or a callable, that would return a dispatcher. Constructor class should extend the AbstractDispatcherConstructor.
The following example demonstrates how some domain dispatchers may be defined:
<?php // config/http.php use ICanBoogie\Binding\HTTP\DispatcherConfig as Config; return [ 'dispatchers' => [ 'pages' => [ Config::CONSTRUCTOR => \Icybee\Modules\Pages\PageDispatcher::class, Config::WEIGHT => Config::WEIGHT_BOTTOM ], 'routing' => \ICanBoogie\Routing\RouteDispatcher::class, 'operation' => [ Config::CONSTRUCTOR => \ICanBoogie\Operation\OperationDispatcher::class, Config::WEIGHT => Config::WEIGHT_BEFORE_PREFIX . 'routing' ] ] ];
The dispatchers configuration may be obtained through the application:
<?php // … $config = $app->configs['http_dispatchers'];
The following prototype methods are defined, the ApplicationBindings trait may be used for type hinting:
ICanBoogie\Application::get_initial_request: Returns the initial request.
ICanBoogie\Application::get_request: Returns the current request.
ICanBoogie\Application::get_dispatcher: Returns the request dispatcher.
The following example demonstrates how this getters may be used:
<?php namespace ICanBoogie; require 'vendor/autoload.php'; $app = boot(); $initial_request = $app->initial_request; $request = $app->request; $dispatcher = $app->dispatcher;
The following event hooks are attached:
ICanBoogie\Application::configure: Used to define an instance of ProvideDispatcher as dispatcher provider. This provider uses the
http_dispatchersconfiguration to create the request dispatcher.
The package requires PHP 5.6 or later.
The recommended way to install this package is through Composer:
$ composer require icanboogie/bind-http
The package is available on GitHub, its repository can be cloned with the following command line:
$ git clone https://github.com/ICanBoogie/bind-http.git
The package is documented as part of the ICanBoogie framework documentation. You can
generate the documentation for the package and its dependencies with the
make doc command. The
documentation is generated in the
build/docs directory. ApiGen is required.
The directory can later be cleaned with the
make clean command.
The test suite is ran with the
make test command. PHPUnit and
Composer need to be globally available to run the suite. The command
installs dependencies as required. The
make test-coverage command runs test suite and also creates
an HTML coverage report in
build/coverage. The directory can later be cleaned with the
make clean command.
The package is continuously tested by Travis CI.
icanboogie/bind-http is licensed under the New BSD License - See the LICENSE file for details.