［PHP］is_readable関数完全ガイド – ファイル読み取り権限チェックの基本から応用まで

PHPでファイル操作を行う際、「このファイルって読み取れるの？」という疑問は開発者なら誰でも持つものです。そんな時に活躍するのがis_readable関数です。この記事では、is_readable関数の基本的な使い方から実践的な活用方法まで、初心者にも分かりやすく解説します。

is_readable関数とは？

is_readable関数は、指定されたファイルまたはディレクトリが読み取り可能かどうかを判定するPHPの組み込み関数です。ファイルの存在チェックと読み取り権限チェックを同時に行える便利な関数として、多くの開発現場で重宝されています。

基本的な構文

bool is_readable(string $filename)

パラメータ：

$filename：チェックしたいファイルまたはディレクトリのパス

戻り値：

true：ファイルが存在し、かつ読み取り可能
false：ファイルが存在しない、または読み取り不可能

基本的な使用例

シンプルなファイルチェック

<?php
$filename = 'example.txt';

if (is_readable($filename)) {
    echo "ファイル '{$filename}' は読み取り可能です";
} else {
    echo "ファイル '{$filename}' は読み取りできません";
}
?>

複数ファイルの一括チェック

<?php
$files = ['config.php', 'data.json', 'log.txt'];

foreach ($files as $file) {
    if (is_readable($file)) {
        echo "✓ {$file} は読み取り可能\n";
    } else {
        echo "✗ {$file} は読み取り不可\n";
    }
}
?>

実践的な活用シーン

1. 設定ファイルの読み込み前チェック

<?php
function loadConfig($configFile) {
    if (!is_readable($configFile)) {
        throw new Exception("設定ファイル '{$configFile}' が読み取れません");
    }
    
    return include $configFile;
}

try {
    $config = loadConfig('config/app.php');
    echo "設定を正常に読み込みました";
} catch (Exception $e) {
    echo "エラー: " . $e->getMessage();
}
?>

2. ログファイルの存在確認

<?php
function writeLog($message) {
    $logFile = 'logs/app.log';
    
    // ログファイルが読み取り可能な場合のみ追記
    if (is_readable($logFile)) {
        $currentLog = file_get_contents($logFile);
        $newLog = $currentLog . date('Y-m-d H:i:s') . " - " . $message . "\n";
        file_put_contents($logFile, $newLog);
    } else {
        // 新規作成
        file_put_contents($logFile, date('Y-m-d H:i:s') . " - " . $message . "\n");
    }
}

writeLog("アプリケーションが開始されました");
?>

3. 画像ファイルの表示前チェック

<?php
function displayImage($imagePath) {
    if (!is_readable($imagePath)) {
        return '<img src="no-image.png" alt="画像が見つかりません">';
    }
    
    return '<img src="' . htmlspecialchars($imagePath) . '" alt="画像">';
}

echo displayImage('uploads/profile.jpg');
?>

他のファイル関数との違い

file_exists() vs is_readable()

<?php
$filename = 'restricted.txt';

// file_exists()は存在のみチェック
if (file_exists($filename)) {
    echo "ファイルは存在します\n";
}

// is_readable()は存在 + 読み取り権限をチェック
if (is_readable($filename)) {
    echo "ファイルは読み取り可能です\n";
} else {
    echo "ファイルは存在するが読み取りできません\n";
}
?>

is_file() vs is_readable()

<?php
$path = 'some/directory';

// is_file()は通常ファイルかどうかをチェック
if (is_file($path)) {
    echo "これは通常ファイルです\n";
}

// is_readable()はファイルでもディレクトリでも読み取り可能かチェック
if (is_readable($path)) {
    echo "これは読み取り可能です（ファイルまたはディレクトリ）\n";
}
?>

注意点とベストプラクティス

1. パスの指定方法

<?php
// 相対パス
$file1 = 'config.php';
$file2 = './config.php';
$file3 = '../config.php';

// 絶対パス
$file4 = '/var/www/html/config.php';
$file5 = __DIR__ . '/config.php';  // 推奨

// __DIR__を使用した安全なパス指定
if (is_readable(__DIR__ . '/config.php')) {
    echo "設定ファイルが読み取り可能です";
}
?>

2. エラーハンドリングの重要性

<?php
function safeFileRead($filename) {
    if (!is_readable($filename)) {
        error_log("ファイル読み取りエラー: {$filename}");
        return false;
    }
    
    $content = file_get_contents($filename);
    if ($content === false) {
        error_log("ファイル内容取得エラー: {$filename}");
        return false;
    }
    
    return $content;
}

$content = safeFileRead('important.txt');
if ($content !== false) {
    echo "ファイル内容: " . htmlspecialchars($content);
} else {
    echo "ファイルの読み取りに失敗しました";
}
?>

3. セキュリティ上の考慮事項

<?php
function secureFileRead($filename) {
    // パストラバーサル攻撃を防ぐ
    $realPath = realpath($filename);
    $allowedDir = realpath(__DIR__ . '/uploads/');
    
    if (!$realPath || strpos($realPath, $allowedDir) !== 0) {
        throw new Exception("許可されていないパスです");
    }
    
    if (!is_readable($realPath)) {
        throw new Exception("ファイルが読み取れません");
    }
    
    return file_get_contents($realPath);
}

try {
    $content = secureFileRead('uploads/data.txt');
    echo "ファイル内容: " . htmlspecialchars($content);
} catch (Exception $e) {
    echo "エラー: " . $e->getMessage();
}
?>

パフォーマンスの考慮

ファイルキャッシュの活用

<?php
class FileCache {
    private $cache = [];
    
    public function isReadable($filename) {
        if (!isset($this->cache[$filename])) {
            $this->cache[$filename] = is_readable($filename);
        }
        return $this->cache[$filename];
    }
    
    public function clearCache() {
        $this->cache = [];
    }
}

$fileCache = new FileCache();

// 初回チェック（実際にファイルシステムにアクセス）
if ($fileCache->isReadable('large-file.txt')) {
    echo "ファイルは読み取り可能です\n";
}

// 2回目以降はキャッシュを使用
if ($fileCache->isReadable('large-file.txt')) {
    echo "ファイルは読み取り可能です（キャッシュから）\n";
}
?>

トラブルシューティング

よくある問題と解決方法

権限エラー

# Linuxでファイル権限を確認
ls -la filename.txt

# 読み取り権限を付与
chmod 644 filename.txt

パスの問題

<?php
// デバッグ用の詳細チェック
function debugFileCheck($filename) {
    echo "ファイル: {$filename}\n";
    echo "絶対パス: " . realpath($filename) . "\n";
    echo "存在: " . (file_exists($filename) ? 'Yes' : 'No') . "\n";
    echo "読み取り可能: " . (is_readable($filename) ? 'Yes' : 'No') . "\n";
    echo "書き込み可能: " . (is_writable($filename) ? 'Yes' : 'No') . "\n";
    echo "ディレクトリ: " . (is_dir($filename) ? 'Yes' : 'No') . "\n";
    echo "ファイル: " . (is_file($filename) ? 'Yes' : 'No') . "\n";
}

debugFileCheck('config.php');
?>