README

Laravel 有一些非常棒的 辅助函数 用于生成 URL/链接，并且它的自动 JSON 魔法使构建 API 变得非常容易。这是我构建单页 JavaScript 应用的首选，但是路由可能会很快变得有点麻烦。

如果我们能从 JavaScript 访问 Laravel 路由会怎么样呢？

这个包允许我们将路由迁移到 JavaScript，并提供了一组 非常熟悉 的辅助函数来使用。

安装

按照常规的 composer 方法安装。

composer.json

{
	"require" : {
		"bharatb/laroute" : "2.*"
	}
}

注意：Laravel 4.x 用户，请查看 版本 1.3.2

app/config/app.php

	...
	
	'providers' => array(
		...
		BharatB\Laroute\LarouteServiceProvider::class,
	],
	
	...

配置（可选）

复制包的配置文件。

php artisan vendor:publish --provider='BharatB\Laroute\LarouteServiceProvider'

app/config/packages/bharatb/laroute/config.php

return [

    /*
     * The destination path for the javascript file.
     */
    'path' => 'public/js',

    /*
     * The destination filename for the javascript file.
     */
    'filename' => 'laroute',

    /*
     * The namespace for the helper functions. By default this will bind them to
     * `window.laroute`.
     */
    'namespace' => 'laroute',

    /*
     * Generate absolute URLs
     *
     * Set the Application URL in config/app.php
     */
    'absolute' => false,

    /*
     * The Filter Methode
     *
     * 'all' => All routes except "'laroute' => false"
     * 'only' => Only "'laroute' => true" routes
     * 'force' => All routes, ignored "laroute" route parameter
     */
    'filter' => 'all',

    /*
     * Action Namespace
     *
     * Set here your controller namespace (see RouteServiceProvider -> $namespace) for cleaner action calls
     * e.g. 'App\Http\Controllers'
     */
    'action_namespace' => '',

    /*
     * The path to the template `laroute.js` file. This is the file that contains
     * the ported helper Laravel url/route functions and the route data to go
     * with them.
     */
    'template' => 'vendor/bharatb/laroute/src/templates/laroute.js',
    
    /*
     * Appends a prefix to URLs. By default the prefix is an empty string.
    *
    */
    'prefix' => '',

];

    

生成 laroute.js

要访问路由，我们需要将它们“迁移”到 JavaScript 文件中

php artisan laroute:generate

默认配置下，这将创建一个 public/js/laroute.js 文件，供您在页面或构建中使用。

<script src="/js/laroute.js"></script>

注意：如果您更改了路由，您将需要运行 laroute:generate。

JavaScript 文档

默认情况下，所有函数都在 laroute 命名空间下。本文档将遵循此约定。

root

生成基本根路径

/**
 * laroute.setRootUrl("http://example.com");
 * setRootUrl	: This will be the Base Url that will be prefix all routes.
 * base_root	: protocol + domain ( eg: https://example.com | http://example.com )
 */

laroute.setRootUrl(base_root);

action

为给定的控制器动作生成 URL。

/** 
 * laroute.action(action, [parameters = {}])
 *
 * action     : The action to route to.
 * parameters : Optional. key:value object literal of route parameters.
 */

laroute.action('HomeController@getIndex');

route

为给定的命名路由生成 URL。

/**
 * laroute.route(name, [parameters = {}])
 *
 * name       : The name of the route to route to.
 * parameters : Optional. key:value object literal of route parameters.
 */
 
 laroute.route('Hello.{planet}', { planet : 'world' });

url

为给定路径生成一个完全限定的 URL。

/**
 * laroute.url(name, [parameters = []])
 *
 * name       : The name of the route to route to.
 * parameters : Optional. value array of route parameters.
 */
 
 laroute.url('foo/bar', ['aaa', 'bbb']); // -> /foo/bar/aaa/bbb

link_to

为给定 URL 生成一个 HTML 链接。

/**
 * laroute.link_to(url, [title = url, attributes = {}]])
 *
 * url        : A relative url.
 * title      : Optional. The anchor text to display
 * attributes : Optional. key:value object literal of additional html attributes.
 */
 
 laroute.link_to('foo/bar', 'Foo Bar', { style : "color:#bada55;" });

link_to_route

为给定路由生成一个 HTML 链接。

/**
 * laroute.link_to_route(name, [title = url, parameters = {}], attributes = {}]]])
 *
 * name       : The name of the route to route to.
 * title      : Optional. The anchor text to display
 * parameters : Optional. key:value object literal of route parameters.
 * attributes : Optional. key:value object literal of additional html attributes.
 */
 
 laroute.link_to_route('home', 'Home');

link_to_action

为给定动作生成一个 HTML 链接。

/**
 * laroute.link_to_action(action, [title = url, parameters = {}], attributes = {}]]])
 *
 * action     : The action to route to.
 * title      : Optional. The anchor text to display
 * parameters : Optional. key:value object literal of route parameters.
 * attributes : Optional. key:value object literal of additional html attributes.
 */
 
 laroute.link_to_action('HelloController@planet', undefined, { planet : 'world' });

PHP 文档

忽略/过滤路由

默认情况下，在运行 php artisan laroute:generate 后，所有路由都对 laroute 可用。然而，有时可能希望 laroute 忽略某些路由。您可以通过传递一个 laroute 路由选项来实现。

Route::get('/ignore-me', [
    'laroute' => false,
    'as'      => 'ignoreme',
    'uses'    => 'IgnoreController@me'
]);

Route::group(['laroute' => false], function () {
    Route::get('/groups-are-super-useful', 'GroupsController@index');
});

许可证

查看此存储库中的许可证。