Pemecahan masalah

Sebagian besar masalah bermuara pada beberapa penyebab utama: versi PHP, izin file, kredensial database, penulisan ulang web-server, atau worker yang hilang. Halaman ini mencantumkan gejala yang paling sering dialami operator beserta cara mengatasinya. Jika ragu, log kesalahan PHP Anda adalah cara tercepat untuk menemukan penyebabnya.

Masalah instalasi

"Versi PHP Anda tidak didukung"

TubePress memerlukan PHP 8.2 atau lebih baru, yang ditegakkan oleh penjaga versi yang aman dari parse dan berjalan sebelum hal lain apa pun. Ganti versi PHP di panel hosting Anda (atau arahkan vhost ke socket PHP-FPM yang lebih baru) dan muat ulang. Lihat Persyaratan.

"Tidak dapat terhubung ke database"

Selama langkah database installer, periksa kembali host (sering kali localhost atau 127.0.0.1), nama database, pengguna dan kata sandi, serta pastikan pengguna memiliki hak akses pada database tersebut. Database harus sudah ada — installer membuat tabel, bukan skema itu sendiri.

Installer tidak dapat menulis konfigurasi / kesalahan "not writable"

Server web memerlukan akses tulis ke config/ dan storage/ selama penyiapan. Buat direktori tersebut dapat ditulis oleh pengguna PHP, lalu coba lagi. Lihat panduan izin di Instalasi.

Saya selesai menginstal tetapi /install masih termuat

Instalasi menulis config/installed.php. Jika file itu hilang, aplikasi menganggap dirinya belum terinstal; jika penyiapan selesai, file itu harus ada dan installer mengunci dirinya sendiri. Periksa kembali bahwa config/ dapat ditulis.

Situs termuat tetapi halaman menampilkan 404

Jika halaman beranda berfungsi tetapi setiap URL lain mengembalikan 404, penulisan ulang URL tidak mencapai front controller.

• Apache — konfirmasi mod_rewrite diaktifkan dan AllowOverride All ditetapkan agar .htaccess yang disertakan dihormati.
• Nginx — location / Anda harus meneruskan ke front controller, misalnya try_files $uri $uri/ /index.php?$query_string;. Lihat Arsitektur untuk catatan web-server.

Login & akses admin

Saya tidak dapat menemukan login admin

Jika Anda menetapkan URL admin khusus untuk keamanan, panel tidak lagi berada di /admin — ia hanya merespons di jalur rahasia Anda. Pulihkan dari tabel settings jika Anda memiliki akses database. Lihat Keamanan.

Autentikasi dua faktor mengunci saya

Jika Anda kehilangan autentikator, nonaktifkan TOTP pengguna di database (kolom yang relevan pada tabel users) untuk mendapatkan kembali akses, lalu daftar ulang. Detail ada di Keamanan.

Unggahan & media

Unggahan besar gagal atau kehabisan waktu

Naikkan batas PHP upload_max_filesize dan post_max_size, dan di Nginx tingkatkan client_max_body_size. Demo memungkinkan unggahan multi-gigabyte melalui client_max_body_size yang tinggi; tiru itu di server Anda untuk file besar.

Video tidak mau diputar

Video yang baru diunggah mungkin masih dalam proses diproses hingga transcoding selesai. Konfirmasi bahwa format dapat disampaikan di web, bahwa file rendisi ada di storage, dan bahwa server Anda mengirimkan tipe MIME yang benar untuk .mp4/.webm. Lihat Player.

Thumbnail atau pratinjau hilang

Pembuatan thumbnail dan pratinjau membutuhkan ekstensi GD atau Imagick (dan FFmpeg untuk frame yang berasal dari video). Verifikasi bahwa keduanya terinstal dan bahwa uploads/ dapat ditulis.

Transcoding macet

Jika pekerjaan berada dalam antrean dan tidak pernah selesai:

• Konfirmasi FFmpeg terinstal di mana pun transcoding berjalan (server lokal atau worker jarak jauh).
• Jika Anda menggunakan server transcode jarak jauh, periksa apakah worker sedang berjalan dan kunci API-nya cocok dengan yang dikonfigurasi di admin.
• Pastikan penjadwal berjalan (lihat di bawah) — pengiriman pekerjaan dan percobaan ulang berjalan pada pseudo-cron.

Pekerjaan terjadwal tidak berjalan

Pseudo-cron hanya aktif saat halaman dirender. Pada situs yang sepi, heartbeat membuatnya tetap aktif — pastikan heartbeat_enabled bernilai 1. Jika Anda menonaktifkannya, aktifkan kembali atau tambahkan entri cron sistem yang mengakses situs Anda secara berkala.

Email tidak terkirim

Konfigurasikan SMTP di bawah Email & notifikasi dan gunakan tombol bawaan Kirim email uji coba untuk mengonfirmasi. Jika pengujian gagal, verifikasi host/port/kredensial SMTP dan pastikan host Anda mengizinkan email keluar; untuk ketercapaian, siapkan SPF/DKIM pada domain Anda.

Performa

Untuk situs yang responsif pada skala besar: aktifkan OPcache, beri PHP memori yang cukup, pertahankan MySQL di jaringan yang sama dengan PHP, dan biarkan perhitungan ulang CTR dan tugas terjadwal lainnya berjalan. TubePress hadir dengan indeks dan pekerjaan terpisah yang diperlukan untuk pustaka besar — lihat Pemeliharaan.

Pembaruan gagal

Jika pembaruan tidak dapat diterapkan, konfirmasi bahwa file inti dapat ditulis oleh pengguna PHP dan bahwa Anda menggunakan PHP 8.2+. Selalu buat cadangan sebelum memperbarui agar Anda dapat melakukan rollback. Lihat Pembaruan.

Masih terhambat?

Kumpulkan pesan kesalahan yang tepat dan baris log yang relevan, lalu buka tiket dari dashboard Anda atau widget dukungan di dalam admin. Semakin banyak konteks yang Anda sertakan — versi PHP, web server, dan apa yang Anda lakukan — semakin cepat masalah diselesaikan. Lihat Pengumuman & dukungan.