Laravel5.0学习--01 入门

2022-10-11 14:31:56

本文以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' => 'Auth\AuthController',

	'password' => 'Auth\PasswordController',

]);

控制器(Controllers)

控制器路径：app/Http/Controllers。

示例：WelcomeController.php

<?php

namespace App\Http\Controllers;

class WelcomeController extends Controller {

	public function index()

	{

		return view('welcome');

	}

}

继承自根控制器：Controller.php

<?php namespace App\Http\Controllers;

use Illuminate\Foundation\Bus\DispatchesCommands;

use Illuminate\Routing\Controller as BaseController;

use Illuminate\Foundation\Validation\ValidatesRequests;

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 Illuminate\Database\Eloquent\Model;

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 Illuminate\Support\Facades\DB;

例如：

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();

Eloquent ORM

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

详见下一章。

学习资料

推荐教程：

Laravel 5 系列入门教程（一）【最适合中国人的 Laravel 教程】 - 岁寒

https://lvwenhan.com/laravel/432.html

Laravel 5 中文文档：

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

码农公寓