Технологическая отрасль

Как обнаружить несанкционированные изменения файлов на вашем сайте с помощью PHP

How to Detect Unauthorized File Changes on Your Website with PHP

Узнайте, как обнаружить неожиданные изменения PHP‑файлов вашего сайта с помощью легкого монитора целостности файлов. Создайте практический сканер PHP, сравните надёжные снимки и определите изменённые, добавленные или удалённые файлы без Composer.

Представьте, что вы открываете свой сайт однажды утром и обнаруживаете, что что-то изменилось. Страница перенаправляет посетителей, PHP-файл содержит незнакомый код или плагин ведёт себя иначе, несмотря на отсутствие запланированного обновления.

Какие файлы изменились? Проверять сотни файлов вручную нереалистично. Мониторинг целостности файлов (FIM) сравнивает текущую файловую систему с доверенным снимком. Этот учебник создаёт небольшой PHP-сканер для пользовательских сайтов, расширений и виртуального хостинга без Composer и базы данных.

1. Что такое мониторинг целостности файлов?

Монитор записывает пути и криптографические хеши выбранных файлов, а затем проверяет их снова. Он сообщает о файлах ADDED, MODIFIED и DELETED. Эти различия являются отправными точками для расследования, а не доказательством атаки: обычные развёртывания также меняют файлы.

Например:

website/
├── index.php
├── includes/
│   ├── bootstrap.php
│   └── database.php
└── plugins/
    └── payment/gateway.php

Более позднее сканирование может сообщить:

MODIFIED  includes/bootstrap.php
ADDED     plugins/payment/debug-shell.php
DELETED   includes/database.php

Ключевое требование — это доверенная базовая линия. Если сайт был скомпрометирован до первоначального снимка, вредоносные файлы могли уже быть записаны как нормальные.

2. Создать сканер или использовать существующий инструмент?

Прежде чем писать код, проверьте свою платформу. В WordPress WP-CLI проверяет основные файлы на соответствие официальным контрольным суммам:

wp core verify-checksums
wp plugin verify-checksums --all

Команда для плагинов в первую очередь охватывает плагины, размещённые в репозитории WordPress.org; пользовательские и коммерческие плагины требуют другой точки отсчёта. В Joomla зарекомендовавшие себя расширения, такие как Akeeba Admin Tools, предлагают мониторинг изменений файлов. Приложения под управлением Git также могут сравнивать развёрнутые артефакты с утверждённым релизом.

Ситуация Отправная точка
Ядро WordPress и плагины из репозитория Проверка контрольных сумм через WP-CLI
Joomla с постоянными потребностями в безопасности Зарекомендовавшее себя расширение безопасности
Пользовательский PHP-сайт или пользовательские расширения Небольшой PHP-сканер целостности
Несколько серверов, требующих централизованных оповещений Выделенная платформа мониторинга
Развёртывание под контролем версий Доверенная сборка или артефакт релиза

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

3. Почему SHA-256?

PHP предоставляет hash_file():

$hash = hash_file('sha256', '/path/to/file.php');

Результатом является 64-символьное шестнадцатеричное дайджест-значение содержимого файла. Изменённый файл почти наверняка даст другой дайджест. Поэтому мы можем хранить компактную карту соответствия относительных путей значениям SHA-256 вместо дублирования каждого файла.

Совпадающий дайджест доказывает согласованность с эталоном, но не то, что эталон или файл заслуживают доверия. Установите первоначальный снимок из заведомо исправного развёртывания, предпочтительно проверенного по системе контроля версий или утверждённому пакету релиза.

4. Создайте облегчённый PHP-сканер целостности файлов

Создайте integrity-check.php вне публичного веб-каталога, рядом с защищённой базовой линией в JSON:

/home/account/
├── private/
│   ├── integrity-check.php
│   └── integrity-baseline.json
└── public_html/
    ├── index.php
    ├── includes/
    └── plugins/

Скрипт имеет две команды: baseline создаёт первоначальный снимок, а scan сравнивает его. Он сообщает о различиях без удаления или замены файлов сайта. Эта версия также генерирует форматированный журнал и вывод, удобный для cron, описанные в разделе 7.

Полный PHP-скрипт (PHP 7.4+)

<?php
declare(strict_types=1);

/**
 * Lightweight file integrity scanner.
 * Run from PHP CLI, outside the public web directory.
 */
$siteRoot = '/home/account/public_html';
$baselinePath = '/home/account/private/integrity-baseline.json';

$extensions = ['php', 'js', 'css'];
$excludedDirectories = [
    'cache',
    'tmp',
    'logs',
    'node_modules',
    'vendor',
];

