Alibaba Cloud SDK:よくある質問

原因

1. ネットワーク接続の問題：オンプレミスネットワークが不安定であるか、ファイアウォールが SSL 接続をブロックしています。

2. プロキシ設定の問題：プロキシが正しく設定されていないため、外部リソースへのアクセスが妨げられています。

3. SSL 証明書の問題：ローカルシステムが一部の SSL 証明書を信頼していないため、接続タイムアウトが発生します。

解決策

1. ネットワーク接続を確認してください。インターネットにアクセスでき、ネットワーク接続が安定していることを確認してください。

2. Composer がプロキシを使用するように設定してください。

   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. 信頼できる CA 証明書をダウンロードしてください。

   1. Mozilla CA Certificate Store などの信頼できる CA 証明書をダウンロードします。

   2. PHP の SSL 証明書パスを設定してください。php.ini ファイルで curl.cainfo を検索し、その値を CA 証明書の絶対パスに設定してから、設定項目の先頭にあるコメント記号 (;) を削除してください。

   3. PHP サービスを再起動してください。

4. 自己署名証明書を信頼します (任意)。接続の問題が自己署名証明書に起因する場合、Composer に SSL 検証を無視させることができます。この操作は本番環境では推奨されません。

   composer config --global secure-http false

   重要

   この操作は SSL 検証を一時的に無効化します。後ほど、必ずコマンド composer config --global --enable-ssl を実行して SSL 検証を再度有効にし、システムのセキュリティを確保してください。

ネットワーク接続の問題

説明：クライアントとサーバー間のネットワークが切断されているか不安定なため、リクエストが宛先サーバーに到達できません。

解決策：

ping コマンドまたは curl コマンドを使用して、ローカルホストとクラウド製品のエンドポイント間の接続性をテストします。 たとえば、SendSms 操作の呼び出しがタイムアウトした場合、ping dysmsapi.aliyuncs.com または curl -v https://dysmsapi.aliyuncs.com を使用して接続性をテストできます。

• コマンドがタイムアウトするか、応答が返されない場合は、ローカルのファイアウォールまたはルーターにブロッキングポリシーがあるかどうかを確認してください。

• コマンドが応答を返す場合は、不適切な設定によるリクエストの失敗を防ぐために、適切なタイムアウト期間を設定できます。詳細については、「タイムアウト設定」をご参照ください。次のコードは例です。

// ランタイムパラメーターでタイムアウトを設定します。これは、このランタイムパラメーターインスタンスを使用するリクエストに対してのみ有効です。
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->connectTimeout = $connectionTimeoutMillis;

API の処理時間が長い

説明：宛先 API がリクエストを処理する時間が、設定された読み取りタイムアウト期間を超えています。

解決策：読み取りタイムアウト期間を設定して、より長い API 応答時間に対応できます。詳細については、「タイムアウト設定」をご参照ください。たとえば、読み取りタイムアウトパラメーターを設定して、現在のリクエストの読み取りタイムアウト期間を延長できます。次のコードは例です。

// ランタイムパラメーターでタイムアウトを設定します。これは、このランタイムパラメーターインスタンスを使用するリクエストに対してのみ有効です。
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->readTimeout = $readTimeoutMillis;

考えられる原因

• 使用しているミラーソース (Alibaba Cloud ミラーなど) が、最新のパッケージ情報を時間内に同期していない可能性があります。その結果、一部のファイルが欠落していることがあります。

• ミラーソースの URL が変更されたか、パスが正しくない可能性があります。

解決策

1. 正しいミラーソースを使用していることを確認してください。

   1. 次のコマンドを実行して、現在設定されている Composer のミラーソースを表示してください。

      composer config -g --list

   2. Alibaba Cloud Composer フルミラー: https://mirrors.aliyun.com/composer/

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

   3. Tsinghua の Composer フルミラー： https://mirrors.tuna.tsinghua.edu.cn/composer/

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

2. トラフィックミラーソースを一時的に無効にして公式の中央リポジトリを直接使用するには、composer.json の repositories 設定を変更または削除するか、コマンド composer config --unset repos.url を実行します。

   # 公式の Composer リポジトリを使用します。
   composer config -g repo.packagist composer https://packagist.org

3. ネットワーク接続を確認してください。ネットワークが不安定な場合、ファイルが正しくダウンロードされないことがあります。別のネットワーク環境に切り替えるか、VPN を使用してみてください。

4. コマンドの実行時に Composer のバージョンが古すぎることを示すメッセージ 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. が表示された場合は、最新バージョンに更新できます (任意)。

   # Composer を最新バージョンに更新します。
   composer self-update
   # Composer を 1.x 系の最新安定版に更新またはダウングレードします。
   composer self-update --1

5. コマンドの実行時に Composer の警告が表示される場合、Composer 1 のサポートが終了することを示しています。互換性とセキュリティを向上させるため、バージョン 2.x にアップグレードできます (任意)。

   composer self-update --2

   重要

   プロジェクトが依存するパッケージが Composer 2.x をサポートしているか確認してください。プロジェクトのコードと設定を更新する必要がある場合があります。

