Alibaba Cloud SDK:FAQ

Causes

1. Problèmes de connectivité réseau : le réseau local est instable ou un pare-feu bloque la connexion SSL.

2. Problèmes de configuration du proxy : le proxy n'est pas configuré correctement, ce qui empêche l'accès aux ressources externes.

3. Problèmes de certificat SSL : le système local ne fait pas confiance à certains certificats SSL, ce qui entraîne des délais d'expiration de connexion.

Solutions

1. Vérifiez votre connectivité réseau. Assurez-vous que vous pouvez accéder à Internet et que la connexion réseau est stable.

2. Configurez Composer pour utiliser 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. Téléchargez un certificat CA de confiance :

   1. Téléchargez un certificat CA de confiance, tel que le Mozilla CA Certificate Store.

   2. Configurez le chemin du certificat SSL pour PHP. Dans le fichier php.ini, recherchez curl.cainfo, définissez sa valeur sur le chemin absolu du certificat CA, puis supprimez le symbole de commentaire (;) au début de l'élément de configuration.

   3. Redémarrez le service PHP.

4. Faire confiance à un certificat auto-signé (facultatif). Si le problème de connexion provient d'un certificat auto-signé, autorisez Composer à ignorer la validation SSL. Cette manipulation n'est pas recommandée pour les environnements de production.

   composer config --global -- disable-ssl

   Important

   Cette opération désactive temporairement la validation SSL. Veillez à exécuter ultérieurement la commande composer config --global --enable-ssl pour la réactiver et garantir la sécurité du système.

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

Problèmes de connectivité réseau

Description : La requête ne parvient pas au serveur de destination car le réseau entre le client et le serveur est interrompu ou instable.

Solution :

Utilisez la commande ping ou curl pour tester la connectivité entre votre hôte local et l'endpoint du produit cloud. Par exemple, si un appel à l'opération SendSms expire, utilisez ping dysmsapi.aliyuncs.com ou curl -v https://dysmsapi.aliyuncs.com pour tester la connectivité.

• Si la commande expire ou ne retourne aucune réponse, vérifiez si votre pare-feu local ou votre routeur applique une politique de blocage.

• Si la commande retourne une réponse, définissez un délai d'expiration raisonnable pour éviter les échecs de requête dus à une configuration inadaptée. Pour plus d'informations, consultez Configuration du délai d'expiration. L'exemple de code suivant illustre cette configuration :

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

Temps de traitement long de l'API

Description : Le temps nécessaire à l'API de destination pour traiter la requête dépasse le délai de lecture configuré.

Solution : Configurez le délai de lecture pour tenir compte d'un temps de réponse plus long de l'API. Pour plus d'informations, consultez Configuration du délai d'expiration. Vous pouvez notamment configurer le paramètre de délai de lecture pour prolonger ce délai pour la requête en cours. L'exemple de code suivant illustre cette configuration :

// 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)

Causes possibles

• La source miroir de trafic utilisée, telle que le miroir Alibaba Cloud, n'a peut-être pas synchronisé les dernières informations de package à temps, ce qui entraîne l'absence de certains fichiers.

• L'URL de la source miroir de trafic a pu changer ou le chemin est incorrect.

Solutions

1. Vérifiez que vous utilisez la bonne source miroir de trafic.

   1. Exécutez la commande suivante pour afficher la source miroir Composer actuellement configurée :

      composer config -g --list

   2. Miroir complet Alibaba Cloud pour Composer : https://mirrors.aliyun.com/composer/

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

   3. Miroir complet Tsinghua pour Composer : https://mirrors.tuna.tsinghua.edu.cn/composer/

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

2. Désactivez temporairement la source miroir de trafic pour utiliser directement le dépôt central officiel. Pour cela, modifiez ou supprimez la configuration repositories dans composer.json, ou exécutez la commande composer config --unset repos.url.

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

3. Vérifiez votre connectivité réseau. Un réseau instable peut empêcher le téléchargement correct des fichiers. Essayez de changer d'environnement réseau ou d'utiliser un VPN.

4. Si un message s'affiche lors de l'exécution de la commande indiquant que la version de Composer est trop ancienne (`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.`), mettez-la à jour vers la dernière version (facultatif).

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

5. Si un avertissement Composer s'affiche lors de l'exécution de la commande, cela indique que la prise en charge de Composer 1 sera abandonnée. Pour une meilleure compatibilité et sécurité, passez à la version 2.x (facultatif).

   composer self-update --2

   Important

   Vérifiez si les packages dont dépend votre projet prennent en charge Composer 2.x. Une mise à jour du code et de la configuration du projet peut être nécessaire.

