O Magento 2 tem requisitos de servidor muito específicos que exigem muita configuração do servidor e ajustes, juntamente com a configuração do Composer (não é uma opção padrão em muitas plataformas). Neste tutorial, vou mostrar-te como instalar e configurar o Magento 2 num servidor local usando o XAMPP.
XAMPP é uma solução de servidor web livre e de código aberto que te permite executar o Magento 2 em sua máquina local para fins de desenvolvimento e testes. No final deste tutorial, terás uma instalação totalmente funcional do Magento 2 a correr no teu localhost.
- Benefícios do Magento 2 no Localhost
- Pré-requisitos do Magento 2 para Localhost
- Instalar e configurar o XAMPP
- Criar uma base de dados no phpMyAdmin
- Instalar o Composer para Magento
- Descarregar Magento Using Composer
- Instalar o Elasticsearch para Magento 2
- Instalar o Magento 2 usando a linha de comando
- Problemas comuns com as versões do Magento 2
Benefícios do Magento 2 no Localhost
Estes são os seguintes benefícios de instalar o Magento 2 em um localhost:
- Executar o Magento 2 no localhost elimina a necessidade de um plano de alojamento dedicado, que pode ser dispendioso.
- Uma instalação local do Magento 2 permite-te trabalhar no teu site offline sem uma ligação à Internet.
- Uma instalação local permite que os programadores testem novas funcionalidades e extensões antes de as implementarem num site ativo.
- Uma instalação local permite-te personalizar o teu site sem o risco de danificar o site em funcionamento.
- Os ambientes de host local têm normalmente um desempenho mais rápido do que os servidores remotos porque não existe latência na comunicação de rede.
- Ao executar o Magento 2 num localhost, podes proteger a tua loja de acessos não autorizados e tentativas de hacking.
- Uma instalação localhost permite-te fazer facilmente cópias de segurança e restaurar o teu sítio web em caso de problema.
Experimenta a Loja de Demonstração Magento 2 da Cloudways – Não são necessários conhecimentos técnicos!
Experimenta uma loja Magento 2 totalmente funcional construída em cima do famoso alojamento Cloudways para oferecer as velocidades mais rápidas.
Pré-requisitos do Magento 2 para Localhost
Antes de instalar o Magento usando o Composer, deves verificar os pré-requisitos e os requisitos do sistema que precisam de ser instalados.
- Apache/NGINX Versão 2.2 ou 2.4
- Versão PHP 7.4.x ou 8.1.x
- MySQL/MariaDB Versão 5.6.x, 5.7.x ou Maria DB
- Elasticsearch 7.6.x ou superior
Leva a tua loja de comércio eletrónico Magento para o próximo nível com a Cloudways.
Começa hoje e experimenta velocidades de carregamento extremamente rápidas, escalabilidade perfeita e suporte especializado 24 horas por dia, 7 dias por semana.
Instalar e configurar o XAMPP
Vou abordar a instalação do Magento 2 no localhost para que não tenhas problemas ao seguir o processo.
Passo: 1 Descarrega o servidor XAMPP
Vai a Apache Friends e faz o download do servidor XAMPP.
O Magento recomenda fortemente que instales o XAMPP com a versão 8.1.x do PHP para o M2.4.5. Além disso, podes instalar o Magento 2.4 com o PHP 7.3, mas não é testado ou recomendado.
Passo: 2 Instala o servidor XAMPP
Depois de fazeres o download do XAMPP, faz duplo clique no ficheiro para o instalares no teu computador.
Clica no botão Seguinte.
Deixa a seleção por defeito como na imagem. Clica no botão Seguinte.
Escolhe a tua pasta de instalação. A localização predefinida é C:\xampp, mas é recomendável selecionar um diretório diferente da unidade C:\, como D:\ ou E:\, conforme a tua conveniência.
Se for necessário alterar, clica no ícone Procurar para alterar o destino do programa XAMPP e, em seguida, clica no botão Seguinte para ir para o passo seguinte.
Clica no botão Seguinte.
Clica no botão Seguinte.
Aguarda até que o assistente de configuração instale o XAMPP no teu computador.
Quando a configuração estiver concluída, verás a opção “Queres iniciar o Painel de Controlo agora?“. Mantém-na selecionada. Clica em Finish para saíres da configuração e entrares no Painel de Controlo XAMPP.
Passo: 3 Configura o PHP
No Painel de Controlo XAMPP, clica no botão Config na linha Apache e clica em PHP (php.ini).
No ficheiro php.ini, encontra estas linhas e remove os pontos e vírgulas (😉 antes de cada linha:
;extensão=intl
;extension=soap
;extensão=sockets
;extensão=sódio
;extension=xsl
;extensão=gd
Aumenta o memory_limit para 4G:
memory_limit=4G
Depois de o fazeres, guarda e fecha o ficheiro. Em seguida, clica no botão Start (Iniciar) em 2 linhas do Apache e do MySQL para os iniciar. Não saias do XAMPP depois deste passo, apenas deixa-o correr.
Passo: 4 Configurar o ficheiro Hosts
Acesso ao diretório C:\Windows\System32\drivers\etc\hosts.
Acrescenta a seguinte linha à última linha:
127.0.0.1 www.localhost.com
Abre o Painel de Controlo XAMPP e inicia as aplicações Apache e MySQL .
Criar uma base de dados no phpMyAdmin
Acede ao URL http://localhost/phpmyadmin, para criar uma base de dados. Coloca um nome de base de dados (por exemplo, Magento2) e clica em Criar.
Clica no botão Seguinte para criar a base de dados.
Base de dados criada com sucesso.
Nota: Lembra-te do nome da base de dados que vais criar, pois vais querer instalar o Magento nela mais tarde.
Instalar o Composer para Magento
A última versão do Magento, open source 2.4.0 em diante, é compatível com o Composer 2. Por isso, tens de instalar o Composer 2 para descarregar o Magento 2 com a versão mais recente.
A melhor forma de o fazer é transferir e executar o ficheiro Composer-Setup.exe. Isto irá instalar a versão mais recente e configurar o teu caminho para “chamar” o Composer a partir de qualquer diretório.
Clica no botão Next (Seguinte ) e procura o caminho do PHP na pasta XAMPP.
É opcional introduzir o teu URL de proxy.
Agora clica no botão Instalar para iniciar o passo final.
Clica no botão Seguinte.
Clica no botão Concluir.
Abre o prompt de comando e executa o comando do Composer para verificar se ele foi instalado sem problemas.
Descarregar Magento Using Composer
Em seguida, cd para C:\xampp\htdocs e executa o seguinte comando usando o Composer para fazer o download de uma versão específica do Magento 2.
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.4.5 <install-diretory-name>
Magento Open Source
composer create-project --repository-url=https://repo.magento.com/magento/project-community-edition:2.4.5
Adobe Commerce (Enterprise)
composer create-project --repository-url=https://repo.magento.com/magento/project-enterprise-edition:2.4.5
Com o comando acima, 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). Caso contrário, ignora a versão e executa o comando abaixo:
Em seguida, introduz as tuas chaves de autenticação Magento. As chaves públicas e privadas são criadas e configuradas na tua conta do mercado Magento.
Navega até ao nome da conta no canto superior direito da página e seleciona O meu perfil.
Em seguida, clica nas chaves de acesso do separador Mercado .
Clica em Criar uma nova chave de acesso. Introduz um nome específico para as chaves (por exemplo, o nome do programador que recebe as chaves) e clica em OK.
Copia a chave pública no nome de utilizador e a chave privada na palavra-passe para instalar o Magento.
Deve demorar algum tempo até que o compositor descarregue e instale todos os módulos necessários. Quando tudo estiver terminado, isto é o que deves ver:
Instalar o Elasticsearch para Magento 2
Elasticsearch é uma extensão altamente recomendada para as versões 2.4.X do Magento.
Descarrega o Elasticsearch 7.6.0: https://www.elastic.co/downloads/past-releases/elasticsearch-7-6-0 (O Magento 2.4.x é testado apenas com o Elasticsearch 7.6.x. Podes utilizar outras versões 7.x à tua discrição, mas recomendamos que utilizes a versão testada do Elasticsearch).
Extrai o ficheiro .zip que acabaste de descarregar. Numa janela de terminal, vai para o diretório extraído e executa este comando:
.\bin\elasticsearch.bat
Também podes verificar a disponibilidade do Elasticsearch na porta:9200. Escreve local:9200 no browser e obterás os detalhes da extensão Elasticsearch instalada.
{
"nome" : "DESKTOP-Jyoti",
"nome_do_cluster" : "elasticsearch",
"cluster_uuid" : "ONNrUlTWQCSoigYBy6WF9g",
"versão" : {
"número" : "7.9.3",
"build_flavor" : "default",
"build_type" : "zip",
"build_hash" : "c41E4fgiueQSoiytrBW",
"build_date" : "2023-02-02T09:51:41.449Z",
"build_snapshot" : falso,
"lucene_version" : "8.7.0",
"minimum_wire_compatibility_version" : "6.8.3",
"minimum_index_compatibility_version" : "6.8.3"
},
"tagline" : "Tu sabes, para pesquisa"
}
Instalar o Magento 2 usando a linha de comando
Abre a janela do prompt de comando. Em seguida, vai para o teu diretório Magento e executa o comando:
php bin/magento setup:install --base-url="http://localhost/magento2/" --db-host="localhost" --db-name="dbmagento241" --db-user="root" --admin-firstname="admin" --admin-lastname="admin" --admin-email="[email protected]" --admin-user="admin" --admin-password="admin123" --language="en_US" --currency="USD" --timezone="America/Chicago" --use-rewrites="1" --backend-frontname="admin" --search-engine=elasticsearch7 --elasticsearch-host="localhost" --elasticsearch-port=9200
Nota: Atribui o URL de base de acordo com o teu caminho, anota o nome de utilizador e a palavra-passe do administrador e não utilizes a porta do Elasticsearch.
Substitui estes valores:
- -base-url: a tua pasta de instalação do magento 2
- -db-name: o nome da tua base de dados ao criar a base de dados
- -db-password: a palavra-passe da tua base de dados
- -db-user: um utilizador da base de dados com permissão total. Utilizaremos o utilizador root predefinido.
- -db-password: a palavra-passe do teu utilizador da base de dados. Deixa-o em branco se estiveres a usar o utilizador ‘root’ da base de dados
- -admin-firstname: Nome próprio do administrador
- -admin-lastname: Apelido do administrador
- -admin-email: Endereço de correio eletrónico do administrador
- -admin-user: o nome de utilizador que vais utilizar para entrar no painel de administração
- -admin-password: a palavra-passe que vais utilizar para entrar no painel de administração
- -language: a língua que vais utilizar no teu painel de administração e na tua montra. Utiliza um código de idioma como en_US.
- -admin-email: altera-o para o teu e-mail
- -currency: define a moeda padrão a ser usada na tua loja. Entra em php bin/magento info:currency:list para uma lista de moedas suportadas juntamente com os seus códigos
- -timezone: muda para o fuso horário em que te encontras. Consulta a lista de fusos horários suportados para teres uma ideia melhor do que deves preencher.
- -url-rewrites: define como 1 para ativar as Reescritas do Servidor Web. Isto ajudará a classificar o teu site.
- -backend-frontname: define o teu URL de administração. Se omitires este parâmetro, o resultado será um URL gerado aleatoriamente para o teu caminho de administração do Magento (por exemplo, admin_jkhgdfq)
- -search-engine: define a versão do Elasticsearch que queres usar para esta instalação do Magento. O padrão é elasticsearch7
- -elasticsearch-host: o nome do host ou o endereço IP onde o Elasticsearch está sendo executado. O padrão é localhost
- -elasticsearch-port: o número da porta que o Elasticsearch está a ouvir. O padrão é 9200
Os outros valores são opcionais, podemos alterá-los mais tarde.
Agora, se tudo foi feito corretamente, o Composer 2 vai começar a instalar o Magento 2. O processo vai durar cerca de 10 minutos.
Sê paciente, pois pode demorar algum tempo a instalar todas as instâncias e módulos necessários para configurar o Magento 2.4.5.
Após a instalação, obterás estes resultados.
Executa os comandos
Agora, tens de executar os seguintes comandos.
php bin/magento indexer:reindex php bin/magento setup:upgrade php bin/magento setup:static-content:deploy -f php bin/magento cache:flush
Agora carrega no URL (normalmente localhost/magento2/pub/) ou no URL de base que definiste anteriormente para o in base-url durante a instalação.
Para Admin: Acede ao url com http://localhost/magento2/pub/admin.
Parabéns!
Agora instalaste com sucesso o Magento 2.4.5-p1 no teu localhost. Podes começar a fazer as tuas personalizações preferidas e lançar uma loja de comércio eletrónico totalmente funcional na máquina local.
Problemas comuns com as versões do Magento 2
Existe a possibilidade de encontrares um problema durante o processo de instalação do Magento 2.4.1 ou versões inferiores do Magento 2.4.5. Aqui estão alguns dos mais comuns, juntamente com uma solução.
1. Página cinzenta em branco – Painel de administração do Magento
Tudo o que tens de fazer é ir ao diretório path …\vendor\magento\framework\View\Element\Template\File\Validator.php
Na função isPathInDirectories, acrescenta uma linha.
$realPath = str_replace('', '/', $this->fileDriver->getRealPath($path));
Consulta a imagem seguinte para veres o ponto onde deves inserir a linha:
2. Se receberes um erro de autenticação
Se não conseguiste entrar no painel de administração do Magento e encontraste um erro de autenticação, basta executar o seguinte comando no Composer:
php bin/magento module:disable Magento_TwoFactorAuth
Resumo
Então é assim que tu podes instalar o Magento 2.4.5-p1 no localhost usando o Composer. Quando estiveres pronto para colocar a tua loja em funcionamento, não precisas de te preocupar com o desempenho, porque o Cloudways Managed Magento Hosting está aqui para aumentar as tuas vendas e remover os problemas de gestão do lado do servidor. Se enfrentares qualquer problema como um erro interno do servidor 500 depois de implementar as etapas acima, por favor, verifique aqui para corrigir o erro.
Concentra-te apenas em construir uma loja Magento 2 fantástica, e a Cloudways trata do resto. E se tiveres algum problema durante a instalação do Magento 2, podes ir em frente e perguntar-me através da secção de comentários.
Q) Como podes executar o Magento 2 em localhost?
A) Para executar o Magento 2 no localhost,
- terás de configurar um ambiente de servidor local como o XAMPP, WAMP ou MAMP.
- Instala o Apache, o MySQL e o PHP
- Em seguida, transfere o Magento 2
- Extrai-o e segue o assistente de configuração utilizando o teu browser.
- Certifica-te de que o teu sistema cumpre as extensões PHP necessárias.
Q) Quais são os requisitos de alojamento para o Magento 2?
A) Magento 2 requer:
– PHP: Versão 7.4 ou posterior.
– Base de dados: MySQL 8.0+ ou MariaDB 10.4+.
– Servidor Web: Apache 2.4+ ou Nginx 1.8+.
– RAM: Mínimo de 2GB (4GB+ recomendado).
– SO: Distribuições Linux (como Ubuntu) são preferidas.
– Extensões PHP adicionais como curl, mbstring, intl, e soap.
Q) O Magento pode funcionar em alojamento partilhado?
A) Sim, o Magento pode tecnicamente ser executado em hospedagem compartilhada, mas não é recomendado devido aos seus altos requisitos de recursos. Para obter o melhor desempenho e escalabilidade, é melhor usar VPS, nuvem ou hospedagem dedicada. A hospedagem compartilhada pode levar a tempos de carregamento lentos e controle limitado sobre as configurações do servidor.
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].
