Laravel5.0学习--01 入门

本文以laravel5.0.22为例。

生产环境建议使用laravel5.1版本，因为该版本是长期支持版本。5.1文档更详细：http://laravel-china.org/docs/5.1。

环境需求

Laravel5.0 框架有一些系统上的需求：

PHP 版本 >= 5.4
Mcrypt PHP 扩展
OpenSSL PHP 扩展
Mbstring PHP 扩展
Tokenizer PHP 扩展

在 PHP 5.5 之后， 有些操作系统需要手动安装 PHP JSON 扩展包。如果你是使用 Ubuntu，可以通过 apt-get install php5-json 来进行安装。

我该使用Laravel吗

来自知乎网友的讨论：PHP框架Laravel还是Codeigniter？ https://www.zhihu.com/question/21617669

CI比较接近原生的PHP，在原有PHP代码的基础上封装了很多类，因为它架构简单，所以容易扩展。从另一个角度来看，也就是没啥架构，最最原始的三层架构。

Laravel 简直就是一次创新，大量吸收了Java，RoR等其他框架的精华，在架构方面，已基本做到现有Php框架最佳，扩展性，伸缩性强大得一塌糊涂，非常适合团队作战。

对于新手来说，Laravel初看上去不太像Php的原本写法了，所谓优雅，就是你光凭代码就可以知道意思，而不用读注释，代码精简复用度非常高；Laravel开发人员都是PHP圈子最顶尖的高手，他们习惯用新的技术和架构，即便如此，Laravel其实上手并不难，一旦以你掌握了它的大致要点后，你会逐渐发现它在每一个方面都全面超越CI，且实用性非常高。(来源：知乎)

简单建议：
如果是个人项目，旨在研究，推荐Laravel；如果是外包或者公司项目，推荐Codeigniter或者ThinkPHP。

特点

RESTful Routing ;
设计精妙的 Blade 模板引擎, 轻快, 不失灵活 ;
合理的 ORM model 层, Eloquent ORM , 借鉴于 Rails 的成功;
migration 数据库版本系统 和 seeding ;
使用包管理器 Composer , 打开了一扇开往春天的门;
强调测试驱动, 整个核心经受过完整的测试, 高质量的代码;
命令行驱动, 可以做到高度自动化 (讲究效率, 代码生成器...) , 借鉴与 rails ;
合理使用 PHP 的新版本特性, 让写代码更加有乐趣, 跟上时代的步伐;
积极向上的社区, 这个很重要呀, 大家都在学习着, 创造着好的工具, 加快开发速度, 提高编程效率, 接受新知识的速度也很快.
对 php 标准化的支持 PHP-FIG — PHP Framework Interop Group

更多阅读：
1、最好的 PHP 框架是什么？为什么？ - Charlie Jade 的回答 - 知乎
https://www.zhihu.com/question/19558755/answer/23062110

2、php - Laravel框架相对于其他框架比如CI、TP、Symfony等的优势是什么？ - SegmentFault
https://segmentfault.com/q/1010000000489103

安装

使用Composer安装

很多人会卡在这一步。要么是不会Composer，要么就是无法使用Composer安装。

如果还不知道Composer，先去学习了解了解：

1、Composer使用 - 飞鸿影~ - 博客园
http://www.cnblogs.com/52fhy/p/5246013.html
2、Packagist / Composer 中国全量镜像
http://pkg.phpcomposer.com/
3、Composer 中文网
http://www.phpcomposer.com/

如果无法使用用Composer安装，很有可能是仓库访问不了，即被墙了。先更新Composer仓库源:

# 修改 composer 的全局配置文件（推荐方式）
# 打开命令行窗口（windows用户）或控制台（Linux、Mac 用户）并执行如下命令：

composer config -g repo.packagist composer https://packagist.phpcomposer.com

接下来正式开始安装吧！
这里以Laravel 5.0 版本为例（PHP 版本 >= 5.4）。

# 指定5.0.22版本，项目目录是learnlaravel5
composer create-project laravel/laravel learnlaravel5 5.0.22

等待安装(需要5分钟左右)：

Installing laravel/laravel (v5.0.22)
  - Installing laravel/laravel (v5.0.22)
    Downloading: 100%

