Como Instalar o PHP Composer no Rocky Linux 8

O PHP Composer é o gerenciador de dependências mais utilizado para PHP. Ele permite que você declare as dependências que seu projeto precisa, e ele irá gerenciá-las (instalar/atualizar) para você.

Baixar, instalar e atualizar dependências pode ser um incômodo e pode distraí-lo de realmente escrever código. Um gerenciador de dependências tornará sua vida como desenvolvedor mais fácil, cuidando disso para você.

Antes do Composer, havia algumas opções diferentes para gerenciar dependências de projetos, como PEAR e PHP Package Manager. Hoje em dia, o Composer se tornou o padrão de fato para gerenciamento de dependências em PHP.

Se você ainda está usando PEAR ou o PHP Package Manager, pode ser hora de uma mudança. Existem várias razões para usar o Composer:

• É escrito em PHP e não requer instalação de software adicional (como Python)
• Suporta pacotes globais e locais/privados
• Milhares de bibliotecas e aplicações já dependem dele, então ao usar o Composer, você poderá facilmente encontrar pacotes e atualizações.

Pré-requisitos

Para instalar o PHP Composer no Rocky Linux 8.4, você precisará:

• Ter o PHP versão 5.3 ou superior instalado em seu sistema (e deve ser capaz de executar a extensão Phar).
• Acesso root é necessário para a instalação.

Atualizando o Sistema

Antes de fazer qualquer outra coisa, certifique-se de que os pacotes do seu sistema estão atualizados. Execute os seguintes comandos para atualizar os pacotes do sistema.

sudo dnf check-update

sudo dnf update -y

Instalando o PHP no Rocky Linux 8.4

Antes de instalar o Composer, você precisa ter o PHP e o interpretador PHP instalados em seu sistema.

Por padrão, o repositório AppStream vem com PHP 7.2, 7.3 e 7.4. Você pode listar todas as versões disponíveis do PHP executando o comando abaixo.

sudo dnf module list php

Você verá uma saída como a abaixo.

Neste guia, instalaremos o PHP 7.4. Você deve escolher uma versão do PHP que atenda às suas necessidades, embora certifique-se de basear sua decisão não apenas neste guia, mas também em relatórios de compatibilidade como este.

Execute os seguintes comandos para habilitar e instalar o PHP 7.4.

sudo dnf module enable php:7.4

sudo dnf install php php-cli php-gd php-curl php-zip -y

sudo dnf install php-mbstring php-opcache php-intl php-mysqlnd -y

Agora você pode verificar se o PHP foi instalado corretamente executando este comando.

php -v

Você deve obter a seguinte saída.

Instalando o PHP Composer no Rocky Linux 8.4

Agora que você tem uma versão do PHP instalada em seu sistema, pode usá-la para baixar e instalar o binário do Composer.

Primeiro, execute os seguintes comandos para baixar a versão mais recente do Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

Em seguida, vamos verificar se o arquivo baixado não está corrompido. Devemos sempre verificar o arquivo baixado para garantir que ele não esteja corrompido. O Composer pode ser muito sensível, e erros podem causar problemas com a forma como você usa o Composer. Execute o seguinte código para verificar se o arquivo do instalador não está corrompido.

HASH=`curl -sS https://composer.github.io/installer.sig`

echo $HASH

php -r "if (hash_file('SHA384', '/tmp/composer-setup.php') === '$HASH') { echo 'Instalador verificado'; } else { echo 'Instalador corrompido'; unlink('composer-setup.php'); } echo PHP_EOL;"

Você deve ver o texto “Instalador verificado” quando a verificação for bem-sucedida, conforme mostrado abaixo. Se você não obtiver a saída esperada, o arquivo provavelmente foi corrompido e você deve tentar baixá-lo novamente. Em seguida, repita o processo de verificação até obter a saída esperada “Instalador verificado”.

Agora você tem duas opções para instalar o Composer em seu sistema.

A Opção 1 é instalar o Composer globalmente em seu sistema, o que significa que ele estará acessível de qualquer diretório do seu sistema e poderá ser usado em qualquer lugar. Use esta opção se você quiser usar o Composer como uma ferramenta de linha de comando, e não apenas como um gerenciador de dependências para seus projetos PHP.

