PHP: file_put_contentsとphp://inputの詳細解説

file_put_contentsの基本的な使い方

PHPのfile_put_contents関数は、データをファイルに書き込むための便利な関数です。以下にその基本的な使い方を示します。

<?php
$file = 'example.txt';
$data = 'Hello, World!';

// ファイルにデータを書き込む
file_put_contents($file, $data);
?>

上記のコードでは、$fileに指定したファイル（この場合はexample.txt）に$dataの内容（この場合はHello, World!）が書き込まれます。

file_put_contents関数は、ファイルが存在しない場合は新しく作成します。また、ファイルが既に存在する場合は、その内容を上書きします。

なお、追記モードでデータを書き込みたい場合は、第3引数にFILE_APPENDを指定します。

<?php
$file = 'example.txt';
$data = 'Hello, PHP!';

// ファイルにデータを追記する
file_put_contents($file, $data, FILE_APPEND);
?>

このコードを実行すると、example.txtの既存の内容の後にHello, PHP!が追記されます。これがfile_put_contents関数の基本的な使い方です。次に、php://inputについて解説します。

php://inputは、PHPが提供する特殊なストリームラッパーの一つです。これは、HTTPリクエストの生のデータを読み取るために使用されます。具体的には、POSTリクエストのボディ部分を直接読み取ることができます。

以下にその基本的な使い方を示します。

<?php
// HTTPリクエストの生のデータを取得する
$data = file_get_contents('php://input');
?>

上記のコードでは、file_get_contents関数を使用してphp://inputからデータを読み取り、それを$dataに格納しています。

php://inputは、$_POSTや$_GETなどのスーパーグローバル変数とは異なり、データを処理せずにそのままの形で提供します。そのため、JSONやXMLなどの形式で送信されたデータを受け取る場合に便利です。

ただし、php://inputはリクエストデータを一度しか読み取ることができない点に注意が必要です。また、enctype="multipart/form-data"のPOSTリクエストには使用できません。

以上がphp://inputの基本的な説明です。次に、file_put_contentsとphp://inputの組み合わせについて解説します。

file_put_contentsとphp://inputを組み合わせることで、HTTPリクエストの生のデータを直接ファイルに書き込むことができます。これは、大量のデータを効率的に処理する場合や、特定の形式（例えば、JSONやXML）のデータをそのまま保存したい場合に便利です。

以下にその基本的な使い方を示します。

<?php
$file = 'request_data.txt';

// HTTPリクエストの生のデータを取得し、ファイルに書き込む
file_put_contents($file, file_get_contents('php://input'));
?>

上記のコードでは、file_get_contents('php://input')でHTTPリクエストの生のデータを取得し、それをfile_put_contents関数で$fileに指定したファイル（この場合はrequest_data.txt）に書き込んでいます。

このように、file_put_contentsとphp://inputを組み合わせることで、HTTPリクエストのデータを直接ファイルに保存することができます。これは、APIの開発やデータのロギングなど、様々なシーンで活用できるテクニックです。