Laravel 5 系列入门教程(一)【最适合中国人的 Laravel 教程】



基于最新 Laravel 5.2 的 2016 版教程已经发布到 Github:https://github.com/johnlui/Learn-Laravel-5/issues/4

十分建议学习 5.2,跟 5.0 比变化非常大。



本教程示例代码见:https://github.com/johnlui/Learn-Laravel-5  

大家在任何地方卡住,最快捷的解决方式就是去看我的示例代码。


Laravel 5 中文文档:

1. http://laravel-china.org/docs/5.0

2. http://www.golaravel.com/laravel/docs/5.0/


默认条件

本文默认你已经有配置完善的 PHP + MySQL 运行环境,懂得 PHP 网站运行的基础知识。跟随本教程走完一遍,你将会得到一个基础的包含登录的简单 blog 系统,并将学会如何使用一些强大的 Laravel 插件和 composer 包(Laravel 插件也是 composer 包)。

软件版本:PHP 5.4+,MySQL 5.1+

本文不推荐完全不懂 PHP 与 MVC 编程的人学习。本文不是 “一步一步跟我做” 教程。本文需要你付出一定的心智去解决一些或大或小的隐藏任务,以达到真正理解 Laravel 运行逻辑的目的。

1. 安装

许多人被拦在了学习Laravel的第一步,安装。并不是因为安装教程有多复杂,而是因为【众所周知的原因】。在此我推荐一个composer全量中国镜像:http://pkg.phpcomposer.com/ 。推荐以 “修改 composer 的配置文件” 方式配置。

镜像配置完成后,切换到你想要放置该网站的目录下(如 C:\\wwwroot、/Library/WebServer/Documents/、/var/www/html、/etc/nginx/html 等),运行命令:

composer create-project laravel/laravel learnlaravel5 5.0.22

然后,稍等片刻,当前目录下就会出现一个叫 learnlaravel5 的文件夹。

本系列教程使用 Laravel 5.0 版本,5.1 版本去掉了本系列教程主要讲解的元素(Auth 系统),不建议使用 5.1 来学习。本系列教程为入门教程,目的是搞清楚 Laravel 的基本使用方法,切忌本末倒置。

然后将网站根目录配置为 learnlaravel5/public。

如果你不会配置,建议去学会配置,网上资料很多。如果自暴自弃,可以把 的第 29 行 'url' => 'http://localhost', 配置成你的子目录地址,注意,要一直配置到 ***/learnlaravel5/public。