Se você optar por esta opção, execute os seguintes comandos.

sudo php composer-installer.php --filename=composer --install-dir=/usr/local/bin 

O comando acima instalará o Composer globalmente com o comando nomeado composer em /usr/local/bin.

Agora você pode verificar se instalou o Composer corretamente executando este comando.

composer

Você deve obter a seguinte saída.

A Opção 2 é instalar o Composer localmente no diretório atual para que ele seja usado apenas por este projeto específico.

Para instalar o Composer localmente, execute os seguintes comandos.

sudo php composer-setup.php

O comando acima instalará o Composer localmente no diretório atual para que ele seja usado apenas por este projeto específico. Você pode usar o composer executando ./composer.phar .

Testando o PHP Composer

Agora que você instalou o Composer, pode usá-lo para criar um novo projeto que você pode testar sua instalação do Composer.

É uma regra geral que você deve sempre criar um diretório separado para cada projeto em que trabalha. Execute os seguintes comandos para criar um novo diretório para seu projeto de teste e navegar até o diretório recém-criado.

cd && mkdir php-composer-test && cd php-composer-test

Agora você pode executar o seguinte comando para inicializar um novo projeto com o Composer.

composer init

O comando acima inicializará um novo projeto com todos os detalhes que você selecionou.

O comando composer init também cria um novo arquivo composer.json no diretório atual, conforme mostrado abaixo. É um arquivo em formato JSON que contém todos os requisitos do projeto. O Composer usa este arquivo para instalar as dependências necessárias para seu projeto.

Agora é hora de carregar um pacote para seu projeto. Acesse https://packagist.org e procure um pacote para instalar em seu projeto.

Por exemplo, se você quiser instalar o pacote Remove Stop Words, que pode nos ajudar a remover palavras de parada de uma string. Se você pesquisar o termo “Remove Stop Words” no Packagist, deverá ver o seguinte resultado.

Para adicionar um novo pacote, execute o comando composer require e selecione o pacote (sem nenhuma versão) que você deseja carregar para seu projeto atual.

composer require rap2hpoutre/remove-stop-words

O Composer decidirá automaticamente qual versão do pacote usar. O Composer baixará o pacote do Packagist para seu diretório atual e extrairá o conteúdo deste pacote.

Ele também atualizará o arquivo composer.json com detalhes sobre este novo pacote. Também criará um novo arquivo - composer.lock, e um novo diretório vendor, conforme mostrado abaixo.

O arquivo composer.lock é usado pelo Composer para bloquear a versão do pacote que está instalada em seu projeto atual. Este arquivo é usado para evitar conflitos com outras instalações do mesmo pacote, ou quando você clona seu projeto. O diretório vendor contém todas as dependências do seu projeto.

Para atualizar as dependências do projeto, execute o comando composer update. O Composer olhará primeiro para o arquivo composer.lock para descobrir qual versão do pacote já está instalada e, em seguida, atualizará este pacote com a versão mais recente disponível no Packagist.

composer update

Saída de exemplo:

Para atualizar pacotes específicos, execute o seguinte comando.

composer update vendor/package

Para remover um pacote específico, execute o seguinte comando.

composer remove vendor/package

Por exemplo, se você não precisar mais do pacote Remove Stop Words, pode executar o seguinte comando para desinstalá-lo de seu projeto.

composer remove rap2hpoutre/remove-stop-words

Saída de exemplo:

Nota: É altamente recomendável que você não exclua o diretório vendor ou seu conteúdo, pois este diretório contém todas as dependências que precisam ser instaladas com o Composer para executar sua aplicação.

Conclusão

Neste artigo, você aprendeu como instalar o gerenciador de dependências PHP Composer no Rocky Linux 8.4 para inicializar um novo projeto, carregar novos pacotes, atualizar pacotes existentes ou desinstalá-los de seu projeto. Você também aprendeu alguns comandos básicos do Composer que são usados para gerenciar as dependências do seu projeto.

Deixe um comentário abaixo se você tiver alguma dúvida ou feedback.