PHPで例外処理を使った安全なファイル操作の実践方法

try {
    // エラーが発生する可能性のあるコード
} catch (Exception $e) {
    // エラーが発生した際の処理
    echo 'エラーが発生しました: ' . $e->getMessage();
}

try {
    $filePath = 'path/to/file.txt';

    if (!file_exists($filePath)) {
        throw new Exception('ファイルが見つかりません: ' . $filePath);
    }

    $fileContents = file_get_contents($filePath);
    echo 'ファイルの内容: ' . $fileContents;

} catch (Exception $e) {
    echo 'エラーが発生しました: ' . $e->getMessage();
}

try {
    $filePath = 'path/to/file.txt';

    if (!file_exists($filePath)) {
        throw new RuntimeException('ファイルが見つかりません: ' . $filePath);
    }

    if (!is_readable($filePath)) {
        throw new RuntimeException('ファイルを読み込む権限がありません: ' . $filePath);
    }

    $fileContents = file_get_contents($filePath);
    echo 'ファイルの内容: ' . $fileContents;

} catch (RuntimeException $e) {
    echo 'エラー: ' . $e->getMessage();
} catch (Exception $e) {
    echo '予期しないエラーが発生しました: ' . $e->getMessage();
}

function readFileSafely($filePath) {
    try {
        // ファイルが存在するかチェック
        if (!file_exists($filePath)) {
            throw new RuntimeException('ファイルが見つかりません: ' . $filePath);
        }

        // ファイルの読み取り権限を確認
        if (!is_readable($filePath)) {
            throw new RuntimeException('ファイルを読み込む権限がありません: ' . $filePath);
        }

        // ファイルの内容を読み込む
        $fileContents = file_get_contents($filePath);
        if ($fileContents === false) {
            throw new RuntimeException('ファイルの読み込みに失敗しました: ' . $filePath);
        }

        // 読み込んだ内容を返す
        return $fileContents;

    } catch (RuntimeException $e) {
        // エラー発生時の処理
        echo 'エラーが発生しました: ' . $e->getMessage();
        return null;
    }
}

// ファイル読み込みの実行例
$filePath = 'path/to/file.txt';
$content = readFileSafely($filePath);
if ($content !== null) {
    echo 'ファイルの内容: ' . $content;
}

function writeFileSafely($filePath, $data) {
    try {
        // ファイルが存在し、書き込み可能かチェック
        if (file_exists($filePath) && !is_writable($filePath)) {
            throw new RuntimeException('ファイルに書き込む権限がありません: ' . $filePath);
        }

        // ファイルを開く（新規作成または上書きモード）
        $fileHandle = fopen($filePath, 'w');
        if ($fileHandle === false) {
            throw new RuntimeException('ファイルを開くことができません: ' . $filePath);
        }

        // 書き込み処理
        if (fwrite($fileHandle, $data) === false) {
            throw new RuntimeException('ファイルへの書き込みに失敗しました: ' . $filePath);
        }

        // ファイルを閉じる
        fclose($fileHandle);

        // 書き込み成功メッセージを返す
        return 'ファイルの書き込みが成功しました。';

    } catch (RuntimeException $e) {
        // エラー発生時の処理
        echo 'エラーが発生しました: ' . $e->getMessage();
        return null;
    }
}

// ファイル書き込みの実行例
$filePath = 'path/to/output.txt';
$data = "このファイルに書き込みます。";
$result = writeFileSafely($filePath, $data);
if ($result !== null) {
    echo $result;
}

function writeFileWithLock($filePath, $data) {
    try {
        $fileHandle = fopen($filePath, 'w');
        if ($fileHandle === false) {
            throw new RuntimeException('ファイルを開くことができません: ' . $filePath);
        }

        // ファイルロックを取得
        if (!flock($fileHandle, LOCK_EX)) {
            throw new RuntimeException('ファイルロックの取得に失敗しました: ' . $filePath);
        }

        // データの書き込み
        if (fwrite($fileHandle, $data) === false) {
            throw new RuntimeException('ファイルへの書き込みに失敗しました: ' . $filePath);
        }

        // ロックの解除
        flock($fileHandle, LOCK_UN);
        fclose($fileHandle);

        return 'ファイルの書き込みが成功しました。';

    } catch (RuntimeException $e) {
        echo 'エラーが発生しました: ' . $e->getMessage();
        return null;
    }
}