Created project in learnlaravel5
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
  - Installing jakub-onderka/php-console-color (0.1)
    Downloading: 100%

  - Installing vlucas/phpdotenv (v1.1.0)
    Downloading: 100%

  - Installing symfony/var-dumper (v2.6.4)
    Downloading: 100%

  - Installing symfony/translation (v2.6.4)
    Downloading: 100%

  - Installing symfony/security-core (v2.6.4)
    Downloading: 100%

  - Installing symfony/routing (v2.6.4)
    Downloading: 100%

  - Installing symfony/process (v2.6.4)
    Downloading: 100%

  - Installing symfony/http-foundation (v2.6.4)
    Downloading: 100%

  - Installing symfony/event-dispatcher (v2.6.4)
    Downloading: 100%

  - Installing psr/log (1.0.0)
    Downloading: 100%

...

Generating autoload files
> php artisan clear-compiled
> php artisan optimize
Generating optimized class loader
Compiling common classes
> php -r "copy('.env.example', '.env');"
> php artisan key:generate
Application key [4FunRLeVWE0jc6QTs3h8vNbDnoa4Qi8Q] set successfully.

安装完便可以访问了：

http://localhost/laravel5/public/index.php

一键安装包下载

一键安装包是在 Laravel 官方 GitHub 仓库源码的基础上安装了依赖库（也就是已经做过 composer install，已经有了 vendor 目录），对于刚接触 Laravel 或者使用 Composer 受挫的用户能够提供快速上手实践 Laravel 的捷径。

Laravel 一键安装包。更新时间：2016年3月7日下午3点04分

master 7.45M http://down.golaravel.com/laravel/laravel-master.zip
v5.2.15 7.46M http://down.golaravel.com/laravel/laravel-v5.2.15.zip
v5.1.11 7.97M http://down.golaravel.com/laravel/laravel-v5.1.11.zip
v5.0.22 5.94M http://down.golaravel.com/laravel/laravel-v5.0.22.zip
v4.2.11 5.06M http://down.golaravel.com/laravel/laravel-v4.2.11.zip
v4.1.27 4.60M http://down.golaravel.com/laravel/laravel-v4.1.27.zip
v4.0.9 6.05M http://down.golaravel.com/laravel/laravel-v4.0.9.zip

来源：http://www.golaravel.com/download/

项目结构

app
|---Commands
|---Console
|---Events
|---Exceptions
|---Handlers
|---Http
    |---Controllers 控制器
    |---Middleware 中间件
    |---Requests 请求
    |---routes.php 路由
|---Providers
|---Services
|---User.php 模型文件
bootstrap
config
database
public
resources
|---lang
|---views 视图
    |---welcome.blade.php
    |---home.blade.php
storage
|---logs
tests
vendor
.env
artisan
composer.json
server.php

Laravel 框架有一个目录需要额外配置权限：storage 和 vendor 目录要让服务器有写入的权限。

路由(Route)

路由文件在：app/Http/routes.php。

默认的配置：

Route::get('/', 'WelcomeController@index');//匹配根目录到WelcomeController/index

Route::get('home', 'HomeController@index');//匹配home到HomeController/index

Route::controller('blog', 'BlogController');//匹配BlogController里的所有方法，但控制器里方法必须以get、post开头

//路由组
Route::controllers([
	'auth' => 'AuthAuthController',
	'password' => 'AuthPasswordController',
]);

控制器(Controllers)

控制器路径：app/Http/Controllers。
示例：WelcomeController.php

<?php 
namespace AppHttpControllers;

class WelcomeController extends Controller {

	public function index()
	{
		return view('welcome');
	}
}

继承自根控制器：Controller.php

<?php namespace AppHttpControllers;

use IlluminateFoundationBusDispatchesCommands;
use IlluminateRoutingController as BaseController;
use IlluminateFoundationValidationValidatesRequests;

abstract class Controller extends BaseController {

	use DispatchesCommands, ValidatesRequests;

}

生成url

url()方法可以生成符合规范的url。

echo url('greeting');

//输出：http://localhost/laravel5/public/index.php/greeting

配置

配置文件：.env，包含了数据库和MAIL等配置。
config目录下也有相关配置。

模型(Model)

与Laravel4系列不同，旧的 app/models 目录已经完全被移除。相对的，Laravel5模型文件都放在 app 目录下，以及默认使用 App 命名空间。

