# Configuração O Chamilo 2.0 utiliza variáveis de ambiente e arquivos de configuração do Symfony para suas configurações principais. Esta página aborda os principais arquivos de configuração e variáveis. ## Variáveis de Ambiente (.env) O arquivo de configuração principal é o `.env`, localizado no diretório raiz do Chamilo. Este arquivo contém configurações específicas do ambiente que não devem ser incluídas no controle de versão. Um arquivo padrão `.env.dist` é fornecido com o Chamilo e contém valores padrão documentados. Crie o arquivo `.env` (necessário para iniciar a instalação) para sobrescrever os valores conforme o seu ambiente. ### Variáveis Principais | Variável | Descrição | Exemplo | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- | | `APP_ENV` | O ambiente da aplicação, no nível do Symfony. Use `prod` para produção, `dev` para desenvolvimento, 'test' para testes. | `prod` | | `APP_SECRET` | Uma string aleatória usada para tokens CSRF, assinatura de cookies e outras operações criptográficas. O Chamilo gera um valor único para cada instalação. Não o modifique. | `a1b2c3d4e5f6...` | | `DATABASE_HOST` | O host do banco de dados. O padrão é localhost. | `localhost` | | `DATABASE_PORT` | A porta do banco de dados. O padrão é 3306 para MySQL/MariaDB. | `3306` | | `DATABASE_NAME` | O nome do banco de dados, conforme fornecido por você ao assistente de instalação. | Veja abaixo. | | `DATABASE_USER` | O nome de usuário do banco de dados, conforme fornecido por você ao assistente de instalação. | Veja abaixo. | | `DATABASE_PASSWORD` | A senha do usuário do banco de dados, conforme fornecida por você ao assistente de instalação. | Veja abaixo. | | `TRUSTED_PROXIES` | (Opcional) Se você estiver hospedando o Chamilo atrás de um proxy reverso, precisará fornecer o(s) IP(s) do proxy reverso aqui para que o Chamilo possa interpretar chamadas e gerar respostas corretamente. | | Outras configurações no arquivo `.env` são raramente modificadas. Observe que, em versões futuras, as configurações `DATABASE_*` serão combinadas em uma única variável `DATABASE_URL`. A configuração de envio de e-mails é apresentada durante a instalação, mas pode ser modificada posteriormente na seção `Configurações da Plataforma` do painel de administração. ## Configuração do Symfony (diretório config/) A configuração no nível do Symfony está localizada no diretório `config/`. Esses arquivos YAML controlam o comportamento do framework, definições de serviços e configurações específicas de pacotes. Não é comum precisar modificar esses arquivos, e alterá-los pode tornar seu portal inoperante, então, por favor, não tente modificá-los se precisar garantir a disponibilidade do sistema. ### Arquivos de Configuração Principais | Arquivo | Finalidade | | -------------------------------- | ------------------------------------------------------------------------------- | | `config/authentication.yaml` | Configuração dos métodos de autenticação. | | `config/packages/doctrine.yaml` | Configuração do banco de dados e ORM. | | `config/packages/security.yaml` | Autenticação, firewalls, controle de acesso e hierarquias de papéis. | | `config/packages/cache.yaml` | Configuração do adaptador de cache (sistema de arquivos, APCu, Redis). | | `config/packages/framework.yaml` | Configurações gerais do framework Symfony (sessão, CSRF, roteador, cache HTTP). | | `config/packages/twig.yaml` | Configuração do motor de templates. | | `config/services.yaml` | Definições de serviços da aplicação e injeção de dependências. | ### Sobrescritas Específicas por Ambiente O Symfony suporta configurações por ambiente. Arquivos em `config/packages/prod/` sobrescrevem os padrões quando `APP_ENV=prod`, e `config/packages/dev/` sobrescreve quando `APP_ENV=dev`. Por exemplo, `config/packages/prod/monolog.yaml` geralmente configura um registro de logs menos detalhado do que o equivalente no ambiente de desenvolvimento. O Chamilo não define nenhuma configuração em `config/packages/prod/` no próprio software, então, se você quiser personalizar configurações de `config/packages/*.yaml`, basta criar uma cópia do arquivo YAML dentro desse diretório e alterar as configurações lá. ## Permissões de Arquivos Fizemos esforços na versão 2.0+ para garantir que apenas um diretório precise de permissões. Este é o diretório `var/`, e para evitar problemas complexos, basta definir a pasta inteira como gravável pelo usuário do sistema do servidor web. Defina as permissões apropriadamente em sistemas baseados em Debian: ```bash # Para sistemas onde o servidor web roda como www-data chown -R www-data:www-data var/ chmod -R 775 var/ ``` ## Tarefas Comuns de Configuração ### Mudar para o Modo de Produção ```bash # No arquivo .env APP_ENV=prod APP_DEBUG=0 ``` Em seguida, limpe e aqueça o cache: ```bash php bin/console cache:clear --env=prod php bin/console cache:warmup --env=prod ``` ### Configurar Proxies Confiáveis Se o Chamilo estiver rodando atrás de um proxy reverso ou balanceador de carga, configure os proxies confiáveis para que a detecção de HTTPS e a resolução de IP do cliente funcionem corretamente: ```yaml # .env TRUSTED_PROXIES='127.0.0.1,PROXY_IP' ``` ### Configurar Armazenamento de Sessões Por padrão, as sessões são armazenadas no sistema de arquivos. Para implantações em múltiplos servidores, configure sessões baseadas em Redis ou banco de dados: ```yaml # config/packages/framework.yaml framework: session: handler_id: 'redis://localhost:6379' ``` *** ## Dicas * **Nunca edite `.env.dist` diretamente** -- Sempre use `.env` para suas personalizações. O arquivo `.env.dist` pode ser sobrescrito durante atualizações. * **Mantenha `APP_DEBUG=0` em produção** -- O modo de depuração expõe informações sensíveis nas páginas de erro. * **Faça backup de `.env`** separadamente do código-fonte, pois ele contém credenciais e é excluído do controle de versão. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.chamilo.org/2.x-pt/guia-de-administracao/admin-guide/installation/configuration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.