Pemecahan Masalah

Cari gejalanya, coba perbaikannya. Kebanyakan entri menautkan ke halaman berisi detailnya. Saat Rezure menampilkan pesan error, biasanya pesannya spesifik; baca dulu.

Instalasi dan menjalankan

SmartScreen bilang "Windows protected your PC"

Itu soal code signing, bukan laporan virus. Verifikasi hash SHA-256 installer-nya, lalu pilih More info → Run anyway.

Nginx atau PHP menampilkan "Not installed" tepat setelah dipasang

Binary bawaannya tidak terekstrak. Instal ulang di atasnya.

Setup bilang WebView2 tidak ada

Pasang dari halaman WebView2 Microsoft, lalu jalankan installer lagi.

Layanan

"port 80 is already in use" / "port 80 is held by …"

Ada program lain yang memakai port itu: Laragon, XAMPP, IIS, Docker. Klik Stop it and start, atau lihat Konflik Port untuk port yang dicadangkan Windows.

Sebuah layanan tetap "Stopped" setelah Start all

Start all tidak menampilkan error per layanan. Klik Start di baris itu sendiri untuk melihat alasannya.

"… isn't installed yet: download it from the Binaries panel first"

Kata-kata versi lama. Pasang layanannya dari barisnya di halaman Services, atau dari Install version di halaman Switch.

PostgreSQL "refuses to run with administrator rights"

Rezure dijalankan dengan Run as administrator. Tutup lalu buka secara normal.

Database macet di "Starting…" atau "stopped responding"

Buka log-nya dari barisnya. Database yang sedang pulih setelah crash atau force stop bisa butuh waktu dan mencetak progres selama berjalan. Lihat Layanan.

PHP terus crash dan "automatic restart paused"

Cek halaman Log yang difilter ke php untuk alasannya. Kalau kamu baru saja menambahkan file ke C:\rezure\etc\php\conf.d, pengaturan yang tidak valid di sana patut dicurigai: pindahkan file-nya keluar, lalu jalankan PHP lagi.

Situs

myapp.test sama sekali tidak terbuka

1. Di halaman Projects, apakah domainnya berwarna aksen? Kalau tidak, klik Sync hosts file dan setujui prompt administrator.
2. Apakah Nginx berjalan?
3. Coba jendela browser private, siapa tahu kegagalan lama tersimpan di cache.

Prompt hosts terus muncul lagi

Tool lain (biasanya Laragon atau XAMPP) menulis ulang file hosts dan menghapus baris milik Rezure. Hentikan tool itu atau matikan fitur pengelolaan hosts-nya.

502 Bad Gateway

Nginx berjalan tetapi layanan PHP yang dipakai proyek tidak. Jalankan PHP. Atau, untuk proyek yang dikunci, baris PHP x.y.z-nya.

Proyek bertuliskan "Not served"

Nama foldernya berisi underscore, spasi, atau karakter lain yang tidak boleh ada di domain. Ganti namanya dengan huruf, angka, dan tanda hubung. Lihat Proyek.

Situs Symfony atau CodeIgniter 4 menjawab 404

Sejak Rezure 3.3 keduanya dideteksi dan dilayani dari public\. Kalau situs masih menjawab 404, berarti dilayani dari folder yang salah: arahkan kursor ke badge framework proyek untuk mengecek, lalu klik dan pilih framework yang benar, atau Custom folder…. Tautan lama ke folder public\ proyek sebaiknya dihapus dan folder proyeknya ditambahkan. Lihat Framework.

"This project's dev server isn't running"

Proyek Vite, Next.js, Nuxt, Astro, atau Node dilayani oleh dev server-nya sendiri, dan tidak ada yang menjawab di port-nya. Klik Open, atau Start di Dev servers pada halaman Projects. Lihat Dev Server.

Dev server tidak mau start

Dialog Dev servers menyebut alasan dan perbaikannya: dependency belum terpasang (npm install), versi Node.js yang belum terpasang, script yang tidak ada, atau salinan yang sudah berjalan di terminal (Stop it and start here). Lihat Dev Server.

Vite bilang "Blocked request. This host is not allowed"

Versi Vite-mu terlalu lama untuk menerima domain yang diteruskan Rezure. Tambahkan server: { allowedHosts: ['.test'] } ke vite.config. Lihat Dev Server.

Halaman kosong atau error 500 dari Laravel

