Joomla 4/5 User Manual
Manual Index
Configurando seu ambiente local
Tutorial
Como configurar um ambiente local para o Joomla 4 Joomla! 4.x
Com o Joomla! 4 nós mudamos o processo de desenvolvimento. Não é mais possível clonar o repositório e ter uma instalação utilizável do Joomla. Seguimos as melhores práticas e implementamos um processo de construção para o sistema de gerenciamento de conteúdo (cms).
Guia de início rápido¶
Os passos para configurar seu ambiente de desenvolvimento dependem de seu sistema operacional. Não podemos escrever documentação para cada sistema operacional (os), use seu mecanismo de pesquisa favorito para encontrar um tutorial.
Ferramentas que você precisa¶
- PHP - basicamente o mesmo que você precisa para executar um site Joomla, mas você precisa da versão CLI (interface de linha de comando) do PHP. (Veja a página Configurando um servidor LAMPP para desenvolvimento PHP.)
- Composer - para gerenciar as dependências PHP do Joomla. Para obter ajuda na instalação do Composer, leia a documentação em https://getcomposer.org/doc/00-intro.md.
- Node.js - para compilar os arquivos JavaScript e SASS do Joomla. Para obter ajuda na instalação do Node.js, siga as instruções disponíveis em https://nodejs.org/pt-br/. Observe que você precisará do NodeJS 12 ou superior para instalar o Joomla.
- Git - para gerenciamento de versões.
Passos para configurar o ambiente local¶
- Clonar o repositório;
- selecionar a ramificação 4.1-dev;
- executar
composer install
a partir da raiz do repositório git; (Você pode adicionar --ignore-platform-reqs se você não tiver o PHP-LDAP instalado localmente e não precisar dele.) - executar
npm ci
na raiz do repositório git. (Observe que você precisa do npm 6.13.4 ou superior para isso. Executenpm install -g npm@lts
para atualizar sua versão do npm para a versão LTS.)
Usuários do Linux e do OSX podem configurar o seguinte alias bash colocando o seguinte dentro do arquivo ~/.bashrc:
alias jclean="rm -rf administrator/templates/atum/css; \
rm -rf templates/cassiopeia/css; \
rm -rf administrator/templates/system/css; \
rm -rf templates/system/css; \
rm -rf media/; \
rm -rf node_modules/; \
rm -rf libraries/vendor/; \
rm -f administrator/cache/autoload_psr4.php; \
rm -rf installation/template/css"
alias jinstall="jclean; composer install; npm ci"
Isso excluirá todos os arquivos compilados em seu sistema e executará
uma nova instalação como um comando chamando jinstall
dentro de sua
instalação do Joomla. Você também pode usar o comando jclean
para
voltar para uma ramificação do Joomla 3.x
Guia de início um pouco mais longo¶
O Joomla é semelhante à muitas outras ferramentas da web nos dias de hoje. Tem uma grande parte PHP e tem cada vez mais código JavaScript. Embora a codificação PHP não precise de muita preparação, o JavaScript precisa de muitas ferramentas. A principal razão é que ninguém escreve código de uma maneira que todos os navegadores entendam, então o código precisa ser transpilado de, por exemplo, ES6 para uma versão compatível de JavaScript. O mesmo vale para CSS. Para Joomla, estamos usando SASS e isso será convertido em CSS nativo para que qualquer navegador o entenda. No lado negativo, configurar um ambiente de desenvolvimento é um pouco mais complicado, mas as ferramentas tornam a codificação mais conveniente. Graças aos observadores e ao recarregamento automático do navegador, você pode ver suas alterações em tempo real.
PHP¶
Deve ser o suficiente para executar composer install
, pois isso
instalará as dependências do PHP salvas no arquivo composer.lock. Você
pode fazer isso quantas vezes quiser. Ele só instalará novos pacotes
quando o arquivo composer.lock for alterado. Não execute
composer update
pois isso atualizará todos os pacotes para versões
mais recentes e atualizará o arquivo composer.lock.
Observação: Você pode precisar executar composer install
com a
opção --ignore-platform-reqs
para ignorar os requisitos de plataforma
especificados no Composer. Ou seja, se você não tiver a extensão LDAP do
PHP instalada.
Scripts node/npm¶
O Node.js vem com um gerenciador de pacotes chamado NPM (em alguns
aspectos o mesmo que o Composer). O NPM possui um comando run
e
preparamos alguns scripts para facilitar sua vida. Você precisa executar
os comandos para a raiz do repositório ao alterar os arquivos JS ou
SASS. Anteriormente, você precisa(va) executar npm ci
uma vez, para
instalar dependências.
npm run build:css¶
Ele compilará arquivos SASS para CSS e também criará os arquivos minificados.
npm run build:js¶
Ele irá compilar e transpilar os arquivos JavaScript para o formato correto e criar arquivos minificados.
npm run watch¶
Este é o mesmo que o comando build:js
, mas observará as alterações e
criará automaticamente os arquivos atualizados no diretório de mídia. Os
arquivos SASS ainda não estão incluídos.
npm run lint:js¶
Isso executará uma verificação de sintaxe em todos os arquivos JavaScript ES6 em relação ao padrão de código javascript (para obter mais informações sobre o padrão de estilo de código do Joomla 4, leia o manual de padrões de codificação.
npm run test¶
Isso executará um conjunto de testes JavaScript.
Possíveis problemas¶
Ao executar o composer install você pode encontrar esses erros
Problem 1
- Installation request for joomla/ldap 2.0.0-beta -> satisfiable by joomla/ldap[2.0.0-beta].
- joomla/ldap 2.0.0-beta requires ext-ldap * -> the requested PHP extension ldap is missing from your system.
Problem 2
- Installation request for symfony/ldap v5.1.5 -> satisfiable by symfony/ldap[v5.1.5].
- symfony/ldap v5.1.5 requires ext-ldap * -> the requested PHP extension ldap is missing from your system.
A solução é executar composer install com a opção
--ignore-platform-reqs
para ignorar os requisitos de plataforma
especificados no Composer. Ou seja, se você não tiver a extensão LDAP do
PHP instalada.
composer install --ignore-platform-reqs
Se você receber um erro de início de sessão como mostrado abaixo, exclua
o arquivo library/autoload_psr4.php
conforme mostrado na segunda
imagem.