Alibaba Cloud SDK：FAQ tentang SDK untuk PHP

Kemungkinan penyebab:

1. Masalah jaringan: Jaringan lokal tidak stabil atau koneksi SSL diblokir oleh firewall.

2. Masalah proxy: Akses ke sumber daya eksternal gagal karena konfigurasi proxy yang salah.

3. Masalah sertifikat SSL: Koneksi timeout karena beberapa sertifikat SSL tidak dipercaya oleh sistem operasi mesin lokal.

Solusi:

1. Pastikan Anda dapat mengakses Internet melalui koneksi yang stabil.

2. Konfigurasikan PHP 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 SSL yang dikeluarkan oleh otoritas sertifikat tepercaya (CA):

   1. Unduh sertifikat SSL dari CA tepercaya. Sebagai contoh, Anda dapat mengunduh sertifikat SSL dari Mozilla. Untuk informasi lebih lanjut, lihat Sertifikat CA yang diekstraksi dari Mozilla.

   2. Konfigurasikan jalur sertifikat SSL untuk PHP. Cari parameter curl.cainfo di file php.ini, atur nilai parameter ini ke jalur absolut sertifikat CA, dan kemudian hapus titik koma (;) sebelum parameter.

   3. Mulai ulang layanan PHP.

4. Opsional. Konfigurasikan sistem operasi Anda untuk mempercayai sertifikat tanda tangan sendiri. Jika masalah koneksi disebabkan oleh sertifikat tanda tangan sendiri, izinkan PHP Composer mengabaikan otentikasi SSL. Namun, kami sarankan agar Anda tidak menggunakan metode ini di lingkungan produksi.

   composer config --global -- disable-ssl

   Penting

   Perintah ini sementara menonaktifkan otentikasi SSL. Untuk memastikan keamanan sistem, Anda harus menjalankan perintah composer config --global -- enable-ssl dalam operasi selanjutnya untuk mengaktifkan otentikasi SSL lagi.

Masalah koneksi jaringan

Penyebab: Permintaan tidak dapat mencapai server karena koneksi jaringan antara klien dan server gagal atau jaringan tidak stabil.

Solusi:

Jalankan perintah ping atau curl untuk menguji konektivitas antara host lokal dan titik akhir layanan cloud. Sebagai contoh, jalankan perintah ping dysmsapi.aliyuncs.com atau curl -v https://dysmsapi.aliyuncs.com untuk menguji konektivitas antara host lokal Anda dan titik akhir API SMS.

• Jika perintah timeout atau tidak menerima respons, periksa kebijakan pemblokiran pada firewall atau router lokal Anda.

• Jika respons dikembalikan, kami sarankan Anda menentukan periode timeout yang tepat untuk mencegah kegagalan permintaan yang disebabkan oleh konfigurasi timeout yang tidak tepat. Untuk informasi lebih lanjut, lihat Konfigurasikan periode timeout. Contoh kode:

// Tentukan periode timeout menggunakan parameter runtime. Periode timeout hanya berlaku untuk permintaan yang menggunakan instance RuntimeOptions.
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->connectTimeout = $connectionTimeoutMillis;

Waktu pemrosesan API request yang lama

Penyebab: Waktu untuk memproses permintaan API melebihi periode timeout baca yang ditentukan.

Solusi: Tentukan periode timeout baca yang lebih lama untuk respons API. Untuk informasi lebih lanjut, lihat Konfigurasikan periode timeout. Sebagai contoh, Anda dapat mengonfigurasi parameter timeout baca untuk memperpanjang periode timeout baca. Contoh kode:

// Konfigurasikan periode timeout untuk permintaan baca menggunakan parameter runtime. Periode timeout hanya berlaku untuk permintaan yang menggunakan RuntimeOptions.
$runtimeOptions = new RuntimeOptions();
$runtimeOptions->readTimeout = $readTimeoutMillis;

Kemungkinan penyebab:

• Sumber gambar, seperti gambar Alibaba Cloud, tidak disinkronkan dengan paket terbaru. Akibatnya, beberapa file yang diperlukan tidak ada.

• URL sumber gambar mungkin telah berubah, atau jalurnya salah.

Solusi:

1. Pastikan bahwa sumber gambar benar.

   1. Jalankan perintah berikut untuk memeriksa sumber gambar yang dikonfigurasikan untuk PHP Composer:

      composer config -g --list

   2. Gambar Alibaba Cloud untuk Composer: https://mirrors.aliyun.com/composer/

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

   3. Gambar Tsinghua University TUNA Association untuk Composer: https://mirrors.tuna.tsinghua.edu.cn/composer/

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

2. Sementara nonaktifkan sumber gambar dan gunakan repositori gambar Composer. Modifikasi atau hapus konfigurasi repositories di file composer.json, atau jalankan perintah composer config --unset repos.url.

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

