Pemecahan Masalah PHP di ServBay: Atasi Error ImageMagick dan Unggah File Besar

ServBay menyediakan lingkungan pengembangan Web lokal yang praktis bagi para developer, dengan dukungan berbagai versi PHP dan aneka ekstensi. Meski ServBay berkomitmen menawarkan layanan yang stabil dan andal, dalam praktiknya pengguna kadang tetap dapat menemui masalah terkait layanan PHP ataupun ekstensi tertentu.

Dokumen ini akan membantu Anda mengidentifikasi serta mengatasi berbagai masalah umum terkait PHP pada ServBay, terutama terkait error dari ekstensi ImageMagick dan penurunan kecepatan unggah file besar di PHP. Tersedia langkah-langkah troubleshooting detail dan solusi yang sesuai.

Kumpulan Masalah Umum PHP & Solusinya

Berikut adalah beberapa masalah dan solusi umum untuk PHP maupun ekstensi PHP.

Error ImageMagick "number of supported formats: 0"

Penjelasan Masalah:

Beberapa pengguna ServBay, saat memakai ekstensi PHP ImageMagick, mungkin menemukan pesan error berikut:

ImageMagick number of supported formats: 0

Hal ini biasanya berarti library ImageMagick tidak berhasil mengenali atau memuat format gambar yang didukung.

Solusi:

Masalah ini umumnya berkaitan dengan library rendah yang disediakan oleh ServBay Runtime. Silakan lakukan langkah berikut:

1. Buka aplikasi ServBay.
2. Pada sidebar kiri, pilih Paket (Packages).
3. Di daftar paket sebelah kanan, cari dan pilih ServBay Runtime.
4. Pastikan ServBay Runtime sudah terpasang dan versinya minimal 1.0.20 atau 1.1.20 ke atas. Jika versi Anda lebih rendah, klik tombol upgrade untuk memperbaruinya.
5. Setelah upgrade ServBay Runtime, restart layanan PHP yang Anda pakai (misalnya PHP 8.1, PHP 8.2, dll).

Penjelasan Teknis: Paket ServBay Runtime mencakup komponen internal ServBay dan berbagai library bersama yang dibutuhkan ekstensi PHP. Melakukan upgrade Runtime akan memastikan library sudah terbaru, sehingga masalah deteksi format pada ImageMagick dapat teratasi.

Unggah File Besar di PHP Menjadi Lambat

Penjelasan Masalah:

Sejumlah pengguna saat mengunggah file besar (di atas 1GB), misalnya melalui aplikasi tus-php, NextCloud, dst, kemungkinan mengalami penurunan kecepatan unggah yang signifikan.

Penyebab utamanya seringkali terkait cara kerja php-fpm dan interaksinya dengan mekanisme file chunk (Chunked Transfer Encoding).

Solusi:

Anda bisa mencoba beberapa langkah berikut untuk mempercepat unggah file besar:

1. Naikkan nilai pm.max_children php-fpm

   Pada pengaturan default php-fpm ServBay, pm.max_children (jumlah maksimal proses anak) biasanya bernilai 10. Untuk unggah file besar yang mungkin menahan proses cukup lama, jumlah yang kecil dapat membuat proses jadi tersendat.

   Anda bisa menambah jumlah ini sesuai kebutuhan. Selain itu, cek juga setelan pm (pm = dynamic atau pm = ondemand) agar sesuai beban kerja Anda.

   

   Langkah Pengaturan:

   • Pada sidebar ServBay, pilih PHP versi yang Anda gunakan (misal PHP 8.2).
   • Klik tombol Konfigurasi (Configuration) di sebelah kanan.
   • Cari dan buka file php-fpm.conf.
   • Temukan pengaturan pm.max_children lalu sesuaikan nilainya.
   • Simpan file dan restart layanan PHP tersebut.

   Penjelasan Teknis: Dengan menambah proses anak, php-fpm bisa menangani lebih banyak request sekaligus. Untuk unggahan file besar yang menahan proses lama, proses anak yang cukup membuat permintaan lain tidak lama mengantre.

2. Nonaktifkan File Chunk (di kode aplikasi, bukan via pengaturan ServBay)

   Metode ini kurang direkomendasikan, sebab perlu mengubah kode aplikasi Anda dan beresiko mengganggu fitur yang memang mengandalkan chunk upload. Tapi di beberapa kasus khusus, menonaktifkan atau menyesuaikan file chunk transfer pada sisi klien/ server dapat mencegah masalah kecepatan akibat interaksi tak efisien dengan php-fpm.