// カスタム例外クラスの定義
class FileException extends Exception {
    // カスタムのエラーメッセージを返す
    public function errorMessage() {
        return 'ファイルエラー: ' . $this->getMessage();
    }
}

class FileNotFoundException extends FileException {
    public function errorMessage() {
        return 'ファイルが見つかりません: ' . $this->getMessage();
    }
}

class FilePermissionException extends FileException {
    public function errorMessage() {
        return 'ファイルのアクセス権限が不足しています: ' . $this->getMessage();
    }
}

function readFileWithCustomException($filePath) {
    try {
        // ファイルが存在するかチェック
        if (!file_exists($filePath)) {
            throw new FileNotFoundException($filePath);
        }

        // 読み取り権限があるかチェック
        if (!is_readable($filePath)) {
            throw new FilePermissionException($filePath);
        }

        // ファイルの内容を読み込む
        $fileContents = file_get_contents($filePath);
        if ($fileContents === false) {
            throw new FileException('ファイルの読み込みに失敗しました: ' . $filePath);
        }

        // 読み込んだ内容を返す
        return $fileContents;

    } catch (FileNotFoundException $e) {
        echo $e->errorMessage();
        return null;
    } catch (FilePermissionException $e) {
        echo $e->errorMessage();
        return null;
    } catch (FileException $e) {
        echo $e->errorMessage();
        return null;
    }
}

// カスタム例外を使ったファイル読み込みの実行例
$filePath = 'path/to/file.txt';
$content = readFileWithCustomException($filePath);
if ($content !== null) {
    echo 'ファイルの内容: ' . $content;
}

function writeFileWithLockHandling($filePath, $data) {
    try {
        // ファイルを開く（新規作成または上書きモード）
        $fileHandle = fopen($filePath, 'w');
        if ($fileHandle === false) {
            throw new RuntimeException('ファイルを開くことができません: ' . $filePath);
        }

        // ファイルロックを取得（排他ロック）
        if (!flock($fileHandle, LOCK_EX)) {
            throw new RuntimeException('ファイルロックの取得に失敗しました: ' . $filePath);
        }

        // データの書き込み
        if (fwrite($fileHandle, $data) === false) {
            throw new RuntimeException('ファイルへの書き込みに失敗しました: ' . $filePath);
        }

        // ロックの解除
        flock($fileHandle, LOCK_UN);
        fclose($fileHandle);

        return 'ファイルの書き込みが成功しました。';

    } catch (RuntimeException $e) {
        // エラーが発生した場合の処理
        echo 'エラーが発生しました: ' . $e->getMessage();
        return null;
    }
}

// ファイル書き込みの実行例
$filePath = 'path/to/output.txt';
$data = "このファイルに書き込みます。";
$result = writeFileWithLockHandling($filePath, $data);
if ($result !== null) {
    echo $result;
}

