shiftonelabs / laravel-singular-resource-routes
Adds support for singular resource routes to the Laravel router.
Installs: 9 181
Dependents: 0
Suggesters: 0
Security: 0
Stars: 26
Watchers: 3
Forks: 0
Open Issues: 0
Requires
- php: >=5.5.0
- illuminate/routing: >=5.0
Requires (Dev)
- illuminate/events: >=5.0
- laravel/framework: >=5.0
- mockery/mockery: ~0.9
- phpunit/phpunit: >=4.0 <6.0
- shiftonelabs/codesniffer-standard: 0.*
- squizlabs/php_codesniffer: 2.*
This package is auto-updated.
Last update: 2024-10-09 08:33:58 UTC
README
This Laravel package adds support for singular resource routes to Laravel's router.
Sometimes you need to deal with a resource that does not need to be referenced by the id. For example, you may have a profile
resource that belongs to the currently authenticated user. Currently, if you wanted to show
the user's profile, the route would be /profile/{profile}
. However, since you don't need the id to look up the current user's profile, it would be nice to be able to simply have the show
route be /profile
. This is the same for the edit
, update
, and destroy
routes, as well.
The singular resource route generates the following routes:
These routes differ from the current resource routes in two ways:
- The
show
,edit
,update
, anddestroy
routes do not need a route parameter. - Since this is a singular resource, there is no
index
action.
Versions
This package has been tested on Laravel 5.0 through Laravel 8.x, though it may continue to work on later versions as they are released. This section will be updated to reflect the versions on which the package has actually been tested.
Install
Via Composer
composer require shiftonelabs/laravel-singular-resource-routes
Service Provider
This package supports Laravel package autodiscovery. So, if using Laravel 5.5+, there is no need to add the server provider. If using Laravel 5.0 - 5.4, add the service provider to your config/app.php
file:
'providers' => [ ... ShiftOneLabs\SingularResourceRoutes\SingularResourceRoutesServiceProvider::class, ];
Usage
In order to create a new singular resource route, a new singular
option is added to the resource route definition. This option can be set to three different values:
- The boolean
true
. This is mainly for non-nested resource definitions. If it is used on a nested resource definition, only the last resource in the chain will be treated as singular. - A string containing the name of the singular resource. This can be used when there is only one resource that is singular in a nested resource definition. The string must contain the name of the singular resource.
- An array of strings containing the names of the singular resources. This format must be used when there are multiple singular resources in a nested resource definition, but it can be used in any scenario.
Code Example
A singular resource (/profile
):
// Since there is only one singular resource, and it is the last one,
// all three options work in this scenario.
Route::resource('profile', 'ProfileController', ['singular' => true]);
Route::resource('profile', 'ProfileController', ['singular' => 'profile']);
Route::resource('profile', 'ProfileController', ['singular' => ['profile']]);
A singular resource nested under a plural resource (/users/{user}/profile
):
// Since there is only one singular resource, and it is the last one,
// all three options work in this scenario.
Route::resource('users.profile', 'ProfileController', ['singular' => true]);
Route::resource('users.profile', 'ProfileController', ['singular' => 'profile']);
Route::resource('users.profile', 'ProfileController', ['singular' => ['profile']]);
A singular resource nested under a singular resource (/profile/avatar
):
// Since there are multiple resources that are singular, only the array
// syntax can be used to specify all the singular resources.
Route::resource('profile.avatar', 'ProfileAvatarController', ['singular' => ['profile', 'avatar']]);
A plural resource nested under a singular resource (/profile/phones/{phone}
):
// Since there is a parent resource that is singular, the "true" option cannot be used.
// But since there is only one singular resource, the string option can be used.
Route::resource('profile.phones', 'PhoneController', ['singular' => 'profile']);
Route::resource('profile.phones', 'PhoneController', ['singular' => ['profile']]);
A singular resource nested under a plural resource nested under a singular resource (/profile/phones/{phone}/type
):
// Since there are multiple resources that are singular, only the array
// syntax can be used to specify all the singular resources.
Route::resource('profile.phones.type', 'PhoneTypeController', ['singular' => ['profile', 'type']]);
Contributing
Contributions are welcome. Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email patrick@shiftonelabs.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.