Alibaba Cloud SDK:FAQ

Penyebab

1. Masalah konektivitas jaringan: Jaringan lokal tidak stabil, atau firewall memblokir koneksi SSL.

2. Masalah konfigurasi proxy: Proxy tidak dikonfigurasi dengan benar, sehingga mencegah akses ke sumber daya eksternal.

3. Masalah sertifikat SSL: Sistem lokal tidak mempercayai beberapa sertifikat SSL, yang menyebabkan timeout koneksi.

Solusi

1. Periksa konektivitas jaringan Anda. Pastikan Anda dapat mengakses Internet dan koneksi jaringan stabil.

2. Konfigurasikan Composer untuk menggunakan 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. Unduh sertifikat CA tepercaya:

   1. Unduh sertifikat CA tepercaya, seperti Mozilla CA Certificate Store.

   2. Konfigurasikan jalur sertifikat SSL untuk PHP. Di file php.ini, cari `curl.cainfo`, atur nilainya ke jalur mutlak sertifikat CA, lalu hapus simbol komentar (;) di awal item konfigurasi tersebut.

   3. Mulai ulang layanan PHP.

4. Percayai sertifikat tanda tangan sendiri (opsional). Jika masalah koneksi disebabkan oleh sertifikat tanda tangan sendiri, Anda dapat mengizinkan Composer untuk mengabaikan validasi SSL. Hal ini tidak disarankan untuk lingkungan produksi.

   composer config --global -- disable-ssl

   Penting

   Operasi ini menonaktifkan validasi SSL secara sementara. Pastikan untuk menjalankan perintah composer config --global --enable-ssl nanti agar validasi SSL diaktifkan kembali dan keamanan sistem terjamin.

Masalah konektivitas jaringan

Deskripsi: Permintaan tidak dapat mencapai server tujuan karena jaringan antara klien dan server terputus atau tidak stabil.

Solusi:

Gunakan perintah ping atau curl untuk menguji konektivitas antara host lokal Anda dan endpoint produk cloud. Misalnya, jika pemanggilan operasi SendSms mengalami timeout, Anda dapat menggunakan ping dysmsapi.aliyuncs.com atau curl -v https://dysmsapi.aliyuncs.com untuk menguji konektivitas.

• Jika perintah mengalami timeout atau tidak mengembalikan respons, periksa apakah firewall atau router lokal Anda memiliki kebijakan pemblokiran.

• Jika perintah mengembalikan respons, Anda dapat mengatur periode timeout yang wajar untuk mencegah kegagalan permintaan akibat konfigurasi yang tidak tepat. Untuk informasi selengkapnya, lihat Konfigurasi timeout. Contoh kode berikut:

// Atur timeout dalam parameter runtime. Ini hanya berlaku untuk permintaan yang menggunakan instance parameter runtime ini.
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->connectTimeout = $connectionTimeoutMillis;

Waktu pemrosesan API yang lama

Deskripsi: Waktu yang dibutuhkan API tujuan untuk memproses permintaan melebihi periode timeout baca yang dikonfigurasi.

Solusi: Anda dapat mengonfigurasi periode timeout baca agar sesuai dengan waktu respons API yang lebih lama. Untuk informasi selengkapnya, lihat Konfigurasi timeout. Misalnya, Anda dapat mengonfigurasi parameter timeout baca untuk memperpanjang periode timeout baca untuk permintaan saat ini. Contoh kode berikut:

// Atur timeout dalam parameter runtime. Ini hanya berlaku untuk permintaan yang menggunakan instance parameter runtime ini.
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->readTimeout = $readTimeoutMillis;

Kemungkinan penyebab

• Sumber cermin lalu lintas yang Anda gunakan, seperti cermin Alibaba Cloud, mungkin belum menyinkronkan informasi paket terbaru secara tepat waktu. Hal ini menyebabkan beberapa file hilang.

• URL sumber cermin lalu lintas mungkin telah berubah, atau jalurnya salah.

Solusi

