Todos los productos
Search
Centro de documentos

Object Storage Service:Installation (PHP SDK V1)

Última actualización: Sep 15, 2026

Instale el OSS PHP SDK para gestionar buckets de OSS, cargar y descargar archivos, gestionar datos o procesar imágenes. Este tema describe varios métodos para instalar el OSS PHP SDK. Elija el método que mejor se adapte a su escenario.

Requisitos previos

El OSS PHP SDK requiere PHP 5.3 o una versión posterior. En este tema se usa PHP 5.6.22 como ejemplo.

  • Entorno de instalación

    Instale PHP y la extensión cURL:

    • En Windows, instale PHP y la extensión cURL. Si aparece un error de "module not found", establezca extension_dir como C:/Windows/System32/ en el archivo php.ini.

    • En Ubuntu, utilice el administrador de paquetes apt-get para instalar la extensión cURL de PHP: sudo apt-get install php-curl.

    • En CentOS, utilice el administrador de paquetes yum para instalar la extensión cURL de PHP: sudo yum install php-curl.

  • Comprobación de versiones

    • Ejecute el comando php -v para comprobar la versión de PHP.

    • Ejecute el comando php -m para comprobar si la extensión cURL está instalada.

Descarga del SDK

Para obtener más información, consulte la documentación de la API de OSS.

Nota

Se recomienda utilizar la versión más reciente del SDK. Puede descargar la documentación de las versiones del OSS PHP SDK anteriores a la 2.0.0 desde aquí.

Instalación del SDK

Puede instalar el SDK con uno de los siguientes métodos:

  • Mediante Composer

    1. Ejecute el comando composer require aliyuncs/oss-sdk-php en el directorio raíz de su proyecto. También puede agregar la siguiente dependencia a su archivo composer.json.

      
      "require": {
          "aliyuncs/oss-sdk-php": "~2.4"
      }
                                  
    2. Ejecute el comando composer install para instalar las dependencias. Una vez finalizada la instalación, la estructura del directorio es la siguiente:

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

      En esta estructura, app.php es su archivo de aplicación y la carpeta vendor/ contiene las dependencias. Agregue la siguiente línea a su archivo app.php:

      require_once __DIR__ . '/../vendor/autoload.php';
                                  
    Nota
    • Si su proyecto ya incluye una referencia a autoload.php, no es necesario agregarla de nuevo.

    • Si ocurre un error de red al usar Composer, utilice un espejo de Composer para la región de China. Para ello, ejecute el siguiente comando en la línea de comandos: composer config -g repositories.packagist composer http://packagist.phpcomposer.com.

  • Mediante un archivo PHAR

    1. En GitHub, seleccione la versión necesaria y descargue el archivo PHAR empaquetado.

    2. Incluya una referencia al archivo PHAR en su código:

      require_once '/path/to/oss-sdk-php.phar';
                                  
  • Mediante el código fuente

    1. En GitHub, seleccione la versión necesaria y descargue el paquete de código fuente (archivo ZIP).

    2. El directorio raíz del paquete descomprimido contiene un archivo autoload.php. Incluya una referencia a este archivo en su código:

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

Preguntas frecuentes

Error: Your configuration does not allow connection

Mensaje de error completo

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

Síntomas

Al usar Composer para instalar el SDK, se produce un error de conexión y no es posible descargar las dependencias necesarias.

Causa

De forma predeterminada, la configuración de Composer prohíbe las conexiones mediante HTTP. Por motivos de seguridad, todas las conexiones deben usar HTTPS. Esta práctica garantiza la seguridad en la transmisión de datos y evita que la información confidencial se filtre o se modifique.

Solución

Para descargar dependencias mediante HTTP, por ejemplo, en ciertos entornos de red interna, ajuste la configuración de Composer para permitir conexiones HTTP.

En el directorio raíz de su proyecto, ejecute el siguiente comando para configurar Composer y permitir conexiones HTTP:

composer config secure-http false.

Tenga en cuenta que deshabilitar HTTPS reduce la seguridad. Dé prioridad a las conexiones seguras en los entornos donde HTTPS esté disponible.