説明
mixed wp_remote_post( string $url [ , array $args = array() ] )
POSTメソッドを送信する。
パラメータ
- $urlリクエスト先URLを指定。
- $argsパラメータを連想配列で指定（省略時はarray()）。連想配列の要素は次の通り。
キー名 内容 省略時の値 'method' メソッド種別 'POST' '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_request関数と同じだが、パラメータ$argsの'method'を省略した場合は'POST'が適用される点が異なる。POST送信するクエリは、パラメータ$argsの'body'の値として連想配列（またはオブジェクト）で指定する。
※このクエリの展開は、'method'値が'POST'か'PUT'の場合のみ行われる。
使用例
- 'http://localhost/'にPOSTメソッドを送信する。
<?php $options = array( 'body' => array( 'query_name'=>'query_value' ) ); $response = wp_remote_post( 'http://localhost/', $options ); ?>
フィルター
直接実行するフィルターはありません。アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/http.php最終更新 : 2017年05月23日 16:20
関連
お勧め
ショートコードを使ってテーマ内の画像URLを簡単に指定する（2018年5月27日 更新）
投稿記事の中で画像パーツを使いたいときがある。画像パーツの配置場所は、/imgディレクトリのようなテーマ外の場合と、/wp-content/themes/mytheme/imagesディレクトリのようなテーマ内の場合があり、今回は後者のケース。ショートコードを使って投稿記事の画像ファイルのURLを記述する方法を紹介したい。リクエスト応答を終了する前に何かを処理する（2013年9月26日 更新）
PHPでは、register_shutdown_function関数を使うことでリクエストに対してレスポンスを返した後に何らかの処理を行うことができる。WordPressでもregister_shutdown_function関数は使えると思うのだが、テーマ内のテンプレートでページを表示した後で何かを行う場合はどうすればいいのか、ちょっと調べてみた。
投稿情報を連想配列で参照する（2018年5月27日 更新）
投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。
段落ブロックに日付・時刻の入力支援を実装した（2023年1月25日 更新）
ブロックエディターには文字入力を支援するAutocompleteがある。自作ブロックだけでなく既存のブロックに適用できるため、ブロックの利用シーンを踏まえた入力支援機能を追加できる。
ブロックエディターのタグ入力にタグクラウド機能を追加した（2019年1月10日 更新）
ブロックエディターのタグ入力には「よく使われているタグから選択」から表示される「タグクラウド」がない。ブロックエディターの不満なところのひとつがこれであり、うまく解消することができないか考えてみた。