3. Periksa koneksi jaringan. Koneksi jaringan yang tidak stabil dapat menyebabkan kesalahan unduhan file. Beralih ke lingkungan jaringan lain atau gunakan VPN.

4. Opsional. Saat Anda menjalankan perintah, jika pesan kesalahan 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 muncul, PHP Composer Anda sudah usang. Kami sarankan Anda memperbarui Composer ke versi terbaru dan menjalankan Composer lagi.

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

5. Jika peringatan Composer muncul saat Anda menjalankan perintah, dukungan untuk Composer 1 akan dinonaktifkan. Opsional. Untuk memastikan kompatibilitas dan keamanan, kami sarankan Anda memperbarui Composer ke versi 2.X.

   composer self-update --2

   Penting

   Periksa apakah paket dependensi proyek mendukung Composer 2.x. Perbarui kode dan konfigurasi proyek jika perlu.

6. Jika kesalahan Content-Length dilemparkan selama proses unduhan, pengunduhan data mungkin terganggu. Data yang diterima berbeda dari data yang diharapkan.

   1. Hapus cache Composer dan jalankan perintah lagi untuk menginstal Composer.

      PowerShell

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

      Shell

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

   2. Koneksi jaringan yang tidak stabil dapat mengganggu pengunduhan data. Anda dapat menjalankan perintah beberapa kali untuk memastikan bahwa Composer diinstal.

   3. Pastikan koneksi jaringan stabil dan unduh file selama jam-jam sepi.

Kemungkinan penyebab:

Ketika Composer mencoba menginstal dependensi, file sementara tidak dapat dihapus karena file tersebut dikunci oleh beberapa perangkat lunak anti-virus atau Windows Search Indexer.

Solusi:

1. Periksa apakah Anda memiliki izin yang cukup pada sistem operasi Windows. Jika tidak, Composer mungkin gagal membuat atau memodifikasi file yang diperlukan.

   1. Jalankan semua perintah Composer sebagai administrator untuk mencegah masalah izin.

   2. Pastikan Composer memiliki izin baca dan tulis pada file dan direktori yang diperlukan.

2. Pastikan versi paket tersedia, bersihkan cache, dan instal ulang dependensi.

   1. Kueri versi yang tersedia dari paket. Contoh perintah:

      composer show alibabacloud/ecs-20140526 --all

   2. Bersihkan cache Composer dan instal ulang dependensi:

      composer clear-cache

3. Periksa apakah Windows Search Indexer berjalan dengan baik. Layanan ini mungkin mengindeks file, yang mengunci file. Untuk menghentikan layanan ini, lakukan langkah-langkah berikut:

   1. Tekan tombol Win dan R untuk membuka program Run.

   2. Masukkan services.msc dan tekan tombol Enter.

   3. Temukan layanan Windows Search, klik kanan layanan tersebut, dan pilih Stop.

   4. Setelah Anda menghentikan Windows Search, instal kembali dependensi Composer.

4. Buka kunci file atau buat direktori untuk menginstal dependensi.

   1. Untuk membuka kunci file, jalankan perintah berikut sebagai administrator:

      1. Klik kanan Command Prompt 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 file tersebut tidak dikunci oleh program seperti perangkat lunak anti-virus atau Windows Search Indexer. Anda dapat menonaktifkan sementara perangkat lunak anti-virus Anda dan menjalankan perintah Composer.

   2. Buat direktori untuk menginstal dependensi. Di direktori tersebut, lakukan operasi Composer berikut:

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

5. Jika kesalahan 404 dilemparkan selama proses instalasi, beralih ke sumber gambar lain dan lakukan instalasi lagi.

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

Kemungkinan penyebab:

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

2. Masalah sumber gambar: Sumber gambar tidak stabil atau tidak tersedia.

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

4. Masalah versi Composer: Composer sudah usang.

5. Masalah konfigurasi lingkungan: Variabel lingkungan atau file konfigurasi Composer mengandung kesalahan.

Solusi:

1. Periksa koneksi jaringan.

   1. Jalankan perintah berikut untuk menguji konektivitas jaringan:

      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. Beralih ke jaringan lain atau lingkungan jaringan lain, seperti dari jaringan kantor ke jaringan pribadi.

2. Konfigurasikan Composer untuk menggunakan repositori gambar Composer.

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

3. Hapus paket Composer, instal ulang Composer, dan bersihkan cache Composer.

   1. Hapus direktori cache lokal:

      rm -rf ~/.composer

   2. Bersihkan cache Composer:

      composer clear-cache

4. Jika masalah tetap ada, periksa log rinci Composer:

   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 mirror Composer yang Anda gunakan belum disinkronkan dengan versi terbaru paket tersebut.

3. Masalah jaringan mencegah paket ditarik dengan benar.

Solusi:

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

  composer show alibabacloud/XXXXXX --all

  Tentukan versi yang tersedia di file composer.json, dan jalankan perintah composer update untuk memperbarui ke versi terbaru.

