Category Archives: PHP

Laravel 视图实例教程 —— 在视图间共享数据及视图Composer

视图的基本使用很简单，可查看视图文档了解详情，这里我们演示两个使用示例：在视图间共享数据和视图Composer。 1、在视图间共享数据除了在单个视图中传递指定数据之外，有时候需要在所有视图中传入同一数据，即我们需要在不同视图中共享数据。要实现这一目的，需要使用视图工厂的share方法。全局帮助函数view和前面一节提到的response类似，如果传入参数，则返回Illuminate\View\View实例，不传入参数则返回Illuminate\View\Factory实例。所以我们可以通过在服务提供者的boot方法中使用如下方式实现视图间共享数据：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider

{

/**

* Bootstrap any application services.

* @return void

public function boot()

{

//视图间共享数据

view()->share('sitename','<a title="View all posts in Laravel" href="http://laravelacademy.org/tags/laravel" target="_blank">Laravel</a>学院');

}

/**

* Register any application services.

* @return void

public function register()

{

}

我们在routes.php中定义两个路由：

Route::get('testViewHello',function(){

return view('hello');

});

Route::get('testViewHome',function(){

return view('home');

});

然后在resources/views目录下创建一个home.blade.php视图文件，内容如下：

1	{{$sitename}}首页

再创建一个hello.blade.php视图文件：

1	欢迎来到{{$sitename}}！

在浏览器中分别访问http://laravel.app:8000/testViewHello和http://laravel.app:8000/testViewHome，则都能解析出$sitename的值。 2、视图Composer 有时候我们想要在每次视图渲染时绑定一些特定数据到视图中，比如登录用户信息，这时候我们就要用到视图Composer，视图Composer通过视图工厂的composer方法实现。该方法的第二个回调参数支持基于控制器动作和闭包函数两种方式。简单起见，我们还是基于AppServiceProvider，不去单独创建服务提供者，这里我们传递闭包参数（控制器动作参考视图文档）：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider

{

/**

* Bootstrap any application services.

* @return void

public function boot()

{

//视图间共享数据

view()->share('sitename','Laravel学院');

//视图Composer

view()->composer('hello',function($view){

$view->with('user',array('name'=>'test','avatar'=>'/path/to/test.jpg'));

});

}

/**

* Register any application services.

* @return void

public function register()

{

}

修改hello.blade.php视图文件：

欢迎来到{{$sitename}}！

用户名:{{$user['name']}}<br>

用户头像:{{$user['avatar']}}

在浏览器中访问http://laravel.app:8000/testViewHello，输出内容如下：

欢迎来到Laravel学院！

用户信息

用户名:test

用户头像:/path/to/test.jpg

你也可以传递数据到多个视图：

view()->composer(['hello','home'],function($view){

$view->with('user',array('name'=>'test','avatar'=>'/path/to/test.jpg'));

});

甚至所有视图（使用通配符*）：

view()->composer('*',function($view){

$view->with('user',array('name'=>'test','avatar'=>'/path/to/test.jpg'));

});

注：更多视图方法请参考Laravel核心源码：Illuminate\View\View.php及Illuminate\View\Factory.php。 from:http://laravelacademy.org/post/697.html

龙生 18 Aug 2017

View Details

HTTP响应实例教程 —— 基本使用、生成Cookie、返回视图、JSON/JSONP、文件下载及重定向

1、Response篇 1.1 基本响应最基本的HTTP响应只需在路由闭包或控制器动作中返回一个简单字符串即可，但是具体业务逻辑中大部分响应都是在控制器动作中返回Response实例或者视图。Response是继承自 Symfony\Component\HttpFoundation\Response的 Illuminate\Http\Response类的一个实例，我们可以使用该实例上的一系列方法来创建HTTP响应：

use Illuminate\Http\Response;

Route::get('testResponse',function(){

$content = 'Hello <a title="View all posts in Laravel" href="http://laravelacademy.org/tags/laravel" target="_blank">Laravel</a>Academy！';

$status = 200;

$value = 'text/html;charset=utf-8';

return (new Response($content,$status))->header('Content-Type',$value);

});

在浏览器中访问，F12查看响应头信息（Chrome浏览器）：如果我们尝试修改$status=500，则头信息如下：为方便使用，我们还可以使用全局帮助函数response来替代生成Response对象实例：

Route::get('testResponse',function(){

$content = 'Hello LaravelAcademy！';

$status = 500;

$value = 'text/html;charset=utf-8';

return response($content,$status)->header('Content-Type',$value);

});

效果一样。以后我们将默认使用这种方式，不再生成Response对象实例。此外，需要注意的是，Illuminate\Http\Response 类中还使用了ResponseTrait，header方法正是该trait提供的，除了header之外，该trait还提供了withCookie、content和status方法。header方法用于设置响应头信息，withCookie方法用于添加cookie，这两个方法都会返回调用它的Response自身对象，所以这两个方法都支持方法链（即多次调用header或withCookie方法）；而content和status方法则用于返回当前响应的响应实体内容和响应状态码。 1.2 添加Cookie 正如上面提到的，我们使用withCookie方法为响应添加cookie，由于header和withCookie支持方法链，所以我们可以这样使用：

Route::get('testResponseCookie',function(){

$content = 'Hello LaravelAcademy！';

$status = 200;

$value = 'text/html;charset=utf-8';

return response($content,$status)->header('Content-Type',$value)

->withCookie('site','LaravelAcademy.org');

});

在浏览器中访问，F12查看Cookie信息：我们还可以使用该cookie的有效期、作用域等信息：

Route::get('testResponseCookie',function(){

$content = 'Hello LaravelAcademy！';

$status = 200;

$value = 'text/html;charset=utf-8';

//设置cookie有效期为30分钟，作用路径为应用根目录，作用域名为laravel.app

return response($content,$status)->header('Content-Type',$value)

->withCookie('site','LaravelAcademy.org',30,'/','laravel.app');

});

注：withCookie方法实际上是调用了全局帮助函数cookie生成cookie，然后将cookie放到响应头中。再次在浏览器中访问，F12查看cookie信息如下：里面多出了有效期及作用域名等相关信息。此外，我们还关注到该cookie是经过加密的，这一点我们在前面已经提到过，这是为了安全性考虑，如果要取消加密，在app/Http/Middleware/EncryptCookies.php文件中将对应的cookie名添加到EncryptCookies类属性$except中即可：

<?php

namespace App\Http\Middleware;

use Illuminate\Cookie\Middleware\EncryptCookies as BaseEncrypter;

class EncryptCookies extends BaseEncrypter

{

/**

* 不被加密的cookie名

* @var array

protected $except = [

'site'

];

}

再次在浏览器中访问http://laravel.app:8000/testResponseCookie，F12查看Cookie信息如下：当然，为了安全起见，我们不建议这么做。 2、ResponseFactory篇 response函数如果不传入参数会返回 Illuminate\Contracts\Routing\ResponseFactory契约的实现——Illuminate\Routing\ResponseFactory，该类中提供了多个方法用来生成更加丰富的响应类型，比如视图响应、JSON响应、文件下载等等。 2.1 视图响应使用view方法即可返回一个视图作为响应内容：

Route::get('testResponseView',function(){

$value = 'text/html;charset=utf-8';

return response()->view('hello',['message'=>'Hello LaravelAcademy'])

->header('Content-Type',$value);

});

与之对应的，我们需要在resources/views下新建一个视图文件hello.blade.php，其内容如下：

1	{{$message}}

接下来我们在浏览器中访问http://laravel.app:8000/testResponseView，页面输出：

1	Hello LaravelAcademy

还可以再简化，如果我们不需要自定义HTTP响应头，还可以直接使用全局帮助函数view：

Route::get('testResponseView',function(){

$value = 'text/html;charset=utf-8';

return view('hello',['message'=>'Hello LaravelAcademy']));

});

效果和上面一样。 2.2 返回JSON/JSONP 还可以使用json方法返回json格式数据：

Route::get('testResponseJson',function(){

return response()->json(['name'=>'LaravelAcademy','passwd'=>'LaravelAcademy.org']);

});

在浏览器中访问，F12查看响应头信息：根据输出信息可见，json方法会自动设置Content-Type为application/json，并调用PHP内置函数json_encode讲数组转化为json格式字符串。如果返回的是JSONP响应，也很简单，只需要在json后面再调用setCallback即可：

Route::get('testResponseJson',function(){

return response()->json(['name'=>'LaravelAcademy','passwd'=>'LaravelAcademy.org'])

->setCallback(request()->input('callback'));

});

2.3 文件下载使用download方法可生成用于下载给定路径文件的响应，这里我们下载上一节上传的文件：

Route::get('testResponseDownload',function(){

return response()->download(

realpath(base_path('public/images')).'/laravel-5-1.jpg',

'Laravel学院.jpg'

);

});

在浏览器中访问http://laravel.app:8000/testResponseDownload，页面将会下载laravel-5-1.jpg文件并保存为Laravel学院.jpg。 3、 RedirectResponse篇重定向响应是 Illuminate\Http\RedirectResponse类的实例，我们通常使用全局帮助函数redirect来生成 RedirectResponse实例。和response类似，redirect函数如果接收参数则调用的是Illuminate\Routing\Redirector类的to方法，如果无参调用则返回的是Redirector对象实例。 3.1 基本重定向

Route::get('dashboard', function () {

return redirect('home/dashboard');

});

如果要重定向到上一个位置，则使用back方法：

Route::post('user/profile', function () {

// 验证请求...

return back()->withInput();

});

3.2 重定向到命名路由使用route方法重定向到命名路由：

Route::get('/hello/laravelacademy',['as'=>'academy',function(){

return 'Hello LaravelAcademy';

}]);

Route::get('testResponseRedirect',function(){

return redirect()->route('academy');

});

在浏览器中访问http://laravel.app:8000/testResponseRedirect，页面会跳转到http://laravel.app:8000/hello/laravelacademy并输出：

1	Hello LaravelAcademy

如果命名路由中有参数，那么我们可以在route中传入参数：

Route::get('/hello/laravelacademy/{id}',['as'=>'academy',function($id){

return 'Hello LaravelAcademy '.$id;

}]);

Route::get('testResponseRedirect',function(){

return redirect()->route('academy',100);

});

在浏览器中访问http://laravel.app:8000/testResponseRedirect，页面会跳转到http://laravel.app:8000/hello/laravelacademy/100并输出：

1	Hello LaravelAcademy 100

3.3 重定向到控制器动作使用action方法重定向到控制器动作：

Route::resource('post','PostController');

Route::get('testResponseRedirect',function(){

return redirect()->action('PostController@index');

});

在浏览器中访问http://laravel.app:8000/testResponseRedirect，则页面会跳转到http://laravel.app:8000/post并输出对应内容。当然也可以传递参数到action方法：

Route::get('testResponseRedirect',function(){

return redirect()->action('PostController@show',[1]);

});

3.4 带一次性Session数据的重定向使用with方法可以携带一次性session数据到重定向请求页面（一次性session数据即使用后立即销毁的session数据项）：

Route::post('user/profile', function () {

// 更新用户属性...

return redirect('dashboard')->with('status', 'Profile updated!');

});

这种特性通常在提交表单验证失败返回错误信息时很有用。 from:http://laravelacademy.org/post/623.html

龙生 18 Aug 2017

View Details

HTTP 请求实例教程 —— 获取请求数据、Cookie及文件上传处理

1、获取Request请求实例 Laravel中一般通过控制器方法依赖注入来获取当前请求的Request实例。我们通过定义一个隐式控制器来进行本章节的测试。首先我们在routes.php定义路由如下：

1 2	Route::controller('request','RequestController'); <span style="color: #ff0000;">注：在laravel5.4中不再支持这种路由写法了。</span>

然后我们在app/Http/Controllers下创建一个控制器RequestController.php：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use Illuminate\Http\Response;

use App\Http\Requests;

use App\Http\Controllers\Controller;

class RequestController extends Controller

{

public function getBasetest(Request $request)

{

$input = $request->input('test');

echo $input;

}

要访问getBasetest方法，我们只需在浏览器中访问http://laravel.app:8000/request/basetest?test=laravelacademy，这样页面会输出：

1	laravelacademy

2、获取请求URL及请求方法 2.1 获取请求URL路径要获取当前请求的URL，我们可以通过Request实例上的path方法，需要注意的是该方法返回相对请求路径，如果要获取绝对请求路径，可以通过Request实例上的另一个方法——url：

public function getUrl(Request $request)

{

//匹配request/*的URL才能继续访问

if(!$request->is('request/*')){

abort(404);

}

$uri = $request->path();

$url = $request->url();

echo $uri;

echo '<br>';

echo $url;

}

我们在浏览器中访问http://laravel.app:8000/request/url，页面输入如下内容：

1 2	request/url http://laravel.app:8000/request/url

2.2 获取请求方法我们还可以通过调用Request实例上的getMethod方法获取当前请求的方法：

public function getMethod(Request $request){

//非get请求不能访问

if(!$request->isMethod('get')){

abort(404);

}

$method = $request->method();

echo $method;

}

3、获取请求数据 3.1 当前请求输入使用Request实例上的input方法即可获取请求输入数据。该方法可以接收两个参数，第一个参数是传递参数名称，第二个参数是如果参数名为空返回的默认值，此外该方法还支持获取数组参数对应值，我们定义测试方法如下：

public function getInputData(Request $request){

//获取GET方式传递的name参数，默认为LaravelAcademy

$name = $request->input('name','LaravelAcademy');

echo $name;

echo '<br>';

echo $request->input('test.0.name');

}

在浏览器中输入http://laravel.app:8000/request/input-data?name=Laravel&test[][name]=Academy，则页面输出：

1 2	Laravel Academy

如果我们想要在获取输入值之前判断输入参数名是否存在，可以使用has方法，比如我们想要判断输入参数是否包含hello，可使用如下方法：

1 2	if($request->has('hello')) echo $request->input('hello');

想要获取所有输入参数值，可以使用Request实例上的all方法；想要获取部分输入值，可使用only方法；想要排除部分输入参数值，可使用except方法：

public function getInputData(Request $request){

$allData = $request->all();

$onlyData = $request->only('name','hello');

$exceptData = $request->except('hello');

echo '<pre>';

print_r($allData);

print_r($onlyData);

print_r($exceptData);

}

在浏览器中访问http://laravel.app:8000/request/input-data?name=Laravel&test[][name]=Academy&hello=World，页面输出如下：

Array

(

[name] => Laravel

[test] => Array

(

[0] => Array

(

[name] => Academy

)

[hello] => World

)

Array

(

[name] => Laravel

[hello] => World

)

Array

(

[name] => Laravel

[test] => Array

(

[0] => Array

(

[name] => Academy

)

3.2 上一次请求输入上面的方法都是用于获取当前请求的输入，如果想要获取上一次请求的输入，需要在处理上一次请求时使用Request实例上的flash方法将请求数据暂时保存到session中，然后在当前请求中使用Request实例上的old方法获取session中保存的数据，获取到数据后就会将session中保存的请求数据销毁：

public function getLastRequest(Request $request){

$request->flash();

}

public function getCurrentRequest(Request $request){

$lastRequestData = $request->old();

echo '<pre>';

print_r($lastRequestData);

}

如果我们想要在上次请求保存数据后重定向到当前请求URL，则可以使用如下方式定义getLastRequest方法：

public function getLastRequest(Request $request){

//$request->flash();

return redirect('/request/current-request')->withInput();

}

这样我们在浏览器中访问http://laravel.app:8000/request/last-request?name=test&passwd=123456，页面会重定向到http://laravel.app:8000/request/current-request并输出如下内容：

Array

(

[name] => test

[passwd] => 123456

)

再次刷新页面，输出为空：

Array

(

)

则表明取出数据后session中的请求数据被清空。更多方法使用参考HTTP请求官方文档。 4、获取Cookie数据我们可以使用Request实例上的cookie方法获取cookie数据，该方法可以接收一个参数名返回对应的cookie值，如果不传入参数，默认返回所有cookie值：

public function getCookie(Request $request){

$cookies = $request->cookie();

dd($cookies);

}

我们在浏览器中访问http://laravel.app:8000/request/cookie，页面输出：

array:2 [

"XSRF-TOKEN" => "<span title="40 characters">fSP1erkCxnxX0wCyrJWJuR3ruH8c09VZXnR64nbC"

"laravel_session" => "<span title="40 characters">820e88a52c45f8dbda55e8c6aaaa9bbca2c760ef"

]</span></span>

我们可以调用Response实例上的withCookie方法新增cookie：

public function getAddCookie(){

$response = new Response();

//第一个参数是cookie名，第二个参数是cookie值，第三个参数是有效期（分钟）

$response->withCookie(cookie('website','LaravelAcademy.org',1));

//如果想要cookie长期有效使用如下方法

//$response->withCookie(cookie()->forever('name', 'value'));

return $response;

}

我们重新定义getCookie方法如下：

public function getCookie(Request $request){

$cookie = $request->cookie('website');

echo $cookie;

}

接下来我们在浏览器中访问http://laravel.app:8000/request/add-cookie，再访问http://laravel.app:8000/request/cookie，页面输出如下：

1	LaravelAcademy.org

5、上传文件我们定义文件上传页面及上传处理如下：

//文件上传表单

public function getFileupload()

{

$postUrl = '/request/fileupload';

$csrf_field = csrf_field();

$html = <<<CREATE

$csrf_field

</form>

CREATE;

return $html;

}

//文件上传处理

public function postFileupload(Request $request){

//判断请求中是否包含name=file的上传文件

if(!$request->hasFile('file')){

exit('上传文件为空！');

}

$file = $request->file('file');

//判断文件上传过程中是否出错

if(!$file->isValid()){

exit('文件上传出错！');

}

$destPath = realpath(public_path('images'));

if(!file_exists($destPath))

mkdir($destPath,0755,true);

$filename = $file->getClientOriginalName();

if(!$file->move($destPath,$filename)){

exit('保存文件失败！');

}

exit('文件上传成功！');

}

通过以上代码可以看到我们可以使用Request实例上的file方法获取上传文件实例，该方法接收的参数是上传文件input标签的name属性，该文件上传实例是 Symfony\Component\HttpFoundation\File\UploadedFile类的实例，更多有关该实例的可用方法，可参考UploadedFile的API文档。 from:http://laravelacademy.org/post/606.html

龙生 17 Aug 2017

View Details

HTTP控制器实例教程 —— 创建RESTFul风格控制器实现文章增删改查

基本控制器及控制器路由、控制器中间件都比较简单，这里不再赘述，相关文档参考HTTP 控制器文档一节。 1、创建RESTFul风格控制器注：关于什么是RESTFul风格及其规范可参考这篇文章：理解RESTful架构。本文我们主要讨论创建一个RESTFul风格的控制器用于对博客文章进行增删改查，创建这样的控制器很简单，在应用根目录运行如下Artisan命令即可：

1	php artisan make:controller PostController

该命令会在app/Http/Controllers目录下生成一个PostController.php文件，该控制器内容如下：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\Http\Requests;

use App\Http\Controllers\Controller;

class PostController extends Controller

{

/**

* 显示文章列表.

* @return Response

public function index()

{

}

/**

* 创建新文章表单页面

* @return Response

public function create()

{

}

/**

* 将新创建的文章存储到存储器

* @param Request $request

* @return Response

public function store(Request $request)

{

}

/**

* 显示指定文章

* @param int $id

* @return Response

public function show($id)

{

}

/**

* 显示编辑指定文章的表单页面

* @param int $id

* @return Response

public function edit($id)

{

}

/**

* 在存储器中更新指定文章

* @param Request $request

* @param int $id

* @return Response

public function update(Request $request, $id)

{

}

/**

* 从存储器中移除指定文章

* @param int $id

* @return Response

public function destroy($id)

{

}

2、为RESTFul风格控制器注册路由接下来我们在routes.php文件中为该控制器注册路由：

1	Route::resource('post','PostController');

该路由包含了指向多个动作的子路由：方法路径动作路由名称 GET /post index post.index GET /post/create create post.create POST /post store post.store GET /post/{post} show post.show GET /post/{post}/edit edit post.edit PUT/PATCH /post/{post} update post.update DELETE /post/{post} destroy post.destroy 比如我们在浏览器中以GET方式访问http://laravel.app:8000/post，则访问的是PostController的index方法，我们可以通过route('post.index')生成对应路由URL。类似的，如果我们以POST方式访问http://laravel.app:8000/post，则访问的是PostController的store方法，对应的POST表单action属性值则可以通过route('post.store')来生成。 3、实例教程——文章增删改查接下来我们演示基本的增删改查操作，关于数据库的操作我们后面再讲，这里我们使用缓存作为存储器（Laravel默认使用文件缓存）。注意：我们这里用到了Cache门面，使用前不要忘了在PostController顶部使用use Cache;引入。关于Cache的用法，可参考缓存文档。 3.1 新增文章首先我们新增一篇文章，定义PostController控制器的create方法和store方法如下（视图部门我们放到后面讲，这里就将HTML放到PHP变量里）：

/**

* 创建新文章表单页面

* @return Response

public function create()

{

$postUrl = route('post.store');

$csrf_field = csrf_field();

$html = <<<CREATE

$csrf_field

</form>

CREATE;

return $html;

}

/**

* 将新创建的文章存储到存储器

* @param Request $request

* @return Response

public function store(Request $request)

{

$title = $request->input('title');

$content = $request->input('content');

$post = ['title'=>trim($title),'content'=>trim($content)];

$posts = Cache::get('posts',[]);

if(!Cache::get('post_id')){

Cache::add('post_id',1,60);

}else{

Cache::increment('post_id',1);

}

$posts[Cache::get('post_id')] = $post;

Cache::put('posts',$posts,60);

return redirect()->route('post.show',['post'=>Cache::get('post_id')]);

}

3.2 查看文章访问http://laravel.app:8000/post/create页面，填写表单，点击“提交”，保存成功后，页面跳转到详情页：

/**

* 显示指定文章

* @param int $id

* @return Response

public function show($id)

{

$posts = Cache::get('posts',[]);

if(!$posts || !$posts[$id])

exit('Nothing Found！');

$post = $posts[$id];

$editUrl = route('post.edit',['post'=>$id]);

$html = <<<DETAIL

<h3>{$post['title']}</h3>

<p>{$post['content']}</p>

<p>

</p>

DETAIL;

return $html;

}

3.3 编辑文章同理我们定义编辑文章对应的edit方法和update方法如下：

/**

* 显示编辑指定文章的表单页面

* @param int $id

* @return Response

public function edit($id)

{

$posts = Cache::get('posts',[]);

if(!$posts || !$posts[$id])

exit('Nothing Found！');

$post = $posts[$id];

$postUrl = route('post.update',['post'=>$id]);

$csrf_field = csrf_field();

$html = <<<UPDATE

$csrf_field

<textarea name="content" cols="50" rows="5">{$post['content']}</textarea><br/><br/>

</form>

UPDATE;

return $html;

}

/**

* 在存储器中更新指定文章

* @param Request $request

* @param int $id

* @return Response

public function update(Request $request, $id)

{

$posts = Cache::get('posts',[]);

if(!$posts || !$posts[$id])

exit('Nothing Found！');

$title = $request->input('title');

$content = $request->input('content');

$posts[$id]['title'] = trim($title);

$posts[$id]['content'] = trim($content);

Cache::put('posts',$posts,60);

return redirect()->route('post.show',['post'=>Cache::get('post_id')]);

}

3.4 删除文章我们还可以使用destroy方法删除文章：

/**

* 从存储器中移除指定文章

* @param int $id

* @return Response

public function destroy($id)

{

$posts = Cache::get('posts',[]);

if(!$posts || !$posts[$id])

exit('Nothing Deleted！');

unset($posts[$id]);

Cache::decrement('post_id',1);

return redirect()->route('post.index');

}

要删除文章，需要参考编辑表单伪造删除表单方法为DELETE（一般使用AJAX删除），这里不再演示。 3.5 文章列表最后我们再来定义一个用于显示所有文章列表的index方法：

/**

* 显示文章列表.

* @return Response

public function index()

{

$posts = Cache::get('posts',[]);

if(!$posts)

exit('Nothing');

$html = '<ul>';

foreach ($posts as $key=>$post) {

$html .= '<li><a href='.route('post.show',['post'=>$key]).'>'.$post['title'].'</li>';

}

$html .= '</ul>';

return $html;

}

from:<a href="http://laravelacademy.org/post/549.html">http://laravelacademy.org/post/549.html</a>

龙生 15 Aug 2017

View Details

中间件实例教程 —— 中间件的创建使用及中间件参数定义

1、中间件简介 Laravel中可以把HTTP中间件看做“装饰器”，在请求到达最终动作之前对请求进行过滤和处理。中间件在Laravel中有着广泛的应用，比如用户认证、日志、维护模式、开启Session、从Session中获取错误信息，以及上一篇教程中提到的CSRF验证，等等。中间件类默认存放在app/Http/Middleware目录下。 2、中间件创建及其使用我们在《HTTP路由实例教程（二）—— 路由命名和路由分组》一文已经演示了如何创建中间件以及中间件的基本使用。自定义中间件类只需要定义一个handle方法即可，然后我们将主要业务逻辑定义在该方法中，如果我们想在请求处理前执行业务逻辑，则在$next闭包执行前执行业务逻辑操作：

<?php

namespace App\Http\Middleware;

use Closure;

class BeforeMiddleware

{

public function handle($request, Closure $next)

{

// 执行业务逻辑操作

return $next($request);

}

如果想要在请求处理后执行中间件业务逻辑，则在$next闭包执行后执行操作：

<?php

namespace App\Http\Middleware;

use Closure;

class AfterMiddleware

{

public function handle($request, Closure $next)

{

$response = $next($request);

// 执行动作

return $response;

}

我们处理的大部分操作都是第一种场景，即在请求处理前执行操作，比如用户认证、CSRF验证、维护模式等都是这样，但也有用到第二种场景的时候，比如StartSession中间件，该中间件在请求处理前后都有操作，其handle方法如下：

public function handle($request, Closure $next)

{

$this->sessionHandled = true;

//如果session驱动已配置，那么我们需要开启session以便为应用准备好数据

//注意Laravel session并没有使用原生的PHP session相关方法，因为它们显得那样蹩脚

if ($this->sessionConfigured()) {

$session = $this->startSession($request);

$request->setSession($session);

}

$response = $next($request);

// 同样，如果session经过配置那么我们需要关闭session以便将session数据持久化到某些存储介质中

// 我们还会添加session id到响应头cookie中

if ($this->sessionConfigured()) {

$this->storeCurrentUrl($request, $session);

$this->collectGarbage($session);

$this->addCookieToResponse($response, $session);

}

return $response;

}

此外，定义好中间件后，需要在app/Http/Kernel.php文件中注册该中间件，如果我们定义的中间件想要在全局有效，即每次请求都会调用，则将该中间件追加到$middleware属性数组；否则如果中间件只是在某些特定的路由中使用，则将其追加到$routeMiddleware属性数组，并在路由定义时使用middleware选项指定。关于这一点我们已经在路由分组中有所陈述，这里不再赘述。 3、中间件参数除了请求实例$request和闭包$next之外，中间件还可以接收额外参数，我们还是以TestMiddleware为例，现在要求年龄在18岁以上的男性才能访问指定页面，handle方法定义如下：

public function handle($request, Closure $next, $gender)

{

if($request->input('age')>=18 && $gender==$request->input('gender')){

return $next($request);

}else{

return redirect()->route('refuse');

}

对应的路由配置如下：

Route::group(['middleware'=>'test:male'],function(){

Route::get('/write/laravelacademy',function(){

//使用Test中间件

});

Route::get('/update/laravelacademy',function(){

//使用Test中间件

});

Route::get('/age/refuse',['as'=>'refuse',function(){

return "18岁以上男子才能访问！";

}]);

4、定义可终止的中间件可终止的中间件是指定义了terminate方法的中间件，terminate方法会在一次请求生命周期的末尾执行一些操作。比如StartSession中间件定义了该方法，在响应数据发送到浏览器之后将session数据保存起来。可终止的中间件需要追加到app/Http/Kernel.php类的全局中间件列表即$middleware属性数组中。调用中间件的terminate方法时，Laravel会从服务容器中取出新的中间件实例，所以如果想要调用handle方法和terminate方法时使用的是同一个中间件实例，需要使用singleton方法将该中间件注册到服务容器。 from:http://laravelacademy.org/post/537.html

龙生 15 Aug 2017

View Details

HTTP路由实例教程（三）—— CSRF攻击原理及其防护

1、什么是CSRF攻击 CSRF是跨站请求伪造（Cross-site request forgery）的英文缩写。关于CSRF攻击原理及其防护，可查看Github上的这个项目：理解CSRF，说得比较详细和透彻。 2、Laravel中如何避免CSRF攻击 Laravel框架中避免CSRF攻击很简单：Laravel自动为每个用户Session生成了一个CSRF Token，该Token可用于验证登录用户和发起请求者是否是同一人，如果不是则请求失败。 Laravel提供了一个全局帮助函数csrf_token来获取该Token值，因此只需在视提交图表单中添加如下HTML代码即可在请求中带上Token：

1	<input type="hidden" name="_token" value="<?php echo csrf_token(); ?>">

该段代码等同于全局帮助函数csrf_field的输出：

1	<?php echo csrf_field(); ?>

在Blade模板引擎中还可以使用如下方式调用：

1	{!! csrf_field() !!}

测试代码我们在routes.php中定义如下代码：

Route::get('testCsrf',function(){

$csrf_field = csrf_field();

$html = <<<GET

<form method="<a title="View all posts in POST" href="http://laravelacademy.org/tags/post" target="_blank">POST</a>" action="/testCsrf">

{$csrf_field}

</form>

GET;

return $html;

});

Route::post('testCsrf',function(){

return 'Success!';

});

在浏览器中我们输入http://laravel.app:8000/testCsrf，点击“Test”按钮，浏览器输出：

Success！

则表示请求成功，否则，如果我们定义GET路由如下：

Route::get('testCsrf',function(){

$html = <<<GET

</form>

GET;

return $html;

});

则点击“Test”按钮，则抛出TokenMismatchException异常。 3、从CSRF验证中排除指定URL 并不是所有请求都需要避免CSRF攻击，比如去第三方API获取数据的请求。可以通过在VerifyCsrfToken（app/Http/Middleware/VerifyCsrfToken.php）中间件中将要排除的请求URL添加到$except属性数组中：

<?php

namespace App\Http\Middleware;

use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as BaseVerifier;

class VerifyCsrfToken extends BaseVerifier

{

/**

* 指定从 CSRF 验证中排除的URL

* @var array

protected $except = [

'testCsrf'

];

}

这样我们刷新页面，再次在http://laravel.app:8000/testCsrf页面中点击“Test”按钮，则页面不会报错，正常输出如下内容：

Success!

4、X-CSRF-Token及其使用如果使用Ajax提交POST表单，又该如何处理呢？我们可以将Token设置在meta中：

1	<meta name="csrf-token" content="{{ csrf_token() }}">

然后在全局Ajax中使用这种方式设置X-CSRF-Token请求头并提交：

$.ajaxSetup({

headers: {

'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')

}

});

Laravel的VerifyCsrfToken中间件会检查X-CSRF-TOKEN请求头，如果该值和Session中CSRF值相等则验证通过，否则不通过。 5、X-XSRF-Token及其使用除此之外，Laravel还会将CSRF的值保存到名为XSRF-TOKEN的Cookie中，然后在VerifyCsrfToken中间件验证该值，当然，我们不需要手动做任何操作，一些JavaScript框架如Angular会自动帮我们实现。 6、Laravel中CSRF验证原理分析说了这么多使用方式，接下来我们来分析下源码，看看Laravel底层到底是如何避免CSRF攻击的： 1）首先Laravel开启Session时会生成一个token值并存放在Session中（Illuminate\Session\Store.php第90行start方法），对应源码如下：

public function start()

{

$this->loadSession();

if (! $this->has('_token')) {

$this->regenerateToken();

}

return $this->started = true;

}

2）然后重点分析VerifyToken中间件的handle方法，该方法中先通过isReading方法判断请求方式，如果请求方法是HEAD、GET、OPTIONS其中一种，则不做CSRF验证； 3）再通过shouldPassThrough方法判断请求路由是否在$excpet属性数组中进行了排除，如果做了排除也不做验证； 4）最后通过tokensMatch方法判断请求参数中的CSRF TOKEN值和Session中的Token值是否相等，如果相等则通过验证，否则抛出TokenMismatchException异常。对应源码如下：

public function handle($request, Closure $next)

{

if ($this->isReading($request) || $this->shouldPassThrough($request) || $this->tokensMatch($request)) {

return $this->addCookieToResponse($request, $next($request));

}

throw new TokenMismatchException;

}

注：tokensMatch方法首先从Request中获取_token参数值，如果请求中不包含该参数则获取X-CSRF-TOKEN请求头的值，如果该请求头也不存在则获取X-XSRF-TOKEN请求头的值，需要注意的是X-XSRF-TOKEN请求头的值需要调用Encrypter的decrypt方法进行解密。 from:http://laravelacademy.org/post/525.html

龙生 15 Aug 2017

View Details

HTTP路由实例教程（二）—— 路由命名和路由分组

1、路由命名——给路由起个名字 1.1 基本使用我们使用as关键字来为路由命名：

<a title="View all posts in Route" href="http://laravelacademy.org/tags/route" target="_blank">Route</a>::get('/hello/laravelacademy',['as'=>'academy',function(){

return 'Hello <a title="View all posts in Laravel" href="http://laravelacademy.org/tags/laravel" target="_blank">Laravel</a>Academy！';

}]);

路由命名可以让我们在使用route函数生成指向该路由的URL或者生成跳转到该路由的重定向链接时更加方便：

Route::get('/testNamedRoute',function(){

return route('academy');

});

我们在浏览器中访问http://laravel.app:8000/testNamedRoute时输出http://laravel.app:8000/hello/laravelacademy，然后我们修改上述闭包内代码：

Route::get('/testNamedRoute',function(){

return redirect()->route('academy');

});

再次在浏览器中访问http://laravel.app:8000/testNamedRoute时会跳转到http://laravel.app:8000/hello/laravelacademy。我们甚至还可以在使用带参数的路由命名：

Route::get('/hello/laravelacademy/{id}',['as'=>'academy',function($id){

return 'Hello LaravelAcademy '.$id.'！';

}]);

对应的测试路由定义如下：

Route::get('/testNamedRoute',function(){

return redirect()->route('academy',['id'=>1]);

});

这样，当我们在浏览器中访问http://laravel.app:8000/testNamedRoute时会跳转到http://laravel.app:8000/hello/laravelacademy/1 1.2 路由分组时路由命名方式再来看一个更复杂的例子，使用路由分组时如何定义路由命名？官网文档提供的例子如下：

Route::group(['as' => 'admin::'], function () {

Route::get('dashboard', ['as' => 'dashboard', function () {

}]);

});

在Route门面的group方法中使用一个as关键字来指定该路由群组中所有路由的公共前缀，然后再在里面每个路由中使用as关键字为该路由命名。这样我们可以通过如下方式来生成该路由URL：

Route::get('/testNamedRoute',function(){

return route('admin::dashboard');

});

2、路由分组路由分组就是将一组拥有相同属性（中间件、命名空间、子域名、路由前缀等）的路由使用Route门面的group方法聚合起来。 2.1 中间件首先我们在应用根目录下运行如下Artisan命令生成一个测试用的中间件TestMiddleware：

1	php artisan make:middleware TestMiddleware

这样会在/app/Http/Middleware目录下生成一个TestMiddleware.php文件，打开该文件编辑TestMiddleware类的handle方法如下：

public function handle($request, Closure $next)

{

if($request->input('age')<18)

return redirect()->route('refuse');

return $next($request);

}

我们在中间件中定义这段业务逻辑的目的是年龄18岁以下的未成年人不能访问。然后我们打开/app/Http/Kernal.php文件，新增TestMiddleware到Kernel的$routeMiddleware属性：

protected $routeMiddleware = [

'auth' => \App\Http\Middleware\Authenticate::class,

'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,

'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,

'test' => \App\Http\Middleware\TestMiddleware::class,

];

接下来我们在routes.php中定义路由如下：

Route::group(['middleware'=>'test'],function(){

Route::get('/write/laravelacademy',function(){

//使用Test中间件

});

Route::get('/update/laravelacademy',function(){

//使用Test中间件

});

Route::get('/age/refuse',['as'=>'refuse',function(){

return "未成年人禁止入内！";

}]);

这样当我们在浏览器中访问http://laravel.app:8000/write/laravelacademy?age=15或者http://laravel.app:8000/update/laravelacademy?age=15时就会跳转到http://laravel.app:8000/age/refuse，并显示：

未成年人禁止入内！

2.2 命名空间默认情况下，routes.php中的定义的控制器位于App\Http\Controllers命名空间下，所以如果要指定命名空间，只需指定App\Http\Controllers之后的部分即可：

Route::group(['namespace' => 'LaravelAcademy'], function(){

// 控制器在 "App\Http\Controllers\LaravelAcademy" 命名空间下

Route::group(['namespace' => 'DOCS'], function()

{

// 控制器在 "App\Http\Controllers\LaravelAcademy\DOCS" 命名空间下

});

2.3 子域名子域名可以通过domain关键字来设置：

Route::group(['domain'=>'{service}.laravel.app'],function(){

Route::get('/write/laravelacademy',function($service){

return "Write FROM {$service}.laravel.app";

});

Route::get('/update/laravelacademy',function($service){

return "Update FROM {$service}.laravel.app";

});

这样我们在浏览器中访问http://write.laravel.app:8000/write/laravelacademy，则输出

1	Write FROM write.laravel.app

访问http://update.laravel.app:8000/write/laravelacademy时，则输出：

1	Write FROM update.laravel.app

注意：要想让子域名解析生效，需要在hosts中绑定IP地址 2.4 路由前缀如果路由群组中的所有路由包含统一前缀，则我们可以通过在group方法中设置prefix属性来指定该前缀：

Route::group(['prefix'=>'laravelacademy'],function(){

Route::get('write',function(){

return "Write LaravelAcademy";

});

Route::get('update',function(){

return "Update LaravelAcademy";

});

这样我们就可以通过http://laravel.app:8000/laravelacademy/write或者http://laravel.app:8000/laravelacademy/update来访问对应的操作。我们甚至还可以在路由前缀中指定参数：

Route::group(['prefix'=>'laravelacademy/{version}'],function(){

Route::get('write',function($version){

return "Write LaravelAcademy {$version}";

});

Route::get('update',function($version){

return "Update LaravelAcademy {$version}";

});

这样我们在浏览器中访问http://laravel.app:8000/laravelacademy/5.1/write，则对应会输出：

Write LaravelAcademy 5.1

from:<a href="http://laravelacademy.org/post/417.html">http://laravelacademy.org/post/417.html</a>

龙生 15 Aug 2017

View Details

HTTP路由实例教程（一）—— 基本使用及路由参数

1、路由基本使用示例 1.1 默认示例 Laravel中所有路由定义在/app/Http/routes.php文件中，该文件默认定义了应用的首页路由：

<a title="View all posts in Route" href="http://laravelacademy.org/tags/route" target="_blank">Route</a>::get('/', function () {

return view('welcome');

});

这段代码的意思是：当访问应用首页http://laravel.app:8000（使用Homestead虚拟机作为开发环境）的时候，返回/resources/views/welcome.blade.php视图中的内容并渲染到浏览器页面中：以上是应用自带的路由示例，下面我们来自定义一些示例来演示路由的基本使用。 1.2 GET请求路由定义对页面常见的请求方式有GET和POST，上面这个例子就是使用GET路由的例子，接下里来我们自定义一个/hello请求：

Route::get('/hello',function(){

return "Hello Laravel[GET]!";

});

我们在浏览器中输入http://laravel.app:8000/hello，以上代码在浏览器中输出：

1	Hello Laravel[GET]!

1.3 POST请求路由示例然后我们来演示一个POST请求的例子：

Route::get('/testPost',function(){

$csrf_token = csrf_token();

$form = <<<FORM

</form>

FORM;

return $form;

});

Route::post('/hello',function(){

return "Hello Laravel[POST]!";

});

首先我们定义一个/testPost页面用于提交POST请求表单，在http://laravel.app:8000/testPost页面点击“Test”按钮，页面跳转到http://laravel.app:8000/hello并显示：

1	Hello Laravel[POST]!

表明这是通过POST请求访问而非GET请求。 1.4 其它便捷路由定义还可以使用Route门面上的match方法匹配多种请求方式：

Route::match(['get','post'],'/hello',function(){

return "Hello Laravel!";

});

当然还使用更方便的any方法匹配所有请求方式：

Route::any('/hello',function(){

return "Hello Laravel!";

});

效果都一样。 2、路由参数使用示例 2.1 必选参数

Route::get('/hello/{name}',function($name){

return "Hello {$name}!";

});

在浏览器中访问http://laravel.app:8000/hello/Laravel输出：

1	Hello Laravel!

当然还可以指定多个参数：

Route::get('/hello/{name}/by/{user}',function($name,$user){

return "Hello {$name} by {$user}!";

});

这样在浏览器中访问http://laravel.app:8000/hello/Laravel/by/Laravel学院则会输出：

1	Hello Laravel by Laravel学院!

注意以上参数是必选的，如果没有输入参数会抛出MethodNotAllowedHttpException或NotFoundHttpException异常。此外闭包函数中的参数与路由参数一一对应。 2.2 可选参数有时候我们并不总是想要输入对应参数，也就是说，我们期望参数是可有可无的，我们通过这种方式来定义：

Route::get('/hello/{name?}',function($name="Laravel"){

return "Hello {$name}!";

});

我们同时为可选参数指定了默认值，这样当我们访问http://laravel.app:8000/hello时输出：

1	Hello Laravel！

当我们访问http://laravel.app:8000/hello/Laravel学院的时候输出：

1	Hello Laravel学院！

2.3 正则约束有时候我们希望对路由有更加灵活的条件约束，可以通过正则表达式来实现：

Route::get('/hello/{name?}',function($name="Laravel"){

return "Hello {$name}!";

})->where('name','[A-Za-z]+');

该条件约束意味着$name参数只能包含大小写字母，如果包含数字或中文就会抛出NotFoundHttpException异常。如果我们想要在全局范围内对参数进行条件约束，可以在RouteServiceProvider的boot方法中做如下定义：

public function boot(Router $router)

{

$router->pattern('name','[A-Za-z]+');

parent::boot($router);

}

我们访问http://laravel.app:8000/hello/Laravel123/by/Laravel学院时一样会抛出NotFoundHttpException异常。这意味着boot方法定义的参数条件约束将会应用到所有包含该参数的路由中。此外，服务提供者的boot方法在所有服务提供者的register方法执行完毕后开始执行，也就是说，我们可以在boot方法对任意服务容器中的对象进行依赖注入。 from:http://laravelacademy.org/post/398.html

龙生 15 Aug 2017

View Details

upgrade Laravel 5.2 to 5.3

昨天折腾了1个小时，把5.2升级到5.3，目前是成功了，遇见了几个小坑。但是之后的坑不可预见，分享一下遇见的小坑。前提是必须仔细阅读的官方文档。刚开始的时候，改了composer文件，直接更新，出现了错误 Declaration of App\Providers\EventServiceProvider::boot() should be compatible with Illuminate\Foundation\Support\Providers\EventServiceProvider::boot(Illuminate\Contracts\Events\Dispatcher $events) 然后我去看了下官方文档，具体忘记在哪里了，主要是bootstrap里面的cache文件没有清理，所以必须得先清理，运行下面的命令 php artisan route:cache php artisan view:clear php artisan config:clear php artisan cache:clear php artisan clear-compiled php artisan optimize php artisan route:cache 更新完之后会报错， ErrorException in EventServiceProvider.php line 8: 按照官方文档解释，就是这些功能已经改变，不需要参数，所以，我们找到相应的位置，把参数去掉即可 public function boot() { parent::boot(); } from：https://laravel-china.org/topics/3767/upgrade-laravel-52-to-53

龙生 14 Aug 2017

View Details

« Previous 1 … 14 15 16 … 29 Next »