Todos os produtos
Search
Central de documentação

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

Última atualização: Oct 17, 2026

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

Pré-requisitos

O OSS PHP SDK requer o 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 verificar se a extensão cURL está instalada.

Baixe o SDK

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

Nota

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

Instale o SDK

Instale o SDK usando um dos seguintes métodos:

  • Com o Composer

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

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

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

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

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

    • Se ocorrer um erro de rede ao usar o Composer, use 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. No GitHub, selecione a versão desejada e baixe o arquivo PHAR compactado.

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

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

    1. No 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 um arquivo autoload.php. Inclua uma referência a esse arquivo no seu código:

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

FAQ

Erro: A sua configuração não permite conexão

Mensagem de erro completa

Sua configuração não permite a conexão com http://packagist.phpcomposer.com/packages.json. Consulte https://getcomposer.org/doc/06-config.md#secure-http para obter mais detalhes

Sintomas

Ao usar o Composer para instalar o SDK, ocorre um erro de conexão e não é possível baixar as dependências necessárias.

Causa

Por padrão, a configuração do 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 que informações sensíveis vazem ou sejam adulteradas.

Solução

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

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

composer config secure-http false.

Lembre-se de que desativar o HTTPS reduz a segurança. Priorize conexões seguras em ambientes onde o HTTPS estiver disponível.