dez-php/dez-router

Router Component

v1.3.1 2016-08-30 19:45 UTC

Requires

• php: >=5.5
• dez-php/dez-di: >=1.0
• dez-php/dez-event: >=1.0
• dez-php/dez-http: >=1.0

MIT

• Ivan Gontarenko

• router
• php router
• dez-php router

README

Initialization

After composer install register few components to DI

$di = new Container();

$di->set( 'router', function() {
  return new Router();
} );

$di->set( 'eventDispatcher', function() {
  new Dispatcher();
} );

$di->set( 'request', function() {
  return new Request();
} );

// try to fetch router from container
try {
  /** @var $router Router */
  $router = $di->get( 'router' );
} catch ( \Exception $e ) {
  die($e->getMessage());
}

Register routes

$router->add( '/:controller' );
$router->add( '/:controller/:action' );
$router->add( '/:controller/:action/:id' );
$router->add( '/:controller/:action/:token' );
$router->add( '/:controller/:action.:format/:module-:do/:params/:statusCode' )
  ->regex( 'format', 'html|json' );
  
// or import from files
$router
  ->importFromArray( [
      '/test.php'  => [
          'matches'   => [
              'controller'    => 'test'
          ]
      ]
  ] )
  ->importFromFileArray( './routes.php' )
  ->importFromJson( './routes.json' )
  ->importFromXml( './routes.xml' );

Sample files

routes.json

{
  "/":{},
  "/:format/:module/:controller/:action": {
    "regex": {
      "format": "html|json"
    }
  }
}

routes.xml

<routes>
  <route match=":module">
    <route match=":controller">
      <route match=":action">
        <route match=":hash" hash="[a-z0-9]{32}"></route>
        <route match=":params"></route>
      </route>
    </route>
  </route>
  <route match=":token" controller="auth" action="checkToken" token="[a-f0-9]{40}"></route>
</routes>

routes.php

return [
  '/dashboard'    => [
    'matches'       => [
      'module'        => 'user-panel',
      'controller'    => 'index',
      'action'        => 'dashboard',
    ]
  ]
];