Guia passo-a-passo para instalar o Magento 2 com o Composer (2025)

Instalar o Magento 2 manualmente pode ser tedioso, especialmente quando lida com dependências, bibliotecas e compatibilidade de versões. Mesmo para desenvolvedores experientes, manter tudo em sincronia pode ser um desafio.

O uso do Composer simplifica o processo, gerenciando as dependências automaticamente, reduzindo os erros e tornando as atualizações mais eficientes. No Magento 2.4 e posterior, o Composer é necessário para a instalação, o que torna essencial entender como ele funciona.

Este guia apresenta dois métodos para instalar o Magento 2 com o Composer:”

• Instala o Magento 2 através do Composer
• Instalar o Magento 2 na Cloudways

Vamos começar…

O que é o Composer?

O Composer é um gestor de dependências de código aberto para PHP que ajuda os programadores a gerir bibliotecas e pacotes de forma eficiente. Em vez de lidar manualmente com as dependências, o Composer automatiza o processo, garantindo compatibilidade e atualizações fáceis.

Funciona utilizando um ficheiro JSON ao nível do projeto para definir os pacotes necessários. Em seguida, o compositor encontra e instala as melhores versões, considerando os requisitos do sistema e as dependências aninhadas.

A maioria das bibliotecas PHP estão disponíveis através do Packagist, o repositório oficial. Embora muitos pacotes sejam gratuitos, uma opção premium permite o alojamento privado de pacotes para projectos de código fechado.

Em suma, ao lidar com as dependências de forma eficiente, o Composer ajuda a manter as aplicações PHP organizadas e actualizadas.

Vantagens de instalar o Magento 2 através do Composer

Usar o Composer para instalar o Magento 2 simplifica o gerenciamento de dependências e garante uma configuração mais estruturada. Veja por que isso é benéfico:

• Gerenciamento Eficiente de Dependências: O Composer permite que o Magento 2 reutilize bibliotecas de terceiros sem agrupá-las em seus arquivos principais, mantendo a base de código limpa.
• Tratamento simplificado de extensões: Reduz os conflitos seguindo uma arquitetura baseada em componentes com uma gestão de dependências robusta. Saiba mais sobre Extensões do Magento.
• Melhor compatibilidade: O Composer alinha-se com os padrões PHP-FIG (Framework Interoperability Group), melhorando a consistência do código em diferentes estruturas PHP.
• Atualizações e personalização mais fáceis: O Magento 2 pode ser reempacotado com outros componentes, tornando-o mais flexível para desenvolvimento e implantação.
• Otimizado para produção: O Composer garante que o Magento 2 seja estruturado adequadamente para ambientes de produção, simplificando a implantação e o desempenho.

Se estás pronto para instalar o Magento 2 usando o Composer, segue este guia passo-a-passo para uma configuração sem problemas.

Requisitos para executar a loja Magento 2

Antes de prosseguir com a instalação do Magento 2 usando o Composer, certifica-te de que cumpres os requisitos básicos para executar uma loja Magento 2:

• Servidor: Sistema operativo baseado em Linux (Ubuntu, CentOS, Debian)
• Servidor Web: Apache 2.4 ou Nginx 1.8+
• PHP: Versão 8.1 ou 8.2 com as extensões necessárias
• Base de dados: MySQL 8.0 ou MariaDB 10.4+
• Compositor: Versão 2.x para gerir dependências
• Memória: Pelo menos 2 GB de RAM (recomenda-se mais de 4 GB)
• Armazenamento: SSD para um melhor desempenho
• Certificado SSL: Necessário para transacções seguras
• Chaves de autenticação Magento: Obtém as chaves de autenticação do Repositório do Magento Composer. Precisarás destas credenciais durante a instalação.
• Acesso ao servidor: Assegura-te que tens acesso SSH ao teu servidor e as permissões necessárias para instalar e configurar o Magento 2.

Post relacionado: Como corrigir o erro de conexão SSH recusada: Um Guia Detalhado

Como instalar o Magento 2 através do Composer?

A instalação do Magento pode ser complexa e demorada, mas o Composer pode simplificar o processo. Dito isso, vamos agora cobrir os principais detalhes para instalar o Magento com sucesso usando o Composer.

Passo 1: Instala o Magento Composer usando a linha de comando ou um link de transferência

O Composer é um popular gestor de dependências para PHP que simplifica a instalação e a gestão de pacotes para aplicações PHP. Pode ser instalado usando a linha de comando ou um link de download.

