Todos os produtos
Search
Central de documentação

Object Storage Service:Instalação (PHP SDK V1)

Última atualização: Sep 12, 2026

Instale o OSS PHP SDK para gerenciar buckets do OSS, fazer upload e download de arquivos, gerenciar dados ou processar imagens. Este tópico descreve várias formas de instalar o OSS PHP SDK. Escolha o método mais adequado ao seu cenário.

Pré-requisitos

O OSS PHP SDK requer PHP 5.3 ou superior. Este tópico usa o PHP 5.6.22 como exemplo.

  • Ambiente de instalação

    Instale o PHP e a extensão cURL:

    • No Windows, instale o PHP e a extensão cURL. Se ocorrer o erro "module not found", defina extension_dir como C:/Windows/System32/ no arquivo php.ini.

    • No Ubuntu, use o gerenciador de pacotes apt-get para instalar a extensão cURL para PHP: sudo apt-get install php-curl.

    • No CentOS, use o gerenciador de pacotes yum para instalar a extensão cURL para PHP: sudo yum install php-curl.

  • Verificação de versões

    • Execute o comando php -v para verificar a versão do PHP.

    • Execute o comando php -m para confirmar se a extensão cURL está instalada.

Baixar o SDK

Para mais informações, consulte a documentação da API do OSS.

Nota

Recomendamos usar a versão mais recente do SDK. Baixe a documentação das versões do OSS PHP SDK anteriores à 2.0.0 aqui.

Instalar o SDK

Instale o SDK por um dos métodos a seguir:

  • Com o Composer

    1. Execute o comando composer require aliyuncs/oss-sdk-php no diretório raiz do projeto ou adicione a seguinte dependência ao arquivo composer.json.

      
      "require": {
          "aliyuncs/oss-sdk-php": "~2.4"
      }
                                  
    2. Execute o comando composer install para instalar as dependências. Após a instalação, a estrutura de diretórios ficará assim:

              .
              ├── src
              |   └──app.php
              ├── composer.json
              ├── composer.lock
              └── vendor
                                  

      Nessa estrutura, app.php é o arquivo do aplicativo e a pasta vendor/ contém as dependências. Adicione a linha abaixo ao arquivo app.php:

      require_once __DIR__ . '/../vendor/autoload.php';
                                  
    Nota
    • Se o projeto já incluir uma referência a autoload.php, não será necessário adicioná-la novamente.

    • Em caso de erro de rede ao usar o Composer, utilize um espelho do Composer para a região da China. Para isso, execute o seguinte comando na linha de comando: composer config -g repositories.packagist composer http://packagist.phpcomposer.com.

  • Com um arquivo PHAR

    1. Acesse o GitHub, selecione a versão desejada e baixe o arquivo PHAR compactado.

    2. Inclua uma referência ao arquivo PHAR no código:

      require_once '/path/to/oss-sdk-php.phar';
                                  
  • Com o código-fonte

    1. Acesse o GitHub, selecione a versão desejada e baixe o pacote do código-fonte (arquivo ZIP).

    2. O diretório raiz do pacote descompactado contém o arquivo autoload.php. Inclua uma referência a esse arquivo no código:

      require_once '/path/to/oss-sdk/autoload.php';

Perguntas frequentes

Erro: Sua configuração não permite conexão

Mensagem de erro completa

Your configuration does not allow connection to http://packagist.phpcomposer.com/packages.json. See https://getcomposer.org/doc/06-config.md#secure-http for details

Sintomas

Ao instalar o SDK com o Composer, ocorre um erro de conexão que impede o download das dependências necessárias.

Causa

Por padrão, o Composer proíbe conexões via HTTP. Por motivos de segurança, todas as conexões devem usar HTTPS. Essa prática garante a segurança na transmissão de dados e evita vazamento ou adulteração de informações sensíveis.

Solução

Para baixar dependências via HTTP, como em certos ambientes de rede interna, ajuste a configuração do Composer para permitir conexões HTTP.

No diretório raiz do projeto, execute o seguinte comando para configurar o Composer para permitir conexões HTTP:

composer config secure-http false.

Desativar o HTTPS reduz a segurança. Priorize conexões seguras em ambientes onde o HTTPS estiver disponível.