{"id":4808,"date":"2020-07-31T16:50:00","date_gmt":"2020-07-31T19:50:00","guid":{"rendered":"https:\/\/blog.hostinger.io\/tutoriais\/?p=4808"},"modified":"2025-04-09T04:46:25","modified_gmt":"2025-04-09T07:46:25","slug":"como-instalar-e-usar-o-composer","status":"publish","type":"post","link":"\/br\/tutoriais\/como-instalar-e-usar-o-composer","title":{"rendered":"Como instalar e usar o Composer: guia completo"},"content":{"rendered":"

Neste artigo, vamos mostrar como instalar e usar o Composer em várias plataformas. O Composer é um gerenciador de dependências para PHP (também funciona com hospedagem PHP<\/a>).<\/p>

Trata-se de uma ferramenta simples e confiável que os desenvolvedores usam para gerenciar e integrar pacotes ou bibliotecas externas em seus projetos baseados em PHP. Deste modo, eles não precisam criar suas páginas da internet ou aplicações web a partir do zero.<\/p>

Para ajudar você a dominar essa ferramenta, você também vai aprender neste artigo como criar um projeto PHP básico .<\/p>

Antes de aprender a instalar o Composer, garanta que você tem acesso a uma interface de linha de comando no seu sistema ou no seu servidor.<\/p>

\"\"<\/a><\/figure>

Como Instalar o Composer<\/strong><\/h2>

Esta seção vai mostrar como instalar o Composer em servidores de hospedagem<\/strong><\/a> compartilhada e em sistemas operacionais como Linux, macOS e Windows.<\/p>

1. C<\/strong>omo Instalar o Composer numa Hospedagem Compartilhada, no Linux ou no MacOS<\/h3>

Os comandos para instalar o Composer numa hospedagem compartilhada, no Linux (PC ou servidor) e no macOS são os mesmos.<\/p>

Note que o Composer já vem pré-instalado nos planos de hospedagem compartilhada Premium e Business da Hostinger. Se você está usando algum deles, pule esta parte.<\/p>

Contudo, se você acha que eles podem estar desatualizados, é possível atualizar o Composer com o seguinte comando:<\/p>

php composer.phar self-update<\/pre>
Siga essas instruções para aprender a instalar o Composer no seu sistema:<\/p>
    \n
  1. Conecte-se à sua conta de hospedagem usando uma conexão SSH. Você pode aprender a fazer isso com este tutorial sobre SSH<\/a>.<\/li>\n
  2. Baixe o Composer no site oficial usando o seguinte comando:\n
    php -r \"copy('https:\/\/getcomposer.org\/installer', 'composer-setup.php');\"<\/pre>\n<\/li>\n
  3. Verifique a assinatura do instalador (SHA-384) para garantir que o arquivo de instalação não está corrompido. Insira:\n
    php -r “if (hash_file(‘sha384’, ‘composer-setup.php’) === ‘e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL;”

    A longa série de caracteres no comando acima (‘e0012edf…’<\/strong>) é a assinatura do instalador. Ela muda toda vez que uma nova versão do Composer é lançada. Portanto, não se esqueça de buscar o SHA-384<\/strong> mais recente     nesta página<\/strong><\/a>.<\/p>\n<\/li>\n
  4. Uma vez que tiver terminado, você pode instalar o Composer<\/strong> de maneira local ou global. A instalação local significa que o gerenciador de dependência será armazenado no seu diretório atual, e você terá que especificar o caminho antes de executar comandos correspondentes. Enquanto isso, a instalação global permite que você rode o composer de qualquer lugar no seu sistema, ao armazená-lo no diretório \/usr\/local\/bin<\/strong>. Aqui está como completar ambos os métodos:
    ○ Instalação Local:<\/strong>
    \n
    php composer-setup.php<\/pre>\n
    ○ Instalação Global:
    <\/strong><\/strong>\n
    php composer-setup.php --install-dir=\/usr\/local\/bin --filename=composer<\/pre>\n
    Você verá este resultado:
    <\/strong><\/strong>\n
    All settings correct for using Composer\nDownloading...\nComposer (version 1.10.5) successfully installed to: \/usr\/local\/bin\/composer<\/pre>\n<\/li>\n
  5.  Assim que tiver terminado, remova o instalador:\n
    php -r \"unlink('composer-setup.php');\"<\/pre>\n<\/li>\n
  6. Teste a instação do Composer:
    \n
    composer<\/pre>\nA linha de comando vai retornar o seguinte resultado:<\/li>\n<\/ol>
       ______\n  \/ ____\/___ ____ ___ ____ ____ ________ _____\n \/ \/ \/ __ \/ __ `__ \/ __ \/ __ \/ ___\/ _ \/ ___\/\n\/ \/___\/ \/_\/ \/ \/ \/ \/ \/ \/ \/_\/ \/ \/_\/ (__ ) __\/ \/\n____\/____\/_\/ \/_\/ \/_\/ .___\/____\/____\/___\/_\/\n                  \/_\/\nComposer version 1.10.5 2020-02-12 16:20:11<\/pre>
    2. Como Instalar o Composer no Windows<\/strong><\/h3>
    O processo para preparar a instalação do Composer numa máquina com Windows é um pouco diferente. Não é necessário usar nenhuma instrução de linha de comando para baixar e instalar o software.<\/p>
    Simplesmente siga esses passos:<\/p>
      \n
    1. Instale o PHP no seu computador. Recomendamos usar o XAMPP<\/a> <\/strong>para este propósito, já que o processo é simples e direto, e você pode executá-lo em alguns minutos.<\/li>\n
    2. Assim que o XAMPP estiver instalado, faça o download da versão mais recente do Composer<\/strong><\/a>.<\/li>\n
    3. Rode o instalador do Composer<\/strong>. Quando ele pedir para você ativar o modo desenvolvedor, ignore e continue com o processo de instalação
      \"instalador<\/li>\n
    4. Outra janela vai aparecer e pedir para você localizar a linha de comando PHP. Por padrão, ela pode ser encontrada em C:\/xampp\/php\/php.exe<\/strong>. Depois de especificar a localização, clique em Next <\/strong>(Próximo).<\/li>\n
    5. Então serão requisitadas as Configurações de Proxy<\/strong> (Proxy Settings). Deixe a caixa desmarcada e pule esta parte ao clicar em Next<\/strong>. Depois, na última janela, escolha Install <\/strong>(Instalar).<\/li>\n
    6. Depois de concluir a instalação, abra o prompt de comando. Para abri-lo, pressione CTRL + R<\/strong>, digite cmd<\/strong> e pressione o botão OK<\/strong>.
      \"windows<\/li>\n
    7. No prompt de comando, digite o seguinte comando:\n
      composer<\/pre>\n<\/li>\n<\/ol>
      Ótimo trabalho! Você instalou o Composer em seu computador com Windows. O instalador automaticamente se encarrega de adicionar Composer a sua variável PATH. Você pode abrir o prompt de comando e executar o Composer a partir de qualquer lugar.<\/p>
      Como Gerar e Entender o composer.json<\/strong><\/h2>
      Agora vem a parte interessante – usar o Composer pela primeira vez em seu projeto PHP.<\/p>
      Para conseguir isso, é necessário gerar um arquivo composer.json<\/strong> para o projeto. Este arquivo pode ser considerado como uma lista de pesquisa para o Composer. Ele só irá baixar os pacotes (dependências) para o seu projeto que são mencionados neste arquivo.<\/p>
      Observe que ele também verifica a compatibilidade de versão dos pacotes com seu projeto. Isto significa que se você estiver usando um pacote mais antigo em seu projeto, o arquivo composer.json<\/strong> o informará para evitar qualquer inconveniente futuro.<\/p>
      Você também tem a opção de criar e atualizar o arquivo composer.json<\/strong>. Mas visto que este é um tutorial sobre automatização de tarefas redundantes, pode ser um pouco irônico para você criar o arquivo manualmente.<\/p>
      Vamos demonstrar a utilidade do composer.json criando um projeto de amostra.<\/p>
      Nosso projeto é um simples temporizador PHP, para os desenvolvedores que querem descobrir quanto tempo um pedaço de código específico leva para executar. Isso é altamente útil para fins de depuração e otimização.<\/p>
      Para fazer isso, siga estas etapas:<\/p>
        \n
      1. Crie um novo diretório para o projeto. Como nosso projeto é um temporizador, vamos nomeá-lo, muito sem imaginação, phptimer<\/strong>. Para isso, abra o terminal e digite o seguinte comando:\n
        mkdir phptimer<\/pre>\n<\/li>\n
      2. Digite o diretório recém-criado através do comando:\n
        cd phptimer<\/pre>\n<\/li>\n
      3. Encontre um pacote ou uma biblioteca para o projeto. O melhor lugar para encontrar pacotes Composer está no Packagist<\/a>, onde você vai encontrar uma série de bibliotecas para auxiliar no desenvolvimento do seu projeto. Para este tutorial, precisamos de um pacote de timer<\/strong>. Para obtê-lo, basta digitar timer<\/strong> na barra de pesquisa:\"packagist\"Como você pode ver, há uma série de temporizadores disponíveis para desenvolvedores no site. Cada pacote tem um nome e uma pequena descrição do que ele faz. Neste exemplo, escolhemos o phpunit\/php-timer<\/strong>, pois tem a maioria dos downloads e mais estrelas no GitHub. <\/li>\n
      4. Especifique o pacote desejado para que o Composer adicione-o para o seu projeto:\n
        composer require phpunit\/php-timer<\/pre>\n
        O output<\/em> vai mostrar a versão do phpunit\/php-timer:<\/p>\n
        Using version ^1.0 phpunit\/php-timer<\/pre>\n
         <\/p>\n<\/li>\n<\/ol>
        O acento circunflexo (^) é definido como a opção para maior interoperabilidade. Isso significa que o Composer sempre vai atualizar o pacote até que uma certa versão quebre-o de alguma maneira.<\/p>
        No nosso caso, a faixa de atualização é >=1.0.9 <2.0.0<\/strong>, já que a versão 2.0.0 vai quebrar a retrocompatibilidade<\/a><\/strong>. Para informações mais detalhadas sobre as versões do Composer, visite a página de documentação<\/a><\/strong>.<\/p>
        Depois de executar o comando acima, o Composer criará dois novos arquivos – composer.json<\/strong> e composer.lock<\/strong> – no diretório do projeto, além de uma nova pasta chamada fornecedor<\/strong>. O diretório do fornecedor é onde o Composer armazenará todos os seus pacotes e dependências.<\/p>
        Como Usar o Script de Carregamento Automático<\/strong><\/h2>
        O seu projeto está quase pronto, e a única coisa que falta fazer é carregar a dependência no seu script PHP. Felizmente, o arquivo de carregamento automático do Composer vai ajudar você a completar esse processo de maneira facilitada.<\/p>
        Para usar o carregamento automático, escreva a seguinte linha antes de declarar ou instanciar novas variáveis no seu script:<\/p>
        require 'vendor\/autoload.php'<\/pre>
         <\/p>
        Vamos dar um exemplo para ajudar você a entender melhor.<\/p>
        Vamos dizer que queremos testar o nosso projeto phptimer<\/strong>:<\/p>
          \n
        1. Abra o editor de texto nano e crie um script chamado demo.php.
          <\/strong><\/strong>\n
          nano demo.php<\/pre>\nEntão cole as seguintes linhas no seu arquivo:
          \n
          <?php\nrequire __DIR__ . '\/vendor\/autoload.php'\nTimer::start();\n\/\/ your code\n$time = Timer::stop();\nvar_dump($time);\nprint Timer::secondsToTimeString($time);<\/pre>\n<\/li>\n
        2. Rode o script:
          \n
          php demo.php<\/pre>\nO terminal deverá exibir um output <\/em>similar ao seguinte:
          \n
          double(1.0893424438611E-5)\n0 ms<\/pre>\n<\/li>\n<\/ol>
          Como Atualizar as dependências do seu Projeto<\/strong><\/h2>
          Tudo o que resta é para você saber como atualizar seus pacotes quando necessário. Isso pode ser feito de duas maneiras:<\/p>