Vê como:

1. Instalar o Composer usando a linha de comando:

a) Descarrega o ficheiro de instalação do Composer executando o seguinte comando no teu terminal:

curl -sS https://getcomposer.org/installer | php

b) Faz o download do ficheiro de instalação do Composer e guarda-o como composer.phar no diretório atual.

c) Move o ficheiro composer.phar para um diretório na tua variável $PATH. Podes usar o seguinte comando para o mover para /usr/local/bin/:

$ sudo mv composer.phar /usr/local/bin/composer

d) Verifica se o Composer está instalado, executando o seguinte comando:

$ composer --version

2. Instala o Composer usando um link de download:

a) Vai ao sítio Web oficial do Composer (https://getcomposer.org/download/) e transfere o ficheiro de instalação do Composer para o teu sistema operativo.

b) Quando a transferência estiver concluída, move o ficheiro transferido para um diretório na tua variável $PATH. Por exemplo, se estiveres a usar o macOS, podes mover o ficheiro para /usr/local/bin/.

c) Renomeia o ficheiro para composer (sem a extensão .phar) executando o seguinte comando:

sudo mv composer.phar /usr/local/bin/composer

d) Verifica se o Composer está instalado, executando o seguinte comando:

$ composer --version

Pronto! Instalaste o Composer com sucesso usando a linha de comando ou um link de download. Agora, podes utilizar o Composer para gerir as dependências das tuas aplicações PHP.

Nota: Se tiveres algum problema técnico, podes perguntar nos comentários. Para obter mais informações, consulta a a documentação oficial do Magento.

Passo 2: Inicia sessão como proprietário de um sistema de ficheiros

1. Antes de instalar o Magento 2, tens de aceder ao diretório onde o queres instalar, como por exemplo public_html ou var/www/html/magento2. Se estiveres logado no servidor Magento, certifica-te de que o proprietário do sistema de arquivos do diretório do servidor é um usuário com permissão de “escrita” no sistema de arquivos do Magento.

2. Adiciona <magento_root>/bin ao PATH do teu sistema para executar comandos Magento a partir de qualquer diretório.

exporta PATH=$PATH:/var/www/html/magento2/bin

Opcionalmente, podes executar os comandos das seguintes formas:

cd <magento_root>/bin e executa-os como ./magento <nome do comando>
<magento_root>/bin/magento <nome do comando>
<magento_root> é um subdiretório do docroot do teu servidor web.

Nota: Segue as instruções para descarregar o pacote Magento Meta.

Passo 3: Transfere o Magento

Podes descarregar a versão Magento 2 diretamente do seu site oficial.

OU

Executa um comando usando o composer para baixar uma versão específica do Magento 2.

Comanda:

composer create-project --repository-url=https://repo.magento.com/
magento/project-community-edition <install-diretory-name>

Magento Open Source

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition:2.4.6 .

Adobe Commerce (Enterprise)

composer create-project --repository-url=https://repo.magento.com/
magento/project-enterprise-edition:2.4.6

Na instalação do Magento, podes especificar a versão específica do Magento (2.0, 2.1, 2.2.1, 2.2.2, 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.3, 2.4) utilizando o comando acima.

Nota: Para instalar o Magento 2 usando o composer no diretório atual (por exemplo, public_html), lembra-te de adicionar o ponto (.) no final.

Durante este processo, antes de descarregar o Magento, ser-te-á pedido que insiras o teu nome de utilizador e palavra-passe repo.magento.com.

⚠️ Importante: Tens de gerar chaves de autenticação:

Para obteres o nome de utilizador e a palavra-passe em repo.magento.com, inicia sessão em Mercado Magento e seleciona Minha conta no canto superior direito. Agora clica em Chaves de acesso e Gera as tuas novas SECURE KEYS.

• Chave pública: É o teu nome de utilizador
• Chave privada: É a tua palavra-passe

Depois de inserires o teu nome de utilizador e a tua palavra-passe repo.magento.com, ser-te-ão pedidas as credenciais da loja. Digita“Sim“.

Em seguida, o Magento 2 começará a ser descarregado no teu servidor.

Passo 4: Define a permissão para instalar o Magento 2.4

Para instalar o Magento 2, tens de definir as permissões adequadas para a tua loja Magento 2. O Magento recomenda um conjunto de permissões que deves aplicar.

