跳到主要内容
版本：4.0

Laravel 快速入门

安装​

Laravel框架使用 Composer 执行安装和依赖管理。如果还没有安装的话，现在就开始 安装 Composer 吧。

安装Composer之后，你就可以通过命令行使用如下命令安装Laravel了：

composer create-project laravel/laravel=4.0.* your-project-name --prefer-dist

或者，你可以从 Github仓库 下载。接下来，在 安装Composer 之后，在项目根目录下执行 composer install 命令。该命令将会下载以及安装框架的依赖组件。

写入权限​

安装完 Laravel ，你还需要为web服务器设置 app/storage 目录的写入权限。请参考 安装 一节以获取更多关于配置方面的信息。

目录结构​

安装完框架后，你需要熟悉一下该项目的目录结构。app 文件夹包含了一些例如 views ，controllers 和 models 目录。 程序中大部分代码将要存放这些目录下。你也可以查看一下 app/config 文件夹里一些配置项目。

路由​

我们开始创建我们第一个路由。在 Laravel，简单路由的方法是闭包。打开 app/routes.php 文件加入如下代码:

Route::get('users', function()
{
	return 'Users!';
});

现在，你在 web 浏览器输入 /users，你应该会看到 Users! 输出。真棒！已经创建了你第一个路由。

路由也可以赋予控制器类。例如：

Route::get('users', 'UserController@getIndex');

该路由告知框架 /users 路由请求应该调用 UserController 类的 getIndex 方法。要查看更多关于路由控制器信息，查看 控制器文档 。

创建视图​

接下来，我们要创建视图来显示我们用户数据。视图以HTML代码存放在 app/views 文件夹。我们将存放两个视图文件到该文件夹：layout.blade.php 和 users.blade.php。首先，让我们先创建 layout.blade.php 文件：

<html>
	<body>
		<h1>Laravel Quickstart</h1>

		@yield('content')
	</body>
</html>

接着， 我们创建 users.blade.php 视图：

@extends('layout')

@section('content')
	Users!
@stop

这里的语法可能让你感到陌生。因为我们使用的是 Laravel 模板系统：Blade。Blade 非常快，因为仅使用了少量的正则表达式来为你的模板编译成原始PHP代码。Blade提供强大的功能，例如模板继承，还有一些常用的PHP控制结构语法糖，例如 if 和 for。 查看 Blade 文档 了解更多。

现在我们有了我们视图，让我们返回 /users 路由。我们用视图来替代返回 Users!:

Route::get('users', function()
{
	return View::make('users');
});

漂亮！现在你成功创建了继承至layout的视图。接下来，让我们开始数据库层。

创建迁移​

要创建表来保存我们数据，我们将使用 Laravel 迁移系统。迁移描述数据库的改变，这让分享给他们团队成员非常简单。

首先，我们配置数据库连接。你可以在 app/config/database.php 文件配置所有数据库连接信息。默认，Laravel 被配置为使用 SQLite，并且一个 SQLite 数据库存放在 app/database 目录。你可以将数据库配置文件的 driver 选项修改为 mysql 并且配置 mysql 连接信息。

接下来，要创建迁移，我们将使用 Artisan CLI。在项目根目录中，在终端中执行以下命令：

php artisan migrate:make create_users_table

然后，找到生成的迁移文件 app/database/migrations 目录。该文件包含了一个包含两个方法： up 和 down 的类。在 up 方法，你要指名数据库表的修改，在 down 方法中你只需要移除它。

让我们定义如下迁移：

public function up()
{
	Schema::create('users', function($table)
	{
		$table->increments('id');
		$table->string('email')->unique();
		$table->string('name');
		$table->timestamps();
	});
}

public function down()
{
	Schema::drop('users');
}

然后，我们在项目根目录中使用终端运行 migrate 命令来执行迁移：

php artisan migrate

如果你想回滚迁移，你可以执行 migrate:rollback 命令。现在我们已经有了数据库表，让我们让添加一些数据！

Eloquent ORM​

Laravel 提供非常棒的 ORM：Eloquent。如果你使用过 Ruby on Rails 框架，你会发现 Eloquent 很相似，因为它遵循数据库交互的 ActiveRecord ORM 风格。

首先，让我们来定义个模型。ELoquent 模型可以用来查询相关数据表，以及表内的某一行。别着急，我们很快会谈及！模型通常存放在 app/models 目录。让我们在该目录定义个 User.php 模型，如：

class User extends Eloquent {}

注意我们并没有告诉 Eloquent 使用哪个表。Eloquent 有多种约定， 一个是使用模型的复数形式作为模型的数据库表。非常方便！

使用你喜欢的数据库管理工具，插入几行数据到 users 表，我们将使用 Eloquent 取得它们并传递到视图中。

现在我们修改我们 /users 路由如下：

Route::get('users', function()
{
	$users = User::all();

	return View::make('users')->with('users', $users);
});

让我们来看看该路由。首先，User 模型的 all 方法将会从 users 表中取得所有记录。接下来，我们通过 with 方法将这些记录传递到视图。with 方法接受一个键和一个值，那么该值就可以在视图中使用了。

激动啊。现在我们准备将用户显示在我们视图！

显示数据​

现在我们视图中已经可以访问 users 类，我们可以如下显示它们：

@extends('layout')

@section('content')
	@foreach($users as $user)
		<p>{{ $user->name }}</p>
	@endforeach
@stop

你可以发现没有找到 echo 语句。当使用 Blade 时，你可以使用两个花括号来输出数据。非常简单，你现在应该可以通过 /users 路由来查看到用户姓名作为响应输出。

这仅仅是开始。在本系列教程中，你已经了解了 Laravel 基础部分，但是还有更让人兴奋的东西要学。继续阅读该文档并且深入Eloquent和Blade这些强大的特性。或者你对队列 和 单元测试 感兴趣。或许是你想了解IoC Container, 选择权在于你!