6. Si une erreur Content-Length survient pendant le téléchargement, cela signifie généralement que le téléchargement des données a été interrompu et que les données reçues ne correspondent pas à la valeur attendue.

   1. Videz le cache Composer et relancez la commande d'installation.

      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. Des fluctuations réseau pouvant provoquer des interruptions de téléchargement, exécutez la commande d'installation à plusieurs reprises.

   3. Vérifiez la stabilité de votre réseau. Assurez-vous que la connexion est stable et évitez les téléchargements aux heures de pointe.

Causes possibles

Lorsque Composer tente d'installer des dépendances, il ne parvient pas à supprimer les fichiers temporaires. Cela peut être dû au verrouillage du fichier par un logiciel antivirus ou par l'indexeur de recherche Windows.

Solutions

1. Vérifiez les permissions. Sur un système Windows, Composer peut échouer à créer ou modifier les fichiers requis en raison de permissions insuffisantes.

   1. Assurez-vous d'exécuter toutes les commandes Composer en mode administrateur pour éviter les problèmes de permissions.

   2. Confirmez que les fichiers et répertoires requis par Composer disposent des permissions de lecture et d'écriture.

2. Vérifiez la disponibilité de la version du package, videz le cache et réinstallez.

   1. Vérifiez les versions disponibles du package requis. Par exemple :

      composer show alibabacloud/ecs-20140526 --all

   2. Videz le cache Composer et réinstallez :

      composer clear-cache

3. Vérifiez si le service Windows Search est en cours d'exécution. Ce service peut indexer des fichiers, provoquant leur verrouillage. Pour arrêter ce service, procédez comme suit :

   1. Appuyez sur Win + R pour ouvrir la boîte de dialogue Exécuter.

   2. Saisissez services.msc et appuyez sur Entrée.

   3. Localisez le service « Windows Search », faites un clic droit dessus et sélectionnez « Arrêter ».

   4. Une fois le service arrêté, tentez d'installer à nouveau les dépendances Composer.

4. Déverrouillez le fichier ou créez un nouveau répertoire pour l'installation.

   1. Déverrouillez le fichier en exécutant la ligne de commande en tant qu'administrateur :

      1. Faites un clic droit sur CMD ou PowerShell et sélectionnez « Exécuter en tant qu'administrateur ».

      2. Exécutez la commande suivante pour supprimer le répertoire verrouillé :

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

      3. Assurez-vous qu'aucun programme, tel qu'un antivirus ou l'indexeur de recherche Windows, ne verrouille le fichier. Essayez de désactiver temporairement l'antivirus et relancez la commande Composer.

   2. Créez un nouveau répertoire pour l'installation. Créez un nouveau répertoire et effectuez-y les opérations Composer :

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

5. Si une erreur 404 survient lors de l'installation, changez de source miroir de trafic et réessayez.

   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.

Causes possibles

1. Problème de cache Composer : le cache local est corrompu ou incomplet.

2. Problème de source miroir : la source miroir de trafic est instable ou indisponible.

3. Problème réseau : la connexion réseau est instable ou bloquée par un pare-feu.

4. Problème de version Composer : une version obsolète de Composer est utilisée.

5. Problème de configuration environnementale : les variables d'environnement ou le fichier de configuration Composer présentent une anomalie.

Solutions

1. Vérifiez votre connectivité réseau.

   1. Exécutez la commande suivante pour tester le bon fonctionnement du réseau :

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

   2. Vérifiez les paramètres du pare-feu pour vous assurer qu'il ne bloque pas l'accès de curl aux ressources externes.

   3. Essayez d'utiliser un autre réseau. Changez d'environnement réseau, par exemple en passant d'un réseau d'entreprise à un réseau personnel.

2. Vérifiez la configuration de Composer et utilisez directement le dépôt central officiel.

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

3. Supprimez le package Composer installé, réinstallez-le et videz le cache Composer.

   1. Supprimez le répertoire de cache local :

      rm -rf ~/.composer

   2. Videz le cache Composer :

      composer clear-cache

4. Si l'erreur persiste, consultez les journaux détaillés de Composer :

   composer install --verbose

Exemple 1

Message d'erreur :

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.

Causes possibles :

1. Le numéro de version spécifié, tel que 3.4.1, n'existe peut-être pas ou n'a pas encore été publié.

2. La source miroir Composer utilisée n'est pas synchronisée avec la dernière version du package.

3. Un problème réseau empêche le téléchargement correct du package.

Solutions :

• Exécutez la commande suivante pour afficher toutes les versions disponibles du package :

  composer show alibabacloud/XXXXXX --all

  Modifiez la version dans le fichier composer.json pour choisir une version disponible, puis exécutez composer update pour réinstaller.

• Changez de source miroir Composer.

  • Exécutez la commande suivante pour passer à la source miroir officielle Packagist :

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

  • Passez à la source miroir accélérée fournie par Alibaba Cloud en Chine continentale :

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

  Après le changement, videz le cache et réinstallez :

  composer clear-cache
  composer install

