Como instalar e usar o PHP Composer no Ubuntu 20.04 LTS

Componha seu projeto PHP com facilidade, permitindo que o composer gerencie todas as dependências

Composer é uma ferramenta de gerenciamento de dependências para PHP. É diferente do gerenciador de pacotes tradicional, como apto e dnf, de forma que não instale os pacotes e bibliotecas globalmente em um nível de sistema, em vez de tratá-los para cada projeto separadamente. Portanto, é um gerenciador de dependências e não um gerenciador de pacotes.

Assim como um compositor de música pega um monte de instrumentos e os organiza para funcionarem perfeitamente em um show, o Composer for PHP pega um monte de bibliotecas e estruturas, os empacota para trabalharem juntos e criar uma base sólida sobre a qual um projeto PHP pode ser composto.

Pré-requisitos

Você precisa de acesso a um sistema Ubuntu 20.04 com um sistema não raiz sudo conta de usuário. Além disso, você precisa instalar algumas dependências para o Composer, que inclui php-cli para executar scripts PHP em seu terminal, descompactar para ajudar o Composer a extrair os pacotes baixados e ondulação para baixar o script de instalação do composer

Para instalar todos os pacotes necessários, atualize a lista de pacotes do Ubuntu executando o comando update:

atualização do apt sudo

Em seguida, instale o php-cli, descompactar e ondulação usando o seguinte comando:

sudo apt install php-cli unzip curl

Você será solicitado a confirmar a instalação, pressione Y em seguida, pressione Enter. Depois de cumprir todos os pré-requisitos, você pode continuar a instalar o Composer.

Baixe e instale o Composer

O Composer oferece um script PHP bacana para fazer o download e instalá-lo em sua máquina a partir da linha de comando. Precisamos usar ondulação para baixar este script, verifique sua autenticidade por motivos de segurança e execute-o para instalar o Composer.

Certifique-se de que seu terminal está aberto no diretório inicial e, em seguida, baixe o script de instalação usando ondulação:

cd ~ curl -sS //getcomposer.org/installer -o composer-setup.php

Em seguida, precisamos verificar se o script de instalação que baixamos é genuíno, combinando o hash SHA-384 dele com o encontrado na página Composer Public Key / Checksums. Para fazer isso, obtenha o hash SHA-384 na página Composer Public Key e armazene-o em uma variável de shell.

Hash = `curl -sS // composer.github.io / installer.sig`

Em seguida, verifique se obteve e armazenou com êxito o hash na variável executando:

echo $ Hash

Você deve obter uma saída de alguma string aleatória como esta do terminal:

Saída: e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a

Agora, execute o seguinte código PHP fornecido pelo Composer para verificar a autenticidade do script de instalação:

php -r "if (hash_file ('SHA384', 'composer-setup.php') === '$ Hash') {echo 'Instalador verificado';} else {echo 'Instalador corrompido'; unlink ('composer-setup .php ');} echo PHP_EOL; "
Saída: Instalador verificado

Se você vir qualquer outra saída, como Instalador corrompido, então você saberá que o script está corrompido e não é seguro executá-lo. Baixe o script novamente usando curl e execute o código PHP no terminal novamente para verificar o script de instalação.

Você pode continuar com a instalação depois de verificar o instalador com sucesso. Você pode instalar Instalar o Composer global ou localmente para um único projeto.

Instale o Composer globalmente

Para instalar o Composer globalmente como um comando de todo o sistema denominado compositor, execute o seguinte comando:

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

O Composer será instalado no / usr / local / bin diretório em seu sistema Ubuntu 20.04 e você verá uma saída como esta:

Saída: Todas as configurações corretas para usar o Composer Baixando ... Composer (versão 1.10.7) instalado com sucesso em: / usr / local / bin / composer Use-o: php / usr / local / bin / composer 

Verifique se o Composer está instalado corretamente e funcionando, executando:

