PHP file_put_contents()関数
定義と使用法
file_put_contents()関数は、文字列をファイルに書き込みます.
fopen(),fwrite()およびfclose()を順次呼び出す機能と同様です.
構文
パラメータ
説明
file
必要です.データを書き込むファイルを指定します.ファイルが存在しない場合は、新しいファイルを作成します.
data
オプション.ファイルに書き込むデータを指定します.文字列、配列、またはデータ・ストリームです.
mode
オプション.ファイルを開く/書き込む方法を指定します.可能な値: FILE_USE_INCLUDE_PATH FILE_APPEND LOCK_EX
context
オプション.ファイルハンドルの環境を指定します.contextは、ストリームの動作を変更できるオプションです.nullを使用すると無視されます.
説明
パラメータdataは配列であってもよい(ただし多次元配列ではない).
PHP 5.1より.0からdataパラメータをstreamリソースとして指定することもでき、streamに保存されているキャッシュデータが指定ファイルに書き込まれ、stream_を使用するのと似ています.copy_to_stream()関数.
contextパラメータのサポートはPHP 5.0である.0が追加されました.
戻り値
この関数は、ファイルに書き込まれたデータのバイト数を返します.
ヒントとコメント
ヒント:FILE_の使用APPENDは、ファイル内の既存のコンテンツの削除を回避します.
注記:この関数は、バイナリ・オブジェクトで安全に使用できます.
例
出力:
file_put_contents()関数は、文字列をファイルに書き込みます.
fopen(),fwrite()およびfclose()を順次呼び出す機能と同様です.
構文
file_put_contents(file,data,mode,context)
パラメータ
説明
file
必要です.データを書き込むファイルを指定します.ファイルが存在しない場合は、新しいファイルを作成します.
data
オプション.ファイルに書き込むデータを指定します.文字列、配列、またはデータ・ストリームです.
mode
オプション.ファイルを開く/書き込む方法を指定します.可能な値:
context
オプション.ファイルハンドルの環境を指定します.contextは、ストリームの動作を変更できるオプションです.nullを使用すると無視されます.
説明
パラメータdataは配列であってもよい(ただし多次元配列ではない).
PHP 5.1より.0からdataパラメータをstreamリソースとして指定することもでき、streamに保存されているキャッシュデータが指定ファイルに書き込まれ、stream_を使用するのと似ています.copy_to_stream()関数.
contextパラメータのサポートはPHP 5.0である.0が追加されました.
戻り値
この関数は、ファイルに書き込まれたデータのバイト数を返します.
ヒントとコメント
ヒント:FILE_の使用APPENDは、ファイル内の既存のコンテンツの削除を回避します.
注記:この関数は、バイナリ・オブジェクトで安全に使用できます.
例
<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>
出力:
26