curl error 60 while downloading https://repo.packagist.org/packages.json:
SSL certificate problem: unable to get local issuer certificate
Pesan di atas biasanya muncul saat Anda menjalankan composer install, composer require, atau composer create-project. Composer gagal mengunduh daftar paket dari Packagist, lalu proses berhenti. Yang membingungkan, browser di komputer yang sama bisa membuka https://repo.packagist.org tanpa masalah. Jadi internetnya jalan, tetapi Composer tetap menolak.
Ada juga varian lain yang masih satu keluarga, yaitu ketika ekstensi OpenSSL di PHP tidak aktif sama sekali:
The openssl extension is required for SSL/TLS protection but is not available.
If you can not enable the openssl extension, you can disable this error,
at your own risk, by setting the 'disable-tls' option to true.
Kedua error ini berakar pada hal yang sama: PHP (yang menjalankan Composer) tidak bisa memverifikasi sertifikat HTTPS milik server tujuan. Artikel ini menjelaskan cara kerja verifikasi sertifikat secara singkat, penyebab yang paling sering, lalu langkah perbaikan berurutan dari yang paling aman. Di bagian akhir ada peringatan penting tentang opsi disable-tls dan secure-http yang sering disarankan di forum, padahal berbahaya jika dipakai sembarangan.
Kenapa error ini terjadi?
Setiap kali Composer menghubungi server lewat HTTPS, server mengirim sertifikat. Sertifikat itu ditandatangani oleh sebuah Certificate Authority (CA). Agar sertifikat dianggap sah, PHP harus punya daftar CA yang dipercaya, biasanya berupa satu file bernama cacert.pem atau CA bundle. Pesan unable to get local issuer certificate artinya PHP tidak menemukan CA penerbit sertifikat tersebut di daftar lokalnya, sehingga koneksi dianggap tidak aman dan dibatalkan. Kalau Anda ingin memahami dasar proses ini, baca juga cara kerja HTTP dan HTTPS untuk pemula.
Browser jarang mengalami masalah ini karena browser memakai penyimpanan sertifikat milik sistem operasi atau miliknya sendiri. PHP berbeda. PHP tidak otomatis membaca penyimpanan sertifikat Windows, sehingga ia bergantung pada file CA bundle yang ditunjuk di konfigurasinya. Inilah sebabnya browser lancar, sedangkan Composer gagal.
Penyebab yang paling sering ditemui dalam praktik:
| Penyebab | Gejala khas | Bagian solusi |
|---|---|---|
File cacert.pem tidak ada, salah path, atau sudah sangat lama | unable to get local issuer certificate | Langkah 2 dan 3 |
php.ini yang diedit bukan yang dipakai PHP CLI | Sudah mengubah konfigurasi, tetapi error tidak berubah | Langkah 1 |
Ekstensi openssl belum diaktifkan | The openssl extension is required for SSL/TLS protection | Langkah 4 |
| Antivirus atau proxy kantor melakukan SSL inspection | Error tetap muncul walau cacert.pem sudah terbaru | Langkah 6 |
| Jam dan tanggal sistem salah | certificate is not yet valid atau certificate has expired | Langkah 7 |
Satu hal yang perlu dipahami sejak awal: tujuan kita adalah membuat verifikasi sertifikat berhasil, bukan mematikannya. Solusi yang benar hampir selalu berupa memberi PHP daftar CA yang tepat.
Langkah 1: Pastikan php.ini mana yang dipakai
Kesalahan paling umum adalah mengedit php.ini yang salah. Di satu komputer bisa ada beberapa instalasi PHP, misalnya bawaan XAMPP, Laragon, dan PHP yang dipasang manual. Di Linux, PHP untuk terminal (CLI) dan PHP untuk web server (misalnya PHP-FPM) juga punya file php.ini terpisah. Composer berjalan memakai PHP CLI, jadi yang harus diubah adalah php.ini milik CLI.
Buka terminal atau Command Prompt, lalu jalankan:
php --ini
Perhatikan baris Loaded Configuration File. Itulah file yang benar-benar dibaca. Contoh hasilnya di Windows dengan XAMPP:
Configuration File (php.ini) Path:
Loaded Configuration File: C:\xampp\php\php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed: (none)
Kalau baris itu bernilai (none), berarti PHP berjalan tanpa php.ini sama sekali. Ini sering terjadi pada PHP yang diekstrak manual dari file ZIP. Solusinya, salin php.ini-development atau php.ini-production di folder PHP menjadi php.ini, lalu lanjutkan langkah berikutnya.
Pastikan juga PHP yang dipakai Composer sama dengan PHP yang Anda cek. Perintah where php di Windows atau which php di Linux dan macOS menampilkan lokasi PHP yang ada di PATH. Jika Anda belum terbiasa dengan perintah semacam ini, panduan cara menggunakan terminal dan command line bisa membantu.
Langkah 2: Unduh cacert.pem terbaru
File CA bundle yang umum dipakai adalah hasil ekstraksi daftar CA Mozilla yang disediakan oleh proyek curl di halaman https://curl.se/docs/caextract.html. File langsungnya ada di:
https://curl.se/ca/cacert.pem
Unduh file itu lewat browser, lalu simpan di lokasi yang permanen dan mudah diingat. Hindari folder Downloads karena sering dibersihkan. Beberapa contoh lokasi yang rapi:
- Windows dengan XAMPP:
C:\xampp\php\extras\ssl\cacert.pem(buat foldernya jika belum ada). - Windows dengan PHP manual:
C:\php\extras\ssl\cacert.pem. - Linux: umumnya tidak perlu mengunduh manual, karena distribusi sudah menyediakan CA bundle lewat paket
ca-certificates. Di Debian dan Ubuntu filenya ada di/etc/ssl/certs/ca-certificates.crt.
Hindari path yang mengandung spasi jika bisa. Path dengan spasi tetap bisa dipakai asalkan diapit tanda kutip di php.ini, tetapi path tanpa spasi lebih sedikit menimbulkan masalah.
Jika Anda sudah punya cacert.pem lama dari beberapa tahun lalu, tetap ganti dengan yang baru. Daftar CA berubah dari waktu ke waktu. Ada CA baru yang masuk dan CA lama yang dicabut atau kedaluwarsa, sehingga file lama bisa saja tidak lagi mengenali penerbit sertifikat server tujuan.
Langkah 3: Set curl.cainfo dan openssl.cafile di php.ini
Buka file php.ini yang ditemukan di Langkah 1 dengan editor teks. Cari dua baris berikut. Biasanya keduanya ada tetapi masih diawali titik koma (;), artinya dinonaktifkan:
;curl.cainfo =
;openssl.cafile=
Hapus titik koma di depannya dan isi dengan path lengkap ke cacert.pem:
[curl]
curl.cainfo = "C:\xampp\php\extras\ssl\cacert.pem"
[openssl]
openssl.cafile = "C:\xampp\php\extras\ssl\cacert.pem"
Kenapa dua-duanya? curl.cainfo dipakai oleh ekstensi cURL di PHP, sedangkan openssl.cafile dipakai oleh fungsi stream PHP seperti file_get_contents terhadap URL HTTPS. Composer bisa memakai salah satu jalur tersebut tergantung ekstensi yang tersedia, jadi mengisi keduanya membuat konfigurasi konsisten. Aplikasi PHP Anda sendiri yang memanggil API lewat HTTPS juga ikut diuntungkan.
Simpan file, lalu tutup dan buka lagi terminal agar perubahan terbaca. Periksa nilainya:
php -i | findstr cainfo
php -i | findstr cafile
Di Linux atau macOS, ganti findstr dengan grep. Jika path yang muncul sudah sesuai, coba lagi perintah Composer yang tadi gagal.
Catatan: perubahan php.ini untuk CLI tidak membutuhkan restart Apache. Restart web server hanya diperlukan jika Anda juga ingin aplikasi web yang berjalan di Apache atau PHP-FPM memakai pengaturan baru, dan itu pun hanya berlaku jika web server membaca file php.ini yang sama.
Langkah 4: Aktifkan ekstensi openssl
Jika error yang muncul adalah The openssl extension is required for SSL/TLS protection, masalahnya lebih mendasar: PHP sama sekali tidak bisa melakukan koneksi TLS. Cek dulu apakah ekstensi itu termuat:
php -m
Perintah ini menampilkan daftar modul yang aktif. Jika openssl tidak ada di daftar, buka php.ini dan cari baris berikut:
;extension=openssl
Hapus titik koma di depannya sehingga menjadi:
extension=openssl
Pada PHP versi lama di Windows (sebelum 7.2), penulisannya memakai nama file DLL, yaitu extension=php_openssl.dll. Pastikan juga baris extension_dir menunjuk ke folder ext di dalam folder PHP, misalnya extension_dir = "ext" atau path lengkapnya. Kalau extension_dir salah, PHP tidak bisa menemukan file ekstensinya dan biasanya menampilkan peringatan saat dijalankan.
Sekalian periksa ekstensi curl dengan cara yang sama (extension=curl). Composer tetap bisa berjalan tanpa ekstensi cURL, tetapi dengan cURL proses unduh paket umumnya lebih cepat karena bisa berjalan paralel.
Di Linux, OpenSSL biasanya sudah menjadi bagian dari paket PHP inti. Jika php -m tidak menampilkannya, kemungkinan PHP dikompilasi tanpa dukungan OpenSSL atau ada instalasi PHP lain yang ikut terpanggil. Cek kembali hasil which php dan php --ini.
Langkah 5: Jalankan composer diagnose
Composer punya perintah bawaan untuk memeriksa lingkungannya:
composer diagnose
Perintah ini mengecek beberapa hal, antara lain konektivitas HTTP dan HTTPS ke Packagist, pengaturan proxy, ketersediaan ekstensi PHP yang penting, serta versi Composer. Setiap pemeriksaan diberi status seperti OK, WARNING, atau FAIL disertai keterangan. Baca bagian yang gagal dengan teliti, karena pesan di sana biasanya lebih spesifik daripada pesan error saat composer install.
Berlangganan gratis. Artikel & tutorial coding terbaru langsung ke email kamu. Tanpa spam.
Jika Composer bisa berjalan normal kembali, ada baiknya sekalian memperbarui Composer itu sendiri dengan composer self-update. Versi Composer lama bisa membawa CA bundle bawaan yang juga sudah tua. Perlu diingat, self-update juga mengunduh lewat HTTPS, jadi perintah ini baru akan berhasil setelah masalah sertifikat beres.
Langkah 6: Atur cafile khusus Composer (dan kasus proxy kantor)
Composer juga punya pengaturan sendiri untuk menunjuk CA bundle, yaitu opsi cafile. Ini berguna ketika Anda tidak bisa atau tidak ingin mengubah php.ini, misalnya di komputer kantor dengan hak akses terbatas. Atur secara global agar berlaku untuk semua proyek:
composer config --global cafile "C:/xampp/php/extras/ssl/cacert.pem"
Untuk melihat nilai yang sedang aktif, jalankan composer config --global cafile tanpa nilai. Untuk menghapusnya, pakai composer config --global --unset cafile. Path bisa ditulis dengan garis miring biasa (/) di Windows sehingga tidak perlu memikirkan escape karakter.
Jika jaringan memakai SSL inspection
Di banyak kantor, lalu lintas HTTPS melewati proxy atau firewall yang membuka dan memeriksa isinya. Hal yang sama dilakukan oleh beberapa antivirus dengan fitur pemindaian web atau HTTPS. Caranya, perangkat tersebut mengganti sertifikat asli server dengan sertifikat yang ia tandatangani sendiri memakai CA internal. Browser tidak protes karena CA internal itu sudah dipasang ke penyimpanan sertifikat Windows oleh tim IT atau oleh antivirus. Namun PHP tidak membaca penyimpanan tersebut, sehingga sertifikat pengganti itu dianggap tidak dikenal.
Ciri-cirinya: cacert.pem sudah terbaru dan path sudah benar, tetapi error tetap muncul, dan masalah hilang ketika laptop dibawa ke jaringan rumah. Cara memastikannya, buka situs HTTPS di browser, klik ikon gembok, lalu lihat detail sertifikat. Jika penerbitnya bukan CA publik yang biasa, melainkan nama perusahaan Anda atau nama produk antivirus, berarti koneksi sedang diperiksa di tengah jalan.
Ada dua jalan keluar yang benar:
- Tambahkan CA internal ke CA bundle. Minta file sertifikat root CA perusahaan ke tim IT dalam format PEM (teks yang diawali
-----BEGIN CERTIFICATE-----). Salin isi file itu ke bagian paling bawahcacert.pemAnda, atau buat salinancacert.pemkhusus yang berisi CA publik plus CA internal, lalu arahkancurl.cainfo,openssl.cafile, ataucafileComposer ke file itu. - Untuk antivirus di komputer pribadi, matikan fitur pemindaian HTTPS atau tambahkan pengecualian untuk
php.exe. Nama menunya berbeda di tiap produk, jadi lihat dokumentasi antivirus Anda.
Jika jaringan kantor mengharuskan proxy, Composer membaca variabel lingkungan HTTP_PROXY dan HTTPS_PROXY (juga versi huruf kecil). Pengaturan proxy ini terpisah dari urusan sertifikat. Proxy yang salah biasanya menghasilkan error koneksi atau timeout, bukan error sertifikat.
Langkah 7: Periksa jam dan tanggal sistem
Setiap sertifikat punya masa berlaku dengan tanggal mulai dan tanggal berakhir. Jika jam komputer meleset jauh, misalnya baterai CMOS lemah sehingga tanggal kembali ke tahun lama, sertifikat yang sebenarnya valid akan dianggap belum berlaku atau sudah kedaluwarsa. Pesan yang muncul biasanya berbunyi certificate is not yet valid atau certificate has expired, bukan unable to get local issuer certificate.
Perbaikannya sederhana: aktifkan sinkronisasi waktu otomatis. Di Windows, buka Settings, bagian Time & language, lalu aktifkan Set time automatically dan klik Sync now. Di Linux, perintah timedatectl menampilkan status sinkronisasi waktu. Untuk server atau VPS, pastikan layanan sinkronisasi waktu berjalan sejak awal setup, sesuatu yang juga dibahas saat deploy Laravel ke VPS Ubuntu dengan Nginx.
Jangan pakai disable-tls atau secure-http false sebagai solusi
Di banyak forum, jawaban tercepat untuk error ini adalah:
composer config --global disable-tls true
composer config --global secure-http false
Kedua perintah itu memang membuat error hilang, tetapi dengan cara mematikan perlindungan. Penjelasannya:
disable-tls truemembuat Composer tidak memakai TLS sama sekali. Koneksi berjalan tanpa enkripsi dan tanpa verifikasi identitas server.secure-http falsemengizinkan Composer mengunduh paket dan metadata lewathttp://biasa, yang secara bawaan diblokir.
Risikonya nyata. Composer mengunduh kode yang nantinya dijalankan di komputer dan server Anda. Tanpa enkripsi dan verifikasi, siapa pun yang berada di jalur jaringan, misalnya pengelola Wi-Fi publik atau perangkat yang sudah disusupi, secara teori bisa menyisipkan kode berbahaya ke paket yang Anda unduh. Anda tidak akan tahu, karena proyek tetap berjalan seperti biasa.
Jika terpaksa memakainya, misalnya untuk keadaan darurat di jaringan terisolasi yang Anda kendalikan sepenuhnya, perlakukan sebagai pengaturan sementara. Begitu selesai, kembalikan ke kondisi aman:
composer config --global --unset disable-tls
composer config --global --unset secure-http
Periksa juga file composer.json proyek. Opsi yang sama bisa ditulis di bagian config per proyek. Jangan sampai pengaturan semacam ini ikut ter-commit ke repository lalu dipakai oleh seluruh tim tanpa disadari.
Ringkasan urutan perbaikan
- Jalankan
php --iniuntuk mengetahuiphp.iniyang benar-benar dipakai. - Unduh
cacert.pemterbaru daricurl.sedan simpan di lokasi permanen. - Isi
curl.cainfodanopenssl.cafiledengan path file tersebut. - Pastikan
extension=opensslaktif dan muncul diphp -m. - Jalankan
composer diagnoseuntuk melihat pemeriksaan yang masih gagal. - Di jaringan kantor atau dengan antivirus tertentu, tambahkan CA internal ke CA bundle atau pakai opsi
cafileComposer. - Pastikan jam sistem sudah benar.
Setelah Composer kembali normal, Anda bisa melanjutkan pekerjaan seperti biasa. Jika masih baru dengan Composer, panduan cara menggunakan Composer untuk manajemen package PHP membahas perintah dasar seperti require, install, dan update beserta perbedaannya.
FAQ
Kenapa browser bisa membuka Packagist, tetapi Composer tidak?
Browser memakai penyimpanan sertifikat sistem operasi atau miliknya sendiri, sedangkan PHP bergantung pada file CA bundle yang diatur di php.ini atau di konfigurasi Composer. Jika file itu tidak ada, salah path, atau tidak memuat CA yang dibutuhkan, Composer gagal walau browser lancar.
Saya sudah mengedit php.ini, tetapi error tetap sama. Apa yang salah?
Paling sering karena file yang diedit bukan file yang dipakai PHP CLI. Cek lagi baris Loaded Configuration File dari php --ini, lalu tutup dan buka ulang terminal setelah menyimpan perubahan. Pastikan juga tidak ada titik koma yang tersisa di depan baris yang diubah.
Apakah file cacert.pem perlu diperbarui secara berkala?
Sebaiknya ya. Daftar CA terus berubah, jadi file yang berumur beberapa tahun bisa tertinggal. Mengunduh ulang dari curl.se sesekali, misalnya saat memperbarui PHP, sudah cukup untuk kebanyakan kebutuhan pengembangan lokal.
Apakah aman memakai disable-tls hanya di laptop sendiri?
Tidak sepenuhnya. Laptop sering berpindah jaringan, termasuk Wi-Fi publik. Pengaturan global yang terlupa akan tetap aktif di mana pun Anda berada. Perbaiki akar masalahnya dengan CA bundle yang benar, dan jika sempat memakai disable-tls, segera hapus dengan --unset.
Apakah error ini bisa muncul di server produksi?
Bisa, terutama di server dengan paket ca-certificates yang sudah lama tidak diperbarui atau di server yang berada di belakang firewall dengan SSL inspection. Di Debian dan Ubuntu, memperbarui paket ca-certificates lewat apt biasanya menyelesaikan masalah CA bundle yang usang.