示例：Blog.php

<?php 
namespace App;
use IlluminateDatabaseEloquentModel;

class Blog extends Model {
    public function listAll(){
        return $this->all();
    }
}

视图(views)

视图根路径：resources/views。

视图与控制器对应关系：
例如：控制器里

view('welcome'); //对应视图根路径下welcome.blade.php
view('admin.pages.edit', $data); //对应对应视图根路径下admin/pages/edit.blade.php

视图文件代码上实际就是html。但自定义了一些标签。

在视图文件，我们可以使用PHP原生语法来获取传过来的数据：

<html>
    <body>
        <h1>Hello, <?php echo $name; ?></h1>
    </body>
</html>

或者使用Laravel的Blade模板标签：双大括号：

<html>
    <body>
        <h1>Hello, {{$name}}</h1>
    </body>
</html>

控制器(WelcomeController.php)里是这样的：

public function greeting() {
    return view('greeting', ['name' => 'James']);
}

注意，测试的时候要新建路由：

Route::get('greeting', 'WelcomeController@greeting');

访问：http://localhost/laravel5/public/index.php/greeting

传递数据到视图

// 使用传统的方法
$view = view('greeting')->with('name', 'Victoria');

// 使用魔术方法
$view = view('greeting')->withName('Victoria');

模板标签语言

示例文件：
layout.blade.php 母视图

<html>
 <body>
    <h1>Laravel Quickstart</h1>
    
    @yield('content')
 </body>
 </html>

users.blade.php 普通视图

@extends('layout')

@section('content')
    Users!
@endsection

1、输出：使用双花括号： {{$name}}。
2、继承：@extends，将copy一份母视图过来。
引入：@include('shared.errors')引入子视图
3、区域替换：@section...@endsection，该标签内的内容将替换在母视图使用@yield定义的内容。
4、条件语句：@if...@endif。

@if (count($records) === 1)
    我有一条记录！
@elseif (count($records) > 1)
    我有多条记录！
@else
    我没有任何记录！
@endif

5、数据遍历、循环：

@for ($i = 0; $i < 10; $i++)
    目前的值为 {{ $i }}
@endfor

@foreach ($users as $user)
    <p>此用户为 {{ $user->id }}</p>
@endforeach

@forelse ($users as $user)
    <li>{{ $user->name }}</li>
@empty
    <p>没有用户</p>
@endforelse

@while (true)
    <p>我永远都在跑循环。</p>
@endwhile

6、url生成：示例

{{ url('blog/detail/'.$item->id) }}

# 或者
{{ url('blog/detail',array('id'=>$item->id)) }}

控制器里方法括号里接这个参数：

public function getDetail($id){

        $blog = new Blog();
        $detail = $blog->find($id);

        return view('detail', array(
            'detail' => $detail
        ));
    }

7、public目录下资源引用

{{asset('/css/main.css')}}

对应public目录下的css/main.css
8、视图可以显示PHP 函数的结果。实际上，可以放置任何想要的 PHP 代码到 Blade 显示的语法里面：

目前的 UNIX 时间戳为 {{ time() }}。

9、禁用渲染
由于许多 JavaScript 框架也使用「大括号」在浏览器中显示指定的表达式，因此可以使用 @ 符号来告知 Blade 渲染引擎该表达式应该维持原样。举个例子：

Hello, @{{ name }}.

10、缺省值：

{{ isset($name) ? $name : 'Default' }}

# 或者
{{ $name or 'Default' }}

11、显示未转义过的数据
默认输出的值会自动调用 PHP 的 htmlentities 函数，以避免 XSS 攻击。禁用：

Hello, {!! $name !!}.

参考：Laravel 5.1 中文文档：Blade 模板
http://laravel-china.org/docs/5.1/blade

数据库操作

Laravel中提供DB facade、查询构造器和Eloquent ORM三种数据库操作方式。本文接下来将讲解前两种方式。

数据库相关配置文件都在 config/database.php。默认从.env文件中读取配置。

目前 Laravel 支持四种数据库系统： MySQL、Postgres、SQLite、以及 SQL Server。

读写分离：

