README

对于 Laravel 4，请使用 1.0 分支

Laravel Prerender

Google、Facebook、Twitter、Yahoo 和 Bing 不断尝试查看您的网站...但他们不会执行 JavaScript。这就是 Prerender 的由来。Prerender 对于 AngularJS SEO、BackboneJS SEO、EmberJS SEO 以及任何其他 JavaScript 框架都十分完美。

此中间件拦截来自爬虫对您的 Laravel 网站或应用的请求，然后调用（外部）Prerender 服务以获取该页面的静态 HTML 而不是 JavaScript。

Prerender 遵循 Google 的 _escaped_fragment_ 提案，我们建议您使用。这很简单

只需将 <meta name="fragment" content="!"> 添加到所有页面的 <head> 部分
如果使用哈希 URL (#)，请将其更改为哈希-bang (#!)，但您也可以使用 HTML5 的 push-state
这就完成了！JavaScript 页面上的完美 SEO。

安装

要使用此包，请运行： composer require nutsweb/laravel-prerender

安装后，将 ServiceProvider 添加到 config/app.php 文件中的 providers 数组。

'Nutsweb\LaravelPrerender\LaravelPrerenderServiceProvider',

如果您想使用 prerender.io 服务，请将以下内容添加到您的 .env 文件中

PRERENDER_TOKEN=yoursecrettoken

如果您使用的是自托管服务，请在 .env 文件中添加服务器地址。

PRERENDER_URL=http://example.com

您可以通过在 .env 文件中添加以下内容来禁用该服务

PRERENDER_ENABLE=false

这可能对您的本地开发环境很有用。

工作原理

中间件检查是否应显示预渲染页面
1. 中间件检查请求是否来自爬虫（_escaped_fragment_ 或代理字符串）
2. 中间件检查是否请求资源（js、css 等...）
3. （可选）中间件检查 URL 是否在白名单中
4. （可选）中间件检查 URL 是否不在黑名单中
中间件向 prerender 服务（phantomjs 服务器）发送 GET 请求以获取页面的预渲染 HTML
将 HTML 返回给爬虫

自定义

要自定义白名单和黑名单，您必须首先发布配置文件

$ php artisan vendor:publish

白名单

白名单路径或模式。您可以使用通配符语法。如果提供了白名单，则仅包含白名单路径的 URL 将被预渲染。空数组表示所有 URI 都将通过此过滤器。请注意，这是完整的请求 URI，因此包括起始斜杠和查询参数字符串。

// prerender.php:
'whitelist' => [
    '/frontend/*' // only prerender pages starting with '/frontend/'
],

黑名单

黑名单路径以排除。您可以使用通配符语法。如果提供了黑名单，则除包含黑名单路径的 URL 之外的所有 URL 都将被预渲染。默认情况下，包括一组资产扩展名（这实际上仅在您通过路由动态提供资产时才是必要的）。请注意，这是完整的请求 URI，因此包括起始斜杠和查询参数字符串。

// prerender.php:
'blacklist' => [
    '/api/*' // do not prerender pages starting with '/api/'
],

贡献

我非常欢迎任何贡献！请随时创建问题或拉取请求。

许可

MIT 许可协议 (MIT)

以下是对任何获得本软件及其相关文档副本（以下简称“软件”）的个人免费授权，允许在不限制的情况下处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许将软件提供给他人以进行上述操作，但须遵守以下条件

nutsweb / laravel-prerender

维护者

详细信息

README

对于 Laravel 4，请使用 1.0 分支

Laravel Prerender

安装

工作原理

自定义

白名单

黑名单

贡献

许可