PHP и файловая система: стратегии безопасности

Расширенные примеры безопасной работы с файлами

Кастомный Stream Wrapper для шифрования данных на лету

Создание собственного stream wrapper позволяет автоматически шифровать данные при записи и расшифровывать при чтении, не меняя логику приложения.

class AesStreamWrapper {
    const PROTOCOL = 'aes';
    private $fp;
    private $key;

    public function stream_open($path, $mode, $options, &$opened_path) {
        $url = parse_url($path);
        $file = $url['host'] . $url['path'];
        $this->fp = fopen($file, $mode);
        if (!$this->fp) return false;
        $this->key = 'секретный_ключ_32_байта';
        return true;
    }

    public function stream_read($count) {
        $data = fread($this->fp, $count);
        if ($data === false) return false;
        return openssl_decrypt($data, 'aes-256-cbc', $this->key, 0, substr($this->key, 0, 16));
    }

    public function stream_write($data) {
        $encrypted = openssl_encrypt($data, 'aes-256-cbc', $this->key, 0, substr($this->key, 0, 16));
        return fwrite($this->fp, $encrypted);
    }

    // ... остальные методы интерфейса
}

stream_wrapper_register(AesStreamWrapper::PROTOCOL, AesStreamWrapper::class);
$data = file_get_contents('aes://secret.txt');
file_put_contents('aes://output.txt', 'конфиденциальный текст');

Результат: файл output.txt содержит зашифрованные данные, которые могут быть прочитаны только через этот же wrapper.

Обработка больших файлов построчно с помощью генератора

При работе с файлами размером в гигабайты недопустимо загружать весь файл в память. Генератор позволяет обрабатывать строку за строкой.

function readLines($filename) {
    $fp = fopen($filename, 'rb');
    if (!$fp) throw new RuntimeException('Не удалось открыть файл');
    try {
        while (!feof($fp)) {
            $line = fgets($fp);
            if ($line === false) break;
            yield rtrim($line, "\r\n");
        }
    } finally {
        fclose($fp);
    }
}

foreach (readLines('/var/log/large.log') as $line) {
    // Анализ строки без загрузки всего файла
    if (strpos($line, 'ERROR') !== false) {
        echo $line . PHP_EOL;
    }
}

Результат: выводятся только строки, содержащие 'ERROR', при этом память используется минимально.

Мониторинг изменений в файловой системе с помощью inotify

Расширение inotify (только Linux) позволяет отслеживать события файловой системы (изменение, удаление, создание) без постоянного опроса.

$inotify = inotify_init();
$watch = inotify_add_watch($inotify, '/var/www/uploads', IN_MODIFY | IN_CREATE | IN_DELETE);
stream_set_blocking($inotify, false);

echo "Ожидание событий...\n";
while (true) {
    $events = inotify_read($inotify);
    if ($events) {
        foreach ($events as $ev) {
            echo "Событие: " . $ev['name'] . " mask=" . $ev['mask'] . PHP_EOL;
        }
    }
    usleep(100000); // 0.1 сек
}

Результат: скрипт выводит имена файлов и типы событий, происходящих в указанной директории.

Безопасная выдача файлов с проверкой и заголовками

При скачивании файла через PHP важно правильно установить заголовки, чтобы избежать инъекций и неправильной интерпретации.

$file = '/var/data/report.pdf';
$name = basename($file);
if (!file_exists($file) || !is_readable($file)) {
    http_response_code(404);
    exit;
}
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . rawurlencode($name) . '"');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . filesize($file));
ob_clean();
flush();
readfile($file);

Результат: браузер инициирует скачивание файла с оригинальным именем, защищённым от специальных символов через rawurlencode.