Cara Backup dan Setting Folder htdocs & MySQL Pada Xampp Windows

anaksmanda.com - Saat mengembangkan website menggunakan XAMPP, kita perlu mengelola file proyek dan database dengan baik. Salah satu langkah penting adalah melakukan pencadangan atau backup agar data tetap aman ketika ingin mengganti komputer, memperbarui XAMPP, atau memindahkan proyek ke drive lain.

Secara default, file proyek website biasanya disimpan di folder htdocs, sedangkan database dikelola oleh layanan MariaDB atau MySQL yang disertakan dalam XAMPP. Kalian dapat memindahkan lokasi penyimpanan proyek, tetapi proses pemindahan database perlu dilakukan dengan hati-hati agar data tidak rusak atau tidak terbaca.

Sebelum melanjutkan, pastikan kalian sudah memahami dasar penggunaan XAMPP. Jika belum, silakan baca artikel Mengenal XAMPP dan Tutorial Instalasi XAMPP.

Mengapa Perlu Backup Folder XAMPP?

Backup diperlukan untuk melindungi file proyek dan database dari kehilangan data. Beberapa kondisi yang membuat pencadangan menjadi penting antara lain:

• Memindahkan proyek website ke komputer atau laptop lain.
• Mengganti drive penyimpanan, misalnya dari drive C ke drive D.
• Memperbarui atau memasang ulang XAMPP.
• Menyimpan salinan proyek di hard disk eksternal atau media penyimpanan lain.
• Mengantisipasi kerusakan sistem atau kesalahan konfigurasi.

Secara umum, ada dua hal utama yang harus dicadangkan, yaitu file website di folder htdocs dan database yang dikelola oleh MariaDB atau MySQL. Keduanya memiliki metode pencadangan yang berbeda.

1. Mengenal Lokasi Folder XAMPP

Jika XAMPP dipasang menggunakan konfigurasi standar di Windows, direktori utamanya biasanya berada di C:\xampp. Di dalamnya terdapat beberapa folder penting.

• C:\xampp\htdocs: tempat menyimpan file proyek website, seperti HTML, PHP, CSS, JavaScript, dan gambar.
• C:\xampp\mysql: berisi komponen layanan database MariaDB/MySQL yang disertakan dalam XAMPP.
• C:\xampp\apache\conf: berisi konfigurasi Apache, termasuk file httpd.conf.

Lokasi tersebut dapat berbeda jika kalian memasang XAMPP di drive atau folder lain. Pastikan menggunakan direktori instalasi yang benar sebelum mengikuti langkah berikutnya.

2. Cara Backup Folder htdocs

Folder htdocs berisi file proyek website yang kalian buat. Untuk mencadangkannya, kalian tidak perlu mengubah konfigurasi Apache terlebih dahulu.

1. Hentikan Apache dari XAMPP Control Panel jika ingin memastikan tidak ada file yang sedang ditulis oleh aplikasi.
2. Buka File Explorer Windows.
3. Masuk ke folder instalasi XAMPP, biasanya C:\xampp.
4. Salin folder htdocs.
5. Tempelkan salinan tersebut ke lokasi backup, misalnya D:\Backup_XAMPP\htdocs.
6. Periksa beberapa file dan folder di lokasi tujuan untuk memastikan proses penyalinan berhasil.

Jika proyek menggunakan file konfigurasi khusus, file unggahan pengguna, atau file lain di luar htdocs, cadangkan juga direktori tersebut. Beberapa aplikasi PHP menyimpan file konfigurasi dan unggahan pada lokasi yang ditentukan oleh pengembang aplikasi.

3. Cara Memindahkan Lokasi Folder htdocs

Jika kalian ingin menyimpan proyek website di drive lain tanpa memindahkan seluruh instalasi XAMPP, lokasi dokumen Apache dapat diubah melalui file konfigurasi httpd.conf.

Contoh pada tutorial ini menggunakan lokasi baru D:\Anaksmanda_web\htdocs. Silakan ganti dengan folder yang benar-benar tersedia di komputer kalian.

Langkah 1: Salin proyek ke lokasi baru

Buat folder tujuan, kemudian salin isi folder C:\xampp\htdocs ke D:\Anaksmanda_web\htdocs. Pastikan seluruh file proyek yang diperlukan sudah tersalin sebelum mengubah konfigurasi Apache.

Langkah 2: Buka file httpd.conf

Buka XAMPP Control Panel, lalu klik tombol Config pada baris Apache. Pilih Apache (httpd.conf) jika opsi tersebut tersedia. Cara lainnya, buka file berikut menggunakan editor teks:

C:\xampp\apache\conf\httpd.conf

Sebaiknya buat salinan file konfigurasi tersebut terlebih dahulu agar kalian dapat memulihkan pengaturan sebelumnya jika terjadi kesalahan.

Langkah 3: Cari konfigurasi DocumentRoot

