Alibaba Cloud SDK:FAQ

Causas

1. Problemas de conectividad de red: la red local es inestable o un firewall está bloqueando la conexión SSL.

2. Problemas de configuración del proxy: el proxy no está configurado correctamente, lo que impide acceder a recursos externos.

3. Problemas con el certificado SSL: el sistema local no confía en algunos certificados SSL, lo que provoca tiempos de espera agotados en la conexión.

Soluciones

1. Compruebe la conectividad de red. Asegúrese de tener acceso a Internet y de que la conexión de red sea estable.

2. Configure Composer para usar un proxy:

   composer config -g -- unset http-proxy
   composer config -g -- unset https-proxy
   composer config -g http-proxy http://your-proxy:port
   composer config -g https-proxy https://your-proxy:port

3. Descargue un certificado de CA de confianza:

   1. Descargue un certificado de CA de confianza, como el almacén de certificados de CA de Mozilla.

   2. Configure la ruta del certificado SSL para PHP. En el archivo php.ini, busque curl.cainfo, establezca su valor con la ruta absoluta del certificado de CA y elimine el símbolo de comentario (;) del inicio del elemento de configuración.

   3. Reinicie el servicio de PHP.

4. Confíe en un certificado autofirmado (opcional). Si el problema de conexión se debe a un certificado autofirmado, permita que Composer omita la validación SSL. No se recomienda esta opción en entornos de producción.

   composer config --global -- disable-ssl

   Importante

   Esta operación deshabilita temporalmente la validación SSL. Asegúrese de ejecutar después el comando composer config --global --enable-ssl para volver a habilitarla y garantizar la seguridad del sistema.

require_once(<path to the autoload.php file in the vendor directory>)

Problemas de conectividad de red

Descripción: la solicitud no puede llegar al servidor de destino porque la red entre el cliente y el servidor está desconectada o es inestable.

Solución:

Use el comando ping o curl para probar la conectividad entre su host local y el endpoint del producto en la nube. Por ejemplo, si se agota el tiempo de espera de una llamada a la operación SendSms, utilice ping dysmsapi.aliyuncs.com o curl -v https://dysmsapi.aliyuncs.com para probar la conectividad.

• Si el comando agota el tiempo de espera o no devuelve respuesta, compruebe si su firewall o router local tiene alguna política de bloqueo.

• Si el comando devuelve una respuesta, establezca un tiempo de espera razonable para evitar que las solicitudes fallen por una configuración inadecuada. Para obtener más información, consulte Timeout configuration. El siguiente código muestra un ejemplo:

// Set the timeout in runtime parameters. This is valid only for requests that use this runtime parameter instance.
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->connectTimeout = $connectionTimeoutMillis;

Tiempo prolongado de procesamiento de la API

Descripción: el tiempo que tarda la API de destino en procesar la solicitud supera el tiempo de espera de lectura configurado.

Solución: configure el tiempo de espera de lectura para contemplar un tiempo de respuesta de la API más largo. Para obtener más información, consulte Timeout configuration. Por ejemplo, configure el parámetro de tiempo de espera de lectura para ampliar dicho periodo en la solicitud actual. El siguiente código muestra un ejemplo:

// Set the timeout in runtime parameters. This is valid only for requests that use this runtime parameter instance.
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->readTimeout = $readTimeoutMillis;

sudo apt-get install php-curl

sudo yum install php-curl

[root@hecs-x-large-2-win-20210204102325 rcw.zhiyuechuanbo.com]# composer require alibabacloud/ocr-api-20210707 3.1.2
Warning: This development build of composer is over 60 days old. It is recommended to update it by running "/usr/bin/composer self-update" to get the latest version.
Do not run Composer as root/super user! See https://getcomposer.org/root for details
Warning from https://mirrors.aliyun.com/composer: Support for Composer 1 will be shutdown on August 1st 2025. You should upgrade to Composer 2. See https://blog.packagist.com/shutting-down-packagist-org-support-for-composer-1-x/
[Composer\Downloader\TransportException]
The "https://mirrors.aliyun.com/composer/p/provider-2013%24a2b47ec1a1bb999e53d88aff50728aebbd3d68225c74aab1ff5f071bac42f5b7.json" file could not be downloaded (HTTP/1.1 404 Not Found)

