Masalah umum
RingkasnyaSebagian besar masalah Pondok CMS di cPanel berasal dari versi PHP yang salah, letak folder aplikasi, APP_URL yang tidak cocok, atau cron yang belum dipasang. Cari gejalanya di tabel, lalu ikuti solusinya.
Daftar isi
Jalankan php artisan pondok:doctor lebih dulu. Pesannya sering langsung menunjukkan penyebab masalah. Lihat HTTPS dan pemeriksaan.
Apa saja masalah yang paling sering muncul? Tautan ke bagian Apa saja masalah yang paling sering muncul?
| Gejala | Penyebab singkat |
|---|---|
| Error 500 Vite manifest not found | Folder public/build tidak ada |
| Gambar tidak tampil | Folder unggahan belum terhubung atau APP_URL salah |
| PHP bukan 8.3 | Perintah atau cron memakai PHP lain |
| Unggahan dokumen gagal | Batas unggah PHP terlalu kecil |
| Perubahan .env tidak berpengaruh | Konfigurasi ter-cache |
| Error 500 setelah pembaruan | Blok handler cPanel hilang dari .htaccess |
| Semua halaman 403 | Aplikasi terekstrak di folder web |
| Peringatan cron di pondok:doctor | Cron belum ada atau path PHP salah |
Bagaimana memperbaiki tiap masalah? Tautan ke bagian Bagaimana memperbaiki tiap masalah?
Error 500 Vite manifest not found Tautan ke bagian Error 500 Vite manifest not found
Gejala. Halaman menampilkan error 500 dengan pesan Vite manifest not found.
Penyebab. Folder public/build tidak ada. Biasanya karena yang diunggah adalah unduhan kode sumber, bukan paket rilis resmi.
Solusi. Unggah ulang zip rilis resmi. Bila memakai cara B, jalankan ulang:
php artisan pondok:publish-publicGambar tidak tampil Tautan ke bagian Gambar tidak tampil
Gejala. Foto portal, logo, atau gambar lain tidak muncul.
Penyebab. Folder unggahan publik belum terhubung, atau APP_URL tidak sama dengan alamat situs.
Solusi. Jalankan ulang pondok:install, atau isi PUBLIC_STORAGE_ROOT bila hosting mematikan symlink. Pastikan APP_URL persis sama dengan alamat yang dibuka pengunjung, termasuk https://. Lihat Menghubungkan folder unggahan publik.
PHP bukan 8.3 Tautan ke bagian PHP bukan 8.3
Gejala. Muncul pesan Your Composer dependencies require a PHP version >= 8.3.
Penyebab. PHP yang menjalankan perintah atau cron bukan versi 8.3.
Solusi. Pakai path PHP 8.3 lengkap, misalnya /opt/cpanel/ea-php83/root/usr/bin/php, dan pilih ea-php83 di MultiPHP Manager. Lihat Memastikan path PHP 8.3.
Unggahan dokumen gagal Tautan ke bagian Unggahan dokumen gagal
Gejala. Dokumen santri atau berkas lain gagal diunggah.
Penyebab. upload_max_filesize atau post_max_size terlalu kecil.
Solusi. Naikkan kedua nilai di MultiPHP INI Editor. upload_max_filesize minimal 5M, dan post_max_size tidak lebih kecil darinya.
Perubahan .env tidak berpengaruh Tautan ke bagian Perubahan .env tidak berpengaruh
Gejala. Anda sudah mengubah .env, tetapi aplikasi masih memakai nilai lama.
Penyebab. Konfigurasi masih ter-cache, biasanya setelah php artisan optimize.
Solusi.
php artisan optimize:clearError 500 setelah pembaruan Tautan ke bagian Error 500 setelah pembaruan
Gejala. Situs error 500 setelah mengekstrak versi baru.
Penyebab. public/.htaccess kehilangan blok cPanel-generated handler, sehingga situs jatuh ke versi PHP lama.
Solusi. Jalankan php artisan pondok:upgrade --force, atau pilih ulang PHP 8.3 di MultiPHP Manager agar blok handler ditulis ulang. Lihat Pembaruan ke versi baru.
Semua halaman 403 Tautan ke bagian Semua halaman 403
Gejala. Semua halaman menampilkan 403 Forbidden.
Penyebab. Aplikasi terekstrak di dalam folder web, misalnya public_html/pondok. Berkas .htaccess di root aplikasi sengaja menolak semua akses.
Solusi. Pindahkan folder ke /home/akun/pondok, lalu atur document root seperti di Mengatur document root.
Pengecualian: bila document root sudah benar (/home/akun/pondok/public) tetapi tetap 403, sebagian server mewariskan .htaccess folder induk. Dalam kasus ini, hapus berkas /home/akun/pondok/.htaccess.
Peringatan cron di pondok:doctor Tautan ke bagian Peringatan cron di pondok:doctor
Gejala. pondok:doctor menampilkan peringatan pada baris cron.
Penyebab. Cron schedule:run belum ditambahkan, atau path PHP-nya salah.
Solusi. Tambahkan cron sesuai Cron dan antrean, dengan path PHP 8.3 lengkap.