Drupal — CMS Enterprise

Guia Técnico Completo sobre Drupal 10/11 (versão 11.3.x – Março 2026)

Drupal é um CMS open-source enterprise-grade escrito em PHP, conhecido por sua flexibilidade, segurança e capacidade de gerenciar sites complexos e de grande escala. Em março de 2026, a versão estável atual é a Drupal 11.3.4 (lançada em 05/03/2026). O Drupal 12 está em desenvolvimento (beta previsto para março/abril 2026, lançamento final em meados/final de 2026). O Drupal 10 ainda recebe suporte de segurança até o lançamento do Drupal 12 (meados/final de 2026). Todas as funcionalidades descritas abaixo estão disponíveis e otimizadas a partir do Drupal 11, com compatibilidade retroativa desde o Drupal 10.3+.

Arquitetura Interna (Entities, Fields, Views, Blocks, Menus)

Drupal é construído em torno do conceito de Entities:

• Content Entities: Nodes (páginas/conteúdo), Taxonomy Terms, Users, Files, Media, Blocks personalizados, etc. Armazenam dados do usuário.
• Configuration Entities: Tipos de conteúdo, Views, Roles, Image Styles, Menus, etc. São exportáveis via Configuration Management.

Fields permitem estender qualquer entity com campos reutilizáveis (Text, Image, Reference, Paragraphs, etc.). Fields são versionados e traduzíveis.

Views é o módulo core para criar listas, grids, blocos e páginas de forma visual (filtros, ordenação, pager, exposição como REST/JSON).

Blocks são componentes reutilizáveis que podem ser colocados em regiões de tema ou via Layout Builder.

Menus são entidades de configuração hierárquicas, totalmente customizáveis e integradas com access control.

Tudo é baseado no Entity API (desde Drupal 8+), com suporte nativo a revisões, traduções e workflows.

Sistema de Módulos e Desenvolvimento de Módulos Customizados

Drupal é 100% modular. O core contém ~100 módulos; milhares de contrib estão disponíveis em drupal.org.

Para criar um módulo customizado (Drupal 11):

• Crie pasta modules/custom/meumodulo
• Arquivo meumodulo.info.yml
• meumodulo.routing.yml para rotas
• meumodulo.module para hooks (ou classes modernas)
• Use serviços, plugins, events, forms, etc.

Desenvolvimento moderno usa:

• PHP 8.3+
• Composer para dependências
• Single Directory Components (SDC) para componentes reutilizáveis
• Hooks como classes (novo no Drupal 11)

Exemplo mínimo: php artisan não existe — use Drush ou manual.

Temas e Twig Templating

Temas definem aparência via .info.yml + templates Twig.

• Twig (engine seguro e poderoso) substitui o antigo PHPTemplate desde Drupal 8.
• Override de qualquer template (node.html.twig, block.html.twig, etc.).
• Single Directory Components (SDC) — padrão oficial desde Drupal 11 — permite componentes com CSS/JS/Template em uma única pasta.
• Subtemas, libraries, preprocess functions e Layout Builder para arrastar-e-soltar.

Drupal como Headless CMS com JSON:API e GraphQL

Drupal é API-first por design:

• JSON:API (módulo core desde Drupal 8.7): zero-config, totalmente compatível com spec JSON:API. CRUD completo para todas as entities. URL automática: /jsonapi/node/article.
• GraphQL (módulo contrib oficial — graphql): schema-first ou code-first, subscriptions, excelente para frontends modernos (Next.js, Nuxt, Gatsby, etc.).
• Decoupled ou “progressive decoupled” (Experience Builder + SDC em Drupal 11+).
• Autenticação via JWT, OAuth, Simple OAuth ou OpenID Connect.

Ideal para apps mobile, SPAs e omnichannel.

Gerenciamento de Conteúdo Estruturado

• Content Types + Fields + Paragraphs/Layout Builder para estruturas complexas.
• Media Library centralizada.
• Revisions + Moderation.
• Tradução integrada (Interface + Content).
• Workspaces (módulo experimental estabilizado no Drupal 11) para staging de conteúdo em ambientes separados.

Workflow e Editorial

• Workflows + Content Moderation (core): estados personalizados (Draft → Review → Published → Archived).
• Workflow Editor visual.
• Integração nativa com revisões, notificações e agendamento de publicação.
• Editorial workflows avançados com Workspaces + Content Moderation + Views.

Multisite

Drupal suporta multisite nativo (vários sites em um único codebase):

• Compartilham core, módulos e temas.
• Bancos de dados separados (ou prefixo de tabelas).
• Configuração por site via sites/sites.php.
• Recomendado para redes de sites (governo, universidades, marcas).

