科技行业

如何使用 PHP 检测您网站上的未授权文件更改

How to Detect Unauthorized File Changes on Your Website with PHP

学习如何使用轻量级文件完整性监控器检测您网站 PHP 文件的意外更改。构建实用的 PHP 扫描器,比较可信的快照,并识别已修改、已添加或已删除的文件,而无需 Composer。

如何使用 PHP 检测网站上的未授权文件变更

想象一下,某天早上打开你的网站,发现有些东西变了。某个页面重定向了访问者,某个 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 文件完整性扫描器

在 公共 Web 目录外部 创建 integrity-check.php,并配合受保护的 JSON 基线:

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

脚本有两个命令:baseline 创建初始快照,scan 进行比较。它报告差异,不删除或替换网站文件。此版本还生成第 7 节所述的格式化日志和 cron 友好输出。

完整 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 的可写目录可能很重要,需监控。基线和日志必须对 Web 服务器不可访问,并防止未授权写入。

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 文件并再次运行。扫描器将生成报告,标识变更文件。

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 通知邮件或事件工单中均适用。

计划扫描器

每天凌晨 3 点扫描的传统 crontab 条目:

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

将地址和路径替换为你自己的。Cron 的 MAILTO 行为取决于 cron 实现和可用的邮件传输;某些共享主机在控制面板提供邮件通知。脚本本身不发送邮件。 它为调度器打印报告以便投递。

退出代码对未来集成有用:

代码 含义
0 干净扫描;无输出
1 扫描器错误;标准错误输出消息
2 检测到差异;标准输出报告

传统 cron 邮件程序通常在作业产生输出时发送邮件,而非仅因退出状态非零。因此脚本仅在变更或错误时打印。

控制日志

未解决的差异每次扫描都会出现,可能生成重复报告。使用常规维护工具设置合理保留期(如 30 天),若扩展扫描器可考虑告警去重。示例脚本保存报告但 不实现自动日志清理。

切勿自动更新基线以消除告警:先调查。

测试通知

在暂存环境创建可信基线,修改一个无害 PHP 文件,运行扫描确认日志出现。然后触发计划任务检查邮件。恢复测试文件并确认扫描器回到干净状态。

若有日志但无邮件,检查主机的 cron 通知设置和邮件投递。文件扫描和邮件传输是独立的。

8. 处理合法更新避免误报

正常部署可能修改数十个文件。扫描器应报告这些变更,但你不应将其视为入侵。

安全工作流:部署批准的版本,对照可信源验证内容,保留旧基线,创建新基线,恢复计划检查。

示例脚本刻意拒绝覆盖现有基线。批准版本后,安全归档旧参考再创建新基线。

对 Git 管理项目,更强的选项是从批准的构建或 CI/CD 工件生成预期文件哈希,并独立于生产服务器交付该参考。

9. 了解局限

定期扫描会遗漏临时变更。 检查间隔内被改动又恢复的文件可能不被察觉。

基线可能被攻击。 拥有足够权限同时篡改文件和参考数据的入侵者可隐藏变更。重要站点请保留独立的可信副本。

覆盖范围有选择性。 示例监控 PHP、JS、CSS 和 .htaccess 文件,但不包括数据库、用户账户、cron 配置或所有可能文件类型。其排除项需审慎审查。

完整性监控非恶意软件分析。 哈希变更只说明文件不同,不代表变更是恶意的。

将完整性检查与更新、受限访问、备份、应用日志和合适安全工具结合。

10. 何时选择专业方案

自定义 PHP 扫描器紧凑、可审计、易集成到自定义应用部署流程。但你需负责可信基线、排除项、告警投递、日志保留和调查。

成熟监控产品可能提供仪表盘、告警历史、集中报告和更广泛的事件响应功能。对 WordPress 和 Joomla,先查看平台和安全扩展已有能力。

选择覆盖运营需求的最小可靠方案。

11. 实用清单

  • [ ] 创建基线前,对照可信版本验证初始文件。
  • [ ] 将脚本、参考和报告存放在公共 Web 目录外。
  • [ ] 审查监控的扩展名和排除目录。
  • [ ] 使用受限的文件系统权限。
  • [ ] 在暂存环境测试新增、修改、删除文件。
  • [ ] 确认 cron 执行和实际邮件投递。
  • [ ] 保留日志并监控扫描器错误。
  • [ ] 仅在批准部署后重建基线。
  • [ ] 调查意外变更,而非自动删除文件。

结语:调查原因前,先知晓变更内容

文件完整性扫描器帮助开发者快速识别意外网站变更。PHP 原生哈希函数使比较简单;真正价值在于 可信基线、定期检查、可读告警和受控部署工作流。

对自定义 PHP 站点和扩展,上述轻量脚本是无需 Composer 或数据库的有用起点。对 WordPress 和 Joomla,现有验证和安全工具可能是更好的首选。

官方参考