说明

Laravel 资讯网站的源代码 https://news.laravel-china.org/ 。

Laravel 最新资讯、精华文章、开发技巧、推荐扩展包、最新 Laravel 职位信息 以及 「Laravel China 社区」 上的精华讨论。

由 Summer 设计和编码。

想学习 Laravel 的同学，推荐 Summer 的书籍 《Laravel 入门教程》 。

《Laravel 入门教程》 封面由设计师 安正超 设计。

优帆远扬 - 创造不息，交付不止

运行环境

• Nginx 1.8+
• PHP 5.6+
• Mysql 5.7+
• Redis 3.0+
• Memcached 1.4+

开发环境部署/安装

本项目代码使用 PHP 框架 Laravel 5.1 开发，本地开发环境使用 Laravel Homestead。

下文将在假定读者已经安装好了 Homestead 的情况下进行说明。如果您还未安装 Homestead，可以参照 Homestead 安装与设置 进行安装配置。

基础安装

1. 克隆源代码

克隆源代码到本地：

> git clone git@github.com:summerblue/news.laravel-china.org.git

2. 配置本地的 Homestead 环境

1). 运行以下命令编辑 Homestead.yaml 文件：

homestead edit

2). 加入对应修改，如下所示：

folders:
    - map: ~/my-path/news.laravel-china.org/ # 你本地的项目目录地址
      to: /home/vagrant/news.laravel-china.org

sites:
    - map: news.app
      to: /home/vagrant/news.laravel-china.org/public

databases:
    - news

3). 应用修改

修改完成后保存，然后执行以下命令应用配置信息修改：

homestead provision

注意：有时候你需要重启才能看到应用。运行 homestead halt 然后是 homestead up 进行重启。

3. 安装扩展包依赖

> composer install

4. 使用安装命令

虚拟机里面：

php artisan est:instal

更多信息，请查阅 ESTInstallCommand

5. 配置 hosts 文件

主机里:

echo "192.168.10.10   news.app" | sudo tee -a /etc/hosts

链接入口

• 首页地址：http://news.app/
• 管理后台：http://news.app/admin

在 local 环境下，直接访问管理后台即可默认登录 id 为 1 的管理员账号。

6. 前端工具集安装

1). 安装 node.js

直接去官网 https://nodejs.org/en/ 下载安装最新版本。

2). 安装 Gulp

npm install --global gulp

3). 安装 Laravel Elixir

npm install

4). 直接 Gulp 编译前端内容

gulp

5). 监控修改并自动编译

gulp watch

至此, 安装完成

扩展包描述

| 扩展包 | 一句话描述 | 本项目应用场景 | | --- | --- | --- | --- | --- | --- | --- | --- | |spatie/laravel-backup| 数据库备份解决方案 | 本项目的数据库备份使用此扩展包完成。 | |summerblue/administrator| 管理后台解决方案| 本项目的后台使用此扩展包开发。 | |laracasts/flash| 简单的 flash messages | 用户操作成功/失败的提示使用此扩展包开发 | | zizaco/entrust | 用户组权限系统 | 整站的权限系统基于此扩展包开发。 | | VentureCraft/revisionable | 记录 Model 的变更日志 | 以下 User Model 用此扩展包记录删除日志。| | mews/purifier | HTML 白名单过滤器 | 用户发帖、回复时防止 XSS 过滤。 | |oumen/sitemap| Sitemap 生成工具| 本项目的 sitemap 使用此扩展包生成。 | | orangehill/iseed | 将数据表里的数据以 seed 的方式导出 | BannersTableSeeder, LinksTableSeeder, CategoriesTableSeeder 和 TipsTableSeeder 使用此扩展包生成。 | | barryvdh/laravel-debugbar | 调试工具栏 | 开发时必备调试工具。 | |rap2hpoutre/laravel-logviewer| Log 查看工具 | 生产环境下，使用此扩展包快速查看 Log，已做权限控制。 | | laracasts/presenter | Presenter 机制 | 以下 Model: User、Topic、Notification 都使用到了 Presenter。 | |league/html-to-markdown| 将 HTML 转换成 Markdown| 用户进行内容发布动作时会使用此扩展包 | |erusev/parsedown| 将 Markdown 转换成 HTML | 用户进行内容发布动作时会使用此扩展包 | | laravel/socialite | 官方社会化登录组件 | GitHub 登录逻辑使用了此扩展包。 | | Intervention/image | 图片处理功能库 | 用发帖和回复帖子时，图片上传的逻辑使用了此扩展包。 | | rtconner/laravel-tagging | 打标签功能 | 本地方式加载扩展包，打标签的内容有「微博用户」、「微博内容」 | | etrepat/baum | 集成于 laravel-tagging 中，与其配合使用 | 增强了标签嵌套功能 | | Ubench | 性能统计工具 | 统计爬虫程序执行，花了多少时间和资源 |

自定义 Artisan 命令列表

| 命令行名字 | 说明 | | --- | --- | --- | --- | | est: install | 安装必备，首次安装时调用此命令可以快速初始化项目 | | est:reinstall | 开发必备，重置所有的数据库和用户权限 |

队列列表

名称	说明	调用
BackupCommand	每 4 小时运行一次，进行数据库备份，属于 spatie/laravel-backup 的逻辑	php artisan backup:run --only-db
ClearCommand	每日 1:20 运行，清理过期的备份，，属于 spatie/laravel-backup 的逻辑	php artisan backup:clean
SyncUserActivedTime	10 分钟运行一次，同步用户的最后访问时间	php artisan basic:sync-user-actived-time

代码生成器日志

记录这些日志目的为了方便后续开发可以借鉴。

php artisan make:scaffold Users --schema="github_id:integer:unsigned:default(0):index,notification_count:integer:unsigned:default(0):index,name:string:index,remember_token:string:nullable,image_url:string:nullable,verification_token:string:nullable,phone:string:nullable:index,email:string:nullable:index,real_name:string:nullable,avatar:string,wechat_openid:string:nullable:index,wechat_unionid:string:nullable:index,weibo_id:string:nullable:index,register_source:string:nullable:index,name:string:index:index"

使用协议

基于 MIT 协议基础上，增加署名权。请在你的修改版本站点底部保留：

<p class="credits font2 add-top-quarter">
    由 <a href="https://github.com/summerblue" target="_blank">Summer</a> 设计与编码。
</p>