a ) O proprietário deve ter pleno acesso aos ficheiros.

b ) O servidor Web tem de ter permissão de escrita para os diretórios var, app/etc e pub.

c ) Executa a permissão de bin/magento.

Nesta fase, é necessário executar determinados comandos para obter permissões:

Comanda:

encontra . -type f -exec chmod 644 {} \; 
encontra . -type d -exec chmod 755 {} \; 
encontra var generated vendor pub/static pub/media app/etc -type f -exec chmod u+w {} +
encontra var generated vendor pub/static pub/media app/etc -type d -exec chmod u+w {} +
chmod u+x bin/magento
chmod 644 ./app/etc/*.xml
chmod -Rf 775 bin

Passo 5: Cria uma base de dados para a instalação do Magento

Cria uma base de dados vazia com MySQL/MariaDB

Comanda:

mysql -u [mysqluser] -p -e "CREATE DATABASE magento2;"

Passo 6: Instala o Magento 2.4

Agora, tens de executar o comando de instalação do Magento

Comanda:

php bin/magento setup:install --base-url="http://phpstack-739336-2511019.cloudwaysapps.com/"
--db-host="167.99.205.158"
--db-name="magento2"
--db-user="yrzhqayjyq"
--db-password="VA2r8RdxAe"
--admin-firstname="Admin"
--admin-sobrenome="Admin"
--admin-email="[email protected]"
--admin-user="admin"
--admin-password="Testing123%567"
--use-rewrites="1"
--backend-frontname="admin"
--db-prefix=mage_

O comando acima garante o seguinte:

• URL de base: “http://yoururl/claudwoys.com” é definido como o URL da tua aplicação.
• Anfitrião da base de dados (db-host): O nome do anfitrião ou o endereço IP do teu servidor.
• Nome do banco de dados (db-name): O nome da tua base de dados Magento.
• Utilizador da base de dados (db-user): O nome de utilizador da tua base de dados.
• Palavra-passe da base de dados (db-password): A palavra-passe da tua base de dados.
• Credenciais do administrador: Podes personalizar o nome, o apelido e outros parâmetros do administrador, conforme necessário.

Nota: Este comando é executado com dados fictícios. Tens de preencher estas informações com base nas informações da tua aplicação.

Agora instalaste com sucesso o Magento 2 usando o Composer. Vamos começar com as configurações.

Agora, só tens de fazer a verificação de prontidão e iniciar a tua loja Magento.

Depois de instalar o Magento, utiliza os comandos abaixo para otimizar e proteger a tua loja:

Define o modo de produção (para um melhor desempenho):

php bin/magento deploy:mode:set production

Habilita os Cron Jobs (necessários para tarefas do Magento como a indexação):

php bin/magento cron:install

Reindexar e limpar a cache (para evitar problemas de frontend/backend):

php bin/magento indexer:reindex
php bin/magento cache:flush

7. Pré-visualizar a tua loja Magento 2

Depois de uma instalação bem sucedida do Magento 2 no teu servidor Cloudways usando o composer, é assim que o teu Magento 2 Frontend e Backend deve parecer.

Frontend

Backend

Nota: Se estás a instalar o Magento 2 usando o Composer e queres configurar o Varnish nele, então segue o nosso tutorial de como configurar o Magento 2 com Varnish.

Como instalar o Magento 2 usando a plataforma Cloudways (super fácil)

A instalação do Magento 2 pode ser um processo demorado, especialmente para os proprietários de lojas que querem se concentrar no crescimento de seus negócios, em vez de lidar com configurações técnicas complexas. É aí que entra a Cloudways.

Na Cloudways, simplificamos a instalação do Magento 2 com uma plataforma intuitiva que elimina a necessidade de configurações manuais do servidor. Nossa plataforma fornece todos os requisitos de servidor necessários, garantindo uma configuração perfeita e um ótimo desempenho desde o início.

Sugestão: Podes solicitar uma demonstração ao vivo para testar o desempenho do Magento na Cloudways.

Agora que já tirámos isso do caminho, vamos ver como podes instalar o Magento 2 usando a plataforma Cloudways em alguns passos simples.

Passo 1: Regista-te/Login na tua conta

• Inscreve-te na Cloudways se ainda não tiveres uma conta, ou inicia sessão se já fores um utilizador Cloudways.

Passo 2: Seleciona a aplicação Magento

• Depois de iniciar sessão, cria um servidor e seleciona a versão para instalar o Magento a partir do menu pendente Aplicação. Além disso, fornece os detalhes do servidor e o nome do aplicativo.

Seleciona a aplicação:

• Preenche os restantes campos para instalar o Magento.

Passo 3: Escolhe os fornecedores de serviços em nuvem

• Seleciona o fornecedor de serviços em nuvem da tua escolha.

Passo 4: Seleciona o tamanho do servidor e a largura de banda

• Seleciona o tamanho do servidor e a largura de banda de acordo com as tuas necessidades.

Passo 5: Define o armazenamento do servidor

• Agora, seleciona o Armazenamento do servidor. Podes sempre aumentar a escala sempre que necessário.

Passo 6: Selecionar a localização do servidor

• Escolhe a localização do teu servidor tendo em conta o fator latência.

• Agora clica no botão Launch Server na parte inferior da página e aguarda a preparação do teu servidor.

• Vai ao teu servidor e verifica os detalhes do servidor e da aplicação
• Quando o servidor estiver pronto, vai a Application Management na barra de menu superior e entra na tua loja Magento 2 usando os Access Details.

Detalhes do servidor:

Detalhes da aplicação:

Verifica a tua candidatura:

Instalar o Magento 2 com o Composer – Dicas de resolução de problemas

Por vezes, as coisas não correm como planeado durante a instalação. Aqui estão alguns problemas comuns que podes encontrar durante o processo de instalação e algumas soluções possíveis:

1. Mensagem “Erro fatal: A mensagem “Erro fatal: O tamanho de memória permitido está esgotado”:

Este erro pode ocorrer quando o limite de memória do PHP está definido muito baixo. Podes tentar aumentar o limite de memória no teu ficheiro php.ini, adicionando a seguinte linha:

memory_limit = 2G

Se isso não funcionar, podes também tentar executar o seguinte comando no teu terminal:

php -d memory_limit=-1 /usr/local/bin/composer install

2. Mensagem “Classe ‘Locale’ não encontrada”:

Este erro pode ocorrer quando a extensão PHP para o pacote ‘intl’ não está instalada. Podes instalar o pacote ‘intl’ executando o seguinte comando no teu terminal:

sudo apt-get install php-intl

3. Mensagem “A extensão PHP solicitada ext-iconv * está em falta no teu sistema”:

Este erro pode ocorrer quando a extensão PHP para o pacote ‘iconv’ não está instalada. Podes instalar o pacote ‘iconv’ executando o seguinte comando no teu terminal:

sudo apt-get install php-iconv

4. Mensagem “A extensão PHP solicitada ext-mbstring * está em falta no teu sistema”:

Este erro pode ocorrer quando a extensão PHP para o pacote ‘mbstring’ não está instalada. Podes instalar o pacote ‘mbstring’ executando o seguinte comando no teu terminal:

sudo apt-get install php-mbstring

5. Mensagem “Não foi possível abrir o ficheiro de entrada: composer.phar”:

Este erro pode ocorrer quando o ficheiro “composer.phar” não está localizado no diretório correto. Certifica-te de que estás a executar o comando a partir do diretório onde se encontra o ficheiro ‘composer.phar’. Se o ficheiro não estiver nesse diretório, podes transferi-lo do site do Composer e movê-lo para o diretório correto.

Palavras finais

Parabéns por teres instalado com sucesso o Magento 2 usando o Composer! Agora que já tens a tua loja Magento 2 configurada, podes começar a personalizá-la e a adicionar produtos para expandir o teu negócio online.

Se estás à procura de uma forma descomplicada de alojar e gerir a tua loja Magento, a Cloudways oferece hospedagem gerenciada Magento com recursos integrados de desempenho e segurança. Dessa forma, você pode se concentrar no crescimento do seu negócio sem se preocupar com o gerenciamento do servidor.

Se tiveres alguma dúvida ou achares que nos falta alguma coisa, diz-nos nos comentários abaixo.

Instalar Magento 2 FAQs

php bin/magento setup:install

Jyotishna Kumari

Jyotishina é a Especialista da Comunidade Magento na Cloudways e tem 4 anos de experiência em desenvolvimento web. Trabalha em sites de e-commerce desde a virada do milênio e já trabalhava com Magento antes da versão 1 ser lançada. Adora viajar e explorar novas ideias sempre que tem tempo. Entra em contacto com ela em [email protected].

Get Connected on: Twitter Community Forum