Alibaba Cloud SDK:FAQ

Causas

1. Problemas de conectividade de rede: A rede local é instável ou um firewall está bloqueando a conexão SSL.

2. Problemas de configuração de proxy: O proxy não está configurado corretamente, o que impede o acesso a recursos externos.

3. Problemas de certificado SSL: O sistema local não confia em alguns certificados SSL, causando tempos limite de conexão.

Soluções

1. Verifique sua conectividade de rede. Certifique-se de ter acesso à Internet e de que a conexão de rede esteja estável.

2. Configure o Composer para usar um 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. Baixe um certificado CA confiável:

   1. Baixe um certificado CA confiável, como o Mozilla CA Certificate Store.

   2. Configure o caminho do certificado SSL para o PHP. No arquivo php.ini, procure por curl.cainfo, defina seu valor como o caminho absoluto do certificado CA e remova o símbolo de comentário (;) do início do item de configuração.

   3. Reinicie o serviço PHP.

4. Confie em um certificado autoassinado (opcional). Se o problema de conexão for causado por um certificado autoassinado, permita que o Composer ignore a validação SSL. Isso não é recomendado para ambientes de produção.

   composer config --global -- disable-ssl

   Importante

   Esta operação desativa temporariamente a validação SSL. Certifique-se de executar o comando composer config --global --enable-ssl posteriormente para reativá-la e garantir a segurança do sistema.

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

Problemas de conectividade de rede

Descrição: A solicitação não consegue alcançar o servidor de destino porque a rede entre o cliente e o servidor está desconectada ou instável.

Solução:

Use o comando ping ou curl para testar a conectividade entre seu host local e o endpoint do produto de nuvem. Por exemplo, se uma chamada para a operação SendSms expirar, use ping dysmsapi.aliyuncs.com ou curl -v https://dysmsapi.aliyuncs.com para testar a conectividade.

• Se o comando expirar ou não retornar uma resposta, verifique se o firewall local ou roteador possui alguma política de bloqueio.

• Caso o comando retorne uma resposta, defina um período de tempo limite razoável para evitar falhas de solicitação devido a configurações inadequadas. Para obter mais informações, consulte Configuração de tempo limite. O código a seguir fornece um exemplo:

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

Longo tempo de processamento da API

Descrição: O tempo que a API de destino leva para processar a solicitação excede o período de tempo limite de leitura configurado.

Solução: Configure o período de tempo limite de leitura para acomodar um tempo de resposta maior da API. Para obter mais informações, consulte Configuração de tempo limite. Por exemplo, configure o parâmetro de tempo limite de leitura para estender esse período para a solicitação atual. O código a seguir fornece um exemplo:

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

Possíveis causas

• A fonte de espelhamento de tráfego utilizada, como o espelho da Alibaba Cloud, pode não ter sincronizado as informações mais recentes do pacote a tempo, causando a ausência de alguns arquivos.

• A URL da fonte de espelhamento de tráfego pode ter mudado ou o caminho pode estar incorreto.

Soluções

1. Verifique e certifique-se de estar usando a fonte de espelhamento de tráfego correta.

   1. Execute o comando a seguir para visualizar a fonte de espelhamento do Composer configurada atualmente:

      composer config -g --list

   2. Espelho completo do Composer da Alibaba Cloud: https://mirrors.aliyun.com/composer/

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

   3. Espelho completo do Composer da Tsinghua: https://mirrors.tuna.tsinghua.edu.cn/composer/

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

2. Desative temporariamente a fonte de espelhamento de tráfego e use o repositório central oficial diretamente. Para isso, modifique ou exclua a configuração repositories no composer.json ou execute o comando composer config --unset repos.url.

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

3. Verifique sua conectividade de rede. Uma rede instável pode impedir que os arquivos sejam baixados corretamente. Tente alternar para um ambiente de rede diferente ou usar uma VPN.

4. Se uma mensagem for exibida ao executar o comando indicando que a versão do Composer é muito antiga (`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.`), atualize para a versão mais recente (opcional).

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

5. Caso um aviso do Composer seja exibido ao executar o comando, indicando que o suporte ao Composer 1 será descontinuado, atualize para a versão 2.x para melhor compatibilidade e segurança (opcional).

   composer self-update --2

   Importante

   Verifique se os pacotes dos quais seu projeto depende oferecem suporte ao Composer 2.x. Talvez seja necessário atualizar o código e a configuração do projeto.