1. Periksa dan pastikan Anda menggunakan sumber cermin lalu lintas yang benar.

   1. Jalankan perintah berikut untuk melihat sumber cermin lalu lintas Composer yang saat ini dikonfigurasi:

      composer config -g --list

   2. Cermin penuh Composer Alibaba Cloud: https://mirrors.aliyun.com/composer/

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

   3. Cermin penuh Composer Tsinghua: https://mirrors.tuna.tsinghua.edu.cn/composer/

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

2. Anda dapat menonaktifkan sementara sumber cermin lalu lintas dan langsung menggunakan repositori pusat resmi. Untuk melakukannya, modifikasi atau hapus konfigurasi repositories di composer.json, atau jalankan perintah composer config --unset repos.url.

   # Gunakan repositori Composer resmi.
   composer config -g repo.packagist composer https://packagist.org

3. Periksa konektivitas jaringan Anda. Jaringan yang tidak stabil dapat mencegah file diunduh dengan benar. Anda dapat mencoba beralih ke lingkungan jaringan berbeda atau menggunakan VPN.

4. Jika muncul pesan saat menjalankan perintah yang menunjukkan bahwa versi Composer terlalu lama (`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.`), Anda dapat memperbarui ke versi terbaru (opsional).

   # Perbarui Composer ke versi terbaru.
   composer self-update
   # Gunakan composer.phar untuk menjalankan versi terbaru.
   composer self-update --1

5. Jika muncul peringatan Composer saat menjalankan perintah, hal ini menunjukkan bahwa dukungan untuk Composer 1 akan dihentikan. Untuk kompatibilitas dan keamanan yang lebih baik, Anda dapat meningkatkan ke versi 2.x (opsional).

   composer self-update --2

   Penting

   Periksa apakah paket yang digunakan proyek Anda mendukung Composer 2.x. Anda mungkin perlu memperbarui kode dan konfigurasi proyek.

6. Jika terjadi kesalahan Content-Length selama pengunduhan, biasanya karena pengunduhan data terganggu, dan data aktual yang diterima tidak sesuai dengan nilai yang diharapkan.

   1. Anda dapat menghapus cache Composer dan menjalankan kembali perintah instalasi.

      PowerShell

      # Hapus direktori .composer
      Remove-Item -Recurse -Force $HOME\.composer
      # Hapus semua konten di direktori C:\tmp
      Remove-Item -Recurse -Force C:\tmp\*

      Shell

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

   2. Fluktuasi jaringan dapat menyebabkan gangguan pengunduhan. Anda dapat menjalankan perintah instalasi beberapa kali.

   3. Periksa stabilitas jaringan Anda. Pastikan koneksi jaringan stabil dan hindari pengunduhan selama jam sibuk.

Kemungkinan penyebab

Saat Composer mencoba menginstal dependensi, file sementara tidak dapat dihapus. Hal ini mungkin karena perangkat lunak antivirus atau Windows Search Indexer telah mengunci file tersebut.

Solusi

1. Periksa izin. Pada sistem Windows, Composer mungkin gagal membuat atau memodifikasi file yang diperlukan karena izin yang tidak mencukupi.

   1. Pastikan semua perintah Composer dijalankan dalam mode administrator untuk menghindari masalah izin.

   2. Konfirmasi bahwa file dan direktori yang diperlukan oleh Composer memiliki izin baca dan tulis.

2. Anda dapat memeriksa ketersediaan versi paket, menghapus cache, dan menginstal ulang.

   1. Periksa versi yang tersedia dari paket yang diperlukan. Contohnya:

      composer show alibabacloud/ecs-20140526 --all

   2. Hapus cache Composer dan instal ulang:

      composer clear-cache

3. Periksa apakah layanan Windows Search sedang berjalan. Layanan ini mungkin mengindeks file, sehingga mengunci file tersebut. Untuk menghentikan layanan ini, lakukan langkah-langkah berikut:

   1. Tekan Win + R untuk membuka kotak dialog Run.

   2. Masukkan services.msc dan tekan Enter.

   3. Temukan layanan "Windows Search", klik kanan, lalu pilih "Stop".

   4. Setelah layanan dihentikan, coba instal dependensi Composer lagi.

