fclose

関数の概要

PHPの fclose 関数は、ファイルポインタリソースを閉じるために使用されます。ファイルを開いた後、処理が終わったら必ず閉じることで、リソースの解放やデータの保存を確実に行うことができます。ファイル操作において最も基本的かつ重要な関数の一つです。

パラメータの説明

  • resource $stream
    閉じたいファイルのポインタリソース。通常は fopen 関数で取得したファイルハンドルを渡します。

戻り値

fclose は、正常にファイルを閉じられた場合に TRUE を返します。何らかの理由でファイルを閉じられなかった場合は FALSE を返します。

使用例

基本的な使い方

<?php
$fp = fopen('example.txt', 'r');
if ($fp) {
    // ファイルの読み込みなどの処理
    fclose($fp);
}
?>

ファイルを読み込みモードで開き、処理が終わったあとに fclose で閉じています。開いたファイルは必ず閉じることが推奨されます。

書き込み後にファイルを閉じる

<?php
$fp = fopen('write.txt', 'w');
if ($fp) {
    fwrite($fp, "こんにちは、世界!");
    fclose($fp);
}
?>

ファイルに文字列を書き込んだ後に、fcloseで確実にファイルを閉じる例です。これにより書き込み内容が保存されます。

エラーハンドリングを含む例

<?php
$fp = fopen('data.txt', 'r');
if (!$fp) {
    echo "ファイルを開けませんでした。";
} else {
    // 読み込み処理
    fclose($fp);
}
?>

ファイルが正常に開けなかった場合のエラーメッセージ表示も加えた例です。fcloseはファイルが開けた場合だけ呼び出します。

関連する関数

  • fopen:ファイルを開く
  • fread:ファイルからデータを読み込む
  • fwrite:ファイルにデータを書き込む
  • feof:ファイルポインタがファイル終端に達したかどうか調べる

まとめ

fclose はPHPでファイル操作を行う際に必須の関数で、開いたファイルを閉じることでリソース解放やデータ保存を保証します。ファイル操作後は必ず呼び出し、安定したプログラムの動作を実現しましょう。