Laravel 4.2参考手册 pdf

立即下载

Laravel 快速入门


安装

通过 Laravel 安装器

首先,通过 Composer 下载 Laravel 安装器。

  1. composer global require "laravel/installer=~1.1"

请确保把 ~/.composer/vendor/bin 路径添加到 PATH 环境变量里, 这样laravel 可执行文件才能被命令行找到, 以后您就可以在命令行下直接使用 laravel 命令.

安装成功后, 可以使用命令 laravel new 在您指定的目录下创建一份全新安装的 Laravel。例如,laravel new blog 将会在当前目录下创建一个叫 blog 的目录, 此目录里面存放着全新安装的 Laravel 以及其依赖的工具包。这种安装方法比通过 Composer 安装要快许多。

通过 Composer

Laravel 框架使用 composer 来执行安装及管理依赖。如果还没有安装它的话,请先从 安装 Composer 开始吧。

安装之后,您可以通过终端执行下列命令来安装 Laravel:

  1. composer create-project laravel/laravel your-project-name --prefer-dist

这个命令会下载并安装一份全新的 Laravel 存放在指定的 your-project-name 的目录中。

手动安装

手动安装 Laravel, 可以直接从 Github 上的 Laravel Respoitory 下载一份打包的代码, 解压缩, 然后在解压后的根目录里,执行 composer install 即可,这个命令会把框架所需要的依赖下载完整。

权限配置

在安装 Laravel 之后,确保 Web 服务器有写入 app/storage 目录的权限。详情请见安装文档说明。

运行 Laravel

一般而言,您需要一个 Web 服务器(比如: Apache 或是 Nginx)来运行您的 Laravel 应用。如果您是使用 PHP 5.4 以上版本,为了方便, 可以使用 PHP 内建的开发服务器,只需要通过使用 Laravel 的 Artisan 命令 来执行 serve 即可:

  1. php artisan serve

目录结构

安装完框架后,我们来了解熟悉一下项目的目录结构。app 目录里面包含了 views(视图), controllers(控制器), 还有 models(模型) 等目录。您的应用程序大多数的代码都会在这个目录中, 需要注意的还有存放相关配置文件的目录 app/config

本地开发环境

过去要在本机上配置一个本地的 PHP 开发环境是非常让人头痛的事情。除了要安装正确的 PHP 版本、对应的扩展包,还有一些所需的组件,都是一个大工程。很多情况下因为这些繁琐的配置问题,导致我们直接放弃了尝试要做的事, 非常的可惜。

为了解决这状况,使用 Laravel Homestead 吧。Homestead 是由 Laravel 和 Vagrant 所设计的虚拟机。而 Homestead Vagrant 里封装了建立一个完整 PHP 应用所需的所有软件。因此可以在瞬间创建一个虚拟化的、独立不受干扰的开发环境。特别适用于团队开发环境的统一。 下面列出包装在 Homestead 里的软件:

  • Nginx
  • PHP 5.6
  • MySQL
  • Redis
  • Memcached
  • Beanstalk

Homestead 依赖于 VirtualBox 和 Vagrant , 所以您需要先安装他们。两个软件都有各平台的图形化安装界面。请参阅 Homestead 说明 进行了解。

Laravel 的社区特别推荐使用 Homestead 来开发应用, 主要有以下优势:

  1. 安装部署简单, 快速使用, 并支持各种主流系统;
  2. 统一开发环境, 避免了团队开发时, 各种 运行系统, 软件发行版本, 软件配置 的不一致所带来不必要的复杂性;
  3. 能使开发环境最大程度上跟线上生产环境一致;

路由

首先,我们先创建第一个路由。在 Laravel 中,最简单的路由是通过匿名函数来实现的。打开 app/routes.php 文件,在文件的最下方添加如下代码:

  1. Route::get('users', function()
  2. {
  3. return 'Users!';
  4. });

现在,在浏览器中输入 /users,您应该会看到页面出现 Users!。简单吧, 您已经建立了第一个路由。

路由也可以指向一个控制器类和动作方法。例如:

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

以上代码声明 /users 路由的请求应该使用 UserController 类的 getIndex 方法。查看更多关于控制器路由的信息,请查阅控制器。

建立视图

接下来,我们要创建视图来显示我们的用户数据。视图以 HTML 代码存放在 app/views 的目录中, 后缀名一般为 .blade.php。我们先来创建两个视图文件: layout.blade.phpusers.blade.php。首先,我们建立layout.blade.php 文件:

  1. <html>
  2. <body>
  3. <h1>Laravel Quickstart</h1>
  4. @yield('content')
  5. </body>
  6. </html>

接下来,我们建立 users.blade.php 文件:

  1. @extends('layout')
  2. @section('content')
  3. Users!
  4. @stop

