Web ve Geliştirme

PHP ile Web Sitenizde Yetkisiz Dosya Değişikliklerini Nasıl Tespit Edebilirsiniz

How to Detect Unauthorized File Changes on Your Website with PHP

Web sitenizin PHP dosyalarındaki beklenmedik değişiklikleri hafif bir dosya bütünlüğü izleyicisi kullanarak nasıl tespit edebileceğinizi öğrenin. Pratik bir PHP tarayıcısı oluşturun, güvenilir anlık görüntüleri karşılaştırın ve Composer olmadan değiştirilen, eklenen veya silinen dosyaları belirleyin.

PHP ile Web Sitenizdeki Yetkisiz Dosya Değişikliklerini Nasıl Tespit Edeceksiniz

Bir sabah web sitenizi açtığınızı ve bir şeyin değiştiğini keşfettiğinizi hayal edin. Bir sayfa ziyaretçileri yönlendiriyor, bir PHP dosyası tanınmayan kod içeriyor veya planlanmış bir güncelleme olmasına rağmen bir eklenti farklı davranıyor.

Hangi dosyalar değişti? Yüzlerini el ile kontrol etmek gerçekçi değildir. Dosya bütünlüğü izleme (FIM), mevcut dosya sistemini güvenilir bir anlık görüntüyle karşılaştırır. Bu eğitim, Composer veya veritabanı olmadan özel siteler, eklentiler ve paylaşımlı barındırma için küçük bir PHP tarayıcısı oluşturur.

1. Dosya bütünlüğü izleme nedir?

Bir izleyici, seçilen dosyaların yollarını ve kriptografik karma değerlerini kaydeder, ardından tekrar kontrol eder. EKLENEN, DEĞİŞTİRİLEN ve SİLİNEN dosyaları raporlar. Bu farklar bir saldırının kanıtı değil, araştırma ipuçlarıdır; normal dağıtımlar da dosyaları değiştirir.

Örneğin:

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

Daha sonraki bir tarama şunu raporlayabilir:

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

Kritik gereklilik bir güvenilir referans (temel çizgi)dur. İlk anlık görüntüden önce bir site tehlikeye atılmışsa, kötü niyetli dosyalar zaten normal olarak kaydedilmiş olabilir.

2. Bir tarayıcı mı oluşturmalı yoksa mevcut bir araç mı kullanmalı?

Kodlamaya başlamadan önce platformunuzu kontrol edin. WordPress'te, WP-CLI çekirdek dosyaları resmi toplamlarla doğular:

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

Eklenti komutu esas olarak WordPress.org deposunda barındırılan eklentileri kapsar; özel ve ticari eklentiler başka bir referans gerektirir. Joomla'da, Akeeba Admin Tools gibi sağlam uzantılar dosya-değişiklik izleme sunar. Git ile yönetilen uygulamalar da dağıtılmış yapıtları onaylanmış bir sürümle karşılaştırabilir.

Durum Başlangıç noktası
WordPress çekirdeği ve depodaki eklentiler WP-CLI toplam doğrulama
Sürekli güvenlik ihtiyacı olan Joomla Sağlam güvenlik uzantısı
Özel PHP sitesi veya özel uzantılar Küçük PHP bütünlük tarayıcısı
Merkezi uyarı gerektiren birden çok sunucu Özel izleme platformu
Sürüm kontrolüyle dağıtım Güvenilir derleme veya sürüm yapıtı

Özel bir betik, kendi kodunuz için odaklanmış bir kontrol ihtiyacınız olduğunda ve referansınızı ve uyarılarınızı sürdürebilirseniz değerlidir.

3. Neden SHA-256?

PHP şunu sağlar: hash_file():

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

Sonuç, dosya içeriğinin 64 karakterlik onaltılık bir özetidir. Değişen bir dosya kesinlikle farklı bir özet üretecektir. Bu nedenle her dosyayı kopyalamak yerine, göreli yolları SHA-256 değerlerine eşleyen kompakt bir harita saklayabiliriz.

Eşleşen bir özet, referansla tutarlılığı kanalar, referansın veya dosyanın güvenilir olduğu anlamına gelmez. İlk anlık görüntüyü, tercih Kaynak denetimi veya onaylanmış bir sürüm paketiyle karşılaştırılmış, bilinen iyi bir dağıtımdan oluşturun.

4. Hafif bir PHP dosya bütünlük tarayıcısı oluşturun

integrity-check.php dosyasını genel web dizininin dışında, korumalı bir JSON referansının yanında oluşturun:

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

Betik iki komuta sahiptir: baseline ilk anlık görüntüyü oluşturur ve scan onu karşılaştırır. Web sitesi dosyalarını silmeden veya değiştirmeden farkları raporlar. Bu sürüm, bölüm 7'de açıklanan biçimlendirilmiş günlüğü ve cron dostu çıktıyı da üretir.

Tam PHP betiği (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);
}