'mysql' => [
    'read' => [
        'host' => '192.168.1.1',
    ],
    'write' => [
        'host' => '196.168.1.2'
    ],
    'driver'    => 'mysql',
    'database'  => 'database',
    'username'  => 'root',
    'password'  => '',
    'charset'   => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix'    => '',
],

使用DB类进行CURD

需要先引入。

use IlluminateSupportFacadesDB;

例如：

public function greeting() {
    $results = DB::select('select * from blog where id = ?', [1]);
    print_r($results);exit;
}

输出：

Array ( [0] => stdClass Object ( [id] => 1 [uid] => 1 [title] => test [content] => hello laravel5! [flag] => 1 [create_time] => 0 [update_time] => 0 ) )

更多方法（来自官方文档）：

//执行 Select 查找
$results = DB::select('select * from users where id = ?', [1]);
$results = DB::select('select * from users where id = :id', ['id' => 1]);

//执行 Insert 语法
DB::insert('insert into users (id, name) values (?, ?)', [1, 'Dayle']);

//执行 Update 语法
DB::update('update users set votes = 100 where name = ?', ['John']);

执行 Delete 语法
DB::delete('delete from users');

//执行一般语法
DB::statement('drop table users');

//监听查找事件
DB::listen(function($sql, $bindings, $time)
{
    //
});


//数据库事务处理
//你可以使用 transaction 方法，去执行一组数据库事务处理的操作：
DB::transaction(function()
{
    DB::table('users')->update(['votes' => 1]);

    DB::table('posts')->delete();
});

//手动事务
DB::beginTransaction();
DB::rollback();
DB::commit();


//获取连接
//若要使用多个连接，可以通过 DB::connection 方法取用：
$users = DB::connection('foo')->select(...);

//你也可以取用原始底层的 PDO 实例：
$pdo = DB::connection()->getPdo();

//有时候你可能需要重新连接到特定的数据库：
DB::reconnect('foo');

//如果你因为超过了底层 PDO 实例的 max_connections 的限制，需要关闭特定的数据库连接，可以通过 disconnect 方法:
DB::disconnect('foo');


//查找日志记录
//Laravel 可以在内存里访问这次请求中所有的查找语句。然而在有些例子下要注意，比如一次添加 大量的数据，可能会导致应用程序耗损过多内存。 如果要启用日志，可以使用 enableQueryLog 方法：
DB::connection()->enableQueryLog();

//要得到执行过的查找纪录数组，你可以使用 getQueryLog 方法：
$queries = DB::getQueryLog();

DB类查询构造器

Laravel 查询构造器使用 PDO 参数绑定，以保护应用程序免于 SQL 注入，因此传入的参数不需额外转义特殊字符。

示例：

//获取所有数据列
$users = DB::table('users')->get();

查询：

//根据条件查找，取得单一数据列
$user = DB::table('users')->where('name', 'John')->first();
var_dump($user->name);


//从数据表中取得单一数据列的单一字段
$name = DB::table('users')->where('name', 'John')->pluck('name');

//取得单一字段值的列表:这个方法将会返回数据表 role 的 title 字段值的数组
$roles = DB::table('roles')->lists('title');
$roles = DB::table('roles')->lists('title', 'name');


//指定查询字段
$users = DB::table('users')->select('name', 'email')->get();
$users = DB::table('users')->distinct()->get();
$users = DB::table('users')->select('name as user_name')->get();


//增加查询字段到现有的查询中
$query = DB::table('users')->select('name');
$users = $query->addSelect('age')->get();

//使用 where 及运算符
$users = DB::table('users')->where('votes', '>', 100)->get();

//or
$users = DB::table('users')
            ->where('votes', '>', 100)
            ->orWhere('name', 'John')
            ->get();
            
//Between
$users = DB::table('users')
            ->whereBetween('votes', [1, 100])->get();
            
//Not Between
$users = DB::table('users')
            ->whereNotBetween('votes', [1, 100])->get();   
            
            
//In
$users = DB::table('users')
            ->whereIn('id', [1, 2, 3])->get();

//NotIn
$users = DB::table('users')
            ->whereNotIn('id', [1, 2, 3])->get();            

//Null 找有未配置的值的数据
$users = DB::table('users')
            ->whereNull('updated_at')->get();

//魔术语句            
$admin = DB::table('users')->whereId(1)->first();