6. ダウンロード中に Content-Length エラーが発生した場合、通常、データダウンロードが中断され、実際に受信したデータが期待値と一致しないことが原因です。

   1. Composer のキャッシュをクリアして、インストールコマンドを再実行できます。

      PowerShell

      # .composer ディレクトリを削除します
      Remove-Item -Recurse -Force $HOME\.composer
      # C:\tmp ディレクトリのすべてのコンテンツを削除します
      Remove-Item -Recurse -Force C:\tmp\*

      Shell

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

   2. ネットワークの変動によりダウンロードが中断されることがあります。インストールコマンドを複数回実行してみてください。

   3. ネットワークの安定性を確認します。ネットワーク接続が安定していることを確認し、ピーク時のダウンロードを避けてください。

考えられる原因

Composer が依存関係をインストールしようとするときに、一時ファイルを削除できません。これは、ウイルス対策ソフトウェアまたは Windows Search Indexer がファイルをロックしていることが原因である可能性があります。

解決策

1. 権限を確認してください。Windows システムでは、権限が不十分なために Composer が必要なファイルを作成または変更できない場合があります。

   1. 権限の問題を避けるために、すべての Composer コマンドが管理者モードで実行されていることを確認してください。

   2. Composer が必要とするファイルとディレクトリに読み取りおよび書き込み権限があることを確認してください。

2. パッケージのバージョンの可用性を確認し、キャッシュをクリアして再インストールできます。

   1. 必要なパッケージの利用可能なバージョンを確認してください。例：

      composer show alibabacloud/ecs-20140526 --all

   2. Composer のキャッシュをクリアして再インストールしてください。

      composer clear-cache

3. Windows Search サービスが実行されているか確認してください。このサービスはファイルをインデックス化し、ロックを引き起こす可能性があります。このサービスを停止するには、次の手順を実行します。

   1. Win + R キーを押して、実行ダイアログボックスを開きます。

   2. services.msc を入力し、Enter を押します。

   3. 「Windows Search」サービスを見つけ、右クリックして「停止」を選択します。

   4. サービスを停止した後、Composer の依存関係を再度インストールしてみてください。

4. ファイルのロックを解除するか、新しいディレクトリを作成してインストールしてください。

   1. コマンドラインを管理者として実行することで、ファイルのロックを解除できます。

      1. CMD または PowerShell を右クリックし、「管理者として実行」を選択します。

      2. 次のコマンドを実行して、ロックされたディレクトリを削除します。

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

      3. ウイルス対策ソフトウェアや Windows Search Indexer などのプログラムがファイルをロックしていないことを確認してください。ウイルス対策ソフトウェアを一時的に無効にして、Composer コマンドを再実行してみてください。

   2. 新しいディレクトリを作成してインストールします。新しいディレクトリを作成し、その中で Composer の操作を実行できます。

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

5. インストール中に 404 エラーが発生した場合は、ミラーソースを変更して再度インストールを試みることができます。

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

考えられる原因

1. Composer のキャッシュの問題：ローカルキャッシュが破損しているか、不完全です。

2. ミラーソースの問題：ミラーソースが不安定または利用不可能です。

3. ネットワークの問題：ネットワーク接続が不安定であるか、ファイアウォールによってブロックされています。

4. Composer のバージョンの問題：古いバージョンの Composer が使用されています。

5. 環境設定の問題：環境変数または Composer 設定ファイルが異常です。

解決策

1. ネットワーク接続を確認してください。

   1. 次のコマンドを実行して、ネットワークが正常かどうかをテストします。

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

   2. ファイアウォールの設定を確認して、ファイアウォールが curl の外部リソースへのアクセスをブロックしていないことを確認してください。

   3. 別のネットワークを使用してみてください。たとえば、企業ネットワークから個人ネットワークに切り替えるなど、ネットワーク環境を切り替えることができます。

2. Composer の設定を確認し、公式の中央リポジトリを直接使用できます。

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

3. インストールされている Composer パッケージを削除し、再インストールして、Composer のキャッシュをクリアできます。

   1. ローカルのキャッシュディレクトリを削除します。

      rm -rf ~/.composer

   2. Composer のキャッシュをクリアします。

      composer clear-cache

4. エラーが解決しない場合は、Composer の詳細なログを確認できます。

   composer install --verbose

例 1

エラーメッセージ：

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.

考えられる原因：

1. 指定されたバージョン番号 (3.4.1 など) は、存在しないか、リリースされていない可能性があります。

2. 使用している Composer のミラーソースが、パッケージの最新バージョンと同期されていません。

3. ネットワークの問題により、パッケージが正しくプルできません。

解決策：

• 次のコマンドを実行して、パッケージの利用可能なすべてのバージョンを表示してください。

  composer show alibabacloud/XXXXXX --all

  composer.json ファイル内のバージョンを利用可能なバージョンに変更し、composer update を実行して再インストールできます。

