Download the PHP package olliecodes/laravel-route-registrars without Composer
On this page you can find all versions of the php package olliecodes/laravel-route-registrars. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download olliecodes/laravel-route-registrars
More information about olliecodes/laravel-route-registrars
Files in olliecodes/laravel-route-registrars
Package laravel-route-registrars
Short Description Adds route registrars as an alternative object based approach to registering routes.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-route-registrars
Laravel Route Registrars
This package introduces a clean object based way to define your routes in a Laravel application. A tutorial on the basic premise exists on Laravel news, written by @juststeveking.
Install
Install via composer.
Fresh Laravel Installation
If you're installing this package on a fresh laravel installation, you'll want to run the following command before you do anything with your routes.
This will overwrite the app/Providers/RouteServiceProvider.php file with one compatible with the route registrars, and create default route registrars to replace both routes/web.php and routes/api.php.
Existing Laravel Installation
If you have an existing application, it is recommended that you read through the Laravel News article that covers this approach, as you're going to have to manually refactor your route service provider and route files.
Requirements
This package requires the following;
- PHP >= 8.0 (Including 8).
laravel/framework>= 9.0
Usage
To register new routes, you can either add their definitions to the map method of a RouteRegistrar, or create a new one.
Creating a new registrar
The following command will create a new registrar inside app/Http/Routes.
The {name} can be any valid class name, or sub-namespace. For example, using Auth\\GuestRoutes will create app/Http/Routes/Auth/GuestRoutes.php.
There are several options available when creating a registrar.
--C|hasChildren
Create a route registrar that has the MapRouteRegistrars trait so that it can map child registrars.
--W|web
Create the route registrar in app/Http/Routes/Web, an option left in for those of you that are splitting the Web and API routes.
--A|API
Exactly the same as the above option, except it creates it in app/Http/Routes/Api,
Registering Registrars
Any class that wants to register registrars can use the following trait.
Once doing so, there are three ways to register. All of them require an instance of the following class.
This interface is implemented by the Laravel Router class, so you can use that.
Register multiple
Call the following method with an instance of the laravel router, and an array of fully qualified class names for the registrars.
Register one
Call the following method with an instance of the laravel router, and the fully qualified class name of the registrars.
Register from paths
Call the following method with an instance of the laravel router, and an array of paths where the registrars are held.
This method will use the order that the files are returned, so please keep route order precedence in mind.