• Vérifiez le bon fonctionnement de votre connexion réseau et privilégiez un environnement réseau stable. Si l'installation échoue toujours, essayez de télécharger manuellement le fichier du package au format .zip ou .tar.gz et installez-le via un chemin local :

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

Exemple 2

Message d'erreur :

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]#

Cause :

Lors de l'installation de alibabacloud/cloudauth-20190307:3.9.2, sa dépendance alibabacloud/tea-oss-utils:0.3.1 exige que guzzlehttp/psr7 soit dans la plage de versions [1.0.0,...,2.0.0). Or, la version actuellement installée de guzzlehttp/psr7 est figée à [1.0.0,..,1.9.1], ce qui provoque un conflit de dépendances.

Solutions :

• Forcez la mise à jour de la version de la dépendance.

  composer require alibabacloud/cloudauth-20190307 3.9.2 -W

• Dans la section require du fichier composer.json, ajoutez une contrainte de version pour guzzlehttp/psr7, par exemple « guzzlehttp/psr7 »: « ^1.0 ». Exécutez ensuite la commande suivante pour mettre à jour les dépendances.

  composer update

• Supprimez composer.lock et exécutez la commande suivante pour réinstaller.

  composer install --prefer-source

Causes :

1. Package de certificats CA non téléchargé : le système ne dispose pas d'un fichier de certificat CA de confiance, ce qui empêche cURL de vérifier le certificat SSL.

2. La configuration cURL de PHP ne spécifie pas de chemin de certificat CA : le paramètre curl.cainfo ou openssl.cafile n'est pas configuré correctement dans le fichier php.ini.

3. Service PHP non redémarré : le service PHP n'a pas été redémarré après la modification du fichier php.ini, la configuration n'a donc pas pris effet.

Solutions :

1. Téléchargez un certificat CA de confiance, tel que le Mozilla CA Certificate Store. Enregistrez le fichier cacert.pem téléchargé dans un répertoire fixe.

   Important

   Assurez-vous que le chemin du fichier ne contient ni caractères chinois ni caractères spéciaux afin d'éviter tout problème potentiel.

2. Configurez le chemin du certificat SSL pour PHP.

   • Ouvrez le fichier de configuration PHP php.ini. Localisez le fichier en exécutant la commande php --ini.

   • Dans le fichier php.ini, localisez curl.cainfo, définissez sa valeur sur le chemin absolu du certificat CA et supprimez le point-virgule (;) au début de l'élément de configuration.

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

     Enregistrez le fichier après modification.

     Remarque

     Remplacez le chemin D:\path\to\cacert.pem de l'exemple par le chemin absolu réel de votre certificat CA téléchargé.

3. Redémarrez le service PHP.

Causes

1. Conflits de versions :

   • Les versions de certaines dépendances sont verrouillées par le fichier composer.lock.

   • Par défaut, Composer ne met pas automatiquement à jour ces packages de dépendances verrouillés.

   • Par exemple, alibabacloud/cloudauth-20190307 nécessite la version 2.0.1 de alibabacloud/openplatform-20191219, mais la version actuellement verrouillée est 1.0.3.

2. Incompatibilité de version PHP :

   • Vous utilisez PHP 8.2, mais certains packages de dépendances ne prennent en charge que PHP 5.4 à 7.x.

   • Par exemple, ralouphie/mimey 2.1.0 ne prend en charge que PHP ^5.4|^7.0, alors que votre environnement utilise PHP 8.2.27.

Solutions

1. Forcez la mise à niveau de toutes les dépendances associées :

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

   Remarque

   Cette opération met à jour récursivement tous les packages de dépendances associés, y compris les anciennes versions verrouillées par composer.lock, afin de résoudre les conflits de versions.

2. Supprimez composer.lock et vendor/, puis réinstallez. Cette approche est recommandée en cas de confusion sévère des dépendances.

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

   Important

   Cette opération supprime toutes les dépendances installées.

3. Si un package de dépendances ne prend pas en charge PHP 8, rétrogradez temporairement vers une version antérieure de PHP pour garantir la compatibilité.

Causes

• Après l'exécution de composer install ou update, Composer échoue à exécuter la commande de découverte automatique des services de ThinkPHP, php think service:discover. Cela interrompt l'ensemble du processus d'installation.

• Dépassement de mémoire ou autres erreurs.

Solutions

1. Désactivez temporairement le script de découverte des services. Modifiez pour cela le fichier composer.json situé à la racine du projet :

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

   Remplacez-le par :

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

   Exécutez à nouveau composer dump-autoload.

2. Augmentez la limite de mémoire PHP. Modifiez pour cela la configuration suivante dans le fichier php.ini :

   memory_limit = 512M

composer require alibabacloud/darabonba-openapi >=0.2.14