Segurança (SA Advisories, Permissões, RBAC)

Drupal tem um dos melhores registros de segurança do mercado:

• Security Advisories publicadas em drupal.org/security (SA-CORE, SA-CONTRIB, PSA).
• Atualizações de segurança críticas a cada 6 meses (ou mais).
• RBAC granular: permissões por role, com “least privilege” por padrão.
• Proteções nativas: CSRF tokens, form API, Twig auto-escape, file permissions, database abstraction.
• Módulos recomendados: Security Review, Paranoia, Shield, Automatic Updates (novo no Drupal 11).

Performance (Varnish, Redis, CDN)

Drupal é extremamente performático em escala:

• Cache interno (render, entity, page) + BigPipe.
• Redis como cache backend e lock (melhor que Memcached).
• Varnish (reverse proxy) + ESI para cache de página completa.
• CDN (Cloudflare, Fastly, Akamai) com purge automático.
• Internal Page Cache + Dynamic Page Cache (core).
• Opções avançadas: BigPipe, Turbo, Experience Builder + SDC.

Migração (Migrate API)

Migrate API (core) permite migrações robustas:

• De Drupal 7/8/9/10 → 11 (migrate_upgrade).
• De WordPress, Joomla, CSV, JSON, XML, etc.
• Pipelines customizadas com plugins de source, process e destination.
• Drush commands integrados.

Drush CLI

Drush 13 (compatível com Drupal 11) é a ferramenta de linha de comando oficial:

• drush cr, drush updb, drush cex, drush entity:delete, drush migrate:import, etc.
• Scripts personalizados, aliases multisite, remote execution.

Composer e Gestão de Dependências

Desde Drupal 8, tudo é gerenciado via Composer:

• composer create-project drupal/recommended-project
• composer require drupal/paragraphs
• composer update + drush updb
• drupal/core-recommended + drupal/core-dev para ambientes.

Padrão enterprise: composer.json versionado + composer.lock em Git.

Casos de Uso Enterprise (Governo, Saúde, Educação)

Drupal é a escolha de:

• Governo: sites .gov (EUA, Brasil, União Europeia), NASA, ONU.
• Saúde: Pfizer, Mayo Clinic, hospitais com HIPAA/GDPR.
• Educação: universidades (Harvard, Stanford, USP, UNESP), plataformas de ensino.
• Outros: Stanford, Pfizer, Tesla, Weather.com, governos nacionais.

Motivos: segurança extrema, acessibilidade WCAG AAA, multilingual, escalabilidade, integração com sistemas legados.

Drupal vs WordPress vs Outras Plataformas (2026)

Conclusão 2026: Drupal vence em projetos enterprise, governamentais, de saúde e educação que exigem segurança, escalabilidade, acessibilidade e governança de conteúdo. WordPress é ideal para blogs, sites institucionais simples ou marketing. Plataformas headless puras (Strapi, etc.) são ótimas quando não se precisa de interface administrativa rica.

Fontes e Links Externos para Consulta

• Documentação Oficial Drupal 11: https://www.drupal.org/docs
• Drupal 11 Release Notes e Sobre: https://www.drupal.org/about/11
• Entity API (Entities, Fields): https://www.drupal.org/docs/drupal-apis/entity-api
• Views, Blocks, Menus: https://www.drupal.org/docs/user_guide
• Módulos Customizados: https://www.drupal.org/docs/develop/creating-modules
• Theming e Twig + SDC: https://www.drupal.org/docs/develop/theming-drupal/twig-in-drupal
• JSON:API (core): https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module
• GraphQL: https://www.drupal.org/project/graphql
• Content Moderation + Workflows: https://www.drupal.org/docs/8/core/modules/content-moderation
• Multisite: https://www.drupal.org/docs/getting-started/multisite-drupal
• Segurança e Advisories: https://www.drupal.org/security
• Performance (Redis, Varnish): https://www.drupal.org/docs/administering-a-drupal-site/performance
• Migrate API: https://www.drupal.org/docs/8/core/modules/migrate
• Drush: https://www.drush.org
• Composer: https://www.drupal.org/docs/getting-started/installing-drupal-with-composer
• Drupal vs WordPress 2026: https://www.acquia.com/blog/drupal-vs-wordpress-comparison-choose-right-cms-2026
• Casos de uso enterprise: https://www.drupal.org/case-studies

Este guia foi elaborado com base nas fontes oficiais e no estado atual do Drupal em março de 2026. Consulte sempre drupal.org para as últimas atualizações e security advisories.