Gunakan fitur pencarian editor teks untuk menemukan baris DocumentRoot dan bagian Directory yang mengarah ke folder htdocs. Konfigurasi standar biasanya terlihat seperti berikut:

DocumentRoot "C:/xampp/htdocs" <Directory "C:/xampp/htdocs"> Options Indexes FollowSymLinks Includes ExecCGI AllowOverride All Require all granted </Directory>

Konfigurasi lengkap pada komputer kalian mungkin berisi direktif tambahan. Jangan menghapus pengaturan lain yang tidak berkaitan dengan perubahan lokasi dokumen.

Langkah 4: Ubah lokasi DocumentRoot

Sesuaikan nilai DocumentRoot dan jalur pada tag Directory agar keduanya menunjuk ke folder yang sama.

DocumentRoot "D:/Anaksmanda_web/htdocs" <Directory "D:/Anaksmanda_web/htdocs"> Options Indexes FollowSymLinks Includes ExecCGI AllowOverride All Require all granted </Directory>

Contoh di atas hanya menunjukkan bagian konfigurasi yang relevan. Pertahankan direktif lain dari konfigurasi asli jika masih diperlukan oleh aplikasi kalian.

Gunakan tanda garis miring / pada path contoh tersebut dan pastikan folder tujuan benar-benar tersedia. Jangan menambahkan spasi yang tidak diperlukan di dalam path.

Langkah 5: Simpan dan uji konfigurasi Apache

1. Simpan perubahan pada file httpd.conf.
2. Buka XAMPP Control Panel.
3. Jalankan Apache kembali.
4. Buka browser dan kunjungi http://localhost/.
5. Uji salah satu proyek untuk memastikan file website terbaca dari lokasi baru.

Jika Apache gagal dijalankan, periksa pesan kesalahan pada XAMPP Control Panel dan log Apache. Pastikan path benar, folder dapat diakses, dan tidak ada kesalahan penulisan pada konfigurasi.

4. Cara Backup Database XAMPP dengan phpMyAdmin

Database tidak sebaiknya dipindahkan hanya dengan menyalin folder data ketika layanan database sedang berjalan. Cara yang lebih aman untuk penggunaan umum adalah mengekspor database ke file SQL, kemudian mengimpornya kembali ketika diperlukan.

Langkah 1: Jalankan layanan database

Buka XAMPP Control Panel, kemudian jalankan layanan MySQL yang pada versi XAMPP modern umumnya menggunakan MariaDB. Setelah layanan aktif, buka:

http://localhost/phpmyadmin

Langkah 2: Pilih database yang akan dicadangkan

Pada panel sebelah kiri phpMyAdmin, pilih database proyek yang ingin disimpan. Jangan memilih database sistem secara sembarangan jika kalian belum memahami fungsinya.

Langkah 3: Ekspor database

1. Klik menu Export.
2. Pilih metode ekspor Quick untuk pengaturan sederhana atau Custom jika membutuhkan opsi tambahan.
3. Pilih format SQL.
4. Jalankan proses ekspor dan simpan file hasilnya ke folder backup di luar direktori XAMPP.

Contohnya, file backup dapat disimpan di D:\Backup_XAMPP\database_proyek.sql. Jika memiliki beberapa database, ekspor masing-masing database yang dibutuhkan dan gunakan nama file yang mudah dikenali.

5. Cara Memindahkan Database ke Lokasi atau Instalasi XAMPP Lain

Jika tujuan kalian adalah memindahkan proyek ke instalasi XAMPP baru atau komputer lain, gunakan file SQL hasil ekspor untuk memulihkan database. Metode ini lebih mudah dipindahkan antarinstalasi dibandingkan menyalin file data internal secara langsung.

Langkah 1: Pasang dan jalankan XAMPP tujuan

Pastikan XAMPP pada komputer tujuan sudah terpasang dan layanan database dapat berjalan. Perhatikan juga kompatibilitas versi MariaDB/MySQL, terutama jika aplikasi menggunakan fitur database tertentu.

Langkah 2: Buat database baru

Buka http://localhost/phpmyadmin, kemudian buat database dengan nama yang sesuai kebutuhan aplikasi. Jika aplikasi membutuhkan pengaturan karakter tertentu, sesuaikan kolasi database dengan kebutuhan proyek.

Langkah 3: Impor file SQL

1. Pilih database tujuan di phpMyAdmin.
2. Klik menu Import.
3. Pilih file SQL yang sebelumnya telah dicadangkan.
4. Periksa format file dan jalankan proses impor.
5. Tunggu hingga proses selesai, kemudian periksa tabel dan data yang berhasil dipulihkan.

Jika file SQL terlalu besar untuk diunggah melalui phpMyAdmin, kalian mungkin perlu menggunakan metode impor melalui command line atau menyesuaikan batas unggahan sesuai kebutuhan. Jangan mengubah konfigurasi server tanpa memahami dampaknya.

Langkah 4: Sesuaikan konfigurasi aplikasi

