PHP HTTP POSTリクエストの基本と実装方法を解説

<?php
// cURLセッションを初期化
$curl = curl_init();
// 結果を文字列で取得する設定
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// 出力結果はありません。

<?php
// APIエンドポイントの指定
curl_setopt($curl, CURLOPT_URL, 'https://api.example.com/endpoint');

// 出力結果はありません。

<?php
// POSTデータの配列を用意
$postData = array(
    'username' => 'ユーザー名',
    'password' => 'パスワード'
);
// 連想配列をURLエンコードされた文字列に変換
$postFields = http_build_query($postData);
echo $postFields; // 出力例として結果を確認

username=%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E5%90%8D&password=%E3%83%91%E3%82%B9%E3%83%AF%E3%83%BC%E3%83%89

<?php
// POST用の配列データ
$dataArray = array(
    'key'   => '値',
    'count' => 123
);
// JSON形式に変換
$jsonData = json_encode($dataArray);
echo $jsonData; // JSON文字列の確認

{"key":"値","count":123}

<?php
// リクエストを実行しレスポンスを取得
$response = curl_exec($curl);
// レスポンスの確認
if ($response !== false) {
    echo 'レスポンス: ' . $response;
} else {
    echo 'レスポンスの取得に失敗';
}

レスポンス: (APIからの返答内容)

<?php
// リクエスト実行後のエラー処理
$response = curl_exec($curl);
if ($response === false) {
    $errorMessage = 'cURLエラー: ' . curl_error($curl);
    echo $errorMessage;
    // 必要に応じて、エラーログの記録などを実施
} else {
    echo 'レスポンス: ' . $response;
}

cURLエラー: (エラー内容が表示されます)

<?php
// POSTデータの配列
$data = array(
    'username' => 'ユーザー名',
    'password' => 'パスワード'
);
// URLエンコードされた文字列に変換
$postData = http_build_query($data);
// HTTPコンテキストの設定
$options = array(
    'http' => array(
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $postData
    )
);
$context = stream_context_create($options);

// 出力結果はありません。

<?php
// JSON形式のデータ作成例
$dataArray = array(
    'key'   => '値',
    'count' => 123
);
$jsonData = json_encode($dataArray);
// JSON形式の場合のHTTPコンテキスト設定
$optionsJson = array(
    'http' => array(
        'method'  => 'POST',
        'header'  => "Content-Type: application/json\r\n",
        'content' => $jsonData
    )
);
$contextJson = stream_context_create($optionsJson);

// 出力結果はありません。

<?php
// 送信先のURL
$url = 'https://api.example.com/endpoint';
// POSTリクエストの送信とレスポンスの受信
$response = file_get_contents($url, false, $context);
echo $response;

(APIからの返答内容)

<?php
if ($response === false) {
    echo 'リクエストの送信に失敗しました。';
} else {
    echo '受信データ: ' . $response;
}

受信データ: (APIからの返答内容)

<?php
// HTTP POSTリクエスト送信用の関数
function sendHttpPost($url, $data) {
    // POSTデータをURLエンコード
    $postFields = http_build_query($data);
    // HTTPコンテキストの設定
    $options = array(
        'http' => array(
            'method'  => 'POST',
            'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
            'content' => $postFields
        )
    );
    $context = stream_context_create($options);
    // file_get_contentsでPOSTリクエストを送信
    $result = file_get_contents($url, false, $context);
    return $result;
}
// サンプルデータとエンドポイント
$dataArray = array('key' => 'value');
$result = sendHttpPost('https://api.example.com/endpoint', $dataArray);
echo $result;

(APIからの返答内容)

<?php
// cURLリクエスト実行
$response = curl_exec($curl);
if ($response === false) {
    $errorMessage = 'cURLエラー: ' . curl_error($curl);
    // エラー内容をログに出力
    error_log($errorMessage);
    echo '通信中にエラーが発生しました。';
} else {
    echo 'レスポンス: ' . $response;
}

通信中にエラーが発生しました。

<?php
// ユーザーからのPOST入力をサニタイズして取得
$userInput = filter_input(INPUT_POST, 'username', FILTER_SANITIZE_STRING);
if (empty($userInput)) {
    echo '適切な入力が行われていません。';
} else {
    echo 'ユーザー入力: ' . $userInput;
}

ユーザー入力: (サニタイズされた入力値)