Posibles causas

• El origen de espejo de tráfico que utiliza, como el espejo de Alibaba Cloud, podría no haber sincronizado a tiempo la información más reciente de los paquetes. Esto provoca que falten algunos archivos.

• La URL del origen de espejo de tráfico pudo haber cambiado o la ruta es incorrecta.

Soluciones

1. Compruebe y asegúrese de utilizar el origen de espejo de tráfico correcto.

   1. Ejecute el siguiente comando para consultar el origen de espejo de tráfico de Composer configurado actualmente:

      composer config -g --list

   2. Espejo completo de Composer de Alibaba Cloud: https://mirrors.aliyun.com/composer/

      composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

   3. Espejo completo de Composer de Tsinghua: https://mirrors.tuna.tsinghua.edu.cn/composer/

      composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/

2. Deshabilite temporalmente el origen de espejo de tráfico y use directamente el repositorio central oficial. Para ello, modifique o elimine la configuración de repositories en composer.json, o ejecute el comando composer config --unset repos.url.

   # Use the official Composer repository.
   composer config -g repo.packagist composer https://packagist.org

3. Compruebe la conectividad de red. Una red inestable puede impedir que los archivos se descarguen correctamente. Intente cambiar a otro entorno de red o utilice una VPN.

4. Si al ejecutar el comando se muestra un mensaje que indica que la versión de Composer es demasiado antigua (`Warning: This development build of composer is over 60 days old. It is recommended to update it by running "/usr/bin/composer self-update" to get the latest version.`), actualice a la versión más reciente (opcional).

   # Update Composer to the latest version.
   composer self-update
   # Use composer.phar to run the latest version.
   composer self-update --1

5. Si al ejecutar el comando se muestra una advertencia de Composer, significa que se suspenderá la compatibilidad con Composer 1. Para mejorar la compatibilidad y la seguridad, actualice a la versión 2.x (opcional).

   composer self-update --2

   Importante

   Compruebe si los paquetes de los que depende su proyecto son compatibles con Composer 2.x. Es posible que deba actualizar el código y la configuración del proyecto.