function collectFiles(
    string $siteRoot,
    array $extensions,
    array $excludedDirectories
): array {
    $files = [];
    $directory = new RecursiveDirectoryIterator(
        $siteRoot,
        FilesystemIterator::SKIP_DOTS
    );
    $filter = new RecursiveCallbackFilterIterator(
        $directory,
        static function ($item) use ($excludedDirectories): bool {
            if ($item->isLink()) {
                return false;
            }
            if ($item->isDir()) {
                return !in_array(
                    $item->getFilename(),
                    $excludedDirectories,
                    true
                );
            }
            return $item->isFile();
        }
    );
    $iterator = new RecursiveIteratorIterator($filter);

    foreach ($iterator as $file) {
        $filename = $file->getFilename();
        $extension = strtolower(pathinfo($filename, PATHINFO_EXTENSION));
        if (
            !in_array($extension, $extensions, true)
            && $filename !== '.htaccess'
        ) {
            continue;
        }
        $fullPath = $file->getPathname();
        $relativePath = str_replace(
            DIRECTORY_SEPARATOR,
            '/',
            substr($fullPath, strlen($siteRoot) + 1)
        );
        $hash = hash_file('sha256', $fullPath);
        if ($hash === false) {
            throw new RuntimeException('Unable to hash: ' . $relativePath);
        }
        $files[$relativePath] = $hash;
    }
    ksort($files, SORT_STRING);
    return $files;
}

function loadBaseline(string $baselinePath): array
{
    if (!is_file($baselinePath)) {
        throw new RuntimeException('Baseline not found. Run baseline first.');
    }
    $json = file_get_contents($baselinePath);
    if ($json === false) {
        throw new RuntimeException('Unable to read baseline.');
    }
    $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (
        !is_array($data)
        || ($data['version'] ?? null) !== 1
        || !isset($data['files'])
        || !is_array($data['files'])
    ) {
        throw new RuntimeException('Invalid baseline format.');
    }
    return $data['files'];
}

