(2.7.0以降)
wp_remote_post - POSTメソッドを送信する

説明

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オブジェクトを返す。連想配列は次の通り。

注意

基本的には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

関連

• WP_Error - WordPress関数のエラー内容
• wp_remote_get - GETメソッドを送信する
• wp_remote_request - HTTPリクエストを送信する
• wp_remote_retrieve_body - wp_remote系関数で取得したレスポンスデータのボディ部を取得する
• wp_remote_retrieve_response_code - wp_remote系関数のレスポンスコードを取得する

お勧めコンテンツ