Como Detectar Alterações Não Autorizadas de Arquivos no Seu Site com PHP
Aprenda a detectar alterações inesperadas nos arquivos PHP do seu site usando um monitor leve de integridade de arquivos. Crie um scanner prático em PHP, compare snapshots confiáveis e identifique arquivos modificados, adicionados ou excluídos sem o Composer.
Imagine abrir seu site uma manhã e descobrir que algo mudou. Uma página redireciona os visitantes, um arquivo PHP contém código desconhecido ou um plugin se comporta de forma diferente apesar de não haver nenhuma atualização planejada.
Quais arquivos foram alterados? Verificar centenas manualmente é inviável. O monitoramento de integridade de arquivos (FIM) compara o sistema de arquivos atual com um instantâneo confiável. Este tutorial constrói um pequeno scanner PHP para sites personalizados, extensões e hospedagem compartilhada, sem Composer ou banco de dados.
1. O que é monitoramento de integridade de arquivos?
Um monitor registra os caminhos e hashes criptográficos dos arquivos selecionados e depois os verifica novamente. Ele relata arquivos ADICIONADOS, MODIFICADOS e EXCLUÍDOS. Essas diferenças são pistas de investigação, não prova de um ataque: implantações normais também alteram arquivos.
Por exemplo:
website/
├── index.php
├── includes/
│ ├── bootstrap.php
│ └── database.php
└── plugins/
└── payment/gateway.php
Uma verificação posterior pode relatar:
MODIFIED includes/bootstrap.php
ADDED plugins/payment/debug-shell.php
DELETED includes/database.php
O requisito crucial é uma linha de base confiável. Se um site foi comprometido antes do instantâneo inicial, arquivos maliciosos podem já estar registrados como normais.
2. Construir um scanner ou usar uma ferramenta existente?
Antes de programar, verifique sua plataforma. No WordPress, o WP-CLI verifica os arquivos principais contra checksums oficiais:
wp core verify-checksums
wp plugin verify-checksums --all
O comando de plugins cobre principalmente plugins hospedados no repositório do WordPress.org; plugins personalizados e comerciais exigem outra referência. No Joomla, extensões estabelecidas como o Akeeba Admin Tools oferecem monitoramento de alterações de arquivos. Aplicativos gerenciados com Git também podem comparar os artefatos implantados com uma versão aprovada.
| Situação | Ponto de partida |
|---|---|
| Núcleo do WordPress e plugins do repositório | Verificação de checksum do WP-CLI |
| Joomla com necessidades contínuas de segurança | Extensão de segurança estabelecida |
| Site PHP personalizado ou extensões personalizadas | Pequeno scanner de integridade PHP |
| Vários servidores exigindo alertas centralizados | Plataforma de monitoramento dedicada |
| Implantação controlada por versão | Artefato de build ou versão confiável |
Um script personalizado é valioso quando você precisa de uma verificação focada no seu próprio código e pode manter sua linha de base e alertas.
3. Por que SHA-256?
O PHP fornece hash_file():
$hash = hash_file('sha256', '/path/to/file.php');
O resultado é um resumo hexadecimal de 64 caracteres do conteúdo do arquivo. Um arquivo alterado quase certamente produzirá um resumo diferente. Podemos, portanto, armazenar um mapa compacto de caminhos relativos para valores SHA-256 em vez de duplicar cada arquivo.
Um resumo correspondente prova a consistência com a referência, não que a referência ou o arquivo seja confiável. Estabeleça o instantâneo inicial a partir de uma implantação conhecida como boa, de preferência verificada contra o controle de código-fonte ou um pacote de versão aprovado.
4. Construir um scanner leve de integridade de arquivos PHP
Crie integrity-check.php fora do diretório web público, ao lado de uma linha de base JSON protegida:
/home/account/
├── private/
│ ├── integrity-check.php
│ └── integrity-baseline.json
└── public_html/
├── index.php
├── includes/
└── plugins/
O script tem dois comandos: baseline cria o instantâneo inicial e scan o compara. Ele relata diferenças sem excluir ou substituir arquivos do site. Esta versão também gera o log formatado e a saída compatível com cron descritos na seção 7.
Script PHP completo (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);
}
O scanner ignora links simbólicos e diretórios comuns gerados. Revise as exclusões cuidadosamente: um diretório gravável contendo PHP executável pode ser importante de monitorar. A linha de base e os logs devem ser inacessíveis ao servidor web e protegidos contra gravações não autorizadas.
5. Execute a primeira verificação
Edite $siteRoot e $baselinePath para corresponder à sua conta de hospedagem. Certifique-se de que o diretório privado exista e seja gravável pelo usuário da CLI.
Após verificar que o site corresponde a uma versão conhecida como boa, crie a linha de base:
php /home/account/private/integrity-check.php baseline
Exemplo:
Baseline created: 428 files
Execute uma comparação:
php /home/account/private/integrity-check.php scan
Sem alterações, a verificação é concluída com sucesso e permanece silenciosa. Modifique um arquivo PHP inofensivo em uma instalação de staging e execute-a novamente. O scanner gerará um relatório identificando o arquivo alterado.
6. Entenda os resultados
- ADICIONADO: um arquivo monitorado existe agora, mas não estava na linha de base.
- MODIFICADO: o mesmo caminho existe em ambos os instantâneos, mas seu resumo SHA-256 difere.
- EXCLUÍDO: um arquivo registrado na linha de base está ausente.
Primeiro verifique o histórico de implantações e atualizações de extensões. Se uma diferença for inexplicável, compare o arquivo com sua revisão Git aprovada ou pacote de versão. Investigue código sensível, como integrações de pagamento, prontamente. Preserve evidências relevantes em vez de substituir cegamente os arquivos de produção.
7. Automatize as verificações de integridade e receba alertas por e-mail
Verificações manuais ajudam durante o desenvolvimento. Uma verificação agendada é mais útil quando ela salva um relatório legível e o envia por e-mail apenas quando algo muda.
A maioria dos painéis de controle de hospedagem oferece tarefas cron. O script completo na seção 4 já implementa o comportamento necessário:
- Calcular os hashes atuais dos arquivos.
- Comparar com a linha de base protegida.
- Se não houver diferenças, sair silenciosamente.
- Caso contrário, salvar um relatório formatado no diretório privado
logs/. - Imprimir o mesmo relatório na saída padrão para que um mailer de cron configurado possa entregá-lo.
Exemplo de relatório em texto simples
========================================
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.
========================================
O log salvo pode ser:
/home/account/private/logs/integrity-2026-11-19-030000.log
Este relatório funciona igualmente bem em um editor de texto, um e-mail de notificação do cron ou um ticket de incidente.
Agende o scanner
Uma entrada tradicional de crontab para uma verificação diária às 3 da manhã:

MAILTO=admin@example.com
0 3 * * * /usr/bin/php /home/account/private/integrity-check.php scan
Substitua o endereço e os caminhos pelos seus próprios. O comportamento MAILTO do cron depende da implementação do cron e de um transporte de e-mail em funcionamento; alguns hosts compartilhados oferecem, em vez disso, notificações por e-mail em seu painel de controle. O script não envia e-mail por conta própria. Ele imprime um relatório para o agendador entregar.
Os códigos de saída são úteis para integrações futuras:
| Código | Significado |
|---|---|
0 |
Verificação limpa; sem saída |
1 |
Erro do scanner; mensagem na saída de erro padrão |
2 |
Diferenças detectadas; relatório na saída padrão |
Um mailer de cron convencional geralmente envia e-mail quando uma tarefa produz saída, não meramente porque seu status de saída é diferente de zero. É por isso que o script imprime apenas em mudanças ou erros.
Mantenha os logs sob controle
Uma diferença não resolvida reaparece a cada verificação, por isso pode gerar relatórios repetidos. Defina um período de retenção razoável (por exemplo, 30 dias) usando suas ferramentas de manutenção normais e considere a deduplicação de alertas se você estender o scanner. O script de exemplo salva relatórios, mas não implementa limpeza automática de logs.
Nunca atualize a linha de base automaticamente para silenciar alertas: investigue primeiro.
Teste a notificação
No staging, crie uma linha de base confiável, modifique um arquivo PHP inofensivo, execute a verificação e confirme que um log aparece. Em seguida, acione a tarefa agendada e verifique o e-mail. Restaure o arquivo de teste e confirme que o scanner retorna a um estado limpo.
Se um log existir, mas nenhum e-mail chegar, verifique as configurações de notificação do cron do host e a entrega de e-mail. A varredura de arquivos e o transporte de e-mail são independentes.
8. Lide com atualizações legítimas sem alarmes falsos
Uma implantação normal pode modificar dezenas de arquivos. O scanner deve relatar essas mudanças, mas você não deve tratá-las como uma intrusão.
Um fluxo de trabalho seguro é: implantar uma versão aprovada, verificar seu conteúdo contra a fonte confiável, preservar a linha de base anterior, criar uma nova linha de base e então retomar as verificações agendadas.
O script de exemplo deliberadamente se recusa a sobrescrever uma linha de base existente. Para substituí-la após uma versão aprovada, arquive a referência antiga com segurança antes de criar a nova.
Para projetos gerenciados com Git, uma opção mais robusta é gerar os hashes de arquivos esperados a partir de um artefato de build ou CI/CD aprovado e entregar essa referência independentemente do servidor de produção.
9. Conheça os limites
Verificações periódicas perdem mudanças temporárias. Um arquivo alterado e restaurado entre verificações pode passar despercebido.
A linha de base pode ser atacada. Um invasor com acesso suficiente para alterar tanto os arquivos quanto os dados de referência pode ocultar mudanças. Mantenha uma cópia confiável independente para sites importantes.
A cobertura é seletiva. Nosso exemplo monitora arquivos PHP, JS, CSS e .htaccess, mas não bancos de dados, contas de usuários, configuração de cron ou todo tipo de arquivo possível. Suas exclusões precisam de revisão deliberada.
O monitoramento de integridade não é análise de malware. Um hash alterado diz que um arquivo difere, não se a mudança é maliciosa.
Combine verificações de integridade com atualizações, acesso restrito, backups, logs de aplicação e ferramentas de segurança adequadas.
10. Quando escolher uma solução profissional
Um scanner PHP personalizado é compacto, auditável e fácil de integrar ao processo de implantação de uma aplicação personalizada. Mas você é responsável por linhas de base confiáveis, exclusões, entrega de alertas, retenção de logs e investigação.
Produtos de monitoramento estabelecidos podem fornecer dashboards, histórico de alertas, relatórios centralizados e recursos mais amplos de resposta a incidentes. Para WordPress e Joomla, comece revisando os recursos já disponíveis por meio da sua plataforma e das extensões de segurança.
Escolha a menor solução confiável que cubra suas necessidades operacionais.
11. Lista de verificação prática
- [ ] Verifique os arquivos iniciais contra uma versão confiável antes de criar a linha de base.
- [ ] Armazene o script, a referência e os relatórios fora do diretório web público.
- [ ] Revise as extensões monitoradas e os diretórios excluídos.
- [ ] Use permissões restritas de sistema de arquivos.
- [ ] Teste arquivos adicionados, modificados e excluídos no staging.
- [ ] Confirme a execução do cron e a entrega real de e-mail.
- [ ] Retenha logs e monitore erros do scanner.
- [ ] Reconstrua a linha de base apenas após uma implantação aprovada.
- [ ] Investigue mudanças inesperadas em vez de excluir arquivos automaticamente.
Conclusão: saiba o que mudou antes de investigar o porquê
Um scanner de integridade de arquivos ajuda os desenvolvedores a identificar rapidamente mudanças inesperadas no site. As funções nativas de hashing do PHP tornam a comparação simples; o valor real está em uma linha de base confiável, verificações regulares, alertas legíveis e um fluxo de trabalho de implantação controlado.
Para sites e extensões PHP personalizados, o script leve acima é um ponto de partida útil sem Composer ou banco de dados. Para WordPress e Joomla, ferramentas estabelecidas de verificação e segurança podem ser uma primeira escolha melhor.