function uploadFileSafely($file, $uploadDir) {
    try {
        // 1. ファイルがアップロードされているかチェック
        if (!isset($file) || $file['error'] !== UPLOAD_ERR_OK) {
            throw new RuntimeException('ファイルのアップロードに失敗しました。');
        }

        // 2. ファイルサイズの確認（例: 2MB以下）
        if ($file['size'] > 2 * 1024 * 1024) {
            throw new RuntimeException('ファイルサイズが大きすぎます。');
        }

        // 3. ファイルのMIMEタイプを検証（例: 画像ファイルのみ許可）
        $finfo = new finfo(FILEINFO_MIME_TYPE);
        $validTypes = ['image/jpeg' => 'jpg', 'image/png' => 'png', 'image/gif' => 'gif'];
        $fileType = $finfo->file($file['tmp_name']);
        if (!array_key_exists($fileType, $validTypes)) {
            throw new RuntimeException('無効なファイル形式です。');
        }

        // 4. ファイル名のサニタイズ
        $safeFileName = basename($file['name']);
        $safeFileName = preg_replace('/[^a-zA-Z0-9_\.-]/', '_', $safeFileName);

        // 5. アップロード先ディレクトリへの書き込み権限を確認
        if (!is_writable($uploadDir)) {
            throw new RuntimeException('アップロード先のディレクトリに書き込む権限がありません。');
        }

        // 6. ファイルを移動する
        $destination = $uploadDir . '/' . $safeFileName;
        if (!move_uploaded_file($file['tmp_name'], $destination)) {
            throw new RuntimeException('ファイルの移動に失敗しました。');
        }

        // アップロード成功メッセージを返す
        return 'ファイルのアップロードに成功しました: ' . $safeFileName;

    } catch (RuntimeException $e) {
        // エラーが発生した場合の処理
        echo 'エラーが発生しました: ' . $e->getMessage();
        return null;
    }
}

// ファイルアップロードの実行例
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['userfile'])) {
    $uploadDir = 'uploads';
    $result = uploadFileSafely($_FILES['userfile'], $uploadDir);
    if ($result !== null) {
        echo $result;
    }
}

function logError($message) {
    error_log($message, 3, '/path/to/error.log');
}

try {
    // エラーを引き起こす可能性のあるコード
} catch (Exception $e) {
    logError('エラー発生: ' . $e->getMessage());
    echo '問題が発生しました。管理者に連絡してください。';
}

// 開発環境
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

// 本番環境
ini_set('display_errors', 0);
error_reporting(E_ALL);

try {
    // ファイルAの処理
    // ファイルBの処理
    // どれかが失敗したら例外をスロー
} catch (Exception $e) {
    // ロールバック処理
    echo 'エラーが発生しました。処理を元に戻します。';
}

function logExceptionToFile($exception) {
    $logMessage = sprintf(
        "[%s] エラーが発生しました: %s in %s on line %d\n",
        date('Y-m-d H:i:s'),
        $exception->getMessage(),
        $exception->getFile(),
        $exception->getLine()
    );
    error_log($logMessage, 3, '/path/to/error.log');
}

try {
    // エラーが発生する可能性のある処理
    throw new Exception('テスト例外が発生しました');
} catch (Exception $e) {
    // 例外をログに記録
    logExceptionToFile($e);
    echo 'エラーが発生しました。ログを確認してください。';
}

function logErrorByLevel($message, $level) {
    $logFile = '/path/to/' . $level . '.log';
    $logMessage = sprintf(
        "[%s] %s: %s\n",
        date('Y-m-d H:i:s'),
        strtoupper($level),
        $message
    );
    error_log($logMessage, 3, $logFile);
}

// 使用例
try {
    // 例外を投げる
    throw new RuntimeException('重大なエラーが発生しました');
} catch (RuntimeException $e) {
    logErrorByLevel($e->getMessage(), 'critical');
    echo '重大なエラーが発生しました。サポートに連絡してください。';
}

function notifyAdminOnCriticalError($exception) {
    $subject = '重大なエラー通知';
    $message = sprintf(
        "重大なエラーが発生しました:\n\nメッセージ: %s\nファイル: %s\n行: %d",
        $exception->getMessage(),
        $exception->getFile(),
        $exception->getLine()
    );
    $headers = 'From: no-reply@example.com';

    // 管理者にメール送信
    mail('admin@example.com', $subject, $message, $headers);
}

try {
    // 重大なエラーを発生させる
    throw new Exception('重大なシステム障害が発生しました');
} catch (Exception $e) {
    // エラーログに記録し、管理者に通知
    logExceptionToFile($e);
    notifyAdminOnCriticalError($e);
    echo '重大なエラーが発生しました。管理者に連絡されました。';
}