Download, instalação e uso do Composer no Ubuntu 14.04

• Exigências
• Instalação
• Uso
• Conclusão

O Composer é uma ferramenta de gerenciamento PHP extremamente popular para dependências, usada para facilitar a instalação e as atualizações dos projetos. Ele também verifica quais outros pacotes um projeto precisa e os obtém automaticamente para você, com a versão correta.

Neste documento, instalaremos e começaremos a usar o Composer em um Vultr Ubuntu 14.04 VPS.

Exigências

• Um Ubuntu 14.04 VPS do Vultr.
• Um usuário comum com Sudoacesso a esse VPS.

Instalação

Instalação de dependência

Antes de tudo, devemos garantir que o nosso VPS tenha todos os requisitos do compositor instalados e funcionando com êxito.

Atualize a lista de pacotes.

sudo apt-get update

Em seguida, instale realmente os requisitos do compositor. Você precisará curldo download e php5-clida instalação e uso do mesmo. gittambém é usado pelo Composer para downloads de requisitos de projeto.

Instale os requisitos.

sudo apt-get install curl php5-cli git

Baixar e instalar

Instalar o Composer é muito simples.

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Que baixa e instala o Composer como um comando global, chamado composer, localizado em /usr/local/bin. Você obterá essa saída.

#!/usr/bin/env php
All settings correct for using Composer
Downloading...

Composer successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer

Execute o seguinte para testar a instalação.

composer

A saída será a seguinte.

   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.0-dev (9859859f1082d94e546aa75746867df127aa0d9e) 2015-08-17 14:57:00

Usage:
 command [options] [arguments]

Uso

Arquivo JSON

Para usar o Composer, você precisa de um arquivo chamado composer.jsonpara informar ao Composer quais requisitos seu projeto possui e qual versão desses requisitos instalar. Não crie isso manualmente para evitar fazer algo incorretamente - o Composer cria o arquivo para você ao adicionar dependências. Dependências adicionais também são adicionadas automaticamente.

Exemplo de uso do compositor

Para usar o Composer para instalações de dependência:

• Identifique a biblioteca necessária para o aplicativo.
• Encontre uma boa biblioteca de código aberto no <Packagist.org>, repositório do Composer.
• Escolha o pacote que você deseja.
• Use composer requirepara incluir e instalar a dependência.

Inicializando o Slugit

Agora, passaremos por esse processo com um aplicativo de exemplo simples, que usará uma frase e a tornará uma string amigável, chamada lesma. Isso é usado com frequência para converter nomes de páginas em URLs, para facilitar a geração de URLs e caminhos. Começaremos criando uma pasta para o aplicativo, chamada slugit.

mkdir ~/slugit
cd ~/slugit

Pesquisando no Packagist

Agora vamos continuar packagist.orge encontrar um pacote para ajudar a gerar lesmas. A pesquisa slugno Packagist deve mostrar alguns desses pacotes.

easy-slug/easy-slug, muffin/slug, ddd/slug, zelenin/slug, webcastle/slug, anomaly/slug-field_type

Precisamos encontrar um conversor de string para slug, para que cocur/slugifyfique bem, com muitas instalações e estrelas.

Exigindo um pacote

Após escolher o pacote, executamos composer requirepara incluí-lo como uma dependência, gerar composer.jsone instalar.

composer require cocur/slugify

Como visto na saída gerada, o Composer selecionou a versão mais recente do pacote e a usou. Verificando ~/slugit, você deve ver 2 arquivos composer.locke composer.json, além de uma pasta chamada vendor.

composer.lock é usado para armazenar informações sobre versões de pacotes e mantê-las iguais.

A vendorpasta é usada para instalar as dependências. Não confirme esta pasta em um repositório Git ou GitHub.

Se um projeto que você baixou já contiver composer.json , use composer installpara baixar suas dependências.

Compreendendo as restrições de versão

Se você verificar o que composer.jsoninclui, deverá ver algo semelhante a este bloco.

{
    "require": {
        "cocur/slugify": "^1.2"
    }
}

O Composer possui muitos formatos e restrições diferentes para definir a versão de um pacote, para permitir flexibilidade associada à estabilidade. ^antes que um número de versão torne a versão mínima e permita todas as versões abaixo 2.0.

Normalmente, você não precisa alterar as restrições de versão, mas, se o fizer, consulte a documentação oficial do Composer para obter mais informações e diretrizes sobre como tudo funciona.

O script de carregamento automático

O Composer fornece um script de carregamento automático, o que facilita muito o trabalho com suas dependências e espaços para nome.

Basta incluir vendor/autoload.phpno seu PHP antes de qualquer instanciação de classe.

De volta ao nosso slugitexemplo. Vamos criar um script de teste, chamado example.php, using cocur/slugify.

vim example.php

Coloque o seguinte em example.php.

<?php
require __DIR__ . '/vendor/autoload.php';

use Cocur\Slugify\Slugify;

$slugify = new Slugify();

echo $slugify->slugify('Hello World, this is a long sentence and I need to make a slug from it!');

Execute o script.

php example.php

Ele exibirá o seguinte texto:

hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it

Atualizando dependências do projeto

Para atualizar dependências do projeto.

composer update

Se forem encontradas atualizações e compatíveis com a restrição mencionada composer.json, ela substituirá a versão e a atualização anteriores composer.lock.

Para atualizar uma ou mais bibliotecas específicas.

composer update vendor1/package1 vendor2/package2

Conclusão

Neste tutorial, passamos pela instalação, configuração e um exemplo do uso do Composer para gerenciamento de dependências de aplicativos PHP.