README

Laravel 路由绑定，正确的方式。

Laravel 4 或 5？

主分支包含与 Laravel 5 兼容的代码。Laravel 5 的发布版本从 3.0 标签开始。

对于与 Laravel 4 兼容的发布版本，请访问 laravel4 分支。

问题

项目开始时很简单：几个路由，可能是一些资源控制器，以及一些参数绑定。但很快，routes.php 文件就开始堆积，有数百行，包含复杂的嵌套组和过滤器，甚至（天哪）还有对 App::make 的调用。更糟糕的是，必须滚动这么多行来寻找那个你显然忘记的奇怪路由名称，因为谁会记得这些呢？

此包可以帮助你做到以下三件事（至少）

1. 通过使用 IoC 容器，使你的路由成为 应用程序 的一部分
2. 让你在多个文件（类）中分割路由，而无需使用过时的 includes 或 requires
3. 由于你将创建类，因此你有机会声明一些字符串常量并保存对这些讨厌的路由名称的引用

解决方案

此包仅包含两个合约，一个配置文件和一个 ServiceProvider。

像往常一样，在 config/app.php 文件中包含 ServiceProvider，如下所示

'providers' => [
    // ...
    LaravelBA\RouteBinder\RouteBinderServiceProvider::class,
    // ...
]

然后，发布包的配置

php artisan vendor:publish --provider="LaravelBA\RouteBinder\RouteBinderServiceProvider"

之后，你需要创建一些类，这些类实现 LaravelBA\RouteBinder\Routes 接口、LaravelBA\RouteBinder\Bindings 接口或两者。别担心！你会看到这很容易

namespace App\Http\Routes;

use Illuminate\Contracts\Routing\Registrar;
use Illuminate\Routing\Router;
use LaravelBA\RouteBinder\Bindings;
use LaravelBA\RouteBinder\Routes;

class FooRoutes implements Routes, Bindings
{
    /**
     * This is what I meant with #3 up there.
     * Completely optional, but highly recommended.
     */
    const INDEX = 'foo.index';

    /**
     * This one is required if you implement the Bindings interface
     */
    public function addBindings(Router $router)
    {
        $router->bind('user_id', function(){
            // Fetch your User object here!
        });
    }

    /**
     * This one is required if you implement the Routes interface
     */
    public function addRoutes(Registrar $router)
    {
        $router->get('foo', ['as' => self::INDEX, 'uses' => function(){
            return view('hello');
        }]);
    }
}

并将它们添加到发布的配置文件中（你现在可以在 config/routes.php 中找到它）

return [
    'binders' => [
        App\Http\Routes\FooRoutes::class,
        App\Http\Routes\BarRoutes::class,
        App\Http\Routes\BazRoutes::class,
        App\Http\Routes\AwesomeRoutes::class,
    ]
];

就这样！现在所有路由都组织得很好，如果事情变得不可控制，你总是可以进一步分割它们！

IoC 容器

我爱 Laravel 的路由模型绑定功能。但是，我必须承认，我不使用 Eloquent，所以我总是选择 Route::bind() 选项。

但是，这个功能虽然强大，但会对你的架构产生很大的影响。在 routes.php 文件中对数据库的调用是可怕的，而使用 App::make(SomeRepository::class) 也不见得有多好。

通过这个小小的包，你的 Bindings 对象可以依赖应用程序的任何 Service 或 Repository 层。现在，你甚至可以通过模拟依赖项并期望在路由解析时调用你使用的任何 Repository::find() 方法来测试这些绑定！

这听起来可能现在看起来非常复杂，但请相信我，你会喜欢的。