Hoe je ongeautoriseerde bestandswijzigingen op je website detecteert met PHP
Leer hoe je onverwachte wijzigingen in de PHP-bestanden van je website detecteert met een lichtgewicht monitor voor bestandsintegriteit. Bouw een praktische PHP-scanner, vergelijk vertrouwde snapshots en identificeer gewijzigde, toegevoegde of verwijderde bestanden zonder Composer.
Hoe u ongeoorloofde bestandswijzigingen op uw website kunt detecteren met PHP
Stel u voor dat u uw website op een ochtend opent en ontdekt dat er iets is veranderd. Een pagina leidt bezoekers om, een PHP-bestand bevat onbekende code, of een plugin gedraagt zich anders ondanks dat er geen geplande update was.
Welke bestanden zijn gewijzigd? Honderden handmatig controleren is onrealistisch. Bestandsintegriteitsmonitoring (FIM) vergelijkt het huidige bestandssysteem met een vertrouwde momentopname. Deze handleiding bouwt een kleine PHP-scanner voor aangepaste sites, extensies en gedeelde hosting, zonder Composer of een database.
1. Wat is bestandsintegriteitsmonitoring?
Een monitor registreert paden en cryptografische hashes van geselecteerde bestanden en controleert ze vervolgens opnieuw. Hij rapporteert TOEGEVOEGD, GEWIJZIGD en VERWIJDERD bestanden. Deze verschillen zijn aanwijzingen voor onderzoek, geen bewijs van een aanval: ook normale implementaties veranderen bestanden.
Bijvoorbeeld:
website/
├── index.php
├── includes/
│ ├── bootstrap.php
│ └── database.php
└── plugins/
└── payment/gateway.php
Een latere scan zou kunnen rapporteren:
MODIFIED includes/bootstrap.php
ADDED plugins/payment/debug-shell.php
DELETED includes/database.php
De cruciale vereiste is een vertrouwde basislijn. Als een site al was gecompromitteerd vóór de initiële momentopname, kunnen kwaadaardige bestanden al als normaal zijn vastgelegd.
2. Een scanner bouwen of een bestaande tool gebruiken?
Controleer uw platform voordat u gaat coderen. Op WordPress verifieert WP-CLI de kernbestanden aan de hand van officiële controlesommen:
wp core verify-checksums
wp plugin verify-checksums --all
Het plugincommando dekt voornamelijk plugins die worden gehost in de WordPress.org-repository; aangepaste en commerciële plugins vereisen een andere referentie. Op Joomla bieden gevestigde extensies zoals Akeeba Admin Tools bestandswijzigingsmonitoring. Git-beheerde applicaties kunnen ook geïmplementeerde artefacten vergelijken met een goedgekeurde release.
| Situatie | Startpunt |
|---|---|
| WordPress-kern en repository-plugins | Controlesomverificatie met WP-CLI |
| Joomla met doorlopende beveiligingsbehoeften | Gevestigde beveiligingsextensie |
| Aangepaste PHP-site of aangepaste extensies | Kleine PHP-integriteitsscanner |
| Meerdere servers die gecentraliseerde meldingen vereisen | Toegewijd monitoringplatform |
| Versiegecontroleerde implementatie | Vertrouwd build- of release-artefact |
Een aangepast script is waardevol wanneer u een gerichte controle op uw eigen code nodig hebt en de bijbehorende basislijn en meldingen kunt onderhouden.
3. Waarom SHA-256?
PHP biedt hash_file():
$hash = hash_file('sha256', '/path/to/file.php');
Het resultaat is een 64-tekens lange hexadecimale samenvatting van de bestandsinhoud. Een gewijzigd bestand zal vrijwel zeker een andere samenvatting opleveren. We kunnen daarom een compacte afbeelding van relatieve paden naar SHA-256-waarden opslaan, in plaats van elk bestand te dupliceren.
Een overeenkomende samenvatting bewijst consistentie met de referentie, niet dat de referentie of het bestand betrouwbaar is. Stel de initiële momentopname op vanuit een bekende-goede implementatie, bij voorkeur gecontroleerd aan de hand van bronbeheer of een goedgekeurd releasepakket.
4. Een lichtgewicht PHP-bestandsintegriteitsscanner bouwen
Maak integrity-check.php buiten de openbare webdirectory, naast een beschermde JSON-basislijn:
/home/account/
├── private/
│ ├── integrity-check.php
│ └── integrity-baseline.json
└── public_html/
├── index.php
├── includes/
└── plugins/
Het script heeft twee commando's: baseline maakt de initiële momentopname en scan vergelijkt deze. Het rapporteert verschillen zonder websitebestanden te verwijderen of te vervangen. Deze versie genereert ook het opgemaakte logboek en de cron-vriendelijke uitvoer die in sectie 7 worden beschreven.
Compleet PHP-script (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);
}
De scanner slaat symbolische koppelingen en veelgebruikte gegenereerde mappen over. Bekijk de uitsluitingen zorgvuldig: een schrijfbare map met uitvoerbare PHP kan belangrijk zijn om te monitoren. De basislijn en logboeken moeten ontoegankelijk zijn voor de webserver en beschermd zijn tegen ongeoorloofde schrijfacties.
5. Voer de eerste scan uit
Bewerk $siteRoot en $baselinePath om overeen te komen met uw hostingaccount. Zorg ervoor dat de privémap bestaat en beschrijfbaar is door de CLI-gebruiker.
Controleer nadat u hebt geverifieerd dat de website overeenkomt met een bekende-goede release de basislijn:
php /home/account/private/integrity-check.php baseline
Voorbeeld:
Baseline created: 428 files
Voer een vergelijking uit:
php /home/account/private/integrity-check.php scan
Zonder wijzigingen wordt de scan succesvol afgesloten en blijft deze stil. Wijzig een onschadelijk PHP-bestand op een staging-installatie en voer het opnieuw uit. De scanner genereert een rapport met daarin het gewijzigde bestand.
6. Begrijp de resultaten
- TOEGEVOEGD: er bestaat nu een gemonitord bestand dat niet in de basislijn voorkomt.
- GEWIJZIGD: hetzelfde pad bestaat in beide momentopnamen, maar de SHA-256-samenvatting verschilt.
- VERWIJDERD: een bestand dat in de basislijn is vastgelegd, ontbreekt.
Controleer eerst de implementatie- en extensie-updategeschiedenis. Als een verschil onverklaard blijft, vergelijk het bestand met zijn goedgekeurde Git-revisie of releasepakket. Onderzoek gevoelige code, zoals betaalintegraties, onmiddellijk. Bewaar relevant bewijsmateriaal in plaats van productiebestanden blindelings te vervangen.
7. Automatiseer integriteitscontroles en ontvang e-mailmeldingen
Handmatige controles helpen tijdens de ontwikkeling. Een geplande scan is nuttiger wanneer deze een leesbaar rapport opslaat en dit alleen per e-mail verstuurt wanneer er iets verandert.
De meeste hostingconfiguratieschermen bieden cron-taken. Het complete script in sectie 4 implementeert al het benodigde gedrag:
- Bereken de huidige bestandshashes.
- Vergelijk met de beschermde basislijn.
- Als er geen verschillen zijn, sluit dan stil af.
- Sla anders een opgemaakt rapport op onder de private
logs/-map. - Print hetzelfde rapport naar de standaarduitvoer, zodat een geconfigureerde cron-mailer het kan afleveren.
Voorbeeld van een platte-tekstrapport
========================================
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.
========================================
Het opgeslagen logboek zou er zo uit kunnen zien:
/home/account/private/logs/integrity-2026-11-19-030000.log
Dit rapport werkt even goed in een teksteditor, in een cron-meldingsmail of in een incidentticket.
Plan de scanner in
Een traditionele crontab-vermelding voor een dagelijkse scan om 3 uur 's nachts:

