Todos os produtos
Search
Central de documentação

Alibaba Cloud SDK:Instalar e usar o Composer

Última atualização: Jun 28, 2026

O Composer é um gerenciador de dependências para PHP que resolve pacotes via composer.json, carrega classes automaticamente e executa scripts personalizados.

Pré-requisitos

  • PHP 5.6 ou posterior instalado. Caso contrário, consulte Instalar o PHP.

  • A extensão openssl deve estar habilitada na instalação do PHP.

    Como verificar se a extensão openssl está habilitada

    Execute o comando a seguir. Se a saída incluir openssl, a extensão estará habilitada.

    • Windows

      php -m | find "openssl"
    • Linux

      php -m | grep openssl

    Para ative a extensão openssl:

    1. Localize o arquivo php.ini no diretório de instalação do PHP.

    2. Abra o arquivo php.ini e localize a linha referente à extensão openssl, como extension=openssl, extension=php_openssl.dll ou extension=openssl.so.

    3. Se a linha começar com ponto e vírgula (;), remova-o para descomentá-la.

    4. Salve o arquivo e verifique a alteração.

Instale o Composer

Instale o Composer no sistema operacional.

Windows

  1. Baixe o instalador do Composer.

    Baixe o arquivo Composer-Setup.exe na página de downloads do Composer.

  2. Execute o instalador e siga as instruções na tela.

  3. Verifique a instalação.

    Abra o prompt de comando (Win+R → cmd) e execute composer -V. Uma saída semelhante à abaixo confirma a instalação bem-sucedida:

    Composer version 2.7.7 2024-06-10 22:11:12
    PHP version 7.4.33
    Run the "diagnose" command to get more detailed diagnostics output.

Linux

  1. Execute um dos comandos a seguir para instale o Composer:

    • Alibaba Cloud Linux/CentOS

      sudo yum install -y composer
    • Ubuntu/Debian

      sudo apt install -y composer
  2. Execute composer --version para validar. Uma saída semelhante à abaixo confirma a instalação bem-sucedida:

    Composer version 1.10.27 2023-09-29 10:50:23

macOS

  1. Execute os comandos a seguir para instale o Composer:

    curl -sS https://getcomposer.org/installer | php
    sudo mv composer.phar /usr/local/bin/composer
    chmod +x /usr/local/bin/composer
  2. Execute composer --version para confirmar a instalação.

Usar o Composer

Instale dependências

  • Comando install

    Crie um arquivo composer.json na raiz do projeto para defina as dependências:

    {
        "require": {
            "alibabacloud/dysmsapi-20170525": "4.1.*"
        }
    }

    Isso define a versão 4.1.x do pacote alibabacloud/dysmsapi-20170525 como obrigatória. Para instale:

    composer install
  • Comando require

    Alternativamente, use require para adicionar uma dependência sem editar manualmente o arquivo composer.json:

    composer require alibabacloud/dysmsapi-20170525
    

    O Composer resolve uma versão compatível, adiciona alibabacloud/dysmsapi-20170525 ao composer.json, baixe o pacote, atualize o composer.lock e regenera os arquivos de autoload.

Atualize dependências

Use o comando update para atualize todos os pacotes ou apenas alguns específicos:

# Update all dependencies
composer update
# Update a specific package
composer update alibabacloud/dysmsapi-20170525
# Update multiple specific packages
composer update alibabacloud/dysmsapi-20170525 alibabacloud/credentials
# You can also use a wildcard to match packages
composer update alibabacloud/*
Nota

As restrições de versão limitam as atualizações dos pacotes a um intervalo especificado.

Remover uma dependência

O comando remove exclui um pacote e suas dependências não utilizadas:

composer remove monolog/monolog

Listar pacotes instalados

composer show --installed

Restrições de versão

Versão exata

Fixe uma versão específica. Por exemplo, composer require alibabacloud/dysmsapi-20170525 4.1.2 instala a versão 4.1.2.

Intervalo

Use operadores de comparação (>, >=, <, <=, !=) para defina intervalos de versão. Um espaço ou vírgula representa E; || representa OU. O operador E tem maior precedência.

  • composer require alibabacloud/dysmsapi-20170525 >=4.1 instala uma versão igual ou superior a 4.1.0.

  • composer require alibabacloud/dysmsapi-20170525 '>=4.1, <4.2' instala qualquer versão 4.1.x.

Curinga (*)

O curinga corresponde a qualquer versão secundária (minor) ou de correção (patch) dentro de uma versão principal. composer require alibabacloud/dysmsapi-20170525 4.1.* instala qualquer versão 4.1.x (equivalente a >=4.1.0 <4.2.0).

Til (~)

O til permite atualizações de nível de correção, mas mantém fixa a versão secundária. composer require alibabacloud/dysmsapi-20170525 ~4.1.3 instala uma versão no intervalo >=4.1.3 e <4.2.0.

Circunflexo (^)

O circunflexo permite atualizações secundárias e de correção, mas impede mudanças na versão principal. composer require alibabacloud/dysmsapi-20170525 ^4.1 instala uma versão no intervalo >=4.1.0 e <5.0.0.