6. Se ocorrer um erro de Content-Length durante o download, geralmente significa que o download dos dados foi interrompido e os dados reais recebidos não correspondem ao valor esperado.

   1. Limpe o cache do Composer e execute o comando de instalação novamente.

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

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

   2. Flutuações na rede podem causar interrupções no download. Execute o comando de instalação várias vezes.

   3. Verifique a estabilidade da sua rede. Certifique-se de que a conexão esteja estável e evite fazer downloads durante horários de pico.

Possíveis causas

Quando o Composer tenta instalar dependências, ele não consegue excluir arquivos temporários. Isso pode ocorrer porque um software antivírus ou o Windows Search Indexer bloqueou o arquivo.

Soluções

1. Verifique as permissões. Em um sistema Windows, o Composer pode falhar ao criar ou modificar arquivos necessários devido a permissões insuficientes.

   1. Certifique-se de que todos os comandos do Composer sejam executados no modo administrador para evitar problemas de permissão.

   2. Confirme se os arquivos e diretórios necessários para o Composer possuem permissões de leitura e gravação.

2. Verifique a disponibilidade da versão do pacote, limpe o cache e reinstale.

   1. Verifique as versões disponíveis do pacote necessário. Por exemplo:

      composer show alibabacloud/ecs-20140526 --all

   2. Limpe o cache do Composer e reinstale:

      composer clear-cache

3. Verifique se o serviço Windows Search está em execução. Esse serviço pode indexar arquivos, fazendo com que sejam bloqueados. Para parar este serviço, execute as etapas a seguir:

   1. Pressione Win + R para abrir a caixa de diálogo Executar.

   2. Insira services.msc e pressione Enter.

   3. Localize o serviço "Windows Search", clique com o botão direito nele e selecione "Stop".

   4. Após parar o serviço, tente instalar as dependências do Composer novamente.

4. Desbloqueie o arquivo ou crie um novo diretório para instalação.

   1. Desbloqueie o arquivo executando a linha de comando como administrador:

      1. Clique com o botão direito no CMD ou PowerShell e selecione "Run as administrator".

      2. Execute o comando a seguir para excluir o diretório bloqueado:

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

      3. Certifique-se de que nenhum programa, como software antivírus ou o Windows Search Indexer, esteja bloqueando o arquivo. Tente desativar temporariamente o software antivírus e execute o comando do Composer novamente.

   2. Crie um novo diretório para instalação. Crie um novo diretório e realize operações do Composer nele:

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

5. Se ocorrer um erro 404 durante a instalação, altere a fonte de espelhamento de tráfego e tente instalar novamente.

   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.

Possíveis causas

1. Problema de cache do Composer: O cache local está corrompido ou incompleto.

2. Problema na fonte de espelhamento de tráfego: A fonte de espelhamento está instável ou indisponível.

3. Problema de rede: A conexão de rede está instável ou bloqueada por um firewall.

4. Problema de versão do Composer: Uma versão desatualizada do Composer está sendo usada.

5. Problema de configuração do ambiente: As variáveis de ambiente ou o arquivo de configuração do Composer apresentam anomalias.

Soluções

1. Verifique sua conectividade de rede.

   1. Execute o comando a seguir para testar se a rede está normal:

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

   2. Verifique as configurações do firewall para garantir que ele não esteja bloqueando o curl de acessar recursos externos.

   3. Tente usar uma rede diferente. Alterne o ambiente de rede, por exemplo, de uma rede corporativa para uma rede pessoal.

2. Verifique a configuração do Composer e use o repositório central oficial diretamente.

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

3. Exclua o pacote do Composer instalado, reinstale-o e limpe o cache do Composer.

   1. Exclua o diretório de cache local:

      rm -rf ~/.composer

   2. Limpe o cache do Composer:

      composer clear-cache

4. Se o erro persistir, verifique os logs detalhados do Composer:

   composer install --verbose

Exemplo 1

Mensagem de erro:

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.

Possíveis causas:

1. O número de versão especificado, como 3.4.1, pode não existir ou não ter sido lançado.

2. A fonte de espelhamento de tráfego do Composer que você está usando não foi sincronizada com a versão mais recente do pacote.

3. Um problema de rede impede que o pacote seja obtido corretamente.

Soluções:

• Execute o comando a seguir para visualizar todas as versões disponíveis do pacote:

  composer show alibabacloud/XXXXXX --all

  Modifique a versão no arquivo composer.json para uma versão disponível e execute composer update para reinstalar.

• Altere a fonte de espelhamento de tráfego do Composer.

  • Execute o comando a seguir para alternar para a fonte de espelhamento oficial do Packagist:

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

  • Alterne para a fonte de espelhamento acelerada fornecida pela Alibaba Cloud na China continental:

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

  Após a alteração, limpe o cache e reinstale:

  composer clear-cache
  composer install

