===================================================================== PANDUAN UPLOAD TARQIA STUDENT KE HOSTING (cPanel / shared hosting) ===================================================================== Kebutuhan hosting: - PHP 8.2 atau lebih baru (atur di cPanel > Select PHP Version) - Ekstensi PHP: intl, mbstring, mysqli, json (biasanya sudah aktif) - MySQL 5.7+ / MariaDB 10.3+ Isi zip: tarqia_app/ -> kode aplikasi (JANGAN taruh di dalam public_html) public_html/ -> file yang bisa diakses publik (index.php, assets) database.sql -> struktur tabel + pengaturan awal + akun admin --------------------------------------------------------------------- LANGKAH 1 - Buat database --------------------------------------------------------------------- 1. cPanel > MySQL Databases: - buat database baru (mis. namauser_tarqia) - buat user database + password - tambahkan user ke database dengan ALL PRIVILEGES 2. cPanel > phpMyAdmin > pilih database tadi > tab Import > pilih database.sql > Go. --------------------------------------------------------------------- LANGKAH 2 - Upload file --------------------------------------------------------------------- 1. cPanel > File Manager > buka folder HOME (/home/namauser/), yaitu folder yang berisi public_html. 2. Upload tarqia-hosting.zip ke folder HOME tersebut, lalu Extract. 3. Hasilnya: /home/namauser/tarqia_app/ /home/namauser/public_html/ (isi index.php, .htaccess, assets/) Jika public_html sudah berisi website lain, backup dulu. (database.sql dan PANDUAN-UPLOAD.txt boleh dihapus setelah selesai.) Catatan: aktifkan "Show Hidden Files" di File Manager agar file .htaccess dan .env terlihat. --------------------------------------------------------------------- LANGKAH 3 - Isi konfigurasi --------------------------------------------------------------------- Edit file tarqia_app/.env lalu ganti: app.baseURL = 'https://domain-anda.com/' (akhiri dengan /) database.default.database = nama database dari langkah 1 database.default.username = user database database.default.password = password database Jika domain sudah HTTPS, boleh ubah: app.forceGlobalSecureRequests = true --------------------------------------------------------------------- LANGKAH 4 - Izin folder --------------------------------------------------------------------- Folder tarqia_app/writable (beserta isinya) harus bisa ditulis server: permission 755 untuk folder (atau 775 jika masih error). --------------------------------------------------------------------- LANGKAH 5 - Coba buka --------------------------------------------------------------------- Buka https://domain-anda.com/ lalu login dengan akun admin yang sama seperti di komputer lokal. SEGERA ganti password lewat menu Akun. --------------------------------------------------------------------- Jika aplikasi dipasang di SUBDOMAIN / folder lain --------------------------------------------------------------------- Misal document root subdomain = /home/namauser/tarqia.domain.com/ - salin ISI folder public_html/ dari zip ke folder tersebut (bukan ke public_html utama) - tarqia_app/ tetap di /home/namauser/tarqia_app/ -> karena sejajar, index.php tidak perlu diubah. - Jika letaknya lebih dalam, mis. /home/namauser/public_html/tarqia/, edit index.php di folder itu: require FCPATH . '../../tarqia_app/app/Config/Paths.php'; - app.baseURL di .env = 'https://tarqia.domain.com/' --------------------------------------------------------------------- Masalah umum --------------------------------------------------------------------- - Halaman putih / error 500: cek tarqia_app/writable/logs/ untuk pesan error, pastikan versi PHP >= 8.2 dan writable bisa ditulis. - "Unable to connect to the database": cek isi .env (langkah 3). - Login berhasil tapi menu error "Server error (404)": pastikan file public_html/.htaccess ikut ter-upload dan app.baseURL sesuai domain (termasuk https dan / di akhir). - Musik login tidak bunyi: browser memblokir autoplay; klik tombol "Putar Musik" (perilaku normal). Memindahkan data dari Google Spreadsheet: Lakukan di komputer lokal (php spark tarqia:import ), lalu jalankan build-hosting.ps1 lagi untuk membuat database.sql terbaru. Atau export tabel dari phpMyAdmin lokal dan import ke hosting.