Laravel学习笔记(3) laravel自学入门教程

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

})

];

}