MAILTO=admin@example.com
0 3 * * * /usr/bin/php /home/account/private/integrity-check.php scan
Vervang het adres en de paden door die van uzelf. Het MAILTO-gedrag van Cron hangt af van de cron-implementatie en een werkend mailtransport; sommige gedeelde hosts bieden in plaats daarvan e-mailmeldingen in hun configuratiescherm. Het script verstuurt zelf geen e-mail. Het print een rapport dat de scheduler moet afleveren.
De afsluitcodes zijn nuttig voor toekomstige integraties:
| Code | Betekenis |
|---|---|
0 |
Schone scan; geen uitvoer |
1 |
Scannerfout; bericht op standaard foutuitvoer |
2 |
Verschillen gedetecteerd; rapport op standaarduitvoer |
Een conventionele cron-mailer verstuurt doorgaans e-mail wanneer een taak uitvoer produceert, niet simpelweg omdat de afsluitstatus niet-nul is. Daarom print het script alleen bij wijzigingen of fouten.
Houd logboeken onder controle
Een onopgelost verschil verschijnt opnieuw bij elke scan, zodat het herhaalde rapporten kan genereren. Stel een redelijke bewaartermijn in (bijvoorbeeld 30 dagen) met uw normale onderhoudstools, en overweeg meldingsdeduplicatie als u de scanner uitbreidt. Het voorbeeldscript slaat rapporten op, maar implementeert geen automatische logboekopruiming.
Werk de basislijn nooit automatisch bij om meldingen te onderdrukken: onderzoek eerst.
Test de melding
Maak op staging een vertrouwde basislijn, wijzig een onschadelijk PHP-bestand, voer de scan uit en bevestig dat er een logboek verschijnt. Activeer vervolgens de geplande taak en controleer de e-mail. Herstel het testbestand en bevestig dat de scanner terugkeert naar een schone toestand.
Als er een logboek bestaat maar er geen e-mail aankomt, controleer dan de cron-meldingsinstellingen en mailbezorging van de host. Bestandsscanning en e-mailtransport zijn onafhankelijk.
8. Ga om met legitieme updates zonder vals alarm
Een normale implementatie kan tientallen bestanden wijzigen. De scanner zou die wijzigingen moeten rapporteren, maar u zou ze niet als een inbraak moeten behandelen.
Een veilige werkwijze is: implementeer een goedgekeurde release, verifieer de inhoud aan de hand van de vertrouwde bron, bewaar de vorige basislijn, maak een nieuwe basislijn en hervat vervolgens de geplande controles.
Het voorbeeldscript weigert opzettelijk een bestaande basislijn te overschrijven. Om deze te vervangen na een goedgekeurde release, archiveert u de oude referentie veilig voordat u de nieuwe maakt.
Voor Git-beheerde projecten is een sterkere optie om de verwachte bestandshashes te genereren uit een goedgekeurd build- of CI/CD-artefact en die referentie onafhankelijk van de productieserver aan te leveren.
9. Ken de beperkingen
Periodieke scans missen tijdelijke wijzigingen. Een bestand dat tussen controles wordt gewijzigd en hersteld, kan onopgemerkt blijven.
De basislijn kan worden aangevallen. Een indringer met voldoende toegang om zowel bestanden als referentiedata te wijzigen, kan wijzigingen verbergen. Bewaar een onafhankelijke vertrouwde kopie voor belangrijke sites.
De dekking is selectief. Ons voorbeeld monitort PHP-, JS-, CSS- en .htaccess-bestanden, maar geen databases, gebruikersaccounts, cron-configuratie of elk mogelijk bestandstype. De uitsluitingen vereisen een weloverwogen beoordeling.
Integriteitsmonitoring is geen malwareanalyse. Een gewijzigde hash zegt dat een bestand verschilt, niet of de wijziging kwaadaardig is.
Combineer integriteitscontroles met updates, beperkte toegang, back-ups, applicatielogboeken en geschikte beveiligingstools.
10. Wanneer u voor een professionele oplossing kiest
Een aangepaste PHP-scanner is compact, controleerbaar en eenvoudig te integreren in het implementatieproces van een aangepaste applicatie. Maar u bent verantwoordelijk voor vertrouwde basislijnen, uitsluitingen, meldingsaflevering, logboekbewaring en onderzoek.
Gevestigde monitoringproducten kunnen dashboards, meldingsgeschiedenis, gecentraliseerde rapportage en bredere functies voor incidentrespons bieden. Voor WordPress en Joomla kunt u beginnen met het beoordelen van de mogelijkheden die al beschikbaar zijn via uw platform en beveiligingsextensies.
Kies de kleinste betrouwbare oplossing die aan uw operationele behoeften voldoet.
11. Praktische checklist
- [ ] Verifieer de initiële bestanden aan de hand van een vertrouwde release voordat u de basislijn maakt.
- [ ] Sla het script, de referentie en de rapporten buiten de openbare webdirectory op.
- [ ] Beoordeel gemonitorde extensies en uitgesloten mappen.
- [ ] Gebruik beperkte bestandssysteemrechten.
- [ ] Test toegevoegde, gewijzigde en verwijderde bestanden op staging.
- [ ] Bevestig cron-uitvoering en daadwerkelijke e-mailbezorging.
- [ ] Bewaar logboeken en monitor scannerfouten.
- [ ] Bouw de basislijn alleen opnieuw op na een goedgekeurde implementatie.
- [ ] Onderzoek onverwachte wijzigingen in plaats van bestanden automatisch te verwijderen.
Conclusie: weet wat er is veranderd voordat u onderzoekt waarom
Een bestandsintegriteitsscanner helpt ontwikkelaars om onverwachte websitewijzigingen snel te identificeren. De native hashfuncties van PHP maken de vergelijking eenvoudig; de werkelijke waarde ligt in een vertrouwde basislijn, regelmatige controles, leesbare meldingen en een gecontroleerde implementatiewerkwijze.
Voor aangepaste PHP-sites en extensies is het bovenstaande lichtgewicht script een nuttig startpunt zonder Composer of een database. Voor WordPress en Joomla kunnen gevestigde verificatie- en beveiligingstools een betere eerste keuze zijn.