Tarayıcı simgesel bağlantıları ve yaygın oluşturulan dizinleri atlar. İstisnaları dikkatle inceleyin: çalıştırılabilir PHP içeren yazılabilir bir dizin izlenmesi önem taşıyabilir. Referans ve günlükler web sunucusu tarafından erişilebilir olmamalı ve yetkisiz yazılmalara karşı korunmalıdır.

5. İlk taramayı çalıştırın

$siteRoot ve $baselinePath dosyalarını barındırma hesabınıza uygun şekilde düzenleyin. Özel dizinin var olduğundan ve CLI kullanıcısı tarafından yazılabilir olduğundan emin olun.

Web sitesinin bilinen iyi bir sürümle eşleştiğini doğruladıktan sonra, referansı oluşturun:

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

Örnek:

Baseline created: 428 files

Bir karşılaştırma çalıştırın:

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

Değişiklik yoksa, tarama başarıyla çıkış yapar ve sessiz kalır. Bir staging kurulumunda zararsız bir PHP dosyasını değiştirin ve tekrar çalıştırın. Tarayıcı, değiştirilen dosyayı belirten bir rapor oluşturacaktır.

6. Sonuçları anlayın

  • EKLENEN: izlenen bir dosya şu anda var ancak referanstan yok.
  • DEĞİŞTİRİLEN: aynı yol iki anlık görüntüde de var, ancak SHA-256 özeti farklıdır.
  • SİLİNEN: referansa kaydedilen bir dosya eksiktir.

Önce dağıtım ve eklenti güncelleme geçmişini kontrol edin. Bir fark açıklanamazsa, dosyayı onaylanmış Git revizyonu veya sürüm paketiyle karşılaştırın. Ödeme entegrasyonları gibi hassas kodu araştırın. Üretim dosyalarını kaba şekilde değiştirmek yerine ilgili kanıtları koruyun.

7. Bütünlük denetimlerini otomatikleştirin ve e-posta uyarısı alın

El ile yapılan denetimler geliştirme sırasında yardımcı olur. Zamanlanmış bir tarama, bir şey değiştiğinde yalnızca okunabilir bir rapor kaydettiği ve e-posta gönderdiği zaman daha kullanışlıdır.

Çoğu barındırma kontrol paneli cron işleri sunar. Bölüm 4'deki tam betik zaten gerekli davranışı uygular:

  1. Mevcut dosya karma değerlerini hesaplayın.
  2. Korumalı referansla karşılaştırın.
  3. Fark yoksa sessizce çıkış yapın.
  4. Aksi takdirde, özel logs/ dizininde biçimlendirilmiş bir rapor kaydedin.
  5. Aynı raporu standart çıkışa yazdırın, böylece yapılandırılmış cron posta sunucusu iletebilir.

Örnek düz metin raporu

========================================
 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.
========================================

Kaydedilen günlük şöyle olabilir:

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

Bu rapor bir metin editöründe, cron bildirim e-postasında veya bir olay biletinde aynı derecede iyi çalışır.

Tarayıcıyı zamanlayın

A traditional crontab entry for a daily 3 AM scan:

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

Adresi ve yolları kendi olanlarınızla değiştirin. Cron'un MAILTO davranışı cron uygulamasından ve çalışan bir posta aktarımından etkilenir; bazı paylaşımlı barındırma sağlayıcılar bunun yerine kontrol panelinde e-posta bildirimleri sunar. Betik kendi e-postayı göndermiyor. Zamanlayıcının ileteceği bir rapor yazdırır.

Çıkış kodları gelecekteki entegrasyonlar için kullanışlıdır:

Kod Anlamı
0 Temiz tarama; çıktı yok
1 Tarayıcı hatası; standart hata çıkışında mesaj
2 Farklar tespit edildi; standart çıkışta rapor

Tipik bir cron posta sunucusu, bir iş çıkış ürettiğinde genellikle e-posta gönderir, sadece çıkış durumu sıfırdan farklı olduğundan dolayı değil. Bu yüzden betik yalnızca değişikliklerde veya hatalarda yazdırır.

Günlükleri denetim altında tutun

Çözülmemiş bir fark her tarama tekrar görünür, bu yüzden yinelenen raporlar oluşturabilir. Normal bakım araçlarınızı kullanarak makul bir bekletme süresi (örneğin, 30 gün) belirleyin ve tarayıcıyı genişletirseniz uyarı tekrarlamasını ortadan kaldırmayı düşünün. Örnek betik raporları kaydeder ancak otomatik günlük temizleme uygulamaz.

Uyarıları susturmak için referansı otomatik olarak asla güncellemeyin: önce araştırın.

Bildirimi test edin

Staging ortamında güvenilir bir referans oluşturun, zararsız bir PHP dosyasını değiştirin, taramayı çalıştırın ve bir günlüğün ortaya çıktığını onaylayın. Ardından zamanlanmış görevi tetikleyin ve e-postayı kontrol edin. Test dosyasını geri yükleyin ve tarayıcının temiz duruma döndüğünü onaylayın.

