Cara Mengatasi Composer SSL Certificate Problem

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 me...

Cara Mengatasi Composer SSL Certificate Problem
Iklan
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.

Iklan

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:

PenyebabGejala khasBagian solusi
File cacert.pem tidak ada, salah path, atau sudah sangat lamaunable to get local issuer certificateLangkah 2 dan 3
php.ini yang diedit bukan yang dipakai PHP CLISudah mengubah konfigurasi, tetapi error tidak berubahLangkah 1
Ekstensi openssl belum diaktifkanThe openssl extension is required for SSL/TLS protectionLangkah 4
Antivirus atau proxy kantor melakukan SSL inspectionError tetap muncul walau cacert.pem sudah terbaruLangkah 6
Jam dan tanggal sistem salahcertificate is not yet valid atau certificate has expiredLangkah 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.

Iklan

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.

Iklan

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.

Iklan

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.

Iklan

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:

Iklan
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.

Iklan

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.

Dapatkan Update Terbaru

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.

Iklan

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.

Iklan

Ada dua jalan keluar yang benar:

  1. 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 bawah cacert.pem Anda, atau buat salinan cacert.pem khusus yang berisi CA publik plus CA internal, lalu arahkan curl.cainfo, openssl.cafile, atau cafile Composer ke file itu.
  2. 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.

Iklan

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 true membuat Composer tidak memakai TLS sama sekali. Koneksi berjalan tanpa enkripsi dan tanpa verifikasi identitas server.
  • secure-http false mengizinkan Composer mengunduh paket dan metadata lewat http:// 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:

Iklan
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

  1. Jalankan php --ini untuk mengetahui php.ini yang benar-benar dipakai.
  2. Unduh cacert.pem terbaru dari curl.se dan simpan di lokasi permanen.
  3. Isi curl.cainfo dan openssl.cafile dengan path file tersebut.
  4. Pastikan extension=openssl aktif dan muncul di php -m.
  5. Jalankan composer diagnose untuk melihat pemeriksaan yang masih gagal.
  6. Di jaringan kantor atau dengan antivirus tertentu, tambahkan CA internal ke CA bundle atau pakai opsi cafile Composer.
  7. 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.

Iklan

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.

Iklan
composer error ssl certificate problem unable to get local issuer certificate composer error openssl ssl error composer composer curl error 60 cacert.pem php.ini composer disable-tls
Rekomendasi

Hosting Cepat untuk Website & Laravel

Butuh hosting yang ngebut dan stabil untuk deploy website atau aplikasi Laravel-mu? Ini rekomendasi yang saya pakai.

Lihat Rekomendasi Hosting
Yudhi
Ditulis oleh

Yudhi

Web Developer

Web developer yang sehari-hari berkutat dengan PHP, Laravel, JavaScript, dan MySQL. Terbiasa membangun aplikasi web dari nol โ€” merancang database, menulis fitur, memburu bug, hingga deploy ke server โ€” lalu menuangkan solusi dan tutorialnya di DhieCoderWeb agar lebih mudah diikuti developer lain.

Bagikan artikel
Kembali

Komentar (0)

Punya pertanyaan atau tambahan? Tulis di bawah โ€” tak perlu login.

Membalas komentarโ€ฆ batal

Belum ada komentar. Jadilah yang pertama!

๐Ÿš€ Partner Recommendation

Butuh Source Code & Aplikasi Premium?

Download aplikasi Laravel, POS, Sekolah, Klinik, ERP, dan source code siap pakai di GudangCode.

GudangCode
  • โœ” Source Code Premium
  • โœ” Sistem Siap Pakai
  • โœ” Lifetime Update
  • โœ” Membership Lifetime
  • โœ” Update Aplikasi Harian
Daftar Membership โ†’
Iklan
Iklan