wp_remote_request

（2.7.0以降）
wp_remote_request - HTTPリクエストを送信する

説明

mixed wp_remote_request( string $url [ , array $args = array() ] )
HTTPリクエストを送信する。

パラメータ

  • $url
    リクエスト先URLを指定。
  • $args
    パラメータを連想配列で指定（省略時はarray()）。連想配列の要素は次の通り。
    キー名内容省略時の値
    'method'メソッド種別'GET'
    'timeout'タイムアウト秒数5
    'redirection'リダイレクト回数5
    'httpversion'HTTPバージョン'1.0'
    'user-agent'ユーザエージェント'WordPress/'.$wp_version.'; '.get_bloginfo( 'url' )
    'blocking'ブロッキング指定true
    'headers'ヘッダーarray()
    'cookies'クッキーarray()
    'body'ボディnull
    'compress'圧縮指定false
    'decompress'非圧縮指定true
    'sslverify'SSLベリファイ指定true
    'stream'ストリーム指定false
    'filename'ファイル情報null

返り値

リクエストを送信（レスポンスを取得）できた場合は連想配列を、送信に失敗した場合は WP_Errorオブジェクトを返す。連想配列は次の通り。
キー名内容
'headers'ヘッダー情報（'server'、'date'、'content-type'などの連想配列）
'body'レスポンス本体（文字列）
'response'レスポンス情報（'code'と'message'要素を持つ連想配列）
'cookies'クッキー情報（配列）
'filename'ファイル情報

注意

基本的には wp_remote_get関数と同じ。

使用例

  • 'http://wordpress.org/'にリクエストを送信する。
    <?php $response = wp_remote_request( 'http://wordpress.org/' ); ?>
  • 'http://wordpress.org/'にタイムアウト10秒でリクエストを送信する。
    <?php $response = wp_remote_request( 'http://wordpress.org/', array( 'timeout'=>10 ) ); ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/http.php

最終更新 : 2017年05月23日 16:20

関連

参考

Code Reference: wp_remote_request

お勧め

使っていないか確認しないとね！（フィルター編）（2019年4月24日 更新）

先週末にWordPress 5.2 Beta3（以降5.2Beta3）が公開され、正式リリースまであとわずか。ソースコードの変更点を見ていくと、wp-login.phpの中に非推奨となったフィルターが目に留まった。

ブロックエディターで現在の「ロケール」を取得した時のメモ（2024年8月10日 更新）

ブロックエディター向けのプラグインで日本語固有の機能を実装する際、現在のロケール（言語）を取得したい。ブロックエディターの編集時、投稿を編集しているユーザーの言語が優先され、それをどうやって取得するかを「ChatGPT」に聞いてみたのだが。。。

プラグインで注意が必要な関数（2013年11月27日 更新）

先日「Login rebuilder」という自作プラグインをアップデートした際、ユーザーさんからエラーになると連絡をいただいた。標準環境では問題なく、どうやら何らかのプラグインが影響しているらしい。

ショートコードを使ってテーマ内の画像URLを簡単に指定する（2018年5月27日 更新）

投稿記事の中で画像パーツを使いたいときがある。画像パーツの配置場所は、/imgディレクトリのようなテーマ外の場合と、/wp-content/themes/mytheme/imagesディレクトリのようなテーマ内の場合があり、今回は後者のケース。ショートコードを使って投稿記事の画像ファイルのURLを記述する方法を紹介したい。

カスタム投稿タイプの投稿保存には専用アクションを使おう（2014年7月4日 更新）

カスタム投稿タイプを登録して、専用ウィジェット（meta_box）を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。