构建 laravel.com 本地镜像，全站离线浏览

Laravel 官方文档网站 https://laravel.com 是我们经常浏览的一个网站，但是在国内访问很慢，甚至在有些地区需要搭梯子。这浪费了很多宝贵时间，可以使用高速梯子、或通过 Dash 等工具浏览离线文档。我觉得最好的方案是访问国内镜像，可能是因为我比较习惯 laravel.com 的网站样式。

以前 Laravel China 有个英文文档，现在找不见了。我们可以在自己电脑或国内服务器上构建一个镜像来加速访问。
laravel.com 的开源代码在 https://github.com/laravel/laravel.com ，但是要在本地跑起来还需要修改一些文件。本文将推荐一个好用的一键部署脚本。

最佳实践

• 部署 https://github.com/laravel/laravel.com 到本地或服务器
• 给 Web 服务器配置一个 virtual host ，域名是 laravel.com www.laravel.com ，其中 www.laravel.com 301 重定向到 laravel.com ，开启 HTTPS 和 HTTP/2 ，并让 HTTP 访问重定向到 HTTPS 地址
• 在本机添加 hosts ，例如 127.0.0.1 laravel.com www.laravel.com
• 如果是部署到外网服务器，建议 alias 一个自己的域名到这个镜像。这样即便本机不添加 hosts 也能使用别的域名高速访问
• 利用 cron-job 或 GitHub Webhook 实现自动更新镜像

使用 laravel.com 这个域名是为了让镜像在本地和官网没任何区别，这样的话你给别人发某文档地址或点击某网页里的 Laravel 文档地址时不需要手动修改域名。使用 HTTPS 同理。

本地镜像和官网的区别是镜像可以秒开 :smile: 而且可以离线访问。

如果你没安装 Web 服务器，或者不会（懒）配置虚拟主机，敲一个部署命令，再敲一个 php artisan serve 就可以了。

部署脚本 sync-laravel.com

项目主页： https://github.com/ElfSundae/sync-laravel....

• 一个命令实现更新和部署网站、编译最新的 docs 和 API 文档。
• 解决 API 文档编译错误。因为第三方库的原因，官方 5.5 的 API 文档一直无法编译，见 https://laravel.com/api/5.5/
• 可查看镜像当前的文档状态
• 可跳过编译 docs 或 api 文档以加速构建
• 支持 Linux 和 macOS 。 理论上支持 Windows ，我没试过。

如果觉得好用希望不吝 Star :star::star::star: ，欢迎提 Issue 或 PR 。