--- url: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-drupal/primeiros-passos/estender-drupal-10-com-composer' title: 'Estender o Drupal 10 com o Composer | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T08:46:45+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: 'Atualmente, é bastante comum os módulos contribuídos do Drupal dependerem de bibliotecas de terceiros. Alguns destes módulos só podem ser instalados com o Composer.' tags: - 'Getting started' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T08:46:45+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 'Estender o Drupal 10 com o Composer' description: 'Atualmente, é bastante comum os módulos contribuídos do Drupal dependerem de bibliotecas de terceiros. Alguns destes módulos só podem ser instalados com o Composer.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T08:46:45+0000' dateModified: '2026-10-24T08:46:45+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-drupal/primeiros-passos/estender-drupal-10-com-composer' articleSection: 'Primeiros passos' - '@type': WebPage '@id': 'https://dxpr.com/pt-pt/hc/documentacao/aprender-drupal/primeiros-passos/estender-drupal-10-com-composer' description: 'Atualmente, é bastante comum os módulos contribuídos do Drupal dependerem de bibliotecas de terceiros. Alguns destes módulos só podem ser instalados com o Composer.' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Início item: 'https://dxpr.com/pt-pt' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: pt-pt --- [Centro de ajuda](/pt-pt/node/75)/[Documentação](/pt-pt/hc/documentacao) /[Aprender Drupal](/pt-pt/hc/documentation/learn-drupal) /[Primeiros passos](/pt-pt/hc/documentation/learn-drupal/getting-started) # Estender o Drupal 10 com o Composer. Aprender DrupalPrimeiros passos ## Neste guia Atualmente, é bastante comum os módulos contribuídos do Drupal dependerem de bibliotecas de terceiros. Alguns destes módulos só podem ser instalados com o Composer. Se já obteve o núcleo do Drupal com o Composer, ou se um módulo exige o Composer, deve usar o Composer para transferir todos os módulos e temas. Se misturar atualizações do Composer com outros métodos, poderá ter problemas de atualização bastante incómodos. ## Obter módulos e temas contribuídos com o Composer Quer transferir módulos ou temas contribuídos do Drupal com o Composer? Eis como: - Escreva `composer require drupal/module_name` - Por exemplo: `composer require drupal/token` - Certifique-se de que está na raiz da instalação do Drupal O Composer atualiza então o ficheiro composer.json, adicionando o módulo à lista dos restantes requisitos, assim: ```javascript { "require": { "drupal/token": "^1.5" } } ``` O Composer transfere o módulo e quaisquer dependências. Para ativar o módulo Drupal, tem duas opções: - Use a interface web normal do Drupal, clicando em Extend na barra de ferramentas. - Experimente uma ferramenta de linha de comandos como o Drush ou a Drupal Console; consulte [Instalar módulos a partir da linha de comandos](/docs/8/extending-drupal-8/installing-modules-from-the-command-line). Ao requerer módulos, pode usar o nome do projeto ou o nome específico do módulo dentro de um projeto: - O Composer transfere todo o projeto que contém um determinado módulo. - Por exemplo, se precisar do módulo fe\_block do projeto [features\_extra](https://drupal.org/project/features_extra), pode escolher uma das seguintes opções: - `composer require drupal/features_extra` - `composer require drupal/fe_block` ## Escolher uma versão Se quiser especificar a versão do módulo ou tema a transferir, faça assim: ```php composer require 'drupal/module_name:version' ``` (Basta substituir `version` pela versão ou restrição de versão real do Composer.) Por exemplo: ```php composer require 'drupal/dxpr_builder:^1.1' composer require 'drupal/dxpr_builder:~1.1' composer require 'drupal/dxpr_builder:2.2.2-alpha2' composer require 'drupal/dxpr_builder:2.2.x-dev' ``` Para evitar problemas em diferentes terminais ou shells, coloque a versão entre aspas, como nos exemplos acima. --- **Atenção!** No Windows, usar aspas (simples) pode invalidar a especificação da versão, causando uma falha na instalação com '*Could not parse version constraint .....': Invalid version string "....'"*. *Sem* as aspas, por exemplo: ```php composer require drupal/dxpr_builder:^2.2 ``` Ou usando *aspas duplas* em vez de aspas simples, assim: ```php composer require "drupal/dxpr_builder:^2.2" ``` Deve funcionar sem problemas. Para mais informações, consulte [Comment 'Composer problems: "could not parse version constraint"'](https://www.drupal.org/forum/support/post-installation/2022-04-08/composer-problems-could-not-parse-version-constraint). --- Nos exemplos acima, as versões correspondem da seguinte forma: - ^1.1: corresponde à última versão estável 10.x-1.x do módulo. - ~1.1: corresponde à última versão estável 10.x-3.x do módulo. - 2.2.2-alpha2: corresponde à versão 2.2.2-alpha2 - 2.2.x-dev: corresponde a 2.2.x-dev Para mais informações sobre restrições de versão com ~ (til) e ^ (circunflexo), consulte [Operadores de próxima versão significativa](https://getcomposer.org/doc/articles/versions.md#next-significant-release-operators). É recomendável especificar a versão do módulo contribuído a transferir. ## Pesquisar com o Composer Boas notícias! Os endpoints de composer do Drupal.org suportam a função [pesquisa do Composer](https://getcomposer.org/doc/03-cli.md#search). Isto significa que pode pesquisar projetos Drupal diretamente na linha de comandos. Para usar a pesquisa do Composer, escreva: ```php composer search views ``` ## Navegar com o Composer Os endpoints de composer do Drupal.org para Drupal 7 a 10 suportam também a função [navegação do Composer](https://getcomposer.org/doc/03-cli.md#browse-home). Isto permite encontrar informações adicionais sobre projetos Drupal diretamente na linha de comandos. Para usar a navegação do Composer, escreva: ```php composer browse drupal/token ```