suitetea/quick-routes

QuickRoutes simplifies and shortens mundane and repeated declaration of routes and controller methods.

Installs: 161

Dependents: 0

Stars: 1

Watchers: 3

Language: PHP

0.8.5 2014-11-17 20:43 UTC

README

Do you ever find yourself declaring the same types of routes over and over again through multiple controllers even though they all do and look basically the same thing/way? That's where Quick Routes comes in.

Turn this:

Route::get('users', 'UserController@index');
Route::post('users', array(
    'as' => 'user.create',
    'uses' => 'UserController@create'
));
Route::post('users/{id}', array(
    'as' => 'user.edit',
    'uses' => 'UserController@update'
))->where(array(
    'id' => '[0-9]+'
));
Route::get('users/{id}/delete', array(
    'as' => 'user.delete',
    'uses' => 'UserController@delete'
))->where(array(
    'id' => '[0-9]+'
));

Route::get('tweets', 'TweetController@index');
Route::post('tweets', array(
    'as' => 'tweet.create',
    'uses' => 'TweetController@create'
));
Route::post('tweets/{id}', array(
    'as' => 'tweet.edit',
    'uses' => 'TweetController@update'
))->where(array(
    'id' => '[0-9]+'
));
Route::get('tweets/{id}/delete', array(
    'as' => 'tweet.delete',
    'uses' => 'TweetController@delete'
))->where(array(
    'id' => '[0-9]+'
));

into this:

QuickRoutes::register('users', ['index', 'create', 'edit', 'delete']);
QuickRoutes::register('tweets', '*');

*you can specify which routes to use, or simply use all ("*")

The magic happens by setting default routes in an array either through a config file or setting it.

There are multiple ways to set the default routes.

1) The package config found in "app/config/suitetea/quick-routes" (available after publish package config). 2) Calling QuickRoutes::setDefault() and passing in a properly formatted array. 3) Overriding the defaults per register call. There is an option third parameter part of register that you can pass routes to be used instead of the global defaults.

Additionally, you can group routes by using different default sets. Ex:

$set_1 = array(); // Declare your routes here
QuickRoutes::setDefault($set_1); // Register calls after this will use $set_1
QuickRoutes::register('users', ['route_1', 'route_3']);
QuickRoutes::register('someroute', '*');

$set_2 = array(); // Another set of routes
QuickRoutes::setDefault($set_2); // Register calls after this will use $set_2
QuickRoutes::register('anotherroute', ['foo', 'bar']);

New in 0.8.0

Fixed a bug where if a HTTP method wasn't specified, the previously declared method was used, resulting in unexpected and unwanted results.

The second parameter in the register method is now optional. If not set, all routes will be used by default. The exception to this is when overriding the default route set for a single instance. In this case, the asterisk ('*') may still be used.

QuickRoutes::register('users'); // assumes all
QuickRoutes::register('settings', '*', $settings_routes);

Introduced with method. Using with merges default routes with a set of routes given for a single instance.

For example, this:

$default_routes = [
    'index' => [
        'pattern' => '/',
    ],
    'create' => [
        'pattern' => 'create',
        'methods' => ['get','post']
    ]
];

$image_routes = [
    'img_create' => [
        'pattern' => 'create/image'
        'methods' => ['post']
    ]
];

QuickRoutes::register('users', '*', array_merge($default_routes, $image_routes));

is equivalent to this:

QuickRoutes::with($image_routes)->register('users');

Also, you can define a custom uses value, including a Closure:

$image_routes = [ 'img_create' => [ 'pattern' => 'create/image' 'methods' => ['post'], 'uses' => function() { return Redirect::route('image.view'); } ] ];

New in 0.7.0

You can now create multiple methods per route, just pass the methods parameter as an array.

Installation

Via Composer

{
    "require": {
        "suitetea/quick-routes": "dev-develop"
    }
}

The default routes array should be in the following format:

$default_routes = [
   'index' => [
       'pattern' => '/',
   ],
   'create' => [
       'pattern' => 'create',
       'methods' => ['get','post']
   ],
   'edit' => [
       'pattern' => '{id}/edit',
       'where' => ['id' => '[0-9]+'],
       'methods' => ['get','post']
   ],
   'view' => [
       'pattern' => '{id}',
       'where' => ['id' => '0-9]+']
   ]
];

Optionally, you can publish the package config file and set default routes there.

php artisan config:publish suitetea/quick-routes