【PHP8.x】BadFunctionCallException::fileプロパティの使い方

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 指定されたパスにファイルが存在するかどうかを確認し、結果を表示します。
7 *
8 * この関数は、PHPの組み込み関数 `file_exists()` を使用して、
9 * ファイルの存在チェックを行う基本的な方法を示します。
10 *
11 * @param string $filePath 確認したいファイルのパス
12 * @return void
13 */
14function checkFile(string $filePath): void
15{
16    // file_exists() は、ファイルまたはディレクトリが存在する場合に true を返します。
17    if (file_exists($filePath)) {
18        echo "✅ ファイルが見つかりました: " . $filePath . PHP_EOL;
19    } else {
20        echo "❌ ファイルが見つかりませんでした: " . $filePath . PHP_EOL;
21    }
22}
23
24// --- メイン処理 ---
25
26// このサンプルコードと同じディレクトリに、テスト用のファイルを作成します。
27$existingFilePath = __DIR__ . '/sample.txt';
28file_put_contents($existingFilePath, 'これはテスト用のファイルです。');
29
30// 存在しないファイルのパスを定義します。
31$nonExistentFilePath = __DIR__ . '/not_found.txt';
32
33// 存在するファイルのパスを指定して関数を呼び出します。
34checkFile($existingFilePath);
35
36// 存在しないファイルのパスを指定して関数を呼び出します。
37checkFile($nonExistentFilePath);
38
39// 後片付けとして、作成したテスト用のファイルを削除します。
40unlink($existingFilePath);
41

このPHPサンプルコードは、指定されたパスにファイルが存在するかどうかを確認するfile_exists()関数の使い方を示しています。この関数は、プログラムでファイルを読み書きする前に、対象のファイルが実際に存在するかを確かめるために広く使われます。

file_exists()関数は、引数として確認したいファイルのパスを文字列で受け取ります。そして、そのパスにファイルまたはディレクトリが存在する場合はtrueを、存在しない場合はfalseを戻り値として返します。

サンプルコード内のcheckFile関数では、このfile_exists()からの戻り値を利用し、if文で処理を分岐させています。戻り値がtrueであれば「ファイルが見つかりました」と表示し、falseであれば「ファイルが見つかりませんでした」と表示します。メイン処理では、実際に存在するファイルと存在しないファイルの2つのパターンで関数を呼び出し、それぞれの結果を確認できるようになっています。このようにfile_exists()を使うことで、存在しないファイルへのアクセスを試みてエラーが発生することを未然に防ぐことができます。

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * file_get_contents() の基本的な使い方とエラーハンドリングを示す関数
7 *
8 * この関数は、ファイル読み込みの成功例と失敗例の両方を実演します。
9 * 成功例では、一時ファイルを作成し、その内容を読み込んで表示します。
10 * 失敗例では、存在しないファイルを読み込もうとし、エラー処理を行います。
11 */
12function demonstrateFileGetContents(): void
13{
14    // --- 1. ファイル読み込みが成功するケース ---
15    $fileName = 'sample.txt';
16    $content = 'こんにちは、PHP!';
17
18    // サンプル用のファイルを作成し、内容を書き込みます
19    // file_put_contents() は、書き込みに失敗すると false を返します
20    if (file_put_contents($fileName, $content) !== false) {
21        echo "ファイル '{$fileName}' を作成しました。\n";
22
23        // file_get_contents() でファイルの内容を文字列として読み込みます
24        // 成功した場合はファイルの内容 (string)、失敗した場合は false が返されます
25        $readContent = file_get_contents($fileName);
26
27        // 戻り値が false でないことを厳密にチェックします (=== or !==)
28        if ($readContent !== false) {
29            echo "読み込み成功: {$readContent}\n";
30        } else {
31            echo "エラー: ファイル '{$fileName}' の読み込みに失敗しました。\n";
32        }
33
34        // 後処理として、作成したファイルを削除します
35        unlink($fileName);
36        echo "ファイル '{$fileName}' を削除しました。\n";
37    } else {
38        echo "エラー: ファイル '{$fileName}' の作成に失敗しました。\n";
39    }
40
41    echo "\n"; // 見やすくするための改行
42
43    // --- 2. 存在しないファイルで失敗するケース ---
44    $nonExistentFile = 'non_existent_file.txt';
45    echo "存在しないファイル '{$nonExistentFile}' の読み込みを試みます。\n";
46
47    // 存在しないファイルを読み込もうとすると、false が返され、E_WARNING が発生します
48    // エラー出力を抑制したい場合は @file_get_contents(...) と書けますが、推奨されません
49    $readContent = file_get_contents($nonExistentFile);
50
51    if ($readContent === false) {
52        echo "読み込み失敗: ファイルが見つからないか、読み込み権限がありません。\n";
53    }
54}
55
56// 作成した関数を実行します
57demonstrateFileGetContents();
58

file_get_contents()関数は、指定したファイルの内容をすべて文字列として一度に読み込むための、PHPでよく使われる基本的な関数です。引数には、読み込みたいファイルのパスを文字列で指定します。

サンプルコードでは、まず成功するケースとしてfile_put_contents()関数で「sample.txt」というファイルを作成し、その内容をfile_get_contents()で読み込んでいます。処理が成功した場合、戻り値としてファイルの内容が文字列型で返されます。この例では「こんにちは、PHP!」という文字列が取得され、画面に出力されています。

一方で、存在しないファイルを読み込もうとする失敗ケースも示されています。このようにファイルの読み込みに失敗した場合、この関数は戻り値としてfalseを返します。そのため、この関数を利用する際は、戻り値がfalseかどうかを厳密な比較演算子（===や!==）を使って必ず確認し、エラーに応じた処理を行うことが非常に重要です。このサンプルコードは、こうした成功例と失敗例の両方において、処理が成功したかどうかを正しく判断する方法を示しています。