• Composer のトラフィックミラーソースを切り替えることができます。

  • 次のコマンドを実行して、公式の Packagist ミラーソースに切り替えます。

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

  • 中国本土で Alibaba Cloud が提供する高速ミラーソースに切り替えます。

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

  切り替えた後、キャッシュをクリアして再インストールできます。

  composer clear-cache
  composer install

• ネットワーク接続が正常かどうかを確認し、安定したネットワーク環境を使用してみてください。それでもインストールが失敗する場合は、.zip または .tar.gz 形式のパッケージファイルを手動でダウンロードし、ローカルパスを使用してインストールしてください。

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

例 2

エラーメッセージ：

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

原因：

alibabacloud/cloudauth-20190307:3.9.2 をインストールする際、その依存関係である alibabacloud/tea-oss-utils:0.3.1 は guzzlehttp/psr7 がバージョン [1.0.0,...,2.0.0) であることを要求します。しかし、現在インストールされている guzzlehttp/psr7 のバージョンは [1.0.0,..,1.9.1] に固定されているため、依存関係の競合が発生します。

解決策：

• 依存関係のバージョンを強制的に更新できます。

  composer require alibabacloud/cloudauth-20190307 3.9.2 -W

• composer.json ファイルの require セクションに、guzzlehttp/psr7 のバージョン制約 (例: "guzzlehttp/psr7": "^1.0") を追加します。次に、次のコマンドを実行して依存関係を更新します。

  composer update

• composer.lock を削除し、次のコマンドを実行して再インストールできます。

  composer install --prefer-source

Causes:

1. CA certificate package not downloaded: The system is missing a trusted CA certificate file, which prevents cURL from verifying the SSL certificate.

2. PHP's cURL configuration does not specify a CA certificate path: The curl.cainfo or openssl.cafile parameter is not correctly configured in the php.ini file.

3. PHP service not restarted: The PHP service was not restarted after the php.ini file was modified, so the configuration did not take effect.

Solutions:

1. You can download a trusted CA certificate, such as the Mozilla CA Certificate Store. Save the downloaded cacert.pem file to a fixed directory.

   重要

   Make sure that the file path does not contain Chinese characters or special characters to avoid potential issues.

2. You can configure the SSL certificate path for PHP.

   • Open the PHP configuration file php.ini. You can find the file location by running the php --ini command.

   • In the php.ini file, find curl.cainfo, set its value to the absolute path of the CA certificate, and remove the semicolon (;) from the beginning of the configuration item.

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

     Save the file after editing.

     説明

     Replace the D:\path\to\cacert.pem path in the example with the actual absolute path of your downloaded CA certificate.

3. Restart the PHP service.

原因

1. バージョンの競合：

   • いくつかの依存関係のバージョンは、composer.lock ファイルによってロックされています。

   • デフォルトでは、Composer はこれらのロックされた依存関係パッケージを自動的に更新しません。

   • たとえば、alibabacloud/cloudauth-20190307 は alibabacloud/openplatform-20191219 のバージョン 2.0.1 を必要としますが、現在ロックされているバージョンは 1.0.3 です。

2. PHP バージョンの非互換性：

   • PHP 8.2 を使用していますが、一部の依存関係パッケージは PHP 5.4 から 7.x のみをサポートしています。

   • たとえば、ralouphie/mimey 2.1.0 は PHP ^5.4|^7.0 にしか対応していませんが、お使いの環境は PHP 8.2.27 です。

解決策

1. 関連するすべての依存関係を強制的にアップグレードできます。

   composer update --with-all-dependencies
   # または短縮形：
   composer update -W

   説明

   この操作は、composer.lock によってロックされた古いバージョンを含む、関連するすべての依存関係パッケージを再帰的に更新し、バージョンの競合を解決するのに役立ちます。

2. composer.lock と vendor/ を削除し、再インストールすることができます。これは、依存関係の混乱が深刻な場合に推奨されます。

   rm -f composer.lock && rm -rf vendor/
   composer clear-cache
   composer install

   重要

   この操作は、インストールされているすべての依存関係を削除します。

3. 依存関係パッケージが PHP 8 をサポートしていない場合は、互換性を確保するために一時的に以前のバージョンの PHP にダウングレードできます。

原因

• composer install または update を実行すると、Composer が ThinkPHP の自動サービス検出コマンド php think service:discover の実行に失敗します。これにより、インストールプロセス全体が中断されます。

• メモリオーバーフローまたはその他のエラー。

解決策

1. サービス検出スクリプトを一時的に無効にするには、プロジェクトのルートディレクトリにある composer.json ファイルを変更します：

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

   これを次のように変更します。

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

   composer dump-autoload を再度実行します。

2. PHP メモリ制限を増やすことができます。これを行うには、php.ini ファイルの以下の設定を変更します。

   memory_limit = 512M