使用浏览器访问你配置的地址,将看到以下画面(我在本地配置的地址为 http://fuck.io:88 ):

Image

2. 体验 Auth 系统并完成安装

—— 经过上面的过程,Laravel 5 的安装成功了?

—— 没有o(╯□╰)o

查看路由文件 `learnlaravel5/app/Http/routes.php` 的代码:

Route::get('/', 'WelcomeController@index');

Route::get('home', 'HomeController@index');

Route::controllers([
	'auth' => 'Auth\AuthController',
	'password' => 'Auth\PasswordController',
]);

跟随代码里的蛛丝马迹,让我们访问 http://fuck.io:88/home (请自行替换域名),结果竟然跳转到了登陆页?

Image

没错,Laravel 自带了开箱即用的 Auth 系统,连页面都已经写好了。

让我们随意输入邮箱和密码,点击登录,你很可能得到以下画面(Mac 或 Linux 下):

Image

为什么空白?用开发者工具查看,这个请求的状态码是 500,为什么?

因为 `learnlaravel5/storage` 目录没有 777 权限。

执行 shell 命令:

cd learnlaravel5

sudo chmod -R 777 storage

重新访问 http://fuck.io:88/home ,随意输入邮箱和密码,如果你得到以下画面:

Image

那么恭喜你~ Laravel 5 安装成功!

不想配置镜像的同学,可以使用 Laravel 界非常著名的 安正超 搞的安装神器:https://github.com/overtrue/latest-laravel

3. 数据库建立及迁移

Laravel 5 把数据库配置的地方改到了 `learnlaravel5/.env`,打开这个文件,编辑下面四项,修改为正确的信息:

DB_HOST=localhost

DB_DATABASE=laravel5

DB_USERNAME=root

DB_PASSWORD=password

推荐新建一个名为 laravel5 的数据库,为了学习方便,推荐使用 root 账户直接操作。

Laravel 已经为我们准备好了 Auth 部分的 migration,运行以下命令执行数据库迁移操作:

php artisan migrate

得到的结果如下:

Image

如果你运行命令报错,请检查数据库连接设置。

至此,数据库迁移已完成,你可以打开 http://fuck.io:88/home 欢快地尝试注册、登录啦。

4. 模型 Models

接下来我们将接触Laravel最为强大的部分,Eloquent ORM,真正提高生产力的地方,借用库克的一句话:鹅妹子英!

运行一下命令:

php artisan make:model Article

php artisan make:model Page

> Laravel 4 时代,我们使用 Generator 插件来新建 Model。现在,Laravel 5 已经把 Generator 集成进了 Artisan。

现在,Artisan 帮我们在 `learnlaravel5/app/` 下创建了两个文件 `Article.php` 和 `Page.php`,这是两个 Model 类,他们都继承了 Laravel Eloquent 提供的 Model 类 `Illuminate\Database\Eloquent\Model`,且都在 `\App` 命名空间下。这里需要强调一下,用命令行的方式创建文件,和自己手动创建文件没有任何区别,你也可以尝试自己创建这两个 Model 类。

Model 即为 MVC 中的 M,翻译为 模型,负责跟数据库交互。在 Eloquent 中,数据库中每一张表对应着一个 Model 类(当然也可以对应多个)。

如果你从其他框架转过来,可能对这里一笔带过的 Model 部分很不适应,没办法,是因为 Eloquent 实在太强大了啦,真的没什么好做的,继承一下 Eloquent 类就能实现很多很多功能了。

如果你想深入地了解 Eloquent,可以阅读系列文章:深入理解 Laravel Eloquent(一)——基本概念及用法


接下来进行 Article 和 Page 类对应的 articles 表和 pages表的数据库迁移,进入 `learnlaravel5/database/migrations` 文件夹。

在 ***_create_articles_table.php 中修改:

Schema::create('articles', function(Blueprint $table)
{
	$table->increments('id');
	$table->string('title');
	$table->string('slug')->nullable();
	$table->text('body')->nullable();
	$table->string('image')->nullable();
	$table->integer('user_id');
	$table->timestamps();
});

在 ***_create_pages_table.php 中修改:

Schema::create('pages', function(Blueprint $table)
{
	$table->increments('id');
	$table->string('title');
	$table->string('slug')->nullable();
	$table->text('body')->nullable();
	$table->integer('user_id');
	$table->timestamps();
});

然后执行命令:

php artisan migrate

成功以后, articles 表和 pages 表已经出现在了数据库里,去看看吧~

5. 数据库填充 Seeder

在 `learnlaravel5/database/seeds/` 下新建 `PageTableSeeder.php` 文件,内容如下:

<?php

use Illuminate\Database\Seeder;
use App\Page;

class PageTableSeeder extends Seeder {

  public function run()
  {
    DB::table('pages')->delete();

    for ($i=0; $i < 10; $i++) {
      Page::create([
        'title'   => 'Title '.$i,
        'slug'    => 'first-page',
        'body'    => 'Body '.$i,
        'user_id' => 1,
      ]);
    }
  }

}

然后修改同一级目录下的 `DatabaseSeeder.php`中:

// $this->call('UserTableSeeder');

这一句为

$this->call('PageTableSeeder');

然后运行命令进行数据填充:

composer dump-autoload

php artisan db:seed

去看看 pages 表,是不是多了十行数据?


教程(一)代码快照:https://github.com/johnlui/Learn-Laravel-5/archive/tutorial_1.zip


下一步:Laravel 5 系列入门教程(二)【最适合中国人的 Laravel 教程】

WRITTEN BY

avatar
2015.3.7   /   热度:241562   /   分类: Laravel

评论:

lili
2017-08-22 17:15
[Illuminate\Database\QueryException]
  SQLSTATE[42S01]: Base table or view already exists: 1050 La table 'users' existe d茅j脿 (SQL

  : create table `users` (`id` int unsigned not null auto_increment primary key, `name` varc
  har(255) not null, `email` varchar(255) not null, `password` varchar(255) not null, `remem
  ber_token` varchar(100) null, `created_at` timestamp null, `updated_at` timestamp null) de
  fault character set utf8mb4 collate utf8mb4_unicode_ci)

  [PDOException]
  SQLSTATE[42S01]: Base table or view already exists: 1050 La table 'users' existe

执行php artisan grate 报了上面的错误,如何避免呢
哲哲别
2017-04-01 17:01
[Symfony\Component\Debug\Exception\FatalErrorException]
  Cannot declare class CreateUsersTable, because the name is already in use


这个是咋回事呢?我已经清空数据库了,说我那个名字已经在使用了,咋解决/我的事wamp64位,php7.0.1版本,laraval是5.2.15刚入手的,之前用过一下thinkphp。请大家指教一下。
柚子
2017-04-16 15:22
@哲哲别:这个数据叫迁移自己会创建附属的数据库,你没有清干净,你这个截图,有点抽象,谁看了,我想一直半会也想不起来
哲哲别
2017-04-01 16:21
我的直接弄的5.2版本,很多有些不一样呀,不知道怎么创建数据表。。。创建模型之后,没有出现在 ***_create_articles_table.php这些。不知道怎么搞了,版本之间变化好大呀!
zhouciming
2017-03-30 00:59
按你的教程,我一切都是成功的。唯一不解的是:插入的记录中,create_at填充的时间总是比实际的时间小8个小时,中国在东8区,所以这个8与时区设置有关。但是我的php.ini中已经设置了timezone = PRC了,那么为什么还会出现这个问题呢,请指教!!!
哲哲别
2017-04-01 16:17
@zhouciming:这个时区要自己重新配置,在D:\wamp64\www\laravel-v5.2.15\config\app.php,这里需要配置一下    'timezone' => 'PRC',就可以了
zhouciming
2017-04-01 16:43
@哲哲别:非常感谢,已经找到这个位置了!
幸运儿
2017-03-17 18:01
你好,怎么做到登录之后跳转到登录前的页面呢?谢谢
柚子
2017-04-16 15:24
@幸运儿:重定向
幸运儿
2017-04-17 18:22
@柚子:我的意思是,你登录之前的页面是不确定的。但是你登录之后要跳转到登录前的页面。你重定向的url写死吗?我是想问怎么把它写活
Alen
2017-10-16 20:00
@幸运儿:你可以这样 redirect()->back()
拾荒少年
2017-02-26 18:39
博主威武!!!
王永东
2017-01-12 10:23
看过你的教程之后,感觉很清晰,条理性很强,赞。
gaga
2016-12-28 22:39
不错,赞一个
snail
2016-09-07 14:46
博主好脏~~~域名亮瞎了。艹
q
2016-08-19 13:41
93年的小伙伴这么强~

2016-07-15 18:25
Uncaught TypeError: Argument 1 passed to App\Exceptions\Handler::report() must be an instance of Exception, instance of Error given, called in /home/dong/www/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/HandleExceptions.php on line 73 and defined in /home/dong/www/laravel/app/Exceptions/Handler.php:25
Stack trace:
#0 /home/dong/www/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/HandleExceptions.php(73): App\Exceptions\Handler->report(Object(Error))
#1 [internal function]: Illuminate\Foundation\Bootstrap\HandleExceptions->handleException(Object(Error))
#2 {main}
thrown

大神这是什么意思?
Ebychu
2016-06-23 15:35
讲的好棒奥,不过生成测试数据,用faker组件会不会更方便一些呢
rolla
2016-05-11 16:04
很棒的教程,简直玩得停不下来
YAJUN813
2016-05-07 15:37
感谢分享!
Laravel 很不错,这几天一直在学习。
xhq
2016-04-29 23:09
rewrite规则,简单方便,http://wp.iyouths.org/292.html
laravel新手
2016-04-24 10:23

请问下 访问不存在的路由 laravel下如何接管啊!!
比如 我定义的路由的路由是test 然后访问一个不存在的路由地址比如new
这个时间如何接管这个new路由

thinkphp 有empty接管
YiHong
2016-04-14 11:58
老师,在实际开发中,每次修改表结构都会在database/migrationgs目录下生产一个.php文件,假如是一个大型的项目,那得生产100多个.php文件。您怎么解决这种问题?
justId
2016-09-22 17:51
@YiHong:这个简单啊,其实真正作用的是方法里的函数,建表的话也可以按照模块来分migrate文件,数据填充也是这个思路
jokee
2016-04-05 10:51
call函数默认会把类里所有的func调用一遍吗?
多谢
jokee
2016-04-05 16:44
@jokee:找了原代码,原来是这样的
    public function call($class)
    {
        $this->resolve($class)->run();

        if (isset($this->command)) {
            $this->command->getOutput()->writeln("<info>Seeded:</info> $class");
        }
    }

BTW,多谢lz的教程
楠楠猪
2016-04-02 21:41
老师你好,我也想把自己的主页变成你的http://fuck.io:88/home,而不是http://localhost/test1/learnlaravel5/public/home,我该怎么做啊,谢谢啦!
1
2016-04-11 17:57
@楠楠猪:虚拟主机里面配置一下
henry
2016-03-29 14:33
感谢分享!学到了很多,都按楼主的步骤实现了

发表评论:

© 2011-2017 岁寒  |  Powered by Emlog