这里有些语法或许让您感到陌生。因为我们使用的是 Laravel 的模板系统:Blade。Blade 非常快,仅需要通过少量的正则表示式来把模板文件编译成 PHP 代码。Blade 提供了强大的功能,例如模板的继承,还有一些常用的 PHP 控制结构语法,如 iffor。更多信息请查阅 Blade。

现在,我们已经有了自己的视图,让我们回到 /users 路由。我们改用视图来替代直接输出的 Users!

  1. Route::get('users', function()
  2. {
  3. return View::make('users');
  4. });

太棒了!现在您已经成功地建立了一个继承自 layout 的简单视图。接下来,我们来学习一下数据库层。

建立迁移文件

我们使用 Laravel 的迁移 (migration) 系统来建立数据库表以保存我们的数据。迁移记录着数据库的改变历史,可以通过版本控制的方式来更好的让团队开发保持一致性。

首先,我们要配置数据库连接。您可以在 app/config/database.php 文件中配置所有的数据库连接信息。Laravel 默认使用 MySQL,所以您必须将相关的数据库连接信息填入其中。您也可以更改 driver 选项为 sqlite,如此 Laravel 就会使用放置在 app/database 里的 SQLite 数据库。

接下来,我们来创建迁移文件,我们使用 Artisan CLI来创建。在项目的根目录下,通过终端执行下列命令:

  1. php artisan migrate:make create_users_table

然后,在 app/database/migrations 目录下就会产生对应的迁移文件。文件中会有一个包含了两个方法 updown 的类。在 up 方法中,您必须写上您要对您的数据库表做哪些更动,而在 down 的方法里,您只要写上对应的回滚代码。

我们定义一个迁移文件如下:

  1. public function up()
  2. {
  3. Schema::create('users', function($table)
  4. {
  5. $table->increments('id');
  6. $table->string('email')->unique();
  7. $table->string('name');
  8. $table->timestamps();
  9. });
  10. }
  11. public function down()
  12. {
  13. Schema::drop('users');
  14. }

然后继续在项目的根目录下,通过终端执行 migrate 命令来执行迁移动作。

  1. php artisan migrate

如果您想回滚迁移,您可以执行以下命令

  1. php artisan migrate:rollback

现在我们已经建好了数据库表了,开始放些数据进去吧。

Eloquent ORM

Laravel 提供了很棒的 ORM:Eloquent。如果您曾经使用过 Ruby on Rails 框架,那您将会觉得 Eloquent 很熟悉,因为它遵循着 ActiveRecord ORM 风格的数据库互动模式。

首先,我们先来定义一个模型 (model)。一个 Eloquent 模型可以用来查询关联的数据库表,以及表内的某一行。模型通常存放在 app/models 目录中。让我们先来在这目录里创建一个 User.php 的模型文件:

  1. class User extends Eloquent {}

注意,我们并未告诉 Eloquent 使用哪个表。Eloquent 有多种惯例,一种就是使用模型的复数形态作为该模型的数据库表名称,非常方便, 这是 Laravel 的开发规范。

使用您喜欢的数据库管理工具,插入几条数据到 users 数据库表,我们将使用 Eloquent 来取得这些数据并且传递到视图中去。

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

  1. Route::get('users', function()
  2. {
  3. $users = User::all();
  4. return View::make('users')->with('users', $users);
  5. });

在以上代码中, 首先,User 模型里的 all 方法会取得 users 表里的所有记录。接下来,我们通过 with 方法将这些记录传递到视图中。with 方法接受一个键和与其对应的值,这样这对键值就可以在视图中使用了。

显示数据

现在,通过 view 下的 with 方法, 视图中已经可以获取到 users 变量了,我们可以显示出来,如下:

  1. @extends('layout')
  2. @section('content')
  3. @foreach($users as $user)
  4. <p>{{ $user->name }}</p>
  5. @endforeach
  6. @stop

您会发现没有看到任何 echo 语句。当使用 Blade 时,您可以使用两个大括号来输出数据。接下来, 通过访问 /users 路由, 就能看到用户数据了。

这仅仅只是开始。在这个教程中,您已经了解了 Laravel 基础部分,但是还有更多令人兴奋的东西等着您学习。继续阅读文件且更深入的了解 Eloquent 和 Blade 的强大特性。或许,您也更有兴趣去了解 队列 和 单元测试。

部署应用程序

Laravel 的其中一个目标就是让 PHP 应用程序开发从下载到部署都非常的轻松,而 Laravel Forge 提供了一个简单的方式去部署您的 Laravel 应用到服务器上。Forge 可以配置并供应在 DigitalOcean、 Linode、Rackspace 和 Amazon EC2 上的机器群。如同 Homestead 一样,所有必须的最新版软件都已安装在内:Nginx、PHP 5.5、MySQL、Postgres、Redis、Memcached 等等。Forge 的 “快速部署” 可以让您在每次发布更新至 GitHub 或是 Bitbucket 时自动部署应用。

更重要的是,Forge 能帮助您配置 queue workers、SSL、Cron jobs、子域名等等。更多的信息请参阅 Forge 网站。