$john = DB::table('users')
            ->whereIdAndEmail(2, 'john@doe.com')
            ->first();

$jane = DB::table('users')
            ->whereNameOrAge('Jane', 22)
            ->first();            

//排序(Order By)、分群(Group By) 及 Having
$users = DB::table('users')
            ->orderBy('name', 'desc')
            ->groupBy('count')
            ->having('count', '>', 100)
            ->get();
                    
//偏移(Offset) 及 限制(Limit)
$users = DB::table('users')->skip(10)->take(5)->get();

//基本的 Join 语法
DB::table('users')
            ->join('contacts', 'users.id', '=', 'contacts.user_id')
            ->join('orders', 'users.id', '=', 'orders.user_id')
            ->select('users.id', 'contacts.phone', 'orders.price')
            ->get();
            
//Left Join 语法
DB::table('users')
        ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
        ->get();
        
//更高级的 join 子句：
DB::table('users')
    ->join('contacts', function($join)
    {
        $join->on('users.id', '=', 'contacts.user_id')->orOn(...);
    })
    ->get();
    
DB::table('users')
    ->join('contacts', function($join)
    {
        $join->on('users.id', '=', 'contacts.user_id')
             ->where('contacts.user_id', '>', 5);
    })
    ->get();   
    
//群组化参数
DB::table('users')
    ->where('name', '=', 'John')
    ->orWhere(function($query)
    {
        $query->where('votes', '>', 100)
              ->where('title', '<>', 'Admin');
    })
    ->get();
    
//上面的查找语法会产生下方的 SQL：
select * from users where name = 'John' or (votes > 100 and title <> 'Admin')

//Exists 语法
DB::table('users')
            ->whereExists(function($query)
            {
                $query->select(DB::raw(1))
                      ->from('orders')
                      ->whereRaw('orders.user_id = users.id');
            })
            ->get();
//上面的查找语法会产生下方的 SQL：
select * from users
where exists (
    select 1 from orders where orders.user_id = users.id
)

//使用聚合方法
$users = DB::table('users')->count();
$price = DB::table('orders')->max('price');
$price = DB::table('orders')->min('price');
$price = DB::table('orders')->avg('price');
$total = DB::table('users')->sum('votes');

新增：

//新增，不会返回新增ID
DB::table('users')->insert(
    ['email' => 'john@example.com', 'votes' => 0]
);

//新增，返回新增ID
$id = DB::table('users')->insertGetId(
    ['email' => 'john@example.com', 'votes' => 0]
);

//批量新增
DB::table('users')->insert([
    ['email' => 'taylor@example.com', 'votes' => 0],
    ['email' => 'dayle@example.com', 'votes' => 0]
]);

更新：

//更新
DB::table('users')
            ->where('id', 1)
            ->update(['votes' => 1]);

//自增或自减一个字段的值
DB::table('users')->increment('votes');
DB::table('users')->increment('votes', 5);
DB::table('users')->decrement('votes');
DB::table('users')->decrement('votes', 5);

//也能够同时指定其他要更新的字段：
DB::table('users')->increment('votes', 1, ['name' => 'John']);

删除：

//删除数据表中的数据
DB::table('users')->where('votes', '<', 100)->delete();

//删除数据表中的所有数据
DB::table('users')->delete();

//清空数据表
DB::table('users')->truncate();

更多查看：http://laravel-china.org/docs/5.0/queries

Eloquent ORM

相比DB类，Laravel 的 Eloquent ORM 提供优雅的 ActiveRecord 实现来和数据库的互动。 每个数据库表会有一个对应的模型文件。
详见下一章。

学习资料

推荐教程：
Laravel 5 系列入门教程（一）【最适合中国人的 Laravel 教程】 - 岁寒
https://lvwenhan.com/laravel/432.html

Laravel 5 中文文档：

1. http://laravel-china.org/docs/5.0
2. http://laravel-china.org/docs/5.1
3. http://www.golaravel.com/laravel/docs/5.0/

更多：

• Laravist |Laravel Vuejs Bootstrap 视频教程
  https://laravist.com/

• LaraBase——全栈工程师之家
  http://laravelbase.com/

• Laravel - The PHP Framework For Web Artisans
  http://laravel.com/

• laravel/laravel
  https://github.com/laravel/laravel