PHP基本教程

PHP高級教程

PHP & MySQL

PHPリファレンスマニュアル

PHP file_put_contents() 関数の使用法と例

file_put_contents()関数は、文字列をファイルに書き込むことができます。

構文

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ] ] )

この関数がファイルにアクセスする際には、以下のルールに従います：

FILE_USE_INCLUDE_PATHが設定されている場合、チェックします *filename* インクルードパスの内蔵パス
ファイルが存在しない場合、ファイルを作成します
ファイルを開きます
LOCK_EXが設定されている場合、ファイルをロックします
FILE_APPENDが設定されている場合、ファイルの最後に移動します。そうでない場合、ファイルの内容をクリアします
ファイルにデータを書き込みます
ファイルを閉じ、すべてのファイルをロック解除します

成功した場合、この関数はファイルに書き込んだ文字数を返します。失敗した場合、falseを返します。

パラメータ

パラメータ	説明
file	必須。書き込むデータのファイルを指定します。ファイルが存在しない場合、新しいファイルを作成します。
data	必須。書き込むデータを指定します。文字列、配列、データストリームができます。
mode	オプション。開き方を指定します/ファイルに書き込みます。可能な値： FILE_USE_INCLUDE_PATH FILE_APPEND LOCK_EX
context	オプション。ファイルハンドルの環境を指定します。contextは、ストリームの動作を変更できるオプションのセットです。

例1

sample.txtファイルに内容を書き込みます

例

<?php
　　　echo file_put_contents("sample.txt", "Hello World!");
?>

出力結果

例2

FILE_APPEND方式を使用して内容を追加し、ファイルに既に存在する内容を削除しないようにします。

例

<?php
　　　$file = "sample.txt";
　　　//ファイルに追加する新しいユーザー
　　　$test = "　w3codebox";
　　　//FILE_APPENDフラグを使用して、ファイルの末尾に内容を追加します
　　　//およびLOCK_EXフラグを使用して、他の人が同時にファイルに書き込むのを防ぎます
　　　file_put_contents($file, $test, FILE_APPEND | LOCK_EX);
　　　echo "内容を成功にファイルに追加して書き込んだ.";
?>

出力結果

内容を成功にファイルに追加して書き込んだ。

PHP Filesystem 参考手冊

PHP CURL 函数 PHP OpenSSL 函数