View source for Setting Up Your Local Environment/pt-br

<noinclude><languages /></noinclude>
{{Top portal heading|color=white-bkgd|icon=magic|icon-color=#5091cd|size=3x|text-color=#333|title=Tutorial<br />
Como configurar um ambiente local para o Joomla 4}}
<noinclude>{{Joomla version|version=4.x}}</noinclude>
{{-}}
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 [[S:MyLanguage/Configuring_a_LAMPP_server_for_PHP_development|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.
# <span class="mw-translate-fuzzy">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.</span>
# Git - para gerenciamento de versões.

<div class="mw-translate-fuzzy">
=== Passos para configurar o ambiente local ===
</div>
# Clonar o repositório;
# <span class="mw-translate-fuzzy">selecionar a ramificação ''4.1-dev'';</span>
# <span class="mw-translate-fuzzy">executar <tt>composer install</tt> 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.)</span>
# <span class="mw-translate-fuzzy">executar <tt>npm ci</tt> na raiz do repositório git. (Observe que você precisa do npm 6.13.4 ou superior para isso. Execute <tt>npm install -g npm@lts</tt> para atualizar sua versão do npm para a versão LTS.)</span>
Usuários do Linux e do OSX podem configurar o seguinte alias bash colocando o seguinte dentro do arquivo ''~/.bashrc'':

<syntaxhighlight lang="bash">
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"
</syntaxhighlight>

Isso excluirá todos os arquivos compilados em seu sistema e executará uma nova instalação como um comando chamando <tt>jinstall</tt> dentro de sua instalação do Joomla. Você também pode usar o comando <tt>jclean</tt> para voltar para uma ramificação do Joomla 3.x


== Guia de início um pouco mais longo ==
<span class="mw-translate-fuzzy">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.</span>

=== PHP ===
Deve ser o suficiente para executar <tt>composer install</tt>, 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 <tt>composer update</tt> pois isso atualizará todos os pacotes para versões mais recentes e atualizará o arquivo ''composer.lock''.

'''Observação:''' Você pode precisar executar <tt>composer install</tt> com a opção <tt>--ignore-platform-reqs</tt> 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 ===

<span class="mw-translate-fuzzy">O Node.js vem com um gerenciador de pacotes chamado NPM (em alguns aspectos o mesmo que o Composer). O NPM possui um comando <tt>run</tt> 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 <tt>npm ci</tt> uma vez, para instalar dependências.</span>

==== 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 <tt>build:js</tt>, 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.

<div class="mw-translate-fuzzy">
==== 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 [https://developer.joomla.org/coding-standards/introduction.html| manual de padrões de codificação].
</div>

==== npm run test ====
Isso executará um conjunto de testes JavaScript.

==Possíveis problemas==
Ao executar o composer install você pode encontrar esses erros

<syntaxhighlight lang="bash">
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.
</syntaxhighlight>

A solução é executar composer install com a opção <tt>--ignore-platform-reqs</tt> para ignorar os requisitos de plataforma especificados no Composer. Ou seja, se você não tiver a extensão LDAP do PHP instalada. 

<syntaxhighlight lang="bash">composer install --ignore-platform-reqs</syntaxhighlight>

<span class="mw-translate-fuzzy">Se você receber um erro de início de sessão como mostrado abaixo, exclua o arquivo <tt>library/autoload_psr4.php</tt> conforme mostrado na segunda imagem.</span>

[[File:Install-error.png|border|center|400px|Login After Install Error]]

<noinclude>
[[Category:Development{{#translation:}}]]
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
</noinclude>