• Verifique se sua conexão de rede está normal e tente usar um ambiente de rede estável. Se a instalação ainda falhar, tente baixar manualmente o arquivo do pacote no formato .zip ou .tar.gz e instale-o usando um caminho local:

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

Exemplo 2

Mensagem de erro:

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:

Ao instalar alibabacloud/cloudauth-20190307:3.9.2, sua dependência alibabacloud/tea-oss-utils:0.3.1 exige que guzzlehttp/psr7 esteja na versão [1.0.0,...,2.0.0). No entanto, a versão atualmente instalada de guzzlehttp/psr7 está fixada em [1.0.0,..,1.9.1], o que causa um conflito de dependências.

Soluções:

• Force uma atualização da versão da dependência.

  composer require alibabacloud/cloudauth-20190307 3.9.2 -W

• Na seção require do arquivo composer.json, adicione uma restrição de versão para guzzlehttp/psr7, como "guzzlehttp/psr7": "^1.0". Em seguida, execute o comando a seguir para atualizar as dependências.

  composer update

• Exclua o composer.lock e execute o comando a seguir para reinstalar.

  composer install --prefer-source

Causas:

1. Pacote de certificados CA não baixado: O sistema não possui um arquivo de certificado CA confiável, o que impede o cURL de verificar o certificado SSL.

2. A configuração cURL do PHP não especifica um caminho de certificado CA: O parâmetro curl.cainfo ou openssl.cafile não está configurado corretamente no arquivo php.ini.

3. Serviço PHP não reiniciado: O serviço PHP não foi reiniciado após a modificação do arquivo php.ini, portanto, a configuração não entrou em vigor.

Soluções:

1. Baixe um certificado CA confiável, como o Mozilla CA Certificate Store. Salve o arquivo cacert.pem baixado em um diretório fixo.

   Importante

   Certifique-se de que o caminho do arquivo não contenha caracteres chineses ou especiais para evitar possíveis problemas.

2. Configure o caminho do certificado SSL para o PHP.

   • Abra o arquivo de configuração do PHP php.ini. Localize o arquivo executando o comando php --ini.

   • No arquivo php.ini, localize curl.cainfo, defina seu valor como o caminho absoluto do certificado CA e remova o ponto e vírgula (;) do início do item de configuração.

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

     Salve o arquivo após a edição.

     Nota

     Substitua o caminho D:\path\to\cacert.pem no exemplo pelo caminho absoluto real do seu certificado CA baixado.

3. Reinicie o serviço PHP.

Causas

1. Conflitos de versão:

   • As versões de algumas dependências estão bloqueadas pelo arquivo composer.lock.

   • Por padrão, o Composer não atualiza automaticamente esses pacotes de dependência bloqueados.

   • Por exemplo, alibabacloud/cloudauth-20190307 requer a versão 2.0.1 do alibabacloud/openplatform-20191219, mas a versão bloqueada atual é 1.0.3.

2. Incompatibilidade de versão do PHP:

   • Você está usando o PHP 8.2, mas alguns pacotes de dependência suportam apenas PHP 5.4 a 7.x.

   • Por exemplo, ralouphie/mimey 2.1.0 suporta apenas PHP ^5.4|^7.0, mas seu ambiente é PHP 8.2.27.

Soluções

1. Force uma atualização de todas as dependências relacionadas:

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

   Nota

   Esta operação atualiza recursivamente todos os pacotes de dependência relacionados, incluindo versões antigas bloqueadas pelo composer.lock, para ajudar a resolver conflitos de versão.

2. Limpe o composer.lock e o vendor/ e reinstale. Isso é recomendado para confusão grave de dependências.

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

   Importante

   Esta operação remove todas as dependências instaladas.

3. Se um pacote de dependência não oferecer suporte ao PHP 8, faça downgrade temporário para uma versão anterior do PHP para garantir compatibilidade.

Causas

• Após executar composer install ou update, o Composer falha ao executar o comando de descoberta automática de serviços do ThinkPHP, php think service:discover. Isso interrompe todo o processo de instalação.

• Estouro de memória ou outros erros.

Soluções

1. Desative temporariamente o script de descoberta de serviços. Para isso, modifique o arquivo composer.json no diretório raiz do projeto:

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

   Altere para:

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

   Execute composer dump-autoload novamente.

2. Aumente o limite de memória do PHP. Para isso, modifique a seguinte configuração no arquivo php.ini:

   memory_limit = 512M

composer require alibabacloud/darabonba-openapi >=0.2.14