如何使用 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 节的完整脚本已实现所需行为:
- 计算当前文件哈希。
- 与受保护基线比较。
- 无差异则静默退出。
- 否则,在私有
logs/目录下保存格式化报告。 - 将相同报告打印到标准输出,以便配置的 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 条目:

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,现有验证和安全工具可能是更好的首选。