Alasannya ada di storage\logs\laravel.log di dalam proyek. Ekstensi PHP yang hilang adalah penyebab paling umum; jalankan Cek Kebutuhan.

"cURL error 60: SSL certificate problem"

PHP tidak punya bundel CA. Di halaman Switch, klik Download di kartu CA certificates, lalu restart PHP. Lihat Konfigurasi PHP.

"413 Request Entity Too Large" saat upload

Nginx menerima body request sampai 64 MB. Upload yang lebih besar ditolak sebelum PHP melihatnya, apa pun nilai upload_max_filesize.

Request panjang berhenti setelah lima menit

max_execution_time milik PHP dan timeout FastCGI milik Nginx sama-sama 300 detik. Untuk pekerjaan yang lebih lama, jalankan dari terminal proyek atau queue worker.

Pengaturan di php.ini tidak berpengaruh

Rezure menulis ulang php.ini miliknya setiap kali start. Taruh pengaturanmu di C:\rezure\etc\php\conf.d lalu restart PHP. Lihat Konfigurasi PHP.

PHP dan terminal

"could not find driver"

Ekstensi PDO untuk database-mu mati atau tidak ada untuk versi PHP yang dipakai proyek: pdo_pgsql untuk PostgreSQL (mati secara default), pdo_sqlsrv untuk SQL Server (pasang dulu). Nyalakan di Ekstensi PHP, lalu restart PHP.

php -v di terminal menampilkan versi yang salah

Jalankan where php. Terminal yang dibuka dari baris proyek memakai versi proyek itu. Di tempat lain, php adalah apa pun yang ada di urutan pertama PATH; aktifkan Use Rezure's PHP everywhere, dan hapus PHP lain dari PATH sistem, yang dibaca Windows lebih dulu.

Ekstensi berfungsi di situs tetapi tidak di terminal

Situs dan terminal membaca file php.ini yang berbeda. Lihat Ekstensi PHP.

composer is not recognized

Rezure tidak menaruh Composer di PATH. Lihat Terminal Proyek.

Database

"MariaDB isn't running, so there's nothing to list yet"

Jalankan database dari halaman Services, lalu klik ikon refresh di halaman Databases. Pesan yang sama muncul saat profil MySQL aktif.

Access denied di direktori data Laragon atau XAMPP yang diadopsi

Rezure membaca server lokal sebagai root dengan password kosong. Lihat MariaDB & MySQL.

"Unknown collation utf8mb4_0900_ai_ci" saat impor

Dump MySQL 8 yang masuk ke MariaDB. Ganti dengan utf8mb4_unicode_ci di file-nya.

Database PostgreSQL-ku hilang setelah ganti versi

Setiap versi major punya folder datanya sendiri. Pindah kembali untuk melihatnya; ekspor dan impor untuk memindahkannya. Lihat PostgreSQL.

Koneksi remote gagal

Lihat bagian pemecahan masalah di Database Remote.

"Access denied (using password: NO)" saat membuka database remote di client

Simpan password koneksi di Rezure: sejak 3.3, Open menyerahkan password tersimpan ke TablePlus, DBeaver, HeidiSQL, dan MariaDB console, termasuk lewat SSH tunnel. MySQL Workbench memintanya sendiri. Lihat Database Remote.

Email

Email tidak pernah sampai ke inbox Mailpit

Cek berurutan: Mailpit berjalan; .env berisi MAIL_HOST=127.0.0.1 (bukan mailpit) dan MAIL_PORT=1025 (bukan 2525); kamu sudah menjalankan php artisan config:clear kalau konfigurasi di-cache; email di antrean butuh php artisan queue:work yang berjalan. Lihat Mailpit.

Berbagi

Link berbagi tidak termuat, atau modal-nya macet

Lihat Berbagi Proyek.

Pembaruan

Aku tahu ada versi baru, tetapi Changelog tidak menampilkan pembaruan

Pengecekan pembaruan yang gagal terlihat sama seperti "tidak ada pembaruan". Pastikan kamu online lalu buka Changelog lagi. Kamu selalu bisa memasang versi terbaru dari halaman unduhan di atas versi yang sekarang.

Masih buntu?

Kirim laporan dari halaman Feedback di aplikasi. Centang Attach latest log supaya pengelola bisa melihat apa yang terjadi; log bisa berisi path folder, jadi baca dulu. Atau buka issue di GitHub.

Terkait

• FAQ: pertanyaan umum
• Log: tempat pertama untuk dicek