Cara Mengubah Konfigurasi Database Magento 1 & 2 Saat Migrasi Server

Bagi pengembang atau pemilik toko online, proses migrasi server adalah hal yang lumrah dilakukan untuk meningkatkan performa situs. Jika Anda menggunakan Magento, satu langkah krusial yang tidak boleh terlewatkan adalah menyesuaikan konfigurasi database. Tanpa pengaturan yang tepat, situs Anda dipastikan akan mengalami error koneksi database.

Meskipun sama-sama berbasis PHP, Magento 1 dan Magento 2 memiliki struktur file konfigurasi yang sangat berbeda. Di artikel ini, kita akan bedah langkah praktis untuk mengedit file tersebut agar proses pindah server Anda berjalan mulus.

Mengapa Konfigurasi Database Ini Begitu Vital?

Sederhananya, file konfigurasi database adalah “jembatan” yang menghubungkan file sistem Magento dengan data produk, pesanan, dan pelanggan Anda. Saat Anda pindah hosting atau server, detail seperti alamat host, username, hingga password database biasanya berubah.

Jika bridge ini tidak diperbarui, Magento tidak akan tahu ke mana harus mengambil data, dan hasilnya situs Anda hanya akan menampilkan halaman blank atau pesan kesalahan.

1. Konfigurasi Database di Magento 1

Pada versi lawas namun masih banyak digunakan ini, semua rahasia koneksi tersimpan dalam sebuah file XML.

Lokasi File

Silakan akses direktori instalasi Magento Anda dan temukan file local.xml di jalur berikut: ROOT_INSTALASI / app / etc / local.xml

Cara Edit

Cari blok kode <connection>. Di sana, Anda perlu menyesuaikan beberapa nilai utama:

Host: Alamat server database (biasanya localhost).
Username & Password: Kredensial baru untuk akses database.
Dbname: Nama database yang Anda gunakan di server baru.

Contoh Struktur Kode:

<resources>
    <default_setup>
        <connection>
            <host><![CDATA[localhost]]></host>
            <username><![CDATA[username_baru]]></username>
            <password><![CDATA[password_baru]]></password>
            <dbname><![CDATA[nama_database]]></dbname>
            <active>1</active>
        </connection>
    </default_setup>
</resources>

2. Konfigurasi Database di Magento 2

Magento 2 membawa perubahan besar dalam struktur file. Alih-alih menggunakan XML, versi ini beralih ke format PHP array yang jauh lebih modern dan efisien bagi sistem.

Lokasi File

Buka folder root Magento 2 Anda, lalu cari file env.php di folder: ROOT_INSTALASI / app / etc / env.php

Cara Edit

Meski formatnya berbeda, variabel yang perlu Anda ubah tetaplah sama dengan versi sebelumnya. Cari bagian array 'db' untuk melakukan penyesuaian:

Contoh Struktur Kode:

'db' => [
    'connection' => [
        'default' => [
            'host' => 'localhost',
            'dbname' => 'magento_db_baru',
            'username' => 'user_baru',
            'password' => 'pass_baru',
            'active' => '1'
        ]
    ]
],

Tips Tambahan Setelah Edit Konfigurasi

Berdasarkan pengalaman di lapangan, mengedit file saja terkadang belum cukup. Berikut adalah dua hal yang wajib Anda lakukan setelah mengubah konfigurasi database:

Flush Cache: Pastikan Anda menghapus cache secara manual dengan menghapus isi folder var/cache dan var/page_cache.
Cek Hak Akses (Permissions): Pastikan file local.xml atau env.php memiliki izin akses yang benar agar sistem bisa membacanya, namun tetap aman dari pihak luar (biasanya permission 644 atau 600).

Mengubah konfigurasi database Magento sebenarnya cukup sederhana asalkan Anda teliti dengan detail kredensialnya. Jika Anda menemui kendala atau muncul pesan error setelah pengeditan, jangan ragu untuk berdiskusi di kolom komentar di bawah ini!