php - Laravel 4.1 文档是如何工作的？

Question

我从 Laravel 的 docs 开始了解 Laravel 的工作原理。以及教程和SO。但是当我尝试使用他们的 API/class reference 时，我一直遇到同样的问题。 .

例如，我已经能够像这样使用 URL 类:

URL::to('string')

这是我从教程中学到的。但是如果我查看 Illuminate\Support\Facades\URL 的文档它没有列出 to() 方法。

相反，如果我查看 Illuminate\Filesystem\Filesystem 的文档我尝试像这样调用 get() 方法:

$file = new Filesystem;
$file->get('lorem.txt'); 

出现以下错误

Class 'Filesystem' not found

我的问题:

• 我如何知道可以使用哪些类以及可以调用哪些方法？
• 我在哪里可以找到这些信息？
• 或者我只是遗漏了一些有关 Laravel 工作原理的信息？

Answer 1

Laravel 使用一种称为 Facade 的设计模式，它基本上是实例化对象的别名，因此您可以这样使用它:

URL::to('string');

代替

$url = new URL;
$url->to('string');

查看您的 app/config/app.php，您会看到指向 Facade 的 URL 别名:

'URL' => 'Illuminate\Support\Facades\URL',

如果您查看 Facade，您会在 IoC 容器中看到它的真正“内部”名称('url'):

protected static function getFacadeAccessor() { return 'url'; }

这个“url”对象由某处的服务提供者实例化，这个对象绑定(bind)到 Illuminate\Routing\RoutingServiceProvider 中的 IoC 容器:

/**
 * Register the URL generator service.
 *
 * @return void
 */
protected function registerUrlGenerator()
{
    $this->app['url'] = $this->app->share(function($app)
    {
        // The URL generator needs the route collection that exists on the router.
        // Keep in mind this is an object, so we're passing by references here
        // and all the registered routes will be available to the generator.
        $routes = $app['router']->getRoutes();

        return new UrlGenerator($routes, $app->rebinding('request', function($app, $request)
        {
            $app['url']->setRequest($request);
        }));
    });
}

您可以看到“url”实际上是 UrlGenerator ->(http://laravel.com/api/4.1/Illuminate/Routing/UrlGenerator.html) .

这是 to() 方法:

/**
 * Generate a absolute URL to the given path.
 *
 * @param  string  $path
 * @param  mixed  $extra
 * @param  bool  $secure
 * @return string
 */
public function to($path, $extra = array(), $secure = null)
{
    // First we will check if the URL is already a valid URL. If it is we will not
    // try to generate a new one but will simply return the URL as is, which is
    // convenient since developers do not always have to check if it's valid.
    if ($this->isValidUrl($path)) return $path;

    $scheme = $this->getScheme($secure);

    $tail = implode('/', (array) $extra);

    // Once we have the scheme we will compile the "tail" by collapsing the values
    // into a single string delimited by slashes. This just makes it convenient
    // for passing the array of parameters to this URL as a list of segments.
    $root = $this->getRootUrl($scheme);

    return $this->trimUrl($root, $path, $tail);
}

一开始有点困惑，但你只需要记住:

1) 找到别名。

2) 找到Facade，得到真正的内部名称。

3)找到ServiceProvider，找到真正的类。