3. Cek dan sesuaikan parameter fastcgi_request_buffering di server Web (Nginx/Caddy)

   Jika Anda menggunakan Nginx atau Caddy untuk meneruskan permintaan ke php-fpm, pengaturan fastcgi_request_buffering berpengaruh pada alur upload file.

   • Nginx: Secara default, fastcgi_request_buffering on; artinya Nginx akan menampung file upload klien terlebih dulu lalu baru mengirim penuh ke php-fpm. Untuk file besar, ini menimbulkan delay saat php-fpm mulai memproses data. Setting ke fastcgi_request_buffering off; akan membuat Nginx langsung mengalirkan data ke php-fpm selama proses upload, sehingga jauh lebih efisien untuk file besar.

     location ~ \.php$ {
         # ... parameter fastcgi lain ...
         fastcgi_request_buffering off; # Tambahkan atau ubah baris ini
         # ...
     }

   • Caddy: Instruksi php_fastcgi di Caddy secara default sudah melakukan stream (mirip dengan fastcgi_request_buffering off). Biasanya tidak perlu ubahan apa pun. Jika Anda menggunakan reverse_proxy manual ke FPM, pastikan tidak terdapat buffer tambahan.

   Langkah Pengaturan:

   • Pada sidebar ServBay, pilih server Web yang Anda gunakan (Nginx atau Caddy).
   • Klik tombol Konfigurasi (Configuration) di sebelah kanan.
   • Cari file konfigurasi utama (misalnya nginx.conf atau Caddyfile), lalu buka.
   • Pada blok location untuk PHP (Nginx) atau blok php_fastcgi (Caddy), tambahkan atau ubah pengaturan ke fastcgi_request_buffering off;.
   • Simpan file konfigurasi dan restart layanan server Web Anda.

Pemeriksaan Tambahan:

• Cek pengaturan PHP (php.ini): Pastikan nilai upload_max_filesize, post_max_size, dan memory_limit cukup besar untuk file yang akan diunggah. Jika kurang, upload bisa gagal (tidak hanya lambat). Masalah ini umum dalam upload file.
• Periksa log: Baca log error dan akses server Web (Nginx/Caddy), serta log error PHP-FPM. Log ini umumnya menyimpan info error mendetail dan anomali pemrosesan permintaan. Lokasi log error PHP biasanya diatur di php.ini dengan instruksi error_log.

Tips Umum Troubleshooting PHP

Jika Anda menemui kendala PHP di lingkungan ServBay, berikut langkah troubleshooting umum yang sebaiknya dilakukan:

1. Periksa versi PHP & ekstensi: Pastikan versi PHP sesuai aplikasi serta ekstensi yang diperlukan (ImageMagick, GD, MySQLi, dsb) sudah terinstal dan aktif. Untuk cek detail konfigurasi, buat file PHP berisi fungsi phpinfo() lalu akses lewat browser.
2. Cek status layanan ServBay: Pastikan layanan PHP yang Anda gunakan (misal PHP 8.2), server Web (Nginx/Caddy), dan layanan database (MySQL/PostgreSQL) berjalan normal di ServBay.
3. Lihat log error: Ini langkah paling penting dalam diagnosa.
   • Log error PHP: Lihat file log yang ditentukan oleh error_log di php.ini. Untuk pengembangan, aktifkan display_errors = On dan pastikan log_errors = On juga.
   • Log server Web: Cek file log error untuk Nginx/Caddy di folder logs pada direktori instalasi ServBay atau lokasi yang ditentukan di konfigurasi server Web.
   • Log ServBay: Aplikasi ServBay juga mungkin memiliki log yang merekam kejadian penting atau error saat startup.
4. Minimalisasi lingkungan uji: Jika memungkinkan, coba reproduksi masalah pada file PHP sederhana supaya lebih mudah mengisolasi sumber error (bukan komplikasi pada aplikasi Anda).
5. Cek dokumentasi & komunitas ServBay: Panduan resmi dan komunitas pengguna adalah sumber solusi dan referensi masalah yang sudah pernah terjadi.

Kesimpulan

Artikel ini memaparkan solusi spesifik atas error ImageMagick dan masalah kecepatan unggah file besar pada ServBay, ditambah tips troubleshooting PHP secara umum. Dengan memeriksa versi ServBay Runtime, mengatur php-fpm, mengubah buffer server Web, serta meneliti log, mayoritas masalah PHP di ServBay bisa diatasi. Jika masalah tetap muncul, manfaatkan detail log untuk analisa lebih lanjut atau minta bantuan dari komunitas ServBay.