• Beralih ke sumber gambar Composer lainnya.

  • Jalankan perintah berikut untuk beralih ke sumber gambar Packagist:

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

  • Beralih ke sumber gambar percepatan Alibaba Cloud di Tiongkok Daratan:

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

  Setelah beralih, bersihkan cache dan instal ulang paket:

  composer clear-cache
  composer install

• Periksa konektivitas jaringan dan beralih ke lingkungan yang stabil. Jika kesalahan tetap ada, unduh secara manual file paket .zip atau .tar.gz dan instal di direktori lokal.

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

Contoh 2

Pesan kesalahan:

Penyebab:

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

Solusi:

• Paksa pembaruan versi dependensi.

  composer require alibabacloud/cloudauth-20190307 3.9.2 -W

• Dalam file composer.json, tambahkan batasan versi untuk guzzlehttp/psr7 di bagian require, misalnya, "guzzlehttp/psr7": "^1.0". Lalu, jalankan perintah berikut untuk memperbarui dependensi.

  composer update

• Hapus composer.lock dan jalankan perintah berikut untuk menginstal ulang dependensi.

  composer install --prefer-source

Penyebab:

1. Paket sertifikat CA belum diunduh. Sistem kekurangan file sertifikat CA tepercaya. Akibatnya, cURL tidak dapat memverifikasi sertifikat SSL.

2. Tidak ada jalur sertifikat CA yang ditentukan dalam konfigurasi PHP cURL. Parameter curl.cainfo atau openssl.cafile tidak dikonfigurasi dengan benar di file php.ini.

3. Layanan PHP dinonaktifkan: Layanan PHP tidak diaktifkan setelah file php.ini dimodifikasi. Dalam hal ini, konfigurasi tidak berlaku.

Solusi:

1. Unduh sertifikat SSL dari CA tepercaya, seperti Mozilla. Untuk detail lebih lanjut, lihat Sertifikat CA yang diekstraksi dari Mozilla. Simpan file cacert.pem di direktori tetap.

   Penting

   Pastikan jalur file tidak mengandung karakter Cina atau karakter khusus. Jika tidak, masalah mungkin muncul.

2. Konfigurasikan jalur sertifikat SSL untuk PHP.

   • Buka file konfigurasi PHP php.ini. Jalankan perintah php --ini untuk menemukan lokasi file tersebut.

   • Dalam file php.ini, temukan curl.cainfo, atur nilainya ke jalur absolut sertifikat CA, lalu hapus tanda titik koma awal ; dari item konfigurasi tersebut.

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

     Simpan file setelah Anda melakukan modifikasi.

     Catatan

     Ganti jalur D:\path\to\cacert.pem dalam contoh dengan jalur absolut sertifikat CA Anda.

3. Mulai ulang layanan PHP.

Penyebab:

1. Konflik versi:

   • Beberapa dependensi terkunci pada versi tertentu oleh file composer.lock.

   • Secara default, Composer tidak memperbarui secara otomatis paket dependensi yang terkunci pada versi tertentu.

   • Sebagai contoh, alibabacloud/cloudauth-20190307 memerlukan versi 2.0.1 dari alibabacloud/openplatform-20191219, yang terkunci pada versi 1.0.3.

2. Ketidakcocokan dengan versi PHP:

   • PHP 8.2 digunakan, tetapi beberapa paket dependensi hanya mendukung PHP 5.4 hingga PHP 7.X.

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

Solusi:

1. Paksa tingkatkan semua paket dependensi:

   composer update --with-all-dependencies
   # Perintah singkat:
   composer update -W

   Catatan

   Perintah ini meningkatkan semua paket dependensi, termasuk yang terkunci pada versi tertentu oleh file composer.lock, untuk menyelesaikan konflik versi.

2. Bersihkan file composer.lock dan direktori vendor/, lalu instal ulang paket. Metode ini cocok untuk skenario dengan masalah dependensi yang parah.

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

   Penting

   Operasi ini menghapus semua dependensi yang diinstal.

3. Jika paket dependensi tidak mendukung PHP 8, turunkan sementara ke versi PHP yang lebih lama untuk menjaga kompatibilitas.

Penyebab:

• Setelah menjalankan perintah composer install atau update, Composer mencoba menjalankan perintah php think service:discover dari ThinkPHP untuk penemuan layanan secara otomatis, tetapi gagal. Akibatnya, proses instalasi terhenti.

• Memori habis (OOM) atau masalah lainnya.

Solusi:

1. Sementara nonaktifkan skrip penemuan layanan dan modifikasi file composer.json di direktori root.

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

   Ubah menjadi:

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

   Jalankan kembali perintah composer dump-autoload.

2. Tambahkan batas memori PHP dengan menambahkan konfigurasi berikut ke file php.ini:

   memory_limit = 512M