try {
    if (PHP_SAPI !== 'cli') {
        throw new RuntimeException('CLI execution only.');
    }
    $command = $argv[1] ?? '';
    if (!in_array($command, ['baseline', 'scan'], true)) {
        throw new RuntimeException(
            'Usage: php integrity-check.php baseline|scan'
        );
    }
    $siteRoot = realpath($siteRoot);
    if ($siteRoot === false || !is_dir($siteRoot)) {
        throw new RuntimeException('Invalid website directory.');
    }
    $current = collectFiles(
        $siteRoot,
        $extensions,
        $excludedDirectories
    );

    if ($command === 'baseline') {
        if (file_exists($baselinePath)) {
            throw new RuntimeException(
                'Baseline already exists. Replace it only after '
                . 'validating a trusted deployment.'
            );
        }
        $payload = [
            'version' => 1,
            'created_at' => gmdate('c'),
            'files' => $current,
        ];
        $json = json_encode(
            $payload,
            JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR
        );
        if (file_put_contents($baselinePath, $json . PHP_EOL, LOCK_EX) === false) {
            throw new RuntimeException('Unable to write baseline.');
        }
        chmod($baselinePath, 0600);
        echo 'Baseline created: ' . count($current) . ' files' . PHP_EOL;
        exit(0);
    }

    $baseline = loadBaseline($baselinePath);
    $added = array_diff_key($current, $baseline);
    $deleted = array_diff_key($baseline, $current);
    $modified = [];
    foreach (array_intersect_key($current, $baseline) as $path => $hash) {
        if ($hash !== $baseline[$path]) {
            $modified[$path] = $hash;
        }
    }
    $changes = count($added) + count($modified) + count($deleted);
    if ($changes === 0) {
        exit(0);
    }

    $report = [
        '========================================',
        ' WEBSITE FILE INTEGRITY REPORT',
        '========================================',
        'Site: ' . $siteRoot,
        'Date: ' . gmdate('Y-m-d H:i:s') . ' UTC',
        'Files checked: ' . count($current),
        'Status: CHANGES DETECTED',
        '',
        'SUMMARY',
        '----------------------------------------',
        'Added:       ' . count($added),
        'Modified:    ' . count($modified),
        'Deleted:     ' . count($deleted),
        'Total:       ' . $changes,
        '',
        'DETAILS',
        '----------------------------------------',
    ];
    foreach (array_keys($added) as $path) {
        $report[] = '[ADDED]     ' . $path;
    }
    foreach (array_keys($modified) as $path) {
        $report[] = '[MODIFIED]  ' . $path;
    }
    foreach (array_keys($deleted) as $path) {
        $report[] = '[DELETED]   ' . $path;
    }
    $report[] = '';
    $report[] = '========================================';
    $report[] = 'ACTION REQUIRED';
    $report[] = 'Review unexpected changes against the';
    $report[] = 'last approved deployment.';
    $report[] = '========================================';

    $reportText = implode(PHP_EOL, $report) . PHP_EOL;
    $logDirectory = dirname($baselinePath) . '/logs';
    if (!is_dir($logDirectory)) {
        if (!mkdir($logDirectory, 0700, true) && !is_dir($logDirectory)) {
            throw new RuntimeException('Unable to create log directory.');
        }
    }
    $logPath = $logDirectory . '/integrity-' . gmdate('Y-m-d-His') . '.log';
    if (file_put_contents($logPath, $reportText, LOCK_EX) === false) {
        throw new RuntimeException('Unable to write integrity log.');
    }
    chmod($logPath, 0600);

    // A cron mailer can deliver this standard output.
    echo $reportText;
    exit(2);

} catch (Throwable $exception) {
    fwrite(STDERR, 'ERROR: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
}

Сканер пропускает символические ссылки и распространённые сгенерированные каталоги. Внимательно проверьте исключения: каталог с правом записи, содержащий исполняемый PHP, может быть важен для мониторинга. Базовая линия и журналы должны быть недоступны для веб-сервера и защищены от несанкционированной записи.

5. Запустите первое сканирование

Отредактируйте $siteRoot и $baselinePath в соответствии с вашей учётной записью хостинга. Убедитесь, что приватный каталог существует и доступен для записи пользователю CLI.

После проверки того, что сайт соответствует заведомо исправному релизу, создайте базовую линию:

php /home/account/private/integrity-check.php baseline

Например:

Baseline created: 428 files

Запустите сравнение:

php /home/account/private/integrity-check.php scan

При отсутствии изменений сканирование завершается успешно и молчит. Измените безобидный PHP-файл на тестовой (staging) установке и запустите снова. Сканер сгенерирует отчёт, определяющий изменённый файл.

6. Поймите результаты

  • ADDED: отслеживаемый файл существует сейчас, но не в базовой линии.
  • MODIFIED: тот же путь существует в обоих снимках, но его дайджест SHA-256 отличается.
  • DELETED: файл, записанный в базовой линии, отсутствует.

Сначала проверьте историю развёртываний и обновлений расширений. Если различие не объяснено, сравните файл с его утверждённой ревизией Git или пакетом релиза. Оперативно расследуйте чувствительный код, например платёжные интеграции. Сохраняйте соответствующие доказательства, а не слепо заменяйте производственные файлы.

7. Автоматизируйте проверки целостности и получайте оповещения по электронной почте

Ручные проверки помогают во время разработки. Запланированное сканирование более полезно, когда оно сохраняет читаемый отчёт и отправляет его по электронной почте только тогда, когда что-то меняется.

Большинство панелей управления хостингом предлагают задания cron. Полный скрипт из раздела 4 уже реализует необходимое поведение:

  1. Вычислить текущие хеши файлов.
  2. Сравнить с защищённой базовой линией.
  3. Если различий нет, завершиться молча.
  4. В противном случае сохранить форматированный отчёт в приватном каталоге logs/.
  5. Вывести тот же отчёт в стандартный вывод, чтобы настроенный cron-отправитель почты мог его доставить.

Пример текстового отчёта в открытом виде

========================================
 WEBSITE FILE INTEGRITY REPORT
========================================
Site: /home/account/public_html
Date: 2026-11-19 03:00:00 UTC
Files checked: 428
Status: CHANGES DETECTED

SUMMARY
----------------------------------------
Added:       1
Modified:    2
Deleted:     1
Total:       4

DETAILS
----------------------------------------
[ADDED]     plugins/payment/debug.php
[MODIFIED]  includes/bootstrap.php
[MODIFIED]  plugins/payment/gateway.php
[DELETED]   includes/legacy.php

========================================
ACTION REQUIRED
Review unexpected changes against the
last approved deployment.
========================================

Сохранённый журнал может быть:

/home/account/private/logs/integrity-2026-11-19-030000.log

Этот отчёт одинаково хорошо работает в текстовом редакторе, в уведомительном письме cron или в заявке об инциденте.

Запланируйте сканер

Традиционная запись crontab для ежедневного сканирования в 3 утра:

Technical workflow illustration
MAILTO=admin@example.com
0 3 * * * /usr/bin/php /home/account/private/integrity-check.php scan

Замените адрес и пути на свои собственные. Поведение MAILTO в cron зависит от реализации cron и работоспособного почтового транспорта; некоторые виртуальные хосты вместо этого предоставляют уведомления по электронной почте в своей панели управления. Сам скрипт не отправляет электронную почту. Он выводит отчёт для доставки планировщиком.

Коды выхода полезны для будущих интеграций:

Код Значение
0 Чистое сканирование; вывода нет
1 Ошибка сканера; сообщение в стандартной ошибке
2 Обнаружены различия; отчёт в стандартном выводе

Обычный cron-отправитель почты, как правило, отправляет письмо, когда задание выдаёт вывод, а не просто потому, что его статус выхода ненулевой. Именно поэтому скрипт выводит данные только при изменениях или ошибках.

Держите журналы под контролем

Неразрешённое различие появляется снова при каждом сканировании, поэтому оно может генерировать повторяющиеся отчёты. Установите разумный срок хранения (например, 30 дней) с помощью обычных инструментов обслуживания и рассмотрите дедупликацию оповещений, если вы расширяете сканер. Пример скрипта сохраняет отчёты, но не реализует автоматическую очистку журналов.

Никогда не обновляйте базовую линию автоматически, чтобы заглушить оповещения: сначала расследуйте.

Проверьте уведомление

На тестовой (staging) установке создайте доверенную базовую линию, измените безобидный PHP-файл, запустите сканирование и убедитесь, что журнал появился. Затем запустите запланированное задание и проверьте электронную почту. Восстановите тестовый файл и убедитесь, что сканер вернулся в чистое состояние.

Если журнал существует, но письмо не приходит, проверьте настройки уведомлений cron у хоста и доставку почты. Сканирование файлов и почтовый транспорт независимы.

8. Обрабатывайте законные обновления без ложных тревог

Обычное развёртывание может изменить десятки файлов. Сканер должен сообщить об этих изменениях, но вы не должны воспринимать их как вторжение.

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

Пример скрипта намеренно отказывается перезаписывать существующую базовую линию. Чтобы заменить её после утверждённого релиза, надёжно заархивируйте старый эталон перед созданием нового.

Для проектов под управлением Git более надёжный вариант — сгенерировать ожидаемые хеши файлов из утверждённой сборки или артефакта CI/CD и доставлять этот эталон независимо от производственного сервера.

9. Знайте ограничения

Периодические сканирования упускают временные изменения. Файл, изменённый и восстановленный между проверками, может остаться незамеченным.

Базовую линию можно атаковать. Нарушитель с достаточным доступом, чтобы изменить как файлы, так и эталонные данные, может скрыть изменения. Храните независимую доверенную копию для важных сайтов.

Охват избирателен. Наш пример отслеживает файлы PHP, JS, CSS и .htaccess, но не базы данных, учётные записи пользователей, конфигурацию cron или все возможные типы файлов. Его исключения требуют вдумчивого рассмотрения.

Мониторинг целостности — это не анализ вредоносного ПО. Изменившийся хеш говорит, что файл отличается, а не о том, является ли изменение вредоносным.

Сочетайте проверки целостности с обновлениями, ограниченным доступом, резервным копированием, журналами приложений и подходящими инструментами безопасности.

10. Когда выбирать профессиональное решение

Пользовательский PHP-сканер компактен, поддаётся аудиту и легко интегрируется в процесс развёртывания пользовательского приложения. Но вы отвечаете за доверенные базовые линии, исключения, доставку оповещений, хранение журналов и расследование.

Зарекомендовавшие себя продукты мониторинга могут предоставлять информационные панели, историю оповещений, централизованную отчётность и более широкие функции реагирования на инциденты. Для WordPress и Joomla начните с рассмотрения возможностей, уже доступных через вашу платформу и расширения безопасности.

Выберите наименьшее надёжное решение, которое охватывает ваши операционные потребности.

11. Практический контрольный список

  • [ ] Проверьте первоначальные файлы по доверенному релизу перед созданием базовой линии.
  • [ ] Храните скрипт, эталон и отчёты вне публичного веб-каталога.
  • [ ] Проверьте отслеживаемые расширения и исключённые каталоги.
  • [ ] Используйте ограниченные права доступа к файловой системе.
  • [ ] Протестируйте добавленные, изменённые и удалённые файлы на тестовой (staging) установке.
  • [ ] Подтвердите выполнение cron и фактическую доставку электронной почты.
  • [ ] Сохраняйте журналы и отслеживайте ошибки сканера.
  • [ ] Пересоздавайте базовую линию только после утверждённого развёртывания.
  • [ ] Расследуйте неожиданные изменения вместо автоматического удаления файлов.

Заключение: знайте, что изменилось, прежде чем выяснять почему

Сканер целостности файлов помогает разработчикам быстро выявлять неожиданные изменения сайта. Встроенные функции хеширования PHP делают сравнение простым; настоящая ценность заключается в доверенной базовой линии, регулярных проверках, читаемых оповещениях и контролируемом рабочем процессе развёртывания.

Для пользовательских PHP-сайтов и расширений лёгкий скрипт выше является полезной отправной точкой без Composer и базы данных. Для WordPress и Joomla зарекомендовавшие себя инструменты проверки и безопасности могут быть лучшим первым выбором.

Официальные ссылки