Bir günlük varsa ama e-posta gelmiyorsa, sunucunun cron bildirim ayarlarını ve posta teslimini kontrol edin. Dosya taraması ve posta aktarımı bağımsızdır.

8. Yanlış alarma neden olmadan geçerli güncellemeleri yönetin

Normal bir dağıtım onlarca dosyayı değiştirebilir. Tarayıcı bu değişiklikleri rapor etmelidir, ancak bunları bir sızma olarak değerlendirmemelisiniz.

Güvenli bir iş akışı şudur: onaylanmış bir sürümü dağıtın, içeriğini güvenilir kaynağa göre doğrulayın, önceki referansı koruyun, yeni bir referans oluşturun, ardından zamanlanmış denetimleri devam ettirin.

Örnek betik, mevcut bir referansın üzerine yazılmasını kasıtlı olarak reddeder. Onaylanmış bir sürümden sonra bunu değiştirmek için, yeni bir tane oluşturmadan önce eski referansı güvenli bir şekilde arşive alın.

Git ile yönetilen projeler için daha güçlü bir seçenek, onaylanmış bir derlemeden veya CI/CD yapıtıyla beklenen dosya karma değerlerini oluşturmak ve bu referansı üretim sunucusundan bağımsız olarak teslim etmesidir.

9. Sınırları bilin

Düzenli taramalar geçici değişiklikleri kaçırır. Denetimler arasında değiştirip geri yüklenen bir dosya dikkat çekmeyebilir.

Referans hedef alınabilir. Hem dosyaları hem de referans verilerini değiştirebilecek yetkiye sahip bir sızmacı, değişiklikleri gizleyebilir. Önemli siteler için bağımsız bir güvenilir kopyayı saklayın.

Kapsam seçicidir. Örneklerimiz PHP, JS, CSS ve .htaccess dosyalarını izler, ancak veritabanlarını, kullanıcı hesaplarını, cron yapılandırmasını veya her türlü dosya türünü izlemez. İstisnaları amaçlı bir şekilde incelemeniz gerekir.

Bütünlük izleme kötü amaçlı yazılım analizi değildir. Değişen bir karma, dosyanın farklı olduğunu söyler, değişikliğin kötü niyetli olup olmadığını söylemez.

Bütünlük denetimlerini güncellemelerle, sınırlı erişimle, yedeklemelerle, uygulama günlükleriyle ve uygun güvenlik araçlarıyla birleştirin.

10. Ne zaman profesyonel bir çözüm seçmelisiniz

Özel bir PHP tarayıcısı kompakt, denetlenebilir ve özel bir uygulamanın dağıtım sürecine entegre etmesi kolaydır. Ancak güvenilir referanslar, istisnalar, uyarı teslimi, günlük bekletme ve araştırma sizin sorumluluğunuzdadır.

Sağlam izleme ürünleri panolar, uyarı geçmişi, merkezi raporlama ve daha geniş olay yanıt özellikleri sağlayabilir. WordPress ve Joomla için, platformunuz ve güvenlik uzantılarınız aracılığıyla zaten mevcut olan özellikleri incelemeye başlayın.

Operasyonel ihtiyaçlarınızı karşılayan en küçük güvenilir çözümü seçin.

11. Pratik kontrol listesi

  • [ ] Referansı oluşturmadan önce ilk dosyaları güvenilir bir sürümle doğrulayın.
  • [ ] Betiği, referansı ve raporları genel web dizininin dışında saklayın.
  • [ ] İzlenen uzantıları ve hariç tutulan dizinleri inceleyin.
  • [ ] Sınırlı dosya sistemi izinleri kullanın.
  • [ ] Eklenen, değiştirilen ve silinen dosyaları staging ortamında test edin.
  • [ ] Cron çalışmasını ve gerçek e-posta teslimini onaylayın.
  • [ ] Günlükleri saklayın ve tarayıcı hatalarını izleyin.
  • [ ] Referansı yalnızca onaylanmış bir dağıtımdan sonra yeniden oluşturun.
  • [ ] Dosyaları otomatik silmek yerine beklenmeyen değişiklikleri araştırın.

Sonuç: Nedenini araştırmadan önce neyin değiştiğini bilin

Bir dosya bütünlük tarayıcısı, geliştiricilerin beklenmeyen web sitesi değişikliklerini hızlıca belirlemelerine yardımcı olur. PHP'nin yerel karma işlevleri karşılaştırmayı basit hale getirir; gerçek değer güvenilir bir referans, düzenli denetimler, okunabilir uyarılar ve kontrollü bir dağıtım iş akışında yatar.

Özel PHP siteleri ve uzantıları için yukarıdaki hafif betik, Composer veya veritabanı olmadan kullanışlı bir başlangıç noktasıdır. WordPress ve Joomla için, doğrulama ve güvenlik araçları daha iyi bir ilk seçim olabilir.

Resmi referanslar