Instalar CodeIgniter 4 com Composer: requisitos e configuração

Para um novo projeto CodeIgniter 4, confira a versão do framework e o PHP compatível. A documentação atual exige PHP 8.2 ou superior para versões recentes. Um projeto existente com CodeIgniter 4.6 e PHP 8.1 precisa de migração planejada e testada, não de atualização automática. Composer com App Starter é a forma habitual de iniciar.

Confira PHP, extensões e Composer

Execute os comandos para o PHP da linha de comando usado pelo Composer e para o PHP do servidor web. intl e mbstring são obrigatórias; json integra o PHP moderno. Ative driver MySQL, curl ou gd/imagick conforme os recursos utilizados. Composer deve atender aos requisitos do pacote. Compatibilidade histórica com PHP 8.1 não é requisito geral de uma instalação recente.

php -v
php -m
composer --version

Escolha o método

App Starter fornece o esqueleto e gerencia o framework em vendor por Composer. É possível baixar uma versão oficial manualmente, mas as atualizações exigem ler as notas e comparar arquivos do projeto. Não altere system; mantenha o código em app e siga as instruções de atualização.

Crie o projeto App Starter

Na pasta acima do projeto, crie a estrutura e use o servidor integrado somente no desenvolvimento. Composer seleciona versão compatível com os limites do pacote e seu PHP; confira o resultado. O servidor de desenvolvimento não substitui um servidor web de produção.

composer create-project codeigniter4/appstarter project-root
cd project-root
php spark serve

Entenda as pastas

app contém seu código, public é a única raiz web, writable guarda logs e cache, tests guarda testes e vendor reúne dependências e o núcleo. Apontar o servidor para a raiz do projeto pode expor configuração e código. Na instalação manual, system fica no próprio projeto.

Configure .env

Copie env para .env e ajuste app.baseURL, ambiente e credenciais somente se usar banco de dados. Confira as chaves da versão instalada. Mantenha .env fora do controle de versão e de public. Na produção use CI_ENVIRONMENT=production, URL correta e permissões de escrita restritas.

cp env .env

Configure o servidor web

Aponte Apache DocumentRoot ou Nginx root para project-root/public. php spark serve serve para testes locais, não produção. Verifique HTTPS, URL, permissões de writable e se .env, app e vendor não ficam acessíveis por HTTP.

Implante e atualize

Guarde composer.lock e execute composer install --no-dev no servidor para instalar versões fixadas sem dependências de desenvolvimento. Use composer update no ambiente de desenvolvimento para mudar versões de propósito, leia o guia de migração, teste e implante lockfile e alterações necessárias em app/public. install e update têm funções diferentes.

composer install --no-dev --prefer-dist --no-interaction

Fontes oficiais

Requisitos: https://codeigniter4.github.io/CodeIgniter4/intro/requirements.html ; Composer: https://codeigniter4.github.io/CodeIgniter4/installation/installing_composer.html ; instalação manual: https://codeigniter4.github.io/CodeIgniter4/installation/installing_manual.html .