6. Si se produce un error de Content-Length durante la descarga, generalmente se debe a que la descarga de datos se interrumpió y los datos recibidos no coinciden con el valor esperado.

   1. Borre la caché de Composer y vuelva a ejecutar el comando de instalación.

      PowerShell

      # Delete the .composer directory
      Remove-Item -Recurse -Force $HOME\.composer
      # Delete all content in the C:\tmp directory
      Remove-Item -Recurse -Force C:\tmp\*

      Shell

      rm -rf ~/.composer/ && rm -rf /tmp/*

   2. Las fluctuaciones de la red pueden provocar interrupciones en la descarga. Ejecute el comando de instalación varias veces.

   3. Compruebe la estabilidad de su red. Asegúrese de que la conexión sea estable y evite descargar durante las horas de mayor demanda.

Posibles causas

Cuando Composer intenta instalar las dependencias, no puede eliminar los archivos temporales. Esto puede deberse a que un software antivirus o el indexador de búsqueda de Windows bloqueó el archivo.

Soluciones

1. Compruebe los permisos. En un sistema Windows, Composer puede fallar al crear o modificar los archivos necesarios por falta de permisos.

   1. Asegúrese de ejecutar todos los comandos de Composer en modo administrador para evitar problemas de permisos.

   2. Confirme que los archivos y directorios que requiere Composer tengan permisos de lectura y escritura.

2. Compruebe la disponibilidad de la versión del paquete, borre la caché y vuelva a instalarlo.

   1. Consulte las versiones disponibles del paquete requerido. Por ejemplo:

      composer show alibabacloud/ecs-20140526 --all

   2. Borre la caché de Composer y vuelva a instalarlo:

      composer clear-cache

3. Compruebe si el servicio Windows Search se está ejecutando. Este servicio puede indexar archivos y provocar que se bloqueen. Para detenerlo, siga estos pasos:

   1. Presione Win + R para abrir el cuadro de diálogo Ejecutar.

   2. Introduzca services.msc y presione Enter.

   3. Busque el servicio "Windows Search", haga clic derecho sobre él y seleccione "Stop".

   4. Una vez detenido el servicio, intente instalar de nuevo las dependencias de Composer.

4. Desbloquee el archivo o cree un nuevo directorio para la instalación.

   1. Desbloquee el archivo ejecutando la línea de comandos como administrador:

      1. Haga clic derecho en CMD o PowerShell y seleccione "Run as administrator".

      2. Ejecute el siguiente comando para eliminar el directorio bloqueado:

         rmdir /S /Q "D:\www\touming_keyword_api\vendor\composer\tmp-7fd77eb46d69640d6040743642007957"

      3. Asegúrese de que ningún programa, como un software antivirus o el indexador de búsqueda de Windows, esté bloqueando el archivo. Intente deshabilitar temporalmente el software antivirus y vuelva a ejecutar el comando de Composer.

   2. Cree un nuevo directorio para la instalación. Cree un directorio nuevo y ejecute las operaciones de Composer dentro de él:

      mkdir D:\new_directory
      cd D:\new_directory
      composer require alibabacloud/ecs-20140526 6.0.1

5. Si se produce un error 404 durante la instalación, cambie el origen de espejo de tráfico e intente instalarlo de nuevo.

   composer config -g repo.packagist composer https://packagist.org

D:\Appserv\PHPTutorial\WWW\changheyuedu>composer require alibabacloud/dysmsapi-20170525 2.0.8
./composer.json has been updated
Running composer update alibabacloud/dysmsapi-20170525
Loading composer repositories with package information
https://mirrors.aliyun.com/composer could not be fully loaded (curl error 61 while downloading https://mirrors.aliyun.com/composer/p2/alibabacloud/dysmsapi-20170525.json: Error while processing content unencoding: Unknown failure within decompression software.), package information was loaded from the local cache and may be out of date
Installation failed, reverting ./composer.json and ./composer.lock to their original content.
  [Composer\Downloader\TransportException]
  curl error 61 while downloading https://mirrors.aliyun.com/composer/p2/alibabacloud/dysmsapi-20170525.json: Error w
  hile processing content unencoding: Unknown failure within decompression software.

Posibles causas

1. Problema con la caché de Composer: la caché local está dañada o incompleta.

2. Problema con el origen de espejo de tráfico: el origen de espejo de tráfico es inestable o no está disponible.

3. Problema de red: la conexión de red es inestable o está bloqueada por un firewall.

4. Problema con la versión de Composer: se utiliza una versión obsoleta de Composer.

5. Problema de configuración del entorno: las variables de entorno o el archivo de configuración de Composer presentan anomalías.

Soluciones

1. Compruebe la conectividad de red.

   1. Ejecute el siguiente comando para comprobar si la red funciona correctamente:

      curl -I https://mirrors.aliyun.com/composer/p2/alibabacloud/dysmsapi-20170525.json

   2. Revise la configuración del firewall para asegurarse de que no bloquee el acceso de curl a recursos externos.

   3. Intente usar otra red. Cambie de entorno de red, por ejemplo, de una red corporativa a una red personal.

2. Revise la configuración de Composer y use directamente el repositorio central oficial.

   composer config -g --list
   composer config -g repo.packagist composer https://packagist.org

3. Elimine el paquete de Composer instalado, vuelva a instalarlo y borre la caché de Composer.

   1. Elimine el directorio de caché local:

      rm -rf ~/.composer

   2. Borre la caché de Composer:

      composer clear-cache

4. Si el error persiste, consulte los registros detallados de Composer:

   composer install --verbose

Ejemplo 1

Mensaje de error:

Your requirements could not be resolved to an installable set of packages.
Problem 1
 - Root composer.json requires alibabacloud/cloudauth-20190307 3.4.1, found alibabacloud/cloudauth-20190307[dev-master, 1.0.0, ..., 1.0.7, 2.0.0, ..., 2.9.1, 3.0.0, ..., 3.3.0] but it does not match the constraint.
Installation failed, reverting ./composer.json and ./composer.lock to their original content.

Posibles causas:

1. El número de versión especificado, como 3.4.1, podría no existir o no haberse publicado aún.

2. El origen de espejo de tráfico de Composer que utiliza no se ha sincronizado con la versión más reciente del paquete.

3. Un problema de red impide extraer el paquete correctamente.

Soluciones:

• Ejecute el siguiente comando para consultar todas las versiones disponibles del paquete:

  composer show alibabacloud/XXXXXX --all

  Modifique la versión en el archivo composer.json por una versión disponible y luego ejecute composer update para reinstalar.

• Cambie el origen de espejo de tráfico de Composer.

  • Ejecute el siguiente comando para cambiar al origen de espejo de tráfico oficial de Packagist:

    composer config -g repo.packagist composer https://repo.packagist.org

  • Cambie al origen de espejo de tráfico acelerado que proporciona Alibaba Cloud en China continental:

    composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

  Después de cambiarlo, borre la caché y vuelva a instalar:

  composer clear-cache
  composer install

• Compruebe si su conexión de red funciona correctamente e intente usar un entorno de red estable. Si la instalación sigue fallando, descargue manualmente el archivo del paquete en formato .zip o .tar.gz e instálelo mediante una ruta local:

  composer require alibabacloud/XXXXXX@dev --prefer-source

Ejemplo 2

Mensaje de error:

composer could not delete the root package (root/mr.appteam/version) defaulting to ... see https://getcomposer.org/root-version
Running composer update alibabacloud/cloudauth-20190307
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.
  Problem 1
    - Root composer.json requires alibabacloud/cloudauth-20190307 3.9.2 -> satisfiable by alibabacloud/cloudauth-20190307[3.9.2].
    - alibabacloud/cloudauth-20190307 3.9.2 requires alibabacloud/tea-oss-utils ^0.3.1 -> satisfiable by alibabacloud/tea-oss-utils[0.3.1].
    - alibabacloud/tea-oss-utils[0.3.0, ..., 0.3.1] require guzzlehttp/psr7 ^1.0 -> found guzzlehttp/psr7[1.0.0, ..., 1.9.1] but the package is fixed
  Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.
Installation failed, reverting ./composer.json and ./composer.lock to their original content.
[root@ebs-171291 mrrapp.com]#

Causa:

Al instalar alibabacloud/cloudauth-20190307:3.9.2, su dependencia alibabacloud/tea-oss-utils:0.3.1 requiere que guzzlehttp/psr7 tenga la versión [1.0.0,...,2.0.0). Sin embargo, la versión instalada actualmente de guzzlehttp/psr7 está fijada en [1.0.0,..,1.9.1], lo que genera un conflicto de dependencias.

Soluciones:

• Fuerce la actualización de la versión de la dependencia.

  composer require alibabacloud/cloudauth-20190307 3.9.2 -W

• En la sección require del archivo composer.json, agregue una restricción de versión para guzzlehttp/psr7, como "guzzlehttp/psr7": "^1.0". Luego, ejecute el siguiente comando para actualizar las dependencias.

  composer update

• Elimine composer.lock y ejecute el siguiente comando para reinstalar.

  composer install --prefer-source

Causas:

1. Paquete de certificados de CA no descargado: al sistema le falta un archivo de certificado de CA de confianza, lo que impide que cURL verifique el certificado SSL.

2. La configuración de cURL de PHP no especifica una ruta de certificado de CA: el parámetro curl.cainfo o openssl.cafile no está configurado correctamente en el archivo php.ini.

3. Servicio de PHP no reiniciado: el servicio de PHP no se reinició después de modificar el archivo php.ini, por lo que la configuración no surtió efecto.

Soluciones:

1. Descargue un certificado de CA de confianza, como el almacén de certificados de CA de Mozilla. Guarde el archivo cacert.pem descargado en un directorio fijo.

   Importante

   Asegúrese de que la ruta del archivo no contenga caracteres chinos ni caracteres especiales para evitar posibles problemas.

2. Configure la ruta del certificado SSL para PHP.

   • Abra el archivo de configuración de PHP php.ini. Puede encontrar la ubicación del archivo ejecutando el comando php --ini.

   • En el archivo php.ini, busque curl.cainfo, establezca su valor con la ruta absoluta del certificado de CA y elimine el punto y coma (;) del inicio del elemento de configuración.

     # Example
     curl.cainfo = "D:\path\to\cacert.pem"
     openssl.cafile = "D:\path\to\cacert.pem"

     Guarde el archivo después de editarlo.

     Nota

     Reemplace la ruta D:\path\to\cacert.pem del ejemplo con la ruta absoluta real del certificado de CA que descargó.

3. Reinicie el servicio de PHP.

Causas

1. Conflictos de versión:

   • Las versiones de algunas dependencias están bloqueadas por el archivo composer.lock.

   • De forma predeterminada, Composer no actualiza automáticamente estos paquetes de dependencias bloqueados.

   • Por ejemplo, alibabacloud/cloudauth-20190307 requiere la versión 2.0.1 de alibabacloud/openplatform-20191219, pero la versión bloqueada actual es 1.0.3.

2. Incompatibilidad de versión de PHP:

   • Está utilizando PHP 8.2, pero algunos paquetes de dependencias solo admiten PHP 5.4 a 7.x.

   • Por ejemplo, ralouphie/mimey 2.1.0 solo admite PHP ^5.4|^7.0, pero su entorno tiene PHP 8.2.27.

Soluciones

1. Fuerce la actualización de todas las dependencias relacionadas:

   composer update --with-all-dependencies
   # Or the short form:
   composer update -W

   Nota

   Esta operación actualiza de forma recursiva todos los paquetes de dependencias relacionados, incluidas las versiones antiguas bloqueadas por composer.lock, para ayudar a resolver los conflictos de versión.

2. Elimine composer.lock y vendor/, y luego vuelva a instalar. Se recomienda esta opción cuando hay una gran confusión de dependencias.

   rm composer.lock vendor/
   composer clear-cache
   composer install

   Importante

   Esta operación elimina todas las dependencias instaladas.

3. Si un paquete de dependencia no es compatible con PHP 8, cambie temporalmente a una versión anterior de PHP para garantizar la compatibilidad.

Causas

• Después de ejecutar composer install o update, Composer no logra ejecutar el comando de detección automática de servicios de ThinkPHP, php think service:discover. Esto interrumpe todo el proceso de instalación.

• Desbordamiento de memoria u otros errores.

Soluciones

1. Deshabilite temporalmente el script de detección de servicios. Para ello, modifique el archivo composer.json en el directorio raíz del proyecto:

   {
       "scripts": {
           "post-autoload-dump": "@php think service:discover"
       }
   }

   Cámbielo por lo siguiente:

   {
       "scripts": {
           "post-autoload-dump": "@echo Skipping 'php think service:discover'"
       }
   }

   Ejecute nuevamente composer dump-autoload.

2. Aumente el límite de memoria de PHP. Modifique la siguiente configuración en el archivo php.ini:

   memory_limit = 512M

composer require alibabacloud/darabonba-openapi >=0.2.14