Rock Drive Backup — Análise da Stack

Stack principal

O que sustenta o plugin de backup e como os jobs saem do admin do WordPress para o Google Drive.

Plataforma

Plugin WordPress (6.5+)

O produto é instalado como um plugin WordPress padrão, com tela de admin própria (Drive Backup), hooks de ativação que criam suas tabelas no banco e WP-Cron executando os jobs e os agendamentos semanais.

Linguagem

PHP sem dependências

Cerca de 3.100 linhas de PHP 7.2+ em dez classes focadas, com polyfills para helpers de string mais novos, sem pacotes Composer, sem SDK do Google e com interface de admin em JavaScript e CSS puros.

Integração com o Drive

Google Drive API v3, REST direto

OAuth 2.0 com o escopo restrito drive.file (o plugin só enxerga pastas e arquivos que ele mesmo cria), uploads e downloads retomáveis e chamadas REST diretas pela API HTTP do WordPress.

Restauração segura

Restauração em um clique com rollback

Restauração no mesmo site protegida por confirmação de senha de administrador e modo de manutenção. Cada artefato é baixado e verificado antes de qualquer mudança, os arquivos são extraídos em staging privado e os dados de rollback de banco e arquivos são criados primeiro.

Integridade e segurança

Manifestos SHA-256, segredos criptografados

Cada artefato de backup entra em um manifesto SHA-256, verificado depois do upload e antes da restauração. Tokens OAuth e o client secret são criptografados com AES-256-GCM usando chaves derivadas dos salts do WordPress.

QA com IA

QA de restauração guiado por agente

O repositório inclui uma skill de agente local ao projeto que valida a integridade da restauração antes de confiar em mudanças: sinais de porcentagem, estruturas de permalink, dados PHP serializados e estilos de coluna do Gutenberg, checados com scripts determinísticos.

Como roda

Backups e restaurações são jobs longos, então o plugin avança um pequeno estágio por vez em vez de depender de uma única requisição frágil.

A tela de admin concentra configuração e ações

templates/admin-page.php reúne o status da conexão com o Google, a pasta de backup, o botão Back Up Now, o agendamento semanal e a lista de backups restauráveis.

Ações viram jobs na fila

class-rdb-repository.php cria cada backup ou restauração como uma linha em uma tabela própria de jobs, com UUID, status, estágio e progresso, ao lado de uma tabela de logs.

Um runner com lock avança os jobs

class-rdb-job-runner.php roda a cada minuto via WP-Cron, adquire um lock e avança o job atual exatamente um estágio, permitindo que jobs longos sobrevivam aos limites de tempo do PHP e continuem de onde pararam.

Os estágios de backup produzem artefatos verificados

class-rdb-backup-engine.php passa por preflight, dump do banco, varredura de arquivos, arquivamento em múltiplos volumes, upload retomável, montagem do manifesto e verificação.

Os estágios de restauração protegem o site

class-rdb-restore-engine.php baixa e verifica manifesto e artefatos, extrai em staging, cria snapshot do banco e dos arquivos alterados para rollback, e só então copia arquivos e importa o banco.

Mapa da arquitetura

O plugin é um conjunto pequeno de classes finais conectadas em uma classe principal, com os dois engines construídos como máquinas de estágios sobre um repositório compartilhado.

Pastas e arquivos principais

rock-drive-backup.phpArquivo de bootstrap com o piso de versão do PHP, polyfills e metadados do plugin.

includes/Dez classes: wiring do plugin, tela de admin, engine de backup, engine de restauração, cliente do Google Drive, job runner, agendador, repositório, criptografia e ativador.

templates/A página única de admin do Drive Backup.

assets/JavaScript e CSS puros do admin.

uninstall.phpLimpeza quando o plugin é excluído.

Análise da arquitetura

rock-drive-backup.php
uninstall.php
readme.txt

includes/class-rdb-plugin.php
includes/class-rdb-admin.php
includes/class-rdb-backup-engine.php
includes/class-rdb-restore-engine.php
includes/class-rdb-google-drive.php
includes/class-rdb-job-runner.php
includes/class-rdb-scheduler.php
includes/class-rdb-repository.php
includes/class-rdb-crypto.php
includes/class-rdb-activator.php

templates/admin-page.php
assets/admin.js
assets/admin.css

O design mantém cada responsabilidade em um lugar óbvio: os engines só conhecem estágios, o repositório é dono do estado dos jobs, o cliente do Drive cuida de OAuth e uploads, e o agendador reaproveita o mesmo pipeline para as execuções semanais, com retenção e resumo por e-mail.

Camada de backup e restauração

O plugin faz backup do site inteiro e trata a restauração como a operação perigosa que ela é, verificando antes e mantendo um caminho de volta.

Escopo do backup

Arquivos completos e dump lógico do banco

A raiz do WordPress é arquivada: core, plugins, temas, uploads, must-use plugins e arquivos de configuração da raiz.

O banco de dados é exportado como um dump lógico completo.

Vários sites podem compartilhar uma pasta principal no Drive, cada um escrevendo apenas na subpasta do seu próprio rótulo de site.

Backups semanais agendados removem backups antigos por site e enviam um resumo por e-mail de cada execução.

Segurança da restauração

Restauração no mesmo site, com caminho de volta

A restauração é limitada à mesma URL do WordPress; não é uma ferramenta de migração.

Cada artefato é verificado contra o manifesto SHA-256 antes de qualquer alteração.

As credenciais atuais do wp-config.php e as tabelas ativas de jobs e logs são preservadas durante a importação do banco.

Os dados de rollback de banco e arquivos alterados são criados antes das mudanças, então uma restauração que falha pode ser desfeita.

Instalação e requisitos

Não há etapa de build nem instalação via Composer; a pasta do plugin é o entregável.

Instalação

wp-content/plugins/
└── rock-drive-backup/
    ├── rock-drive-backup.php
    ├── includes/
    ├── assets/
    ├── templates/
    └── uninstall.php

Copie a pasta para wp-content/plugins (ou envie como zip), ative e conecte um cliente OAuth do Google e uma conta pela tela de admin do Drive Backup.

Requisitos

O que o plugin precisa

RDB_PRIVATE_DIR opcionalmente definido no wp-config.php para escolher um diretório privado gravável para staging e rollback fora da raiz web.

PHP 7.2+ com ZipArchive, OpenSSL, cURL, JSON e zlib, servido em HTTPS.

Um cliente OAuth 2.0 do Google Cloud (aplicativo web) com a Drive API habilitada, colado na tela de configurações.

Um WP-Cron funcional, já que backups, restaurações e agendamentos semanais rodam por ele.

Resumo final

Rock Drive Backup é um plugin de backup para WordPress sem dependências com um motor de jobs em estágios e retomável. Ele faz backup de arquivos e banco de dados em uma pasta do Google Drive criada pelo próprio plugin, verifica cada artefato com manifestos SHA-256 e restaura o mesmo site atrás de confirmação de senha, com rollback de banco e arquivos.