WP_Http クラスの使い方|説明・引数・注意点

説明

WP_Http は、WordPressのHTTP通信を担当するクラスです。通常は wp_remote_get() などのラッパー関数を使います。

基本構文

WP_Http

引数

  • request():リクエストを送る
  • get():GET
  • post():POST
  • head():HEAD

戻り値

WP_Http オブジェクト。

使い方(サンプル)

$res = wp_remote_get( 'https://example.com/' );

注意点

  • クラスを直接使うことは、ほとんどありません。

実務での使いどころ

  • WordPressの、HTTPリクエストの処理(wp_remote_* 関数が、内部で使うクラス)を、理解するとき。

よくあるミスと対処

  • 直接、new WP_Http() を使っている。通常は、wp_remote_get()・wp_remote_post() などの関数で足りる。
  • 戻り値が WP_Error のときを、考えていない。
  • ユーザー入力のURLに使っている。宛先を検証する、wp_safe_remote_get() を使う。

NG例

$http = new WP_Http();
$response = $http->get( $url ); // 通常は、関数で足りる

OK例

$response = wp_remote_get( $url );
if ( is_wp_error( $response ) ) {
	return;
}

使い分け早見表

やりたいこと 使うもの
GETで取得する wp_remote_get()
POSTで送信する wp_remote_post()
宛先が入力で変わるリクエスト wp_safe_remote_get()

関連項目

wp_remote_get()、wp_remote_post()

公式リファレンス:WP_Http | WordPress Developer Resources

コメント

タイトルとURLをコピーしました