Page 1
【令和最新版】
開発者フレンドリーな
HTTP SDK作るには
Creating Developer-Friendly HTTP SDKs
pixiv Inc.
USAMI Kenta
2022-06-24 PHP Conference Fukuoka
Page 10
SDKを書く前におさえておきたいPHPでのHTTPの使いかた
Page 12
WEB+DB PRESS Vol.96(2016年)
Page 13
関数ベースの処理はイケてないからGuzzle使おうぜ！…という内容
Page 17
PHPからHTTPリクエスト
- グローバル関数を使うと超かんたんにHTTPリクエストを発行できる
- file_get_contents($url)
- 名前に反してPOSTなど任意のメソッドのリクエストを発行できる(!)
- cURL関数 [curl_init(), curl_exec(), ...]
- こいつらは事実上の標準関数みたいな感じで外部ライブラリも要らないし
簡単だけどリクエスト・レスポンスの組み立てがちょっとめんどい
Page 22
PHP-FIGとかいう有志の団体が勧告している標準仕様
Page 27
PSRではHTTPに関連する仕様も多く勧告されている
Page 29
PSR-18はHTTP Clientのインターフェイス
Page 30
PSR-18はPSR-15と似ているがよりシンプル
Page 32
＿人人人人人人人人人人人人人人人人人＿＞ 僕の知ってるHTTPClientと違う ＜‾Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^‾
Page 35
それに引き換えなんだこのPSR-18
シンプルすぎる
Page 37
PSR-7/18 vs Guzzle (1)
- PSRはフレームワークの相互運用できる共通部品となるべく設計された
- PSR-7/18はHTTPの仕様を(PHPで扱える範囲で)そのまま表現できる
- Guzzleはエンドユーザーが使いやすいように設計されていて、
ユーザーはHTTPやPSRの仕様を考えなくても簡単に使えるようになってる
- リクエスト生成やHTTPヘッダの組み立てなどの実装も含んでいる
Page 43
特定の場合に処理を横取りできるとうれしいことがある
Page 47
外部にリクエストが送られないように
- PSR-18の場合、仕様がとてもシンプルなのでClientInterfaceを実装し
たシンプルな無名クラスを作ってしまうのが簡単
- Guzzleの場合、MockHandlerというハンドラを有効化して
テスト用に任意のレスポンスを返す関数を登録してやることができる
- 重要: アプリケーション内に不用意に new Guzzle\Client()とか書かない
- 普通の方法で処理を横取りできなくなってしまう
Page 48
依存の注入 (Dependency Injection)
- オブジェクトはメソッド内でその都度生成するのではなく、
呼び出し側(もしくはさらに上位のモジュール)から入れ込むことで共通のインターフェイスを持ったものに交換できることを保証する
- 同一機能を持った別のライブラリに乗り換えることもできるし、
テスト時に決まった値を返すモックオブジェクトに差し替えることも簡単
- くわしくは「ちょうぜつソフトウェア設計入門」を読んで！
Page 54
利用者の邪魔をするパターン
- SDKの実装の中で new Guzzle\Client() って書く
- SDKの実装の中で file_get_contents() とか curl 関数を呼ぶ
- ただしこれらのパターンはPHP-VCRというテスト用ライブラリを
活用することで通信をフックして任意のレスポンスに書き換えたりすることもできなくはない
