fopen

関数の概要

PHPの fopen 関数は、ファイルやURLを開くための基本的な関数です。ファイルの読み込み、書き込み、追記などさまざまな操作を行うために使われ、ファイルポインタを返します。このポインタを使ってファイルの内容を読み書きできます。

パラメータの説明

  • filename (必須)：開きたいファイルやURLのパスを文字列で指定します。
  • mode (必須)：ファイルを開くモードを文字列で指定します。例: “r”（読み込み用）、”w”（書き込み用）など。
  • use_include_path (任意)：include_pathを検索するかどうかを指定するブール値。省略可能でデフォルトは false です。
  • context (任意)：ストリームコンテキストを指定するリソース。通常は省略します。

戻り値

成功した場合はファイルポインタリソースを返します。失敗した場合は false を返します。ファイルが正しく開けたかどうかを事前に確認することが重要です。

使用例

基本的な使い方（読み込みモード）

<?php
$fp = fopen("example.txt", "r");
if ($fp) {
    while (($line = fgets($fp)) !== false) {
        echo $line . "<br>";
    }
    fclose($fp);
} else {
    echo "ファイルを開けませんでした。";
}
?>

この例では、テキストファイルを読み込みモードで開き、1行ずつ表示しています。ファイルが開けなかった場合はエラーメッセージを表示します。

ファイルを書き込みモードで開く

<?php
$fp = fopen("output.txt", "w");
if ($fp) {
    fwrite($fp, "Hello, world!n");
    fclose($fp);
    echo "書き込みが成功しました。";
} else {
    echo "ファイルを開けませんでした。";
}
?>

こちらはファイルを書き込みモードで開き、文字列を書き込んでいます。モード「w」はファイルの内容を上書きします。

追記モードでファイルを開く

<?php
$fp = fopen("log.txt", "a");
if ($fp) {
    fwrite($fp, date("Y-m-d H:i:s") . " ログ追加n");
    fclose($fp);
    echo "ログを追記しました。";
} else {
    echo "ファイルを開けませんでした。";
}
?>

この例ではファイルを追記モード（”a”）で開き、日時付きのログをファイルの末尾に追加しています。

関連する関数

  • fclose – 開いたファイルポインタを閉じる
  • fread – ファイルから指定したバイト数を読み込む
  • fwrite – ファイルに書き込む
  • file_get_contents – ファイル全体を簡単に読み込む
  • file_put_contents – ファイルに簡単に書き込む

まとめ

fopen はPHPでファイルやURLを開くための基本的かつ重要な関数です。モードを適切に指定することで、読み込み、書き込み、追記など多様な操作が可能になります。ファイル操作においては、必ずファイルが開けたかを確認してから処理を行うことが安全です。また、多くの関連関数と組み合わせて使うことで、効率的にファイル操作を実装できます。

スポンサーリンク