Alibaba Cloud SDK:SDK for PHP に関するよくある質問

考えられる原因：

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

2. プロキシの問題：プロキシ構成が正しくないため、外部リソースへのアクセスに失敗します。

3. SSL 証明書の問題：一部の SSL 証明書がオンプレミスマシンのオペレーティングシステムによって信頼されていないため、接続がタイムアウトになります。

解決策：

1. 安定した接続でインターネットにアクセスできることを確認します。

2. プロキシを使用するように PHP 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）が発行した SSL 証明書をダウンロードします。

   1. 信頼できる CA から SSL 証明書をダウンロードします。 たとえば、Mozilla から SSL 証明書をダウンロードできます。 詳細については、「Mozilla から抽出された CA 証明書」をご参照ください。

   2. PHP の SSL 証明書のパスを構成します。 php.ini ファイルで curl.cainfo パラメーターを検索し、このパラメーターの値を CA 証明書の絶対パスに設定してから、パラメーターの前にあるセミコロン（;）を削除します。

   3. PHP サービスを再起動します。

4. オプション。 自己署名証明書を信頼するようにオペレーティングシステムを構成します。 接続の問題が自己署名証明書によって引き起こされている場合は、PHP Composer が SSL 認証を無視するようにします。 ただし、本番環境ではこの方法を使用しないことをお勧めします。

   composer config --global -- disable-ssl

   重要

   このコマンドは、SSL 認証を一時的に無効にします。 システムのセキュリティを確保するために、後続の操作で composer config --global -- enable-ssl コマンドを実行して、SSL 認証を再度有効にする必要があります。

ネットワーク接続の問題

原因：クライアントとサーバー間のネットワーク接続に失敗したか、ネットワークが不安定なため、リクエストがサーバーに到達できません。

解決策：

ping コマンドまたは curl コマンドを実行して、オンプレミスホストとクラウドサービスのエンドポイント間の接続をテストします。 たとえば、ping dysmsapi.aliyuncs.com コマンドまたは curl -v https://dysmsapi.aliyuncs.com コマンドを実行して、オンプレミスホストと SMS API のエンドポイント間の接続をテストします。

• コマンドがタイムアウトになった場合、または応答を受信しなかった場合は、オンプレミスのファイアウォールまたはルーターのブロッキングポリシーを確認します。

• 応答が返された場合は、適切なタイムアウト期間を指定して、不適切なタイムアウト構成によるリクエストの失敗を防ぐことをお勧めします。 詳細については、「タイムアウト期間を構成する」をご参照ください。 サンプルコード：

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

API リクエストの処理時間の長さ

原因：API リクエストの処理時間が、指定された読み取りタイムアウト期間を超えています。

解決策：API 応答の読み取りタイムアウト期間を長く指定します。 詳細については、「タイムアウト期間を構成する」をご参照ください。 たとえば、読み取りタイムアウトパラメーターを構成して、読み取りタイムアウト期間を延長できます。 サンプルコード：

// 実行時パラメーターを使用して読み取りリクエストのタイムアウト期間を構成します。タイムアウト期間は、RuntimeOptions を使用するリクエストにのみ有効です。
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->readTimeout = $readTimeoutMillis;

考えられる原因：

• Alibaba Cloud イメージなどのイメージソースが最新のパッケージと同期されていません。 その結果、必要なファイルがいくつかありません。

• イメージソースの URL が変更されたか、パスが正しくありません。

解決策：

1. イメージソースが正しいことを確認します。

   1. 次のコマンドを実行して、PHP Composer に構成されているイメージソースを確認します。

      composer config -g --list

   2. Composer の Alibaba Cloud イメージ：https://mirrors.aliyun.com/composer/

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

   3. Composer の清華大学 TUNA 協会イメージ：https://mirrors.tuna.tsinghua.edu.cn/composer/

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

2. イメージソースを一時的に無効にし、Composer イメージリポジトリを使用します。 composer.json ファイルの repositories 構成を変更または削除するか、composer config --unset repos.url コマンドを実行します。

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

