Changelog

Mudanças notáveis do mpm. Formato baseado em Keep a Changelog.

[0.2.2] — 2026-07-01

list / remove / check / status no layout docroot. A listagem de plugins instalados (list_plugins) só olhava /var/www/html/plugins fixo, então em Mautic 5/6 com layout docroot (composer "recommended-project", plugins em <root>/docroot/plugins) esses comandos não encontravam plugin nenhum. Agora a listagem procura em <root>/docroot/plugins e <root>/plugins, honra --mautic-root, e extrai o bundle de forma agnóstica de layout. O install e o update já eram docroot-aware desde a 0.2.1 — a 0.2.2 fecha o gap nos demais.

Validação com aspas duplas. Config/config.php declarando "name" => "..." / "version" => "..." (aspas duplas) deixava de ser reconhecido e o plugin era marcado como Missing fields: name, version. Agora chaves e valores são aceitos com aspas simples OU duplas (PHP permite os dois). Afetava, por exemplo, o queryreport.
Layout docroot (Mautic 5/6 composer). Instalações cujo bin/console fica em /var/www/html mas o app roda em /var/www/html/docroot carregam plugins de docroot/plugins. O mpm fazia deploy em /var/www/html/plugins (diretório que o Mautic não lê), reportava sucesso, mas o plugin nunca registrava. Agora o mpm detecta o layout (sonda docroot/app/AppKernel.php) e instala no diretório correto automaticamente. Override manual continua via --plugins-dir.

Fingerprint binding por instalação (anti-compartilhamento). O mpm computa sha256(secret_key + "|" + domínio) (lidos do config/local.php) e envia em X-MPM-Fingerprint em toda chamada autenticada. A key fica atrelada à instalação no primeiro uso; usada fora desse ambiente, é revogada.
Tratamento de 403 key_revoked (key fora do ambiente original) e 426 fingerprint_required (mpm desatualizado → mpm self-update).
Persistência de config dentro do Mautic (media/.mpm/cnf), cifrada com o secret_key do install (AES-256-GCM).
Resolução de api_key em cascata: --api-key → MPM_API_KEY → media/.mpm/cnf → /opt/mpm/config.toml (legado).
Knobs de ambiente com override por arg e defaults version-aware: --mautic-root, --plugins-dir, --console, --php-bin, --web-user.

Deploy, permissões, cache, reload e backup passam a respeitar os knobs de ambiente (sem paths/usuário hardcoded).

By Borlot.com.br on 26/06/2026