siokas/laryr

Helps Laravel users to add routes easily.

0.4 2016-08-04 06:44 UTC

Requires

• php: ~5.5|~7.0
• illuminate/support: ~5.1
• symfony/yaml: ^3.1

Requires (Dev)

• phpunit/phpunit: ~4.0||~5.0
• scrutinizer/ocular: ~1.1
• squizlabs/php_codesniffer: ~2.3

MIT

• Apostolos Siokas

• yaml
• routes
• laravel
• Siokas
• Laryr

README

This package helps Laravel users to add routes easily. There will be a yaml on your project in which you have the option to specify the routes. Currently the package provides functionality for simple routes and group routes. The plan for a future update is to include more complex routes with where statements.

The package supports functionality for:

• Routes with all methods (get, post, put, patch, delete, resource)
• Route Name
• Middleware
• (new) Route Groups

Note: Tested and works fine on Laravel 5.3

Install

Via Composer

composer require siokas/laryr

After the installation you should regirster the ServiceProvider to the config/app.php file. Add the following line in the providers array.

Siokas\Laryr\LaryrServiceProvider::class,

Now you should publish the unpublished files. Open terminal and type:

php artisan vendor:publish

This command will publish a yaml file at the root directory of your app, called routes.yml and a configuration file in config directory called laryr.php.

Usage

Open the routes.yml file and enter your application routes in a collection type.

-
  route: test
  method: get
  controller: AppController
  function: index

This will create a route which points to the specified Controller and function.

Note 1: If you want to change the name and the path of the routes.yml file, you have to specify the new path and filename in the config/laryr.php file.

Note 2: Nested functions are not supported on the yaml file.

To create a route group you have to add a route with method as group and name your route.

-
  method: group
  name: groupRoutes

Then you have to create a .yml file in the same directory with the routes.yml file. This file has to have the same name that you spesified in the previous step. To create that file, open the terminal and type the make artisan command:

php artisan make:yaml groupRoutes

In this file you can specify the routes you want in the same way.

Options

There are two options in the routes which are listed below:

  name: routeName
  middleware: auth

For the route groups there are more available options to specify:

  name: test
  domain: {account}.app.dev
  prefix: user
  namespace: UsersAccount

Tutorial

The following link contains a nice fully tutorial on how to use the package to your project: https://www.siokas.com/post/laryr/

Libraries

• Symfony/Yaml

License

The MIT License (MIT). Please see License File for more information.