【サクッと解説】PHPでのファイル存在確認と安全な削除処理

2025年8月4日

1. 本記事のポイント

PHPでファイルの存在を安全に確認する方法を解説
実務で使われるファイル削除処理とその注意点を紹介
削除処理におけるエラーハンドリングやパーミッション問題にも触れる

2. PHPにおけるファイルの存在チェックと削除処理とは？

PHPでは、ローカルファイルの存在確認や削除といった基本的なファイル操作を標準関数で行えます。

file_exists() は指定されたパスにファイルまたはディレクトリが存在するかを確認でき、unlink() はファイルを削除する関数です。これらはファイルアップロード後の一時ファイル処理、キャッシュファイルのクリア、不要ログの削除など、日常的なバックエンド開発で多用されます。

特にWebアプリでは、ユーザー操作や自動スクリプトによってファイルの存在が不確定な場合も多く、安全な存在チェックと例外への対処が求められます。

また、これらの関数はパーミッションやファイルロック状態に依存するため、設計時には事前条件や例外発生時のロールバックなども考慮する必要があります。

3. 詳細解説

ファイルの存在を確認する: `file_exists()`

まず、指定したファイルが存在するかを確認する基本的な処理です。

PHP

$file = 'data/sample.txt';

// ファイルの存在を確認
if (file_exists($file)) {
    echo "ファイルは存在します\n";
} else {
    echo "ファイルが存在しません\n";
}

$file = 'data/sample.txt';

// ファイルの存在を確認
if (file_exists($file)) {
    echo "ファイルは存在します\n";
} else {
    echo "ファイルが存在しません\n";
}

この関数はファイルだけでなくディレクトリの存在も確認可能です。ただし、シンボリックリンク先が切れている場合でも true を返す点に注意が必要です。

ファイルを削除する: `unlink()`

ファイルの存在を確認した上で削除する安全な方法です。

PHP

$file = 'data/sample.txt';

if (file_exists($file)) {
    if (unlink($file)) {
        echo "ファイルを削除しました\n";
    } else {
        echo "ファイルの削除に失敗しました\n";
    }
} else {
    echo "削除対象のファイルが存在しません\n";
}

$file = 'data/sample.txt';

if (file_exists($file)) {
    if (unlink($file)) {
        echo "ファイルを削除しました\n";
    } else {
        echo "ファイルの削除に失敗しました\n";
    }
} else {
    echo "削除対象のファイルが存在しません\n";
}

unlink() は削除に失敗すると false を返すため、明示的なエラーハンドリングが推奨されます。

ファイルが存在していても削除できないケース

以下のようなケースでは unlink() が失敗します。

ファイルが読み取り専用で、PHP実行ユーザーに削除権限がない
ファイルが他プロセスによってロックされている
パスがディレクトリだった（unlink() はファイル専用）

PHP

$dir = 'data';

// ディレクトリに対してunlinkすると警告が発生する
unlink($dir); // Warning: unlink(data): Is a directory

$dir = 'data';

// ディレクトリに対してunlinkすると警告が発生する
unlink($dir); // Warning: unlink(data): Is a directory

ディレクトリ削除には rmdir() を使う必要があります。

`is_file()` と `file_exists()` の使い分け

file_exists() はディレクトリも含めて存在確認を行いますが、is_file() は純粋にファイルかどうかを判定できます。

PHP

$path = 'data/sample.txt';

if (is_file($path)) {
    echo "これはファイルです\n";
} elseif (file_exists($path)) {
    echo "これはディレクトリです\n";
} else {
    echo "存在しません\n";
}

$path = 'data/sample.txt';

if (is_file($path)) {
    echo "これはファイルです\n";
} elseif (file_exists($path)) {
    echo "これはディレクトリです\n";
} else {
    echo "存在しません\n";
}