Setelah database dipulihkan, periksa file konfigurasi proyek PHP. Pastikan nama database, nama pengguna, kata sandi, dan alamat server sesuai dengan instalasi tujuan. Jika nama database berubah, konfigurasi aplikasi juga perlu diperbarui.

6. Mengapa Tidak Disarankan Langsung Mengubah datadir di my.ini?

Pada instalasi XAMPP lama, pengguna mungkin menemukan petunjuk yang menyarankan mengubah nilai datadir, innodb_data_home_dir, dan innodb_log_group_home_dir di file my.ini. Pengaturan tersebut berkaitan dengan lokasi penyimpanan internal database.

Namun, konfigurasi database dapat berbeda berdasarkan versi XAMPP dan MariaDB/MySQL yang digunakan. Memindahkan folder data secara langsung tanpa prosedur yang sesuai dapat menyebabkan layanan database gagal berjalan, file data tidak cocok dengan versi server, atau database tidak dapat dibuka.

Untuk itu, gunakan metode ekspor dan impor melalui phpMyAdmin untuk pencadangan dan pemindahan database biasa. Jika kalian memang harus mengubah lokasi penyimpanan internal database, pelajari dokumentasi untuk versi server yang digunakan, hentikan layanan dengan benar, simpan salinan cadangan lengkap, dan pastikan semua direktif terkait sudah sesuai.

Perlu dibedakan pula antara memindahkan folder proyek htdocs dengan memindahkan seluruh instalasi XAMPP. Jika seluruh instalasi XAMPP dipindahkan ke direktori lain, dokumentasi resmi XAMPP menjelaskan penggunaan skrip setup_xampp.bat pada distribusi yang mendukungnya untuk menyesuaikan konfigurasi path. Periksa petunjuk resmi sesuai paket yang digunakan.

7. Cara Memeriksa Apakah Backup Berhasil

Backup belum dapat dianggap berhasil hanya karena file sudah tersalin. Lakukan pemeriksaan sederhana untuk memastikan proyek dan database dapat digunakan kembali.

• Pastikan folder backup berisi file proyek yang diperlukan.
• Pastikan file SQL hasil ekspor tersimpan dan ukurannya masuk akal.
• Coba impor file SQL ke database uji jika memungkinkan.
• Jalankan aplikasi dan periksa apakah halaman dapat dibuka.
• Uji fitur yang menggunakan database, seperti login, daftar data, atau formulir.
• Simpan satu salinan backup di lokasi berbeda dari drive tempat XAMPP dipasang.

Pengujian pemulihan sangat penting karena file backup yang rusak atau tidak lengkap tidak akan membantu ketika terjadi kehilangan data.

Masalah yang Sering Terjadi

Apache tidak bisa dijalankan setelah mengganti DocumentRoot

Periksa kembali path pada DocumentRoot dan bagian Directory. Pastikan folder tujuan tersedia, tanda kutip sudah benar, dan tidak ada kesalahan sintaks pada file konfigurasi. Periksa log Apache untuk mengetahui pesan kesalahan yang lebih spesifik.

Database tidak muncul setelah dipindahkan

Pastikan proses impor SQL selesai tanpa kesalahan dan kalian memilih database yang benar. Periksa juga apakah aplikasi terhubung ke nama database yang sama dengan yang sudah dibuat.

Aplikasi PHP mengalami error koneksi database

Periksa host database, nama database, nama pengguna, kata sandi, serta port yang digunakan. Pengaturan di instalasi baru mungkin tidak sama dengan pengaturan di komputer sebelumnya.

File SQL gagal diimpor

Periksa pesan kesalahan, ukuran file, kompatibilitas versi server, dan batas unggahan phpMyAdmin. Untuk file berukuran besar, gunakan metode impor yang sesuai daripada memecah atau mengubah file SQL secara sembarangan.

Baca Juga

• Mengenal XAMPP dan Tutorial Instalasi XAMPP
• Cara Mempercepat Loading Blog Blogger
• Cara Membuat Blog di Blogger untuk Pemula

Kesimpulan

Backup dan pemindahan folder XAMPP perlu dilakukan dengan metode yang sesuai agar file proyek dan database tetap aman. Folder htdocs dapat dicadangkan dan dipindahkan ke lokasi lain, lalu Apache disesuaikan melalui konfigurasi DocumentRoot dan bagian Directory.

Sementara itu, untuk mencadangkan dan memindahkan database, metode ekspor dan impor melalui phpMyAdmin merupakan pilihan yang lebih aman bagi kebanyakan pengguna. Hindari mengubah lokasi internal folder data database tanpa memahami konfigurasi dan versi server yang digunakan.

Biasakan menyimpan backup di lokasi terpisah dan menguji hasil pemulihan secara berkala. Dengan begitu, proyek website kalian lebih siap menghadapi risiko kehilangan data, pemindahan komputer, maupun pembaruan perangkat lunak.