response()助手方法可以在相应中设置Header:
return response('Error', 400)->header('X-Header-Name', 'header-value');
在Header中,任何以“X-”开头的名称都不是HTTP规范中的相应头,或者尚未成为规范公约的一部分。

如果须要读取Header,则利用$request工具:$request->header('Accept');
同样可以在相应中添加cookie:
return response('Error', 400)->cookie('cookie-name', 'cookie-value');
利用download()方法可以下载文件:
return response('Error', 400)->download('file.pdf');
利用json输出:
return response('Error', 400)->json(['Tom', 'Jerry']);
利用redirect()助手方法来实现重定向:
return redirect()->route('account.payment');
return redirect()->action('AccountController@showPayment');
当路由须要参数时,将参数数组作为第二个参数传入:
return redirect()->route('account.payment', ['payment_id'=>15]);
还有一个快捷方法back(),浸染是可以回到前一个页面,并且支持自动填入之前的输入:
return back()-withInput();
要求Request按照中间件注册的顺序进入中间件,依次处理,最后进入运用程序,返回的时候也会经由每一个中间件,末了由第一个注册的中间件返回相应Response。
范例的中间件构造如下:
class MiddleWareBan{
public function handle($request, Closure $next){
// 处理要求
banSomeIP($request);
// 传到下一个中间件或运用
$response = $next($request);
// 处理相应。
$response->cookie('visited', true);
// 返回相应
return $response;
}
}
在Kernel.php中添加绑定,使之成为全局中间件:
// app/Http/Kernel.php
protected $middleware = [\App\Http\Middleware\MiddleWareBan::class, ];
还可以绑定为专门用于路由的中间件,此时须要设定一个键名,以便路由配置:
protected $routeMiddleware = ['band'=>\App\Http\Middleware\MiddleWareBan::class, ];
Laravel自带两个中间件组:web和api,个中web包括用于cookie, 会话,CSRF保护等;而api不包括任何web中间件,它包括throttle和路由模型绑定中间件。
利用冒号向中间件传参数:
Route::get()->middleware('auth:owner');
对应中间件,须要在handle方法中增加吸收参数:
class MiddlewareAuth{
public function handle($request, Closure $next, $role){
if($role == 'owner'){}
}
}
在测试中,有时须要禁用中间件,可以导入:
use Illuminate\Foundation\Testing\WithoutMiddleware;
或者在方法中调用:
$this->withoutMiddleware();
达到禁用的目的。
依赖注入指的是类的依赖项是由外部注入,而不是在类中布局,通过类的布局函数参数注入的办法比较常见。
PHP的类型提示(typehint),指的是在参数前面给出类型,它可以是一个接口或详细的类。哀求传入参数必须跟类型匹配。
如果作为容器工具,则不必传入参数,容器可以根据配置自动化实例工具。
须要在做事供应者中注册工具,才能成为容器工具:
class AppServiceProvider{
public function register(){
$this->app->bind(Logger::class, function($app){
return new Logger('\log\path', 'error');
});
}
}
bind()方法将Logger类,以及如何实例化该类的方法进行了绑定。
还支持嵌套绑定,即其余一个容器工具利用到了当前的容器工具,利用make()方法来实例化:
$this->app->bind(MailLogger:class, function ($app){
return new MailLogger(
$app->make(Mailer::class),
$app->make(Logger::class)
);
});
bind()方法不能缓存,每次都会返回新的实例,利用singleton()或instance()方法来返回同一个实例:
public function register(){
$logger = new Logger();
$this->app->instance(Logger::class, $logger);
}
掌握反转指的是在上层通过配置来确定详细利用的类型,而实现部分用的是接口,从而反向掌握:
$this->app->bind(\Interface\Mailer::class, function(){
// 将接口绑定到详细的类。
return new MailgunMailer();
});
容器卖力解析掌握器,以是可以在掌握器的布局函数中注入容器工具,而不须要外部传入:
class MyController extends Controller{
public function __construct(Logger $logger){}
}
Facade模式,利用的是静态方法访问非静态资源,实际上是容器实例化后的调用,以是:
Log::error('Help!');
app('log')->error('Help!');
两者是一样的。
如何创建自己的Facade:
(1) 创建类继续自Illuminate\Support\Facades\Facade
(2) 供应getFacadeAccessor()方法,返回一个字符串,字符串可以表示容器工具。
(3) 通过config/app.php将它添加到aliases数组中注册。
注册容器工具时,可以将它添加到包罗万象的App\Providers\AppServiceProvider中。但一样平常来说,为每一组功能创建一个单独的做事供应者,并将其绑定到register()方法中,则是更好的方法。
TestCase供应了一些便捷的测试方法,例如:
$this->visit('/') // 访问首页
->see('Laravel'); // 查看DOM中是否有Laravel笔墨, 可以利用正则表达式。
按照PHPUnit的规则,只有名字以test开头,或者在方法注释块中含有@test的方法才会被测试实行。
在测试时,Laravel会将环境设置成testing。通过判断环境,可以针对测试来实行干系逻辑:
if(app()->environment('testing')){
// 作一些测试环境的设置
}
在测试时,Laravel不会加载.env中的环境变量,以是测试环境中的环境变量须要在phpunit.xml中添加:
<php>
<env name="DB_CONNECTION" value="mysql" />
</php>
DatabaseTransactions会在测试时,将每个测试包装在事务中,测试完成后回滚,让数据库回到测试前相同的状态:
use Illuminate\Foundation\Testing\DatabaseTransactions;
利用测试方法$this->call()会像visit()一样发出对页面的要求,并把相应存储在$this->response中,但是不会利用类似see()的爬虫。
$this->get(), $this->post()均是对call()方法的包装,它们是将要求类型传给了call()方法的第一个参数。
同样$this->json()也是对call()的包装,它将通报的数据转换成json,并添加JSON要求头。
$this->followRedirect()方法将会跟随页面逻辑重定向到末了的页面,如果不该用这个方法,得到的相应是末了的页面,而不是重定向前的页面内容。
assertPageLoaded()方法检讨加载页面时,状态码是否为200.
若要检讨数据库中的记录,可以利用seeInDatabase()方法,将表名作为它的第一个参数,将要查找的数据作为第二个数组参数:
$this->seeInDatabase('emails', ['email'=>'someone@domain.com']);
测试视图时,可以利用assertViewHas()方法:
// foo是键,bar是值。
// 判断时,也可以只传入键“foo”.
$this->assertViewHas('foo', 'bar');
assertSessionHasErrors()方法用来判断session会话中是否存在缺点。
assertHasOldInput()方法判断旧的数据已经添补到输入框中,一样平常涌如今用户点击返回按钮时。
$this->session()方法用来启动会话:
$this->session(['visit'=>'true', 'user_name'=>'someone']);
$this->flushSession()用来打消当前会话的所有数据。
seed()方法可以插入仿真数据,浸染与$this->artisan('db:seed')相同。
可以利用Mockery来得到一个伪工具,并且伪工具的方法可以供外部调用,但是不产生效果(返回空值):
$slackMock = Mockery::mock(SlackClient::class)->shouldIgnoreMissing();
REST api除了环绕uri表示的资源构造化,紧张利用HTTP动词与资源进行交互外,还有以下特色:
(1) 无状态,要求之间没有持久化,彼此没有关系。
(2) 可缓存和同等性,多次调用返回的结果是相同的。
--resource标志会让artisan命令天生一个资源掌握器,而不是普通的掌握器:
php artisan make:controller Api/\DogsController --resource
在路由中创建一个REST风格的API:
Route::group(['prefix'=>'api', 'namespace'=>'Api'], function(){
Route::resource('dogs', 'DogsController');
});
路由将会自动将REST的要求方法,对应到掌握器的相应方法,比如DELETE对应destroy()方法。
分页利用paginate()方法:
Dog::paginate(20);
在REST接口中,Lavarel可以根据查询参数page,来自动筛选出精确的页面数据:
GET /dogs // 1-20
GET /dogs?page=1 // 1-20
GET /dogs?page=2 // 21-40
同时paginate()方法也适用于路由中的查询布局器:
Route::get('dogs', function(){
return DB::table('dogs')->paginate(20);
});
须要把稳的是,当把结果转化为json时,并不是20行数据,它还会包含一些汇总数据:
{
"total":50,
"per_page":3,
"current_page":1,
"data":[] // 此处是真正的页面数据。
}
json规范中data和errors成员不能同时涌如今一个文件中,也便是有缺点就不能返回数据。
排序轻微麻烦一些,须要手工布局出排序字段和方向,然后传给实体的orderBy()方法:
// 页面排序参数是?sort=-weight
function($request){
$sortCol = $request->input('sort');
$sortDir = starts_with($sortCol, '-') ? 'desc' : 'asc';
$sortCol = ltrim($sortCol, '-');
return Dog::orderBy($sortCol, $sortDir);
}
条件筛选则利用实体的查询布局器完成:
// 页面过滤器参数为:?filter=sex:female,color:brown
function($request){
$query = Dog::query();
if($request->has('filter')){
$filters = explode(',', $request->input('filter'));
foreach($filters as $filter){
list($criteria, $value) = explode(':', $filter);
$query->where($criteria, $value);
}
}
return $query->paginate(20);
}
有时页面模型并不是和数据库模型完备对应,此时我们须要通过转换器将数据库模型转换成页面模型。
new DogTransformer(Dog::all());
实现转换器时,关键在于实现__toString()方法:
class UserTransformer{
public function __construct($user){}
public functon toArray(){
return [
'id'=>$this->user->id,
'full_name'=>sprintf('%s %s', $this->user->first_name, $this->user->last_name),
'friend_count'=>$this->user->friends->count()
];
}
public function __toString(){
reutrn json_encode($this->toArray());
}
}
这样就将api须要的构造同实体模型的构造分离开,纵然往后双方各自发生变革,也可以通过变动转换器来实现同等输出。
小技巧,如果实体中含有其他嵌套实体,实现时则可以调用对方的toArray()方法,而不必重新编写:
public functon toArray(){
return [
'id'=>$this->user->id,
'full_name'=>sprintf('%s %s', $this->user->first_name, $this->user->last_name),
'friend_count'=>$this->user->friends->count(),
'friends'=>$this->user->friends->map(function($friend){
return (new FriendTransformer($friend))->toArray();
})
];
}