compositor
Saída: ______ / ____ / ___ ____ ___ ____ ____ ________ _____ / / / __ \ / __ `__ \ / __ \ / __ \ / ___ / _ \ / ___ / / / ___ / / _ / / / / / / / / _ / / / _ / (__) __ / / \ ____ / \ ____ / _ / / _ / / _ / .___ / \ ____ / ____ / \ ___ / _ / / _ / Composer versão 1.10.7 2020-06- 03 10:03:56 Uso: comando [opções] [argumentos] 

Você instalou com sucesso o composer em seu sistema Ubuntu 20.04. Agora você pode começar a usar o Composer para gerenciar, atualizar e instalar dependências em seus projetos PHP imediatamente.

Instalando o Composer localmente

Instalar o Composer localmente é útil quando você não tem permissão para instalá-lo em todo o sistema ou se deseja que o Composer seja usado apenas em um único projeto. Para instalar o composer localmente, execute:

php composer-setup.php

O comando acima irá criar um novo arquivo em seu diretório atual chamado composer.phar. Você precisará mover este arquivo para a pasta raiz do projeto para usar os recursos do Composer. Este arquivo pode ser executado usando o comando mostrado abaixo.

php composer.phar

Noções básicas do compositor

Agora que você tem o Composer instalado em sua máquina Ubuntu 20.04, vamos dar uma olhada em alguns fundamentos do Composer. O Composer visa facilitar a instalação e atualização fáceis de dependências e, para isso, cria muitos arquivos no diretório raiz do projeto. Vejamos a estrutura de diretório de um projeto usando o Composer para gerenciar dependências.

Estrutura raiz do projeto Composer:ProjectRoot / ├── composer.json ├── composer.lock ├── Project.php ├── composer.phar * Apenas se você instalou o Composer localmente └── fornecedor ├── autoload.php ├── compositor │ ├── ClassLoader.php │ ├── LICENÇA │ ├── autoload_classmap.php │ ├── ..... ├── ....... 
  • O composer.json O arquivo localizado no diretório raiz do projeto armazena todas as informações sobre as dependências (pacotes) exigidas pelo projeto.
  • O composer.lock contém as informações sobre os pacotes com versão bloqueada para o projeto.
  • fornecedor é o diretório onde todos os pacotes são armazenados, ele também tem alguns scripts PHP, como autoload.php, o que facilita a inclusão automática dos pacotes no diretório do fornecedor.
  • Finalmente, se você instalou o Composer localmente, você deve ter composer.phar arquivo no diretório do projeto para instalar pacotes.

Todos esses arquivos são criados quando você usa o compositor ou php composer.phar comando para baixar e instalar pacotes para o seu projeto pela primeira vez. Então, vamos dar uma olhada no funcionamento do Composer criando um projeto Demo.

Criando seu primeiro projeto usando o Composer

A primeira etapa é criar um diretório raiz para o seu projeto, então crie um com mkdir comando e navegue até ele usando CD comando:

mkdir ~ / ComposerDemo cd ~ / ComposerDemo

Agora, precisamos encontrar e instalar os pacotes / bibliotecas necessários para construir nosso projeto de demonstração. Packagist é o repositório principal do Composer que lista todos os pacotes PHP publicamente disponíveis que podem ser instalados com o Composer.

Neste exemplo, usaremos um pacote PHP chamado cakephp / chronos, é uma extensão de API simples para data e hora. Assim, para gerar um novo projeto Composer e instalar o pacote Chronos, execute o seguinte comando:

compositor requer cakephp / chronos
Saída: Usando a versão ^ 2.0 para cakephp / chronos ./composer.json foi criado Carregando repositórios composer com informações de pacote Atualizando dependências (incluindo require-dev) Operações de pacote: 1 instalação, 0 atualizações, 0 remoções - Instalando cakephp / chronos (2.0.5 ): Baixando (100%) Gravando arquivo de bloqueio Gerando arquivos de carregamento automático 

O exigir opção busca e instala o pacote que você deseja e gera os arquivos e diretórios como composer.json, composer.lock e fornecedor no diretório raiz do projeto. Você verá que cakephp / chronos é adicionado ao composer.json se você executar o seguinte comando:

cat composer.json
Saída: {"requer": {"cakephp / chronos": "^ 2.0"}} 

A seguir, vamos usar o Chronos em nosso projeto Demo, abrir e criar um arquivo PHP chamado demo.php usando nano:

nano demo.php

Em seguida, adicione o seguinte código ao demo.php, a segunda linha que inclui vendor / autoload.php é um arquivo do Composer que carrega automaticamente todos os pacotes e bibliotecas instalados para o projeto. Salve o arquivo pressionando Ctrl + O e saia do editor nano pressionando Ctrl + X.

Execute o demo.php executando o seguinte comando:

php demo.php
Saída: Agora: 2020-06-23 17:07:45

No futuro, quando você precisar atualizar os pacotes e bibliotecas do seu projeto, basta executar o seguinte comando:

atualização do compositor

O comando acima verificará a versão mais recente dos pacotes instalados e os atualizará com segurança, sem interromper o projeto e suas bibliotecas interdependentes.

Vimos como instalar o Composer na máquina Ubuntu 20.04 e vimos o básico que você precisa saber sobre o Composer. Agora você pode tentar construir novos projetos adicionando os pacotes necessários pesquisando no Packagist. Se você deseja aprender mais sobre o Composer e suas opções, vá para a página de documentação online do Composer.