3. ネットワーク接続を確認します。 ネットワーク接続が不安定な場合、ファイルのダウンロードエラーが発生する可能性があります。 別のネットワーク環境に切り替えるか、VPN を使用します。

4. オプション。 コマンドを実行したときに、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 というエラーメッセージが返された場合、PHP Composer は古くなっています。 Composer を最新バージョンに更新し、Composer を再度実行することをお勧めします。

   # Composer を最新バージョンに更新します。
   composer self-update
   # composer.phar ファイルを使用して最新バージョンを実行します。
   composer self-update --1

5. コマンドを実行したときに Composer の警告が出力された場合、Composer 1 のサポートは無効になります。 オプション。 互換性とセキュリティを確保するために、Composer をバージョン 2.X に更新することをお勧めします。

   composer self-update --2

   重要

   プロジェクトの依存関係パッケージが Composer 2.x をサポートしているかどうかを確認します。 必要に応じて、プロジェクトのコードと構成を更新します。

6. ダウンロードプロセス中に Content-Length エラーがスローされた場合、データのダウンロードが中断される可能性があります。 受信したデータは、予期されたデータと異なります。

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

      PowerShell

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

      Shell

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

   2. ネットワーク接続が不安定な場合、データのダウンロードが中断される可能性があります。 コマンドを複数回実行して、Composer がインストールされていることを確認できます。

   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 Indexer が想定どおりに実行されているかどうかを確認します。 このサービスはファイルをインデックス化するため、ファイルがロックされる可能性があります。 このサービスを停止するには、次の手順を実行します。

   1. Win キーと R キーを押して、「ファイル名を指定して実行」プログラムを開きます。

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

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

   4. Windows Search を停止した後、Composer 依存関係を再度インストールします。

4. ファイルをロック解除するか、依存関係をインストールするためのディレクトリを作成します。

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

      1. コマンドプロンプトまたは 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 を構成します。

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

3. Composer パッケージを削除し、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

エラーメッセージ:

原因:

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

原因：

1. CA 証明書パッケージがダウンロードされていません。 システムに信頼できる CA 証明書ファイルがありません。 その結果、cURL は SSL 証明書を検証できません。

2. PHP cURL 構成で CA 証明書のパスが指定されていません。 php.ini ファイルで curl.cainfo パラメーターまたは openssl.cafile パラメーターが正しく構成されていません。

3. PHP サービスが無効になっています。php.ini ファイルの変更後、PHP サービスが有効になっていません。 この場合、構成は有効になりません。

解決策：

1. 信頼できる CA から SSL 証明書をダウンロードします。 たとえば、Mozilla から SSL 証明書をダウンロードできます。 詳細については、「Mozilla から抽出された CA 証明書」をご参照ください。 cacert.pem ファイルを固定ディレクトリに保存します。

   重要

   ファイルパスに中国語の文字や特殊文字が含まれていないことを確認してください。そうしないと、問題が発生する可能性があります。

2. PHP の SSL 証明書のパスを構成します。

   • PHP 構成ファイル php.ini を開きます。 php --ini コマンドを実行して、ファイルの場所をクエリできます。

   • php.ini ファイルで curl.cainfo を見つけ、その値を CA 証明書の絶対パスに設定し、構成項目の先頭の ; を削除します。

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

     変更を加えた後、ファイルを保存します。

     説明

     例の D:\path\to\cacert.pem パスを、CA 証明書の絶対パスに置き換えます。

3. PHP サービスを再起動します。

原因：

1. バージョンの競合：

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

   • デフォルトでは、Composer は特定のバージョンにロックされている依存関係パッケージを自動的に更新しません。

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

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

   • PHP 8.2 が使用されていますが、一部の依存関係パッケージは PHP 5.4 から PHP 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 composer.lock vendor/
   composer clear-cache
   composer install

   重要

   この操作により、インストールされているすべての依存関係が削除されます。

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

原因：

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

• メモリ不足（OOM）またはその他の問題。

解決策：

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.ini ファイルに次の構成を追加して、PHP メモリ制限を追加します。

   memory_limit = 512M