介紹
- Laravel 是一款 MVC架構(gòu)、 目前最流行的 PHP框架。
- Laravel的優(yōu)點(diǎn)在于: 豐富的composer類庫(kù)支持, 優(yōu)雅的代碼, 未來(lái)的主流框架(目前市場(chǎng)占有率最高的框架)
- Laravel的缺點(diǎn)在于: 過(guò)于優(yōu)雅(我們只需要編寫極少的代碼即可實(shí)現(xiàn)功能,意味著底層極其復(fù)雜的封裝)導(dǎo)致程序的執(zhí)行效率略低, 和thinkphp等國(guó)內(nèi)主流框架相比,上手難度略高(因?yàn)樗鼮槲覀兗闪撕芏嗥渌墓δ埽踔聊氵€需要學(xué)習(xí)nodeJS相關(guān)的知識(shí))。
- 本項(xiàng)目,是完全使用 Laravel框架 內(nèi)的所提供的最基礎(chǔ),但是又是最有用(能顯著提升我們開發(fā)效率)的工具而開發(fā)出來(lái)的。在學(xué)習(xí)過(guò)程中,你只需要操作一次數(shù)據(jù)庫(kù),不需要自己構(gòu)建html視圖模板(當(dāng)然還是要寫一些html和js代碼的),不需要考慮外部的css、js。本教程的目的完全為向各位 phper 以及對(duì) laravel 有興趣的小伙伴推薦這款我相信是未來(lái)主流的php框架。
推薦教程:2019年最新的五個(gè)Laravel視頻教程推薦
準(zhǔn)備工作
- 確保你了解 php面向?qū)ο缶幊?的基礎(chǔ)知識(shí), 會(huì)html和簡(jiǎn)單的js, 在css方面: 我們使用laravel內(nèi)置的 bootstrap4, 最后,一定要會(huì)使用 composer。
- 唯一一次操作數(shù)據(jù)庫(kù): 創(chuàng)建用戶、數(shù)據(jù)庫(kù),授權(quán)
如果你愿意用root用戶,你甚至只需要 create 一個(gè) database 即可。 (不過(guò)不推薦,我的習(xí)慣是一個(gè)項(xiàng)目 對(duì)應(yīng) 一個(gè)用戶 + 一個(gè)數(shù)據(jù)庫(kù),root則只用來(lái)管理他們)
# 創(chuàng)建用戶 blog, 密碼自定義 CREATE USER 'blog'@'%' IDENTIFIED BY '密碼'; # 創(chuàng)建數(shù)據(jù)庫(kù) blog, 設(shè)置默認(rèn)編碼為utf8 CREATE DATABASE `blog` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; # 授權(quán) 授予 blog庫(kù)下所有表的 所有權(quán)限 給 用戶blog GRANT ALL on blog.* to 'blog'@'%';
- 使用 composer 創(chuàng)建一個(gè) laravel 項(xiàng)目 取名叫blog
# 進(jìn)入你本地服務(wù)器用于存放網(wǎng)站文檔的目錄,輸入命令 composer create-project --prefer-dist laravel/laravel blog
- 你還需要配置一個(gè)虛擬主機(jī)以提升開發(fā)效率(直接訪問(wèn)url,不需要 “l(fā)ocalhost/項(xiàng)目/public” 訪問(wèn) ),你可以選擇手動(dòng)配置,或者選擇集成開發(fā)環(huán)境創(chuàng)建項(xiàng)目(推薦:mac=>mamp 、 windows=>phpstudy。)。
下文中,“/” 即表示 laravel 框架的根目錄
- 配置 /.env 文件
# 數(shù)據(jù)庫(kù)配置 DB_CONNECTION=mysql #類型 DB_HOST=127.0.0.1 #ip DB_PORT=3306 #端口 DB_DATABASE=數(shù)據(jù)庫(kù)名 DB_USERNAME=用戶名 DB_PASSWORD=密碼
- 下載中文包
composer require caouecs/laravel-lang
然后將 /vendor/caouecs/src/zh-CN/ 放入 /resources/lang/ 下 - 配置一下 /config/app.php
# 時(shí)區(qū) 'timezone' => 'Asia/Shanghai', # 語(yǔ)言 'locale' => 'zh-CN',
準(zhǔn)備工作總結(jié)
- 1、創(chuàng)建用戶、數(shù)據(jù)庫(kù),然后授權(quán)。
- 2、使用 composer 創(chuàng)建項(xiàng)目。
- 3、配置 laravel 的環(huán)境 ./env 。 然后使用 composer 安裝了漢化包,并且在 /config/app.php 中設(shè)置時(shí)區(qū)并且讓中文包生效。
第一階段: Migration、Factory、Seeder
你可能沒有見過(guò)上面3個(gè)名詞,不過(guò)和他們有關(guān)的文件都存放在 /database/ 下: 通過(guò)這個(gè)文件夾的名稱,你大概已經(jīng)猜到:這三個(gè)文件都是用來(lái)操作數(shù)據(jù)庫(kù)的。
-
上文中,我們只是創(chuàng)建了數(shù)據(jù)庫(kù),并沒有創(chuàng)建數(shù)據(jù)表,現(xiàn)在來(lái)確定一下我們的數(shù)據(jù)表
- 一個(gè)用戶表 users
- 一個(gè)博客表 blogs
- 一個(gè)評(píng)論表 comments
項(xiàng)目是一個(gè)個(gè)人博客,因此只有博主可以發(fā)布、刪除、修改博客。其他用戶則可以查看博客和發(fā)布評(píng)論。
-
使用 Migration 創(chuàng)建這3張數(shù)據(jù)表
- 打開命令行,創(chuàng)建 migrations
php artisan make:migration create_blogs --create=blogs
博客表,php artisan make:migration create_comments --create=comments
評(píng)論表
php aritsan 是laravel內(nèi)置的命令 你可以直接在控制臺(tái)輸入它,則會(huì)在控制臺(tái)提示你接下來(lái)你能輸入的命令。
上文我們就使用 make:migration 幫我們創(chuàng)建了遷移文件, –create 是參數(shù),即告訴這條命令,幫我們創(chuàng)建一個(gè)用于創(chuàng)建數(shù)據(jù)表的遷移文件 - 打開命令行,創(chuàng)建 migrations
-
為什么不創(chuàng)建用戶表呢? 打開 /database/migrations/ 你會(huì)發(fā)現(xiàn)有一個(gè)2014年就創(chuàng)建好的 針對(duì) users 和 password_resets 表。這是框架自帶的。
-
編輯這兩個(gè)遷移文件
- create_blogs
// 首先類定義中,有兩個(gè)方法,up()可以理解為正向操作:創(chuàng)建表,而 down()可以理解為回滾操作:刪除表。 // up() Schema::create('blogs', function (Blueprint $table) { $table->increments('id'); $table->string('title'); $table->text('content'); $table->timestamps(); }); // down() 已經(jīng)自動(dòng)幫我們寫好了。
- create_comments
// up() Schema::create('comments', function (Blueprint $table) { $table->increments('id'); $table->string('content'); $table->integer('blog_id'); //這條評(píng)論是針對(duì)哪一篇博客的? $table->integer('user_id'); //這條評(píng)論是哪一位用戶發(fā)送的? $table->timestamps(); });
-
執(zhí)行遷移: 1、確保你的 /.env 配置正確 2、確保你的數(shù)據(jù)庫(kù)可以正常使用 3、確保數(shù)據(jù)庫(kù)中沒有數(shù)據(jù)表或者沒有和users blogs comments重名的數(shù)據(jù)表
php artisan migrate
-
打開數(shù)據(jù)庫(kù)(你可以任選一款數(shù)據(jù)庫(kù)管理工具,或者直接使用mysql的命令行),打開數(shù)據(jù)庫(kù) blog ,你會(huì)發(fā)現(xiàn)有以下表
- blogs => 我們創(chuàng)建的博客表
- comments => 我們創(chuàng)建的評(píng)論表
- migrations => 系統(tǒng)創(chuàng)建的遷移記錄表
- password_resets => 框架自帶遷移文件生成的重置密碼用表
- users => 框架自帶的用戶表
-
主要解釋一下 migrations 表:
- 這是一個(gè)記錄你的遷移文件名稱和批次的表。它的主要作用是通過(guò)記錄批次,方便你對(duì)數(shù)據(jù)庫(kù)進(jìn)行版本控制:打開 migrations表,你會(huì)發(fā)現(xiàn),當(dāng)前記錄了4張表的遷移文件名,而他們的batch都是1,你可以理解為當(dāng)前數(shù)據(jù)庫(kù)是第一批,版本1。
- 如果你執(zhí)行
php artisan migrate:rollback
即回滾數(shù)據(jù)庫(kù),將會(huì)執(zhí)行批次batch最大的記錄的那些遷移文件的 down() 方法。
-
migration 的作用:1、幫我們省略了去寫sql語(yǔ)句的麻煩,2、讓我們對(duì)數(shù)據(jù)庫(kù)可以進(jìn)行有效的版本控制。
- 使用模型工廠 Factory 來(lái)插入虛構(gòu)的數(shù)據(jù)
在日常的開發(fā)中,我們需要很多模擬的數(shù)據(jù)進(jìn)行測(cè)試,模型工廠的作用就是幫我們快速的,隨機(jī)的生成這些數(shù)據(jù)。
- 創(chuàng)建模型工廠
php artisan make:factory BlogFactory --model=Blog
, 關(guān)于評(píng)論表的模型工廠請(qǐng)自己寫。 - 注意此時(shí)我們其實(shí)沒有模型 Blog 和模型 Comment,我們只是創(chuàng)建了數(shù)據(jù)表而已。因此我們?cè)賱?chuàng)建兩個(gè)模型。
php artisan make:model Blog
, 關(guān)于評(píng)論表的模型請(qǐng)自己寫。
細(xì)心的你可能發(fā)現(xiàn)了,我們的數(shù)據(jù)表和模型的名字是有區(qū)別的:數(shù)據(jù)表為“小寫復(fù)數(shù)形式”,而模型名為“大寫單數(shù)形式”。 創(chuàng)建的模型都存在于 /app/ 下。
- 編輯模型工廠 /database/factories
- BlogFactory
// 使用 Faker 類為我們提供的生成隨機(jī)偽造數(shù)據(jù)的方法生成數(shù)據(jù) return [ 'title' => $faker->name, 'content' => $faker->text, ];
- CommentFactory
return [ 'content' => $faker->text, 'blog_id' => 1, 'user_id' => 1, ];
- 使用 tinker 模式調(diào)試代碼
- 進(jìn)入 “修補(bǔ)匠模式”
php artisan tinker
, 當(dāng)命令提示符變?yōu)?">>>" 時(shí),你就處于tinker模式下了,此時(shí)你可以輸入php代碼,或者調(diào)用laravel提供的全局函數(shù),甚至引用一個(gè)類,調(diào)用它的靜態(tài)方法或者實(shí)例化它。 - 在 tinker 模式下使用全局函數(shù) factory() 生成模擬的數(shù)據(jù)
factory(AppBlog::class)->make()
此時(shí)屏幕上會(huì)顯示,它給你模擬出來(lái)的一個(gè)虛擬數(shù)據(jù)數(shù)組。 - 使用 create() 一次性向數(shù)據(jù)表中插入100條模擬的數(shù)據(jù)
factory(AppBlog::class, 100)->create()
打開數(shù)據(jù)庫(kù),您會(huì)發(fā)現(xiàn)100條標(biāo)題和內(nèi)容都無(wú)關(guān)緊要,但是對(duì)我們快速開發(fā)特別有用的測(cè)試數(shù)據(jù)已經(jīng)存放在數(shù)據(jù)庫(kù)中了。
- 進(jìn)入 “修補(bǔ)匠模式”
- 使用 Seeder 一次性完成多個(gè)數(shù)據(jù)庫(kù)的批量虛擬數(shù)據(jù)插入
- 創(chuàng)建 Seeder (如果你處于 tinker, 【ctrl】+【c】 先退出)
php artisan make:seeder UserTableSeeder
,針對(duì)博客表和評(píng)論表的Seeder創(chuàng)建命令自己寫。 - 打開 /database/seeds/ 我們創(chuàng)建的Seeder都在這里了,不過(guò)多了一個(gè) DatabaseSeeder.php,我們等下再來(lái)了解它,先編輯其他Seeder,以 UserTableSeeder.php 為例
... use AppUser; // 在 class 關(guān)鍵字前面,引用一下 User 模型 class ... public function run() { factory(AppUser::class, 50)->create(); //向users表中插入50條模擬數(shù)據(jù) $user = User::find(1); //插入完后,找到 id 為 1 的用戶 $user->name = "najiuyuanzou"; //設(shè)置 用戶名 $user->email = "najiuyuanzou@test.com"; //設(shè)置 郵箱 $user->password = bcrypt('liuhaoyu'); //設(shè)置 密碼 $user->save(); //保存 }
在這里我們明確1號(hào)用戶為真實(shí)的可用的管理員用戶!所以我們?cè)O(shè)置一下它的 用戶名 郵箱 以及密碼
-
其余的Seeder我們可以只插入模擬的數(shù)據(jù)即可。
-
現(xiàn)在回過(guò)頭來(lái),編輯 DatabaseSeeder
public function run() { // $this->call(UsersTableSeeder::class); // 這里給我們舉例了如何引用其他Seeder $this->call(UserTableSeeder::class); $this->call(BlogTableSeeder::class); $this->call(CommentTableSeeder::class);// 這里有先后關(guān)系需要注意一下: 評(píng)論n : 1文章/用戶,所以應(yīng)該把它寫在最后 }
- 使用命令,刷新整個(gè)數(shù)據(jù)庫(kù)并且執(zhí)行模擬數(shù)據(jù)插入
php artisan migrate:refresh --seed
=> 查看數(shù)據(jù)庫(kù),發(fā)現(xiàn)數(shù)據(jù)庫(kù)重置了,并且 users blogs comments 每張表都有很多虛擬的數(shù)據(jù)。
第一階段總結(jié)
- 學(xué)習(xí)使用 migrations 的創(chuàng)建、編輯、執(zhí)行以及回滾: 實(shí)現(xiàn)對(duì)數(shù)據(jù)表的結(jié)構(gòu)更改以及數(shù)據(jù)庫(kù)版本管理(說(shuō)白了就是個(gè)帶日志的數(shù)據(jù)表結(jié)構(gòu)管理工具)
- 學(xué)習(xí)使用 factories 的創(chuàng)建、使用 tinker 調(diào)試、使用 factory() 全局函數(shù)制造和插入數(shù)據(jù)。
- 學(xué)習(xí)使用 seeds 的創(chuàng)建(Seeder)、編輯其他Seeder(在 run() 中調(diào)用 factory() )、編輯DatabaseSeed(在 run() 中調(diào)用 其他 Seeder)。
- 最后通過(guò)它們3個(gè)的配合,使用命令刷新了整個(gè)數(shù)據(jù)庫(kù)并且分別向3張表插入了很多模擬的數(shù)據(jù),便于我們開發(fā)。
也許你到這里會(huì)覺得這還不如你寫sql語(yǔ)句。但是請(qǐng)相信我,等你熟練掌握使用這些東西之后,你的開發(fā)速度會(huì)非常快?。ó吘鼓悴恍枰?"INSERT INTO table values ()" 復(fù)制粘貼修改100遍了)
第二階段: Auth的使用
- 輸入神奇的命令,看看發(fā)生了什么
php artisan make:auth
- 打開瀏覽器輸入你配置的虛擬主機(jī)地址,你會(huì)看到一個(gè)Laravel框架的歡迎頁(yè)面,這不是重點(diǎn),點(diǎn)擊右上角的 register ,你可以注冊(cè)賬號(hào),點(diǎn)擊 login 你可以登陸…
- 本階段結(jié)束。
第二階段繼續(xù): Auth
-
好吧你可能很懵逼,但這就是Laravel的厲害之處,那個(gè)2014年就建好的migration遷移文件可不是個(gè)擺設(shè)。它就是通過(guò)操作users表來(lái)實(shí)現(xiàn)注冊(cè)登陸等等的。
-
php artisan make:auth
到底干了哪些事情呢?- 它給你創(chuàng)造了一組控制器,位于 /app/Http/Controllers/Auth
- 它在 /routes/web.php 中給你定義了2條路由
Auth::routes(); //這是用戶操作相關(guān)的路由 Route::get('/home', 'HomeController@index')->name('home'); //這是主頁(yè)的路由
- 它給你創(chuàng)造了一組視圖 /resources/views/auth/ 下是用戶操作相關(guān)的路由, home.blade.php是主頁(yè), layouts/下是布局模板。
-
我們改良一下它自動(dòng)為我們生成的東西
- 路由方面 (routes/web.php) 我們將根路由也指向視圖 home.blade.php ,這是最后的有效代碼:
// Route::action('uri', 'Controller@function'); Route::get('/', 'HomeController@index'); Auth::routes(); Route::get('/home', 'HomeController@index')->name('home');
- 控制器方面 app/Http/Controllers/ 我們修改一下 HomeController.php
/** * 這里這個(gè)構(gòu)造函數(shù)調(diào)用了 中間件auth 對(duì)我們進(jìn)行權(quán)限認(rèn)證 * 即要求我們必須登陸才可以訪問(wèn)該控制器的其他方法 * 有兩種解決方法,一直是在 $this->middleware('auth')->except('你要排除權(quán)限認(rèn)證的方法'),比如 ...->except('index') * 另一種是直接干掉這個(gè)函數(shù)(我們確定這個(gè)控制器就只是來(lái)展示首頁(yè)的,那么就干掉它吧) */ // public function __construct() // { // $this->middleware('auth'); // }
- 視圖方面:HomeController@index (這里我指的是 Home控制器的 index() 方法)調(diào)用了
return view('視圖名稱')
來(lái)抓取視圖顯示在頁(yè)面上,現(xiàn)在打開瀏覽器訪問(wèn)主頁(yè),你就可以看得到 home.blade.php 中的內(nèi)容了,我們看看 /resources/views/home.blade.php 的內(nèi)容: 重點(diǎn): @extens @section
{{-- 內(nèi)容不重要我們等下要改,先來(lái)看下 @符號(hào) 的作用 --}} {{-- @extends繼承其他模板 --}} @extends('layouts.app') {{-- 這里的layouts.app => /resources/views/layouts/app.blade.php --}} {{-- @section 填充在布局模板上用 @yield 標(biāo)注的占位符 --}} @section('content') {{-- 你可以在 /resources/views/layouts/app.blade.php 看到 @ yield('content')標(biāo)注的占位符 --}} ... 這里面是html內(nèi)容 @endsection
Auth為我們生成的整個(gè)視圖模板的邏輯: layouts/app.blade.php 為布局模板,其他模板都繼承該模板。
- 最后我們“漢化”這些視圖
- home.blade.php,你可以自由發(fā)揮,展示一個(gè)好看的主頁(yè),這是我的
@extends('layouts.app') @section('content')<div class="container"> <div class="row justify-content-center"> <div class="col-md-8"> <div class="card"> <div class="card-header">歡迎!這里是 “那就遠(yuǎn)走” 的個(gè)人博客</div> <div class="card-body"> 如無(wú)牽掛,那就遠(yuǎn)走。 {{-- 這里等下要添加一個(gè)跳轉(zhuǎn)到展示文章列表頁(yè)面的按鈕 --}} </div> </div> </div> </div> </div> @endsection
- ../layouts/app.blade.php & ../auth/login.blade.php & register.blade.php
# 首先布局模板我們需要把 brand 登陸、注冊(cè)這些東西改一改 {{ config('app.name', 'Laravel') }} => 我的博客 //注意這里有一個(gè) config('app.name') 該函數(shù)其實(shí)是讀取的 /.env 里的 APP_NAME 值,且默認(rèn)值為 'Laravel' ,也就是說(shuō),你改 APP_NAME 也可以改這里顯示的值,不過(guò)我嫌麻煩,直接查找替換了。 {{ __('Login') }} => 登陸 {{ __('Register') }} => 注冊(cè) {{ __('Logout') }} => 退出 # 然后登陸模板: {{ __('Login') }} => 登陸 {{ __('E-Mail Address') }} => 郵箱 {{ __('Password') }} => 密碼 {{ __('Remember Me') }} => 記住我 然后我們把 ForgetPassword 那個(gè)按鈕給干掉吧(這個(gè)找回密碼的功能需要一個(gè)SMTP服務(wù)的郵箱才能實(shí)現(xiàn),現(xiàn)在暫時(shí)不弄) # 然后注冊(cè)模板 {{ __('Register') }} => 注冊(cè) {{ __('Name') }} => 昵稱(用戶名) {{ __('Confirm Password') }} => 密碼確認(rèn) # 有可能有說(shuō)漏的,反正自己看著頁(yè)面上的英文查找替換成中文就可以了。
第二階段總結(jié)
- 我們使用一條命令就實(shí)現(xiàn)了用戶操作的相關(guān)功能。
- 但是這條命令生成的視圖是英文的,所以需要我們改成中文。
- 這條命令主要是 生成了一組用戶操作的控制器+主頁(yè)控制器(其實(shí)還有中間件),生成了2條路由,生成了一組視圖。
第三階段_1: 路由、模型、視圖、控制器詳解。
- 如果你完全熟悉MVC架構(gòu),可以跳過(guò)這一步。
- 這里用大白話解釋:
- 路由: /routes/web.php 瀏覽器中輸入的地址,比如定義
Route::get('home', 'HomeController@home')
=> 即表示,你輸入 "http://localhost/blog/public/home" 是以GET的請(qǐng)求方式去請(qǐng)求 HomeController 的 home() 方法。 - 模型: /app/ 一個(gè)模型對(duì)應(yīng)數(shù)據(jù)庫(kù)中的一張數(shù)據(jù)表。(注意大小寫和單復(fù)數(shù),模型:Model => 數(shù)據(jù)表:models)
- 視圖: /resources/views/ 視圖就是普通的html模板,它等待控制器通過(guò)
return view()
調(diào)用和渲染它,最終展示給網(wǎng)站訪客。 - 控制器: /app/Http/Controllers/ 處理數(shù)據(jù)、調(diào)用模型、簡(jiǎn)單地操作數(shù)據(jù)庫(kù)、渲染視圖…,都由它完成。
- 總結(jié) => 路由定義在瀏覽器中訪問(wèn)某控制器中某方法的地址,控制器完成一系列操作:如果需要操作數(shù)據(jù)庫(kù),需要調(diào)用模型,每一個(gè)模型對(duì)應(yīng)一張表。如果需要顯示數(shù)據(jù),則需要找到框架內(nèi)指定位置的視圖,對(duì)它完成渲染。
- 路由: /routes/web.php 瀏覽器中輸入的地址,比如定義
第三階段_2:資源路由、在資源控制器中完成對(duì)博客的增刪改查。
我們寫的程序,除了前臺(tái)好看的界面,就是后臺(tái)的程序,而后臺(tái)的程序無(wú)非就是“增刪改查”以及“花式增刪改查”罷了。
因此,仔細(xì)想想,對(duì)于一張數(shù)據(jù)表的操作,我們通常就需要這些行為:1、一個(gè)分頁(yè)展示所有數(shù)據(jù)的列表 2、一個(gè)添加數(shù)據(jù)的功能 3、一個(gè)編輯數(shù)據(jù)的功能 4、一個(gè)顯示單條數(shù)據(jù)詳細(xì)信息的功能 5、一個(gè)刪除功能。
-
創(chuàng)建一個(gè)資源控制器,一次性幫我們生成能實(shí)現(xiàn)上面5個(gè)功能的方法
php artisan make:controller BlogController --resource --model=Blog
( –resouce生成的控制器為資源控制器即自帶 CURD增刪改查 所有方法的控制器 ) ( –model 是讓生成的控制器在參數(shù)列表中自動(dòng)幫我們完成依賴注入生成實(shí)際變量 ) -
根據(jù) 三_1 階段的說(shuō)法,我們其實(shí)需要設(shè)置很多路由,來(lái)對(duì)應(yīng)生成的 BlogController 下的各種方法,Laravel已經(jīng)幫我們想到了所以它給我們提供了這樣一種方法配置路由,編輯 /routes/web.php ,在最后面添加這么一句
Route::resource('blog', 'BlogController');
-
有一個(gè)命令可以看到當(dāng)前所有生效的路由
php artisan route:list
,控制臺(tái)自動(dòng)彈出的表格中,Method 表示 請(qǐng)求方法,即Route::這里的方法()
,URI 表示 請(qǐng)求地址,即Route::action('這里就是uri')
, name 表示 路由別名,可以通過(guò)Route::action('uri', 'Controller@function')->name('這里可以定義路由別名')
。 -
你會(huì)發(fā)現(xiàn),有7條關(guān)于 blog 的路由,這就是
Route::resource('blog', 'BlogController')
幫我們生成的。(5個(gè)功能7條是因?yàn)?添加和編輯多了2條載入視圖的路由) -
完成增刪改查吧: 首先完成 BlogController@index : 展示列表
- 先來(lái)個(gè)入口鏈接,打開 home.blade.php
{{-- 上面說(shuō)過(guò)這里會(huì)添加一個(gè)按鈕 --}} <a href="{{ route('blog.index') }}" class="btn btn-lg btn-block btn-primary">點(diǎn)擊這里查看我的博客</a>
- 編輯 BlogController@index => 這里還是再提醒一下吧,這是說(shuō) BlogController 的 index() 方法??刂破魑募荚?appHttpControllers 中
<?php namespace AppHttpControllers; use AppBlog; //這里是使用命令創(chuàng)建控制器時(shí),通過(guò) --model=Blog 自動(dòng)幫我們生成的 use IlluminateHttpRequest; class BlogController extends Controller{ public function index() { // 查詢數(shù)據(jù),并且讓查詢結(jié)果是一個(gè)可分頁(yè)對(duì)象 $blogs = Blog::orderBy('created_at', 'desc') // 調(diào)用 Blog模型 的靜態(tài)方法 orderBy('根據(jù)created_at字段', '倒敘排序') ->paginate(6); // -> 鏈?zhǔn)讲僮鳎簆aginate(6) 即數(shù)據(jù)沒頁(yè)6條 // 跳轉(zhuǎn)到視圖并傳值 return view('blog.index', [ //第一個(gè)參數(shù)是說(shuō),視圖模板是 /resources/views/blog/index.blade.php 'blogs' => $blogs, //這里是說(shuō),我們給視圖傳遞一個(gè)叫 $'blogs'的變量,值是前面我們查詢的數(shù)據(jù),也叫$blogs。 ]); // view() 的第二參數(shù)也可以使用 view(..., compact('blogs')) }
- 此時(shí)刷新頁(yè)面當(dāng)然會(huì)報(bào)錯(cuò)了,因?yàn)槲覀兊囊晥D還不存在,新建文件夾 /resources/views/blog/index.blade.php
@extends('layouts.app') @section('content') <div class="container"> <div class="row justify-content-center"> <div class="card"> <div class="card-header">這是頁(yè)面小標(biāo)題</div> <div class="card-body"> 這里是內(nèi)容 </div> </div> </div> </div> @endsection
這就是我們所有頁(yè)面的布局,可以復(fù)制一份,作為模板。
- 完成視圖里面的內(nèi)容
<div class="container"> <div class="row justify-content-center"> <div class="card"> <div class="card-header">文章列表</div> <div class="card-body"> <table class="table table-hover table-bordered"> <thead class="bg-info"> <tr> <th>文章標(biāo)題</th> <th>發(fā)布時(shí)間</th> <th>相關(guān)操作</th> </tr> </thead> <tbody> {{-- 這里通過(guò) @foreach 遍歷數(shù)據(jù) --}} @foreach ($blogs as $blog) <tr> <td>{{ $blog->title }}</td> <td>{{ $blog->created_at }}</td> <td></td> </tr> @endforeach </tbody> <tfoot> {{-- 這里通過(guò) $blogs->links() 來(lái)顯示分頁(yè)按鈕 --}} {{ $blogs->links() }} </tfoot> </table> </div> </div> </div> </div>
- 完成文章添加 添加入口鏈接, ../layouts/app.blade.php
{{-- route('路由別名') 在視圖上就是一個(gè)指向 BlogController@create 的鏈接 --}} <a href="{{ route('blog.create') }}" class="dropdown-item"> 添加文章 </a>
- 完成文章的添加 BlogController@create
public function create(){ return view('blog.create'); //載入視圖 }
- 編輯視圖 重點(diǎn):表單中添加@csrf告訴框架,這是我們自己的表單,不用擔(dān)心csrf跨站請(qǐng)求偽造的攻擊
@extends('layouts.app') @section('content') <div class="container"> <div class="row justify-content-center"> <div class="card"> <div class="card-header">添加文章</div> <div class="card-body"> {{-- from.method="POST" action="通過(guò) route()函數(shù)讀取路由別名 " --}} <form method="POST" action="{{ route('blog.store') }}"> {{-- 聲明 csrf 令牌 --}} @csrf <div class="form-group"> <label for="title">文章標(biāo)題</label> <input type="text" class="form-control" id="title" placeholder="請(qǐng)輸入文章標(biāo)題" name="title"> </div> <div class="form-group"> <label for="content">文章內(nèi)容</label> <textarea id="content" cols="30" rows="10" class="form-control" name="content"></textarea> </div> <button class="btn btn-primary" type="submit">發(fā)布新文章</button> </form> </div> </div> </div> </div> @endsection
所謂跨站請(qǐng)求偽造,可以理解為來(lái)自于其他ip的表單,惡意請(qǐng)求我們的服務(wù)器。Laravel提供了一種防范這種攻擊的手段,即將自己的路由隱藏起來(lái),只有帶有 @csrf 聲明的表單可以找得到接收表單信息的路由
- 編輯 BlogController@store
public function store(Request $request) //這里的 $request 是通過(guò)依賴注入的方法實(shí)例化的 Request 類的對(duì)象,包含的有所有請(qǐng)求的信息 { // 我們只需要調(diào)用 Blog模型 的靜態(tài)方法 create() 插入 $request->post() 數(shù)據(jù)即可 $blog = Blog::create($request->post()); //改方法的返回值是新插入的數(shù)據(jù)生成的對(duì)象 // redirect() 頁(yè)面重定向 return redirect()->route('blog.show', $blog); // 這里我們將 $blog 作為參數(shù)請(qǐng)求 BlogController@show }
- 回到頁(yè)面,點(diǎn)擊提交,會(huì)發(fā)現(xiàn)報(bào)錯(cuò)了,Laravel是一個(gè)極其注重安全的框架,用戶能修改哪些字段,必須要在模型文件中聲明,因此打開 appBlog.php 模型文件
// 可填字段白名單 protected $fillable = [ 'title', 'content' ];
-
再次提交,頁(yè)面一片空白,是因?yàn)槲覀兊?BlogController@show 方法還沒有寫,不過(guò)你可以注意到地址欄已經(jīng)發(fā)生了改變。
-
完成 show 方法
public function show(Blog $blog) //這里已經(jīng)通過(guò)依賴注入的形式幫我們實(shí)例化了 $blog { return view('blog.show', [ 'blog' => $blog, //直接將$blog傳給視圖進(jìn)行渲染 ]); }
- 新建 ../blog/show.blade.php
@extends('layouts.app') @section('content') <div class="container"> <div class="row justify-content-center"> <div class="card"> <div class="card-header">文章詳情</div> <div class="card-body"> <h1 class="text-center">{{ $blog->title }}</h1> <p>發(fā)布時(shí)間<small>{{ $blog->created_at }}</small></p> <hr> <p> {{ $blog->content }} </p> </div> </div> </div> </div> @endsection
-
刷新頁(yè)面,文章就顯示出來(lái)了。
-
完成我們的編輯入口鏈接: 在 ../blog/index.blade.php & show.blade.php 中合理的位置添加一個(gè)編輯按鈕
<a href="{{ route('blog.edit', $blog->id) }}" class="btn btn-info">編輯文章</a>
- 完成 BlogController@edit
public function edit(Blog $blog){ return view('blog.edit', [ 'blog' => $blog, ]); }
- 完成視圖 重點(diǎn):action聲明文章編號(hào),根據(jù)路由要求action在表單中使用@method偽造請(qǐng)求動(dòng)作類型
@extends('layouts.app') @section('content') <div class="container"> <div class="row justify-content-center"> <div class="card"> <div class="card-header">編輯文章</div> <div class="card-body"> {{-- action需要聲明當(dāng)前編輯的文章編號(hào)$blog->id --}} <form method="POST" action="{{ route('blog.update', $blog->id) }}"> {{-- 聲明 csrf 令牌 --}} @csrf {{-- 偽造 PATCH 方法 --}} @method("PATCH") <div class="form-group"> <label for="title">文章標(biāo)題</label> <input type="text" class="form-control" id="title" placeholder="請(qǐng)輸入文章標(biāo)題" name="title" value="{{ $blog->title }}"> </div> <div class="form-group"> <label for="content">文章內(nèi)容</label> <textarea id="content" cols="30" rows="10" class="form-control" name="content">{{ $blog->content }}</textarea> </div> <p>發(fā)表于<small>{{ $blog->created_at }}</small></p> <p>修改于<small>{{ $blog->updated_at }}</small></p> <button class="btn btn-primary" type="submit">確認(rèn)編輯</button> </form> </div> </div> </div> </div> @endsection
- 完成 BlogController@update
public function update(Request $request, Blog $blog){ $blog->update($request->post()); //調(diào)用 $blog對(duì)象->update(更新數(shù)據(jù)組成的數(shù)組) 更新 return redirect()->route('blog.show', $blog); }
- 完成刪除功能 在 index.blade.php 和 show.blade.php 合理的位置插入刪除按鈕
<a href="javascript:deleteConfirm({{ $blog->id }});" class="btn btn-danger btn-sm">刪除文章</a> {{-- 因?yàn)閯h除也需要 csrf 令牌認(rèn)證,所以弄個(gè)表單 --}} <form method="POST" action="{{ route('blog.destroy', $blog->id) }}" id="delete-blog-{{ $blog->id }}"> @csrf {{-- 這里偽造DELETE請(qǐng)求 --}} @method("DELETE") </form>
- “刪除文章” 按鈕其實(shí)是調(diào)用了一個(gè) js 函數(shù),我們?cè)?../layousts/app.blade.php 中完成
<script> function deleteConfirm(id) { var confirm = window.confirm('確認(rèn)要?jiǎng)h除這篇文章嗎?'); if(confirm === true) { $("#delete-blog-" + id).submit(); //提交表單 }else { window.alert('你選擇不刪除!'); } } </script>
- 完成 BlogController@delete 方法
public function destroy(Blog $blog){ $blog->delete(); return redirect()->route('blog.index'); //跳轉(zhuǎn)到首頁(yè) }
- 增刪改查完成。
-
完善和優(yōu)化
-
首先無(wú)論增刪改查操作,成功后我們沒有任何提示,我們使用 session 閃存方法消息吧:
- 新建組件視圖文件夾 /resources/views/components/
- 然后新建一個(gè)組件視圖 _message.blade.php => 組件視圖我們都用
_
下劃線開頭
<div class="container"> {{-- 遍歷 success danger 這兩個(gè)我們等會(huì)會(huì)在 session->flash() 方法中設(shè)置的"key" --}} @foreach (['success', 'danger'] as $msg) {{-- 當(dāng)key存在的時(shí)候,證明我們給 session flash 閃存里面裝載了一次提示信息,那么就顯示提示信息 --}} @if (session()->has($msg)) <div class="alert alert-{{ $msg }}"> <ul> <li>{{ session()->get($msg) }}</li> </ul> </div> @endif @endforeach </div>
- 在 ../layousts/app.blade.php 中導(dǎo)入該組件 重點(diǎn):@include 導(dǎo)入html片段
{{-- 在導(dǎo)航下面,內(nèi)容上面導(dǎo)入 --}}@include('components._message')
- 編輯 BlogController 里的各種方法,在執(zhí)行成功某些方法時(shí),頁(yè)面重定向前,裝載閃存。以刪除舉例
$blog->delete(); session()->flash('success', '刪除文章成功!'); //裝載session閃存 return redirect()->route('blog.index');
-
然后有個(gè)問(wèn)題,就是在于,我們這是一個(gè)個(gè)人博客,所以只有我們自己可以對(duì)博客文章進(jìn)行增刪改,而用戶只可以進(jìn)行查看。因此我們需要:
- 使用構(gòu)造函數(shù)調(diào)用 auth中間件 來(lái)排除沒有登陸的用戶查看文章詳情: 編輯 BlogController
public function __construct(){ $this->middleware('auth')->except('index'); }
- 在 新增create、編輯edit、和刪除方法中加入一次用戶認(rèn)證,以 create 方法舉例
// 因?yàn)楸容^簡(jiǎn)單,所以我們不用Policy進(jìn)行認(rèn)證,我會(huì)在以后的教程里面教大家如何使用Policy策略進(jìn)行權(quán)限認(rèn)證 // 這里我們就使用判斷當(dāng)前用戶在數(shù)據(jù)表中信息的主鍵id是不是1即可(因?yàn)槲覀冊(cè)赟eeder里面把編號(hào)為1的用戶設(shè)置為了可用的管理員賬號(hào)) // 1、在代碼開頭引用 Auth // 2、在方法內(nèi)先判斷一下是不是 1號(hào)用戶 if(Auth::user()->id != 1) { // Auth::user() 獲取當(dāng)前用戶信息 -> id獲取屬性id(主鍵) session()->flash('danger', '抱歉,只有博主才可以新增文章!'); return redirect()->back(); }
-
-
針對(duì)博客的增刪改查在這里就結(jié)束了。
第三階段總結(jié)
- 我們使用命令創(chuàng)建了一個(gè) “資源控制器”
- 我們?cè)?/routes/web.php 定義了一條資源路由
- 我們使用 BlogController 中的7個(gè)方法完成了對(duì) 博客文章 的 CURD(增刪改查)操作。
- 我們優(yōu)化了一下體驗(yàn),使用
session()->flash()
裝載閃存信息,用一個(gè)組件html片段加載信息,最后用@include()
在模板上加載這個(gè)html組件。 - 我們最后增加了一個(gè)簡(jiǎn)單的權(quán)限認(rèn)證,判斷進(jìn)行增刪改的用戶是不是管理員,不是管理員則不允許操作,直接裝載一條錯(cuò)誤提示閃存,然后返回。
第四階段 評(píng)論功能
- 新建一個(gè)評(píng)論資源控制器
php artisan make:controller CommentController --model=Commment
- 新增一條資源路由,但只支持發(fā)表 /routes/web.php
Route::resource('comment', 'CommentController', ['only' => 'store']);
其實(shí)我們可以定義一條
Route::post('comment', 'CommentController@store')
路由,但是為什么要寫資源路由呢?因?yàn)槲乙嬖V你資源路由可以用['onlu'=>'操作']
讓其只支持一種操作:)
- 在文章詳情頁(yè)面下方增加一個(gè)表單 show.blade.php
<form method="POST" action="{{ route('comment.store') }}"> @csrf <input type="hidden" name="user_id" value="{{ Auth::user()->id }}"> <input type="hidden" name="blog_id" value="{{ $blog->id }}"> <div class="form-group"> <label for="content"></label> <textarea id="content" class="form-control" cols="30" rows="10" name="content">您對(duì)這篇文章有什么看法呢?</textarea> </div> <button class="btn btn-primary" type="submit">發(fā)表評(píng)論</button> </form>
- 編輯 CommentController@store
public function store(Request $request){ Comment::create($request->post()); session()->flash('success', '評(píng)論成功!'); return redirect()->back(); }
- 提交評(píng)論出錯(cuò)了,又忘了寫可填字段白名單,編輯模型 appComment
protected $fillable = [ 'content', 'user_id', 'blog_id' ];
- 展示評(píng)論
- 首先我們需要確定 Blog 和 Comment 的關(guān)系 => Blog 1:n Comment “一篇博客有多個(gè)評(píng)論”
- 我們來(lái)綁定他們的關(guān)系
- appBlog.php
// 綁定1:n關(guān)系 public function comments() { return $this->hasMany('AppComment'); // 1 hasMany n }
- appComment.php
public function blog() { return $this->belongsTo('AppBlog'); // n belongsTo 1 }
- 然后通過(guò)他們的關(guān)系,我們可以在 BlogController@show 方法中調(diào)用
$blog->comments
來(lái)獲取屬于這篇文章的評(píng)論
// 查詢?cè)u(píng)論 $comments = $blog->comments; // 視圖渲染 return view('blog.show', [ 'blog' => $blog, 'comments' => $comments, //把評(píng)論也傳過(guò)去 ]);
- 在視圖層遍歷評(píng)論 show.blade.php
<h3>評(píng)論</h3> <ul> @foreach ($comments as $comment) <li><small>{{ $comment->userName() }} 評(píng)論說(shuō):</small>“ {{ $comment->content }} ”</li> @endforeach</ul>
- 注意我們調(diào)用了 $comment->userName() 方法,現(xiàn)在沒有,所以我們?cè)?appComment.php 模型中完成
use AppUser; //引用模型 // 根據(jù) user_id 獲取用戶名 public function userName() { return User::find($this->user_id)->name; //這里通過(guò)當(dāng)前對(duì)象的 user_id 獲取 user對(duì)象, 然后指向->name屬性 }
- 評(píng)論驗(yàn)證
在博客中,我們就沒有使用驗(yàn)證,那是因?yàn)轫?xiàng)目定位是一個(gè)個(gè)人博客,能夠操縱博客增刪改的只有我們自己。而評(píng)論則是只要有人注冊(cè)賬號(hào),就可以評(píng)論了,所以我們應(yīng)該對(duì)評(píng)論進(jìn)行一些校驗(yàn)以防惡意攻擊。
-
新建一個(gè)請(qǐng)求Request
php artisan make:request CommentRequest
-
新建的請(qǐng)求位于 appHttpRequests 下,編輯 CommentRequest
// 1、 開啟授權(quán) public function authorize(){ return true; //如果返回false則所有請(qǐng)求都無(wú)法生效,會(huì)告訴你沒有授權(quán)(其實(shí)在這里面我們是需要去進(jìn)行判斷的,但是這里的邏輯很簡(jiǎn)單:只有登陸才能查看文章詳情,才能看到文章詳情下面發(fā)表評(píng)論的表單,才能發(fā)表評(píng)論。)所以我們這里直接 return true;}// 2、 編輯規(guī)則public function rules(){ return [ 'content' => 'required|min:15|max:100', //這里你可以定義規(guī)則我的是:必填、最少15字、最多100字 ]; }
- 在 CommentController@store 方法的參數(shù)列表中通過(guò) CommentRequest 構(gòu)造 $request, 自動(dòng)完成校驗(yàn)
public function store(CommentRequest $request) // 這將 Request 改成 CommentRequest 就會(huì)自動(dòng)調(diào)用 CommentRequest@rules 來(lái)校驗(yàn)請(qǐng)求的數(shù)據(jù)了 { Comment::create($request->post()); session()->flash('success', '評(píng)論成功!'); return redirect()->back(); }
- 優(yōu)化視圖 show.blade.php
{{-- 樣式里面加一個(gè)判斷,判斷是否有關(guān)于content的錯(cuò)誤有的話給樣式給文本域加一個(gè)紅邊邊 --}} <textarea id="content" class="form-control {{ $errors->has('content') ? ' is-invalid' : '' }}" cols="30" rows="10" name="content">你對(duì)文章有什么看法呢?</textarea> {{-- 如果有錯(cuò)誤,再顯示一個(gè)小的錯(cuò)誤提示信息 --}} @if ($errors->has('content')) <span class="invalid-feedback"> <strong>{{ $errors->first('content') }}</strong> </span> @endif
- 此時(shí)提交表單,左下角會(huì)提醒你 “內(nèi)容不能為空”,如果你想改“內(nèi)容兩個(gè)字”,可以打開 /resources/lang/zh-CN/validation.php
'content' => '內(nèi)容', //這里就是配置字段的中文名,你把它改成評(píng)論即可。
- 有時(shí)候文章過(guò)長(zhǎng),導(dǎo)致提交了,往下拉才看得到文本域變紅,所以我們需要新建一個(gè)錯(cuò)誤組件../components/_error.blade.php
{{-- 判斷是否有錯(cuò)誤 --}} @if (count($errors) > 0) <div class="alert alert-danger"> {{-- 遍歷所有錯(cuò)誤 --}} @foreach ($errors->all() as $error) <ul> {{-- 打印錯(cuò)誤 --}} <li> {{ $error }}</li> </ul> @endforeach </div>
-
@endif
- 然后在 show.blade.php 中引用
@include('components._error')
- 然后在 show.blade.php 中引用
第四階段總結(jié)
- 我們依然創(chuàng)建資源控制器,但是在路由中使用
['only'=>'store']
讓資源路由只暴露指向 CommentController@store 的路由 - 我們學(xué)會(huì)了通過(guò)
hasMany() & belongsTo()
綁定模型之間的1:n關(guān)系。然后通過(guò)文章->評(píng)論+s;
的方法直接獲取了屬于某篇文章的所有評(píng)論。 - 我們學(xué)會(huì)了創(chuàng)建請(qǐng)求Request,并且在它的內(nèi)部配置驗(yàn)證規(guī)則,在控制器層中通過(guò)依賴注入的形式驗(yàn)證數(shù)據(jù)。
- 一旦表單提交的數(shù)據(jù)不符合 Request@rules Laravel會(huì)自動(dòng)幫我們生成一個(gè)叫 $errors 的數(shù)組,它存放著所有的錯(cuò)誤信息, 我們?cè)谝晥D上通過(guò)判斷它是否有
content
字段來(lái)判斷是否是表單提交的評(píng)論有問(wèn)題,然后修改文本域的樣式并且在下方用一個(gè)小的提示span顯示錯(cuò)誤提示信息 - 錯(cuò)誤提示信息顯示的是“內(nèi)容 怎么怎么樣…”,我們想把“內(nèi)容”改成評(píng)論只需要修改中文語(yǔ)言包下的validation.php中的'content'字段的別名即可。
第五階段 最后總結(jié)
- 想讓項(xiàng)目上線,也許你需要
- 更好看的html排版
- 重新執(zhí)行一次
php artisan migrate:rollback
- 權(quán)限認(rèn)證太水了。你需要學(xué)習(xí)使用 Policy 來(lái)進(jìn)行更安全和全面的權(quán)限認(rèn)證。
也許文字很多,但是真正的代碼可能只有不到100行,你如果熟練掌握,可能不需要30分鐘,甚至10分鐘,你就可以開發(fā)出這樣一個(gè)博客了。
- 視圖方面
- 我們有通過(guò) auth 生成的模板
- Laravel 自帶的 bootstrap4 + jquery
- 所以我們解決了css和js的問(wèn)題 => 我們只是寫了一個(gè) “確認(rèn)刪除” 的前端代碼
- 數(shù)據(jù)庫(kù)方面
- 我們有 /database/ 下提供的 3套解決方案 Migration / Factory / Seeder 來(lái)幫我們解決數(shù)據(jù)庫(kù)管理的問(wèn)題
- 因?yàn)樯厦娴慕鉀Q方案,我們甚至只寫了 建用戶、建表、授權(quán)3條 數(shù)據(jù)庫(kù)操作語(yǔ)句。
- 路由方面
- Auth 自動(dòng)幫我們生成了用戶操作相關(guān)路由
- 我們使用資源路由來(lái)映射一個(gè) CURD 控制器
- 控制器和模型方面,通過(guò)命令生成的所有類文件,都幾乎幫我們寫好了,我們只需要完成里面的邏輯。
- 當(dāng)然,我們還有 Request 請(qǐng)求認(rèn)證 Policy 策略控制等等一些列的特性沒有學(xué)習(xí),我們也只使用了一次composer,其實(shí)在開發(fā)Laravel時(shí),我們還可以使用非常多的,支持Laravel的,完善的輪子可以利用。
現(xiàn)在請(qǐng)告訴我,它是否配得上 “優(yōu)雅” 的兩字?:)
希望大家可以喜歡、學(xué)習(xí)和推廣Laravel。如果您愿意付出比學(xué)習(xí)thinkphp5多0.01分的努力,我想這個(gè)框架是非常簡(jiǎn)單的。
如果您依然討厭它的龐大,我向您推薦 Lumen 框架。