Ziggy creates a Blade directive which you can include in your views. This will export a JavaScript object of your application's named routes, keyed by their names (aliases), as well as a global route()
helper function which you can use to access your routes in your JavaScript.
-
Add Ziggy to your Composer file:
composer require tightenco/ziggy
-
(if Laravel 5.4) Add
Tightenco\Ziggy\ZiggyServiceProvider::class
to theproviders
array in yourconfig/app.php
. -
Include our Blade Directive (
@routes
) somewhere in your template before your main application JavaScript is loaded—likely in the header somewhere.
This package replaces the @routes
directive with a collection of all of your application's routes, keyed by their names. This collection is available at window.namedRoutes
.
The package also creates an optional route()
JavaScript helper which functions like Laravel's route()
PHP helper, which can be used to retrieve URLs by name and (optionally) parameters.
Without parameters:
route('posts.index') // Returns '/posts'
With required parameter:
route('posts.show', {id: 1}) // Returns '/posts/1'
route('posts.show', [1]) // Returns '/posts/1'
route('posts.show', 1) // Returns '/posts/1'
With multiple required parameters:
route('events.venues.show', {event: 1, venue: 2}) // Returns '/events/1/venues/2'
route('events.venues.show', [1, 2]) // Returns '/events/1/venues/2'
If whole objects are passed, Ziggy will automatically look for id
primary key:
var event = {id: 1, name: 'World Series'};
var venue = {id: 2, name: 'Rogers Centre'};
route('events.venues.show', [event, venue]) // Returns '/events/1/venues/2'
Practical AJAX example:
var post = {id: 1, title: 'Ziggy Stardust'};
return axios.get(route('posts.show', post))
.then((response) => {
return response.data;
});
Filtering routes is completely optional. If you want to pass all of your routes to JavaScript by default, you can carry on using Ziggy as described above.
If you do want to filter routes, we have provided two optional configuration settings to allow you to do so. To take advantage of these, create a standard config file called ziggy.php
in the config/
directory of your Laravel app and set either the whitelist
or blacklist
setting to an array of route names.
Note: You've got to choose one or the other. Setting whitelist
and blacklist
will disable filtering altogether and simply return the default list of routes.
<?php
return [
// 'whitelist' => ['home', 'api.*'],
'blacklist' => ['admin.*', 'vulnerabilities.*'],
];
As shown in the example above, Ziggy the use of asterisks as wildcards in filters. home
will only match the route named home
whereas api.*
will match any route whose name begins with api.
, such as api.posts.index
and api.users.show
.
To get started contributing to Ziggy, check out the contribution guide.
Thanks to Caleb Porzio, Adam Wathan, and Jeffrey Way for help solidifying the idea.