Pembaruan ke versi baru

Contoh memakai akun cPanel akun dan folder aplikasi /home/akun/pondok.

1. Membuat backup #Tautan ke bagian 1. Membuat backup

Simpan empat hal berikut:

• Database, lewat menu Backup cPanel atau ekspor dari phpMyAdmin.
• Folder storage, berisi unggahan dan dokumen santri.
• Berkas .env.
• Berkas public/.htaccess.

2. Menghapus folder kode lama #Tautan ke bagian 2. Menghapus folder kode lama

Di /home/akun/pondok, hapus folder dan berkas kode berikut:

• app
• bootstrap/cache/*.php
• config
• database
• lang
• public/build
• resources
• routes
• vendor

3. Mengekstrak versi baru #Tautan ke bagian 3. Mengekstrak versi baru

Unggah zip versi baru ke /home/akun, lalu ekstrak sehingga menimpa folder pondok.

4. Menjalankan pondok:upgrade #Tautan ke bagian 4. Menjalankan pondok:upgrade

Segera setelah ekstrak, jalankan:

php artisan pondok:upgrade --force

Perintah ini:

1. menutup situs sementara (mode pemeliharaan);
2. memperbarui tabel database;
3. menambah permission dan pengaturan baru;
4. mengembalikan blok cPanel-generated handler ke public/.htaccess yang tertimpa zip;
5. menyalin ulang public_html bila Anda memakai cara B;
6. membersihkan cache;
7. membuka situs kembali.

Tanpa --force, perintah menanyakan apakah backup sudah dibuat. Bila tidak ada Terminal, jalankan lewat cron sekali jalan seperti pada instalasi.

Apa yang dilakukan bila pembaruan gagal? #Tautan ke bagian Apa yang dilakukan bila pembaruan gagal?

Bila pembaruan gagal, situs tetap dalam mode pemeliharaan sehingga pengunjung tidak melihat halaman rusak.

1. Baca pesan error dan perbaiki penyebabnya.

2. Jalankan ulang perintah yang sama. Perintah ini aman diulang.

3. Bila perlu memulihkan backup, buka kembali situs setelah selesai dengan:

   Terminal

   php artisan up

   Salin

Bila situs menampilkan error 500 setelah pembaruan, pilih ulang PHP 8.3 di MultiPHP Manager untuk menulis ulang blok handler di .htaccess. Lihat juga Error 500 setelah pembaruan.

Apakah peran dan pengaturan ikut berubah? #Tautan ke bagian Apakah peran dan pengaturan ikut berubah?

• Pembaruan mengembalikan permission peran bawaan (super-admin, admin sekolah, dan seterusnya) ke definisi aplikasi.
• Peran buatan sendiri tidak berubah.
• Pengaturan yang sudah diubah dari panel tidak ditimpa.

Bila Anda menambah permission ke peran bawaan, buat peran sendiri agar perubahan itu tidak hilang saat pembaruan.

Langkah berikutnya #Tautan ke bagian Langkah berikutnya

• HTTPS dan pemeriksaan
• Masalah umum