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
命令。现在我们已经有了数据库表,让我们让添加一些数据!
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, 选择权在于你!