2.6 KiB
控制器
通過控制器來處理 HTTP 請求,需要通過 配置檔案
或 註解
的形式將路由與控制器方法進行繫結,具體請查閱 路由 章節。
對於 請求(Request)
與 響應(Response)
,Hyperf 提供了 Hyperf\HttpServer\Contract\RequestInterface
和 Hyperf\HttpServer\Contract\ResponseInterface
方便您獲取入參和返回資料,關於 請求 與 響應 的詳細內容請查閱對應的章節。
編寫控制器
<?php
declare(strict_types=1);
namespace App\Controller;
use Hyperf\HttpServer\Contract\RequestInterface;
use Hyperf\HttpServer\Contract\ResponseInterface;
class IndexController
{
// 在引數上通過定義 RequestInterface 和 ResponseInterface 來獲取相關物件,物件會被依賴注入容器自動注入
public function index(RequestInterface $request, ResponseInterface $response)
{
$target = $request->input('target', 'World');
return 'Hello ' . $target;
}
}
我們假設該
Controller
已經通過了配置檔案的形式定義了路由為/
,當然您也可以使用註解路由
通過 cURL
呼叫該地址,即可看到返回的內容。
$ curl http://127.0.0.1:9501/\?target\=Hyperf
Hello Hyperf.
避免協程間資料混淆
在傳統的 PHP-FPM 的框架裡,會習慣提供一個 AbstractController
或其它命名的 Controller 抽象父類
,然後定義的 Controller
需要繼承它用於獲取一些請求資料或進行一些返回操作,在 Hyperf 裡是 不能這樣做 的,因為在 Hyperf 內絕大部分的物件包括 Controller
都是以 單例(Singleton)
形式存在的,這也是為了更好的複用物件,而對於與請求相關的資料在協程下也是需要儲存到 協程上下文(Context)
內的,所以在編寫程式碼時請務必注意 不要 將單個請求相關的資料儲存在類屬性內,包括非靜態屬性。
當然如果非要通過類屬性來儲存請求資料的話,也不是沒有辦法的,我們可以注意到我們獲取 請求(Request)
與 響應(Response)
物件時是通過注入 Hyperf\HttpServer\Contract\RequestInterface
和 Hyperf\HttpServer\Contract\ResponseInterface
來獲取的,那對應的物件不也是個單例嗎?這裡是如何做到協程安全的呢?就 RequestInterface
來舉例,對應的 Hyperf\HttpServer\Request
物件內部在獲取 PSR-7 請求物件
時,都是從 協程上下文(Context)
獲取的,所以實際使用的類僅僅是一個代理類,實際呼叫的都是從 協程上下文(Context)
中獲取的。