4. Buka kunci file atau buat direktori baru untuk instalasi.

   1. Anda dapat membuka kunci file dengan menjalankan command line sebagai administrator:

      1. Klik kanan CMD atau PowerShell dan pilih "Run as administrator".

      2. Jalankan perintah berikut untuk menghapus direktori yang terkunci:

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

      3. Pastikan tidak ada program, seperti perangkat lunak antivirus atau Windows Search Indexer, yang mengunci file tersebut. Anda dapat mencoba menonaktifkan sementara perangkat lunak antivirus dan menjalankan kembali perintah Composer.

   2. Buat direktori baru untuk instalasi. Anda dapat membuat direktori baru dan melakukan operasi Composer di dalamnya:

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

5. Jika terjadi kesalahan 404 selama instalasi, Anda dapat mengubah sumber cermin lalu lintas dan mencoba menginstal ulang.

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

Kemungkinan penyebab

1. Masalah cache Composer: Cache lokal rusak atau tidak lengkap.

2. Masalah sumber cermin lalu lintas: Sumber cermin lalu lintas tidak stabil atau tidak tersedia.

3. Masalah jaringan: Koneksi jaringan tidak stabil atau diblokir oleh firewall.

4. Masalah versi Composer: Menggunakan versi Composer yang sudah usang.

5. Masalah konfigurasi lingkungan: Variabel lingkungan atau file konfigurasi Composer tidak normal.

Solusi

1. Periksa konektivitas jaringan Anda.

   1. Jalankan perintah berikut untuk menguji apakah jaringan normal:

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

   2. Periksa pengaturan firewall untuk memastikan firewall tidak memblokir curl dari mengakses sumber daya eksternal.

   3. Coba gunakan jaringan berbeda. Anda dapat mengganti lingkungan jaringan, misalnya dari jaringan kantor ke jaringan pribadi.

2. Anda dapat memeriksa konfigurasi Composer dan langsung menggunakan repositori pusat resmi.

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

3. Anda dapat menghapus paket Composer yang telah diinstal, menginstal ulang, dan menghapus cache Composer.

   1. Hapus direktori cache lokal:

      rm -rf ~/.composer

   2. Hapus cache Composer:

      composer clear-cache

4. Jika kesalahan tetap berlanjut, Anda dapat memeriksa log Composer secara detail:

   composer install --verbose

Contoh 1

Pesan kesalahan:

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.

Kemungkinan penyebab:

1. Nomor versi yang ditentukan, seperti 3.4.1, mungkin tidak ada atau belum dirilis.

2. Sumber cermin lalu lintas Composer yang Anda gunakan belum disinkronkan dengan versi terbaru paket tersebut.

3. Masalah jaringan mencegah paket ditarik dengan benar.

Solusi:

• Jalankan perintah berikut untuk melihat semua versi paket yang tersedia:

  composer show alibabacloud/XXXXXX --all

  Anda dapat mengubah versi di file composer.json menjadi versi yang tersedia, lalu jalankan composer update untuk menginstal ulang.

• Anda dapat mengganti sumber cermin lalu lintas Composer.

  • Jalankan perintah berikut untuk beralih ke sumber cermin lalu lintas Packagist resmi:

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

  • Beralih ke sumber cermin lalu lintas akselerasi yang disediakan Alibaba Cloud di Tiongkok daratan:

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

  Setelah beralih, Anda dapat menghapus cache dan menginstal ulang:

  composer clear-cache
  composer install

• Periksa apakah koneksi jaringan Anda normal dan coba gunakan lingkungan jaringan yang stabil. Jika instalasi tetap gagal, Anda dapat mencoba mengunduh manual file paket dalam format .zip atau .tar.gz dan menginstalnya menggunakan jalur lokal:

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

Contoh 2

Pesan kesalahan:

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

Penyebab:

Saat menginstal alibabacloud/cloudauth-20190307:3.9.2, dependensinya alibabacloud/tea-oss-utils:0.3.1 memerlukan guzzlehttp/psr7 versi `[1.0.0,...,2.0.0)`. Namun, versi guzzlehttp/psr7 yang saat ini terinstal difiksasi pada `[1.0.0,..,1.9.1]`, yang menyebabkan konflik dependensi.

Solusi:

• Anda dapat memaksa pembaruan versi dependensi.

  composer require alibabacloud/cloudauth-20190307 3.9.2 -W

• Di bagian `require` file composer.json, Anda dapat menambahkan batasan versi untuk guzzlehttp/psr7, seperti "guzzlehttp/psr7": "^1.0". Lalu, jalankan perintah berikut untuk memperbarui dependensi.

  composer update

• Anda dapat menghapus composer.lock dan menjalankan perintah berikut untuk menginstal ulang.

  composer install --prefer-source

Penyebab:

1. Paket sertifikat CA belum diunduh: Sistem tidak memiliki file sertifikat CA tepercaya, sehingga cURL tidak dapat memverifikasi sertifikat SSL.

2. Konfigurasi cURL PHP tidak menentukan jalur sertifikat CA: Parameter curl.cainfo atau openssl.cafile tidak dikonfigurasi dengan benar di file php.ini.

3. Layanan PHP tidak dimulai ulang: Layanan PHP tidak dimulai ulang setelah file php.ini dimodifikasi, sehingga konfigurasi tidak berlaku.

Solusi:

1. Anda dapat mengunduh sertifikat CA tepercaya, seperti Mozilla CA Certificate Store. Simpan file cacert.pem yang diunduh ke direktori tetap.

   Penting

   Pastikan jalur file tidak mengandung karakter Tionghoa atau karakter khusus untuk menghindari potensi masalah.

2. Anda dapat mengonfigurasi jalur sertifikat SSL untuk PHP.

   • Buka file konfigurasi PHP php.ini. Anda dapat menemukan lokasi file dengan menjalankan perintah php --ini.

   • Di file php.ini, temukan curl.cainfo, atur nilainya ke jalur mutlak sertifikat CA, dan hapus tanda titik koma (;) di awal item konfigurasi tersebut.

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

     Simpan file setelah diedit.

     Catatan

     Ganti jalur D:\path\to\cacert.pem dalam contoh dengan jalur mutlak aktual sertifikat CA yang Anda unduh.

3. Mulai ulang layanan PHP.

Penyebab

1. Konflik versi:

   • Versi beberapa dependensi dikunci oleh file composer.lock.

   • Secara default, Composer tidak memperbarui otomatis paket dependensi yang dikunci ini.

   • Sebagai contoh, alibabacloud/cloudauth-20190307 memerlukan versi 2.0.1 dari alibabacloud/openplatform-20191219, tetapi versi yang saat ini dikunci adalah 1.0.3.

2. Ketidakcocokan versi PHP:

   • Anda menggunakan PHP 8.2, tetapi beberapa paket dependensi hanya mendukung PHP 5.4 hingga 7.x.

   • Sebagai contoh, ralouphie/mimey 2.1.0 hanya mendukung PHP ^5.4|^7.0, tetapi lingkungan Anda menggunakan PHP 8.2.27.

Solusi

1. Anda dapat memaksa peningkatan semua dependensi terkait:

   composer update --with-all-dependencies
   # Atau bentuk singkatnya:
   composer update -W

   Catatan

   Operasi ini memperbarui secara rekursif semua paket dependensi terkait, termasuk versi lama yang dikunci oleh `composer.lock`, untuk membantu menyelesaikan konflik versi.

2. Anda dapat menghapus composer.lock dan vendor/ lalu menginstal ulang. Ini direkomendasikan untuk kebingungan dependensi yang parah.

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

   Penting

   Operasi ini menghapus semua dependensi yang telah diinstal.

3. Jika paket dependensi tidak mendukung PHP 8, Anda dapat menurunkan sementara ke versi PHP sebelumnya untuk memastikan kompatibilitas.

Penyebab

• Setelah menjalankan `composer install` atau `update`, Composer gagal menjalankan perintah penemuan layanan otomatis ThinkPHP, php think service:discover. Hal ini mengganggu seluruh proses instalasi.

• Overflow memori atau kesalahan lainnya.

Solusi

1. Anda dapat menonaktifkan sementara skrip penemuan layanan. Untuk melakukannya, modifikasi file composer.json di direktori root proyek:

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

   Ubah menjadi:

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

   Jalankan kembali composer dump-autoload.

2. Anda dapat menambah batas memori PHP. Untuk melakukannya, modifikasi konfigurasi berikut di file php.ini:

   memory_limit = 512M