WordPress Extremo: Arquitetura e Engenharia de Plugins
Fala, pessoal! 👋
Aqui é o Asllan Maciel — e hoje vamos voltar ao tema Arquitetura e Engenharia de plugins e falar sobre algo essencial para qualquer plugin WordPress profissional: gerenciamento inteligente de erros e logs.
Precisamos avançar com a estruturação do nosso plugin, mas logo logo vamos voltar à criação de blocos em nível avançado!
Então… se você quer elevar o nível dos seus projetos, precisa abandonar o velho error_log() espalhado no meio do código. Hoje vamos estruturar um sistema de logs real, digno de plugin de mercado.
🚀 Bora aprender do jeito certo?
🚀 Por que ter um sistema de logs no plugin?
✅ Facilita a identificação de bugs sem depender de ambientes ao vivo.
✅ Permite rastrear falhas específicas, como problemas de integração de API ou erros em transações.
✅ Profissionaliza seu plugin: quem lida bem com erros passa segurança.
✅ Melhora o suporte ao cliente, reduzindo o tempo de análise de problemas.
🎯 Exemplo real:
Sem log:
Usuário: “O pagamento não funcionou!”
Você: “🤔… vou tentar reproduzir aqui.”
Com log:
Você abre o log e vê:[2025-04-23 15:47:00] - Erro no pagamento: Código 403 - Permissão negada.
🔵 Resultado: Você soluciona rápido e transmite confiança!
🛠️ Estruturando o Gerenciador de Logs
Decidimos implementar uma classe de serviços — e não apenas um “Logger” — para manter o plugin modular, limpo e escalável.
Estrutura:
/src/Services/LogService.phpCódigo:
<?php
namespace WpArquiteturaExtrema\Services;
class LogService
{
protected $log_file;
public function __construct()
{
$upload_dir = wp_upload_dir();
$this->log_file = $upload_dir['basedir'] . '/wp-arquitetura-extrema.log';
}
public function info($message)
{
$this->write_log('INFO', $message);
}
public function warning($message)
{
$this->write_log('WARNING', $message);
}
public function error($message)
{
$this->write_log('ERROR', $message);
}
protected function write_log($level, $message)
{
$datetime = date('Y-m-d H:i:s');
$formatted = "[{$datetime}] {$level}: {$message}" . PHP_EOL;
file_put_contents($this->log_file, $formatted, FILE_APPEND);
}
}🔌 Como Instanciamos o LogService?
Vamos garantir que o log esteja disponível em todo o plugin.
Pra isso, alteramos nosso Init para carregar o serviço de log centralmente.
Atualização no Init:
<?php
namespace WpArquiteturaExtrema\Hooks;
use WpArquiteturaExtrema\Services\HelloService;
use WpArquiteturaExtrema\Repositories\UserRepository;
use WpArquiteturaExtrema\Services\LogService;
class Init
{
protected $logger;
public function register()
{
$this->logger = new LogService();
add_action('init', [$this, 'init_plugin']);
add_action('init', [$this, 'register_blocks']);
}
public function init_plugin()
{
$repo = new UserRepository();
$service = new HelloService($repo);
$service->execute();
// Exemplo de uso do logger
$this->logger->info('Plugin inicializado com sucesso.');
}
public function register_blocks()
{
// Registro dos blocos conforme já estruturamos
}
}Agora, qualquer serviço que precisar de logs poderá usar essa instância de forma controlada! 🔥
🧠 Boas práticas para usar o Log
- Não abuse: logue apenas eventos relevantes.
- Proteja: nunca deixe logs expostos publicamente em produção.
- Rotacione: dependendo do volume, implemente rotação (arquivar logs antigos).
- Padronize mensagens: sempre claras e objetivas.
📌 Recapitulando
Hoje estruturamos:
✅ Um sistema de logs inteligente com níveis de informação (info, warning, error).
✅ Uma maneira centralizada de instanciar e usar o Logger.
✅ A integração limpa com nossa arquitetura já existente.
Se você quer seguir elevando o nível, fique ligado nos próximos dias! 🚀
