README

使用 Laravel 创建 Web 应用时，总会有一些准备工作要做，以使项目正常运行。有一些常见的任务需要完成，几乎适用于每个 Web 应用。例如：

• 配置和设置数据库
• 配置路由和过滤器
• 创建认证控制器
• 创建“登录”和“注册”视图
• 配置“用户”模型

Laravel App Boilerplate 旨在在执行这些任务时减轻一些重担，同时不会限制你在一个预配置的、不灵活的设置中。该模板包与 Laravel 的默认安装完全兼容，并可按需进行定制。

要求

Laravel App Boilerplate 需要 Laravel v4.2+

安装

要安装 Laravel App Boilerplate，请执行以下操作：

• 请确保您已经安装了 Laravel。使用干净的安装最好。
• 将 Laravel App Boilerplate 添加到您的 composer.json 文件的 "require" 部分

"gilbitron/laravel-app-boilerplate": "0.1.*"

• 运行 composer update 以安装模板包
• 打开 app/config/app.php 并将以下行添加到 $providers 数组中

'Gilbitron\LaravelAppBoilerplate\LaravelAppBoilerplateServiceProvider',

• 运行 php artisan config:publish gilbitron/laravel-app-boilerplate 以将配置文件复制到 app/config/packages/gilbitron/laravel-app-boilerplate 文件夹
• 运行 php artisan migrate --package="gilbitron/laravel-app-boilerplate" 以在数据库中生成 "users" 表（注意，您的 app/config/database.php 中的设置需要正确配置）

使用

您的 Web 应用已设置完毕，准备好使用。以下路由已定义并可供使用：

• 注册
• 登录
• 登出

注意，Laravel App Boilerplate 使用 Laravel 内置的认证方法和过滤器。

您可以在 app/config/packages/gilbitron/laravel-app-boilerplate/config.php 中更改默认设置。

自定义

默认情况下，Laravel App Boilerplate 使用预配置的 layout.blade.php 和一些其他视图（登录、注册等），这些视图可以按需进行自定义。为此，您需要运行以下命令将视图复制到 app/views/packages 目录，以便您的更改不会在更新模板包时丢失：

php artisan view:publish gilbitron/laravel-app-boilerplate

Laravel App Boilerplate 使用自定义 User 模型用于其内置的认证页面。Laravel 的默认安装提供自己的 User 模型，因此建议您将以下代码添加到默认的 User 模型中，以确保兼容性。

/**
 * The attributes that can be mass assigned
 *
 * @var array
 */
protected $fillable = array('email', 'password', 'name');

/**
 * Automatically hash a password when it is being set
 */
public function setPasswordAttribute($pass)
{
	$this->attributes['password'] = Hash::make($pass);
}

鸣谢

Laravel 应用模板由来自 Gilbert Pellegrom 的 Dev7studios 创建。在 MIT 许可下发布。