響應(yīng)
響應(yīng)實際上是一個support\Response對象，為了方便創(chuàng)建這個對象，webman提供了一些助手函數(shù)。
返回一個任意響應(yīng)
例子
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return response('hello webman');
}
}response函數(shù)實現(xiàn)如下：
function response($body = '', $status = 200, $headers = array())
{
return new Response($status, $headers, $body);
}你也可以先創(chuàng)建一個空的response對象，然后在適當?shù)奈恢美?code>$response->cookie() $response->header() $response->withHeaders() $response->withBody()設(shè)置返回內(nèi)容。
public function hello(Request $request)
{
// 創(chuàng)建一個對象
$response = response();
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置cookie
$response->cookie('foo', 'value');
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置http頭
$response->header('Content-Type', 'application/json');
$response->withHeaders([
'X-Header-One' => 'Header Value 1',
'X-Header-Tow' => 'Header Value 2',
]);
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置要返回的數(shù)據(jù)
$response->withBody('返回的數(shù)據(jù)');
return $response;
}返回json
例子
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return json(['code' => 0, 'msg' => 'ok']);
}
}json函數(shù)實現(xiàn)如下
function json($data, $options = JSON_UNESCAPED_UNICODE)
{
return new Response(200, ['Content-Type' => 'application/json'], json_encode($data, $options));
}返回xml
例子
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
$xml = <<<XML
<?xml version='1.0' standalone='yes'?>
<values>
<truevalue>1</truevalue>
<falsevalue>0</falsevalue>
</values>
XML;
return xml($xml);
}
}xml函數(shù)實現(xiàn)如下：
function xml($xml)
{
if ($xml instanceof SimpleXMLElement) {
$xml = $xml->asXML();
}
return new Response(200, ['Content-Type' => 'text/xml'], $xml);
}返回視圖
新建文件 app/controller/FooController.php 如下
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return view('foo/hello', ['name' => 'webman']);
}
}新建文件 app/view/foo/hello.html 如下
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>webman</title>
</head>
<body>
hello <?=htmlspecialchars($name)?>
</body>
</html>重定向
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return redirect('/user');
}
}redirect函數(shù)實現(xiàn)如下：
function redirect($location, $status = 302, $headers = [])
{
$response = new Response($status, ['Location' => $location]);
if (!empty($headers)) {
$response->withHeaders($headers);
}
return $response;
}header設(shè)置
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return response('hello webman', 200, [
'Content-Type' => 'application/json',
'X-Header-One' => 'Header Value'
]);
}
}也可以利用header和withHeaders方法來單個或者批量設(shè)置header。
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return response('hello webman')
->header('Content-Type', 'application/json')
->withHeaders([
'X-Header-One' => 'Header Value 1',
'X-Header-Tow' => 'Header Value 2',
]);
}
}你也可以提前設(shè)置header，最后設(shè)置將要返回的數(shù)據(jù)。
public function hello(Request $request)
{
// 創(chuàng)建一個對象
$response = response();
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置http頭
$response->header('Content-Type', 'application/json');
$response->withHeaders([
'X-Header-One' => 'Header Value 1',
'X-Header-Tow' => 'Header Value 2',
]);
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置要返回的數(shù)據(jù)
$response->withBody('返回的數(shù)據(jù)');
return $response;
}設(shè)置cookie
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return response('hello webman')
->cookie('foo', 'value');
}
}你也可以提前設(shè)置cookie，最后設(shè)置要返回的數(shù)據(jù)。
public function hello(Request $request)
{
// 創(chuàng)建一個對象
$response = response();
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置cookie
$response->cookie('foo', 'value');
// .... 業(yè)務(wù)邏輯省略
// 設(shè)置要返回的數(shù)據(jù)
$response->withBody('返回的數(shù)據(jù)');
return $response;
}cookie方法完整參數(shù)如下：
cookie($name, $value = '', $max_age = 0, $path = '', $domain = '', $secure = false, $http_only = false)
返回文件流
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return response()->file(public_path() . '/favicon.ico');
}
}- webman支持發(fā)送超大文件
- 對于大文件(超過2M)，webman不會將整個文件一次性讀入內(nèi)存，而是在合適的時機分段讀取文件并發(fā)送
- webman會根據(jù)客戶端接收速度來優(yōu)化文件讀取發(fā)送速度，保證最快速發(fā)送文件的同時將內(nèi)存占用減少到最低
- 數(shù)據(jù)發(fā)送是非阻塞的，不會影響其它請求處理
- file方法會自動添加
if-modified-since頭并在下一個請求時檢測if-modified-since頭，如果文件未修改則直接返回304以便節(jié)省帶寬 - 發(fā)送的文件會自動使用合適的
Content-Type頭發(fā)送給瀏覽器 - 如果文件不存在，會自動轉(zhuǎn)為404響應(yīng)
下載文件
<?php
namespace app\controller;
use support\Request;
class FooController
{
public function hello(Request $request)
{
return response()->download(public_path() . '/favicon.ico', '文件名.ico');
}
}download方法與file方法基本一致，的區(qū)別是
1、設(shè)置下載的文件名后文件會被下載下來，而不是顯示在瀏覽器里
2、download方法不會檢查if-modified-since頭
獲取輸出
有些類庫是將文件內(nèi)容直接打印到標準輸出的，也就是數(shù)據(jù)會打印在命令行終端里，并不會發(fā)送給瀏覽器，這時候我們需要通過ob_start(); ob_get_clean(); 將數(shù)據(jù)捕獲到一個變量中，再將數(shù)據(jù)發(fā)送給瀏覽器，例如：
<?php
namespace app\controller;
use support\Request;
class ImageController
{
public function get(Request $request)
{
// 創(chuàng)建圖像
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);
// 開始獲取輸出
ob_start();
// 輸出圖像
imagejpeg($im);
// 獲得圖像內(nèi)容
$image = ob_get_clean();
// 發(fā)送圖像
return response($image)->header('Content-Type', 'image/jpeg');
}
}
