WampServer, XAMPP veya Laragon'dan geçiş

Coduva diğer yerel sunuculara dokunmaz; onların dosyalarını, ayarlarını ve veritabanlarını olduğu gibi bırakır. Bir projeyi taşımak için dosyaları ve veritabanını bu sayfadaki adımlarla siz aktarırsınız.

Otomatik göç sihirbazı planlanıyor

WampServer, XAMPP ve Laragon'daki projeleri ve veritabanlarını tek seferde içe aktaran bir sihirbaz v1.x için planlanıyor. O zamana kadar aşağıdaki elle yöntem kullanılır. Bkz. yol haritası.

Başlamadan önce

İki yerel sunucu aynı anda aynı portu kullanamaz. Web sunucuları 80'i, veritabanları 3306'yı ister. WampServer, XAMPP veya Laragon çalışıyorsa Coduva Kontrol merkezinde "Başka bir yerel sunucu algılandı" uyarısını gösterir; yalnızca kurulu olması uyarı çıkarmaz. Port doluysa servis kartı portu hangi programın tuttuğunu yazar (ör. "Port 80, WampServer tarafından kullanılıyor").

İki seçeneğiniz var:

• Eski sunucuyu durdurun. Taşıma bitince en temiz yol budur.
• Coduva'nın portlarını değiştirin. İki programı bir süre birlikte kullanmak istiyorsanız Ayarlar → Ağ bölümünden Nginx HTTP portu için ör. 8080, MariaDB portu için ör. 3307 yazıp her satırın kendi Kaydet düğmesine tıklayın. Port yalnızca servis durmuşken değiştirilebilir. HTTPS portu (443) 0.2.0 sürümünde değiştirilemez.

Veritabanını dışa aktarmak için eski sunucunun çalışıyor olması gerekir. Bu yüzden önce veritabanını alın, sonra eski sunucuyu durdurun.

1. Veritabanını eski sunucudan dışa aktarın

Eski sunucunuzun phpMyAdmin'ini açın (WampServer ve XAMPP'ta genellikle http://localhost/phpmyadmin/):

1. Soldan projenin veritabanını seçin.
2. Dışa aktar sekmesine geçin.
3. Biçim olarak SQL seçin ve dosyayı indirin, ör. magaza.sql.

Komut satırını tercih ediyorsanız eski sunucunun mysqldump aracını kullanabilirsiniz. Aracın yolu sunucuya ve sürüme göre değişir:

mysqldump -u root -p --default-character-set=utf8mb4 magaza > magaza.sql

Dosya hazır olunca eski sunucuyu durdurun.

2. Proje klasörünü yerleştirin

Klasörü olduğu yerde bırakabilir veya C:\Coduva\www altına kopyalayabilirsiniz. Coduva her iki durumda da çalışır.

Kopyalamanız önerilir; böylece eski sunucuyu kaldırdığınızda proje etkilenmez:

Copy-Item -Recurse "C:\wamp64\www\magaza" "C:\Coduva\www\magaza"

Yol Türkçe karakter içeriyorsa ASCII bir yola taşıyın. Bkz. Türkçe karakterli yollar.

3. Veritabanını Coduva'ya aktarın

1. Veritabanı ekranını açın. MariaDB çalışmıyorsa ekrandaki MariaDB'yi başlat düğmesine tıklayın.
2. Ad alanına bir ad yazın, ör. magaza, ve Veritabanı oluştur düğmesine tıklayın. Ad harf, rakam ve alt çizgi içerebilir.
3. Yeni veritabanının satırındaki İçe aktar düğmesine tıklayın ve 1. adımda aldığınız .sql dosyasını seçin.

Ayrıntılar için Veritabanıyla çalışmak sayfasına bakın.

4. Projeyi ekleyin

1. Projeler → Klasör ekle düğmesine tıklayın.
2. Proje klasörünü seçin. Coduva türünü (WordPress, Laravel veya PHP) ve web kökünü algılar.
3. Projenin eski sunucuda kullandığı sürüme yakın bir PHP sürümü seçin.
4. Ekle düğmesine tıklayın.

Coduva PHP 8.0 ve üzerini destekler. PHP 7.x gerektiren bir proje önce güncellenmelidir.

5. Bağlantı bilgilerini güncelleyin

Coduva'nın MariaDB'si için bağlantı bilgileri şunlardır: sunucu 127.0.0.1, port 3306 (değiştirdiyseniz yeni port), kullanıcı root, parola boş.

WordPress: wp-config.php

define( 'DB_NAME', 'magaza' );
define( 'DB_USER', 'root' );
define( 'DB_PASSWORD', '' );
define( 'DB_HOST', '127.0.0.1:3306' );

DB_HOST için localhost yerine 127.0.0.1:<port> yazın.

Laravel: .env

APP_URL=http://magaza.test
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=magaza
DB_USERNAME=root
DB_PASSWORD=

DB_CONNECTION değerini olduğu gibi bırakabilirsiniz; mysql sürücüsü MariaDB ile de çalışır.

Ardından proje sayfasının Komutlar sekmesinden gerekenleri çalıştırın:

• vendor klasörü yoksa: composer install
• APP_KEY yoksa: artisan key:generate
• public/storage bağlantısı yoksa: artisan storage:link
• Eski önbellekleri temizlemek için: artisan optimize:clear

6. WordPress adreslerini değiştirin

WordPress, eski adresi (ör. http://localhost/magaza) veritabanında saklar. Değiştirmezseniz site sizi eski adrese yönlendirir.

1. Proje sayfasında Araçlar sekmesini açın.
2. Adres değiştir (ara-değiştir) kartında Eski metin alanına http://localhost/magaza yazın (alan projenin yeni adresiyle dolu gelir; onu silin), Yeni metin alanına http://magaza.test yazın.
3. Dene (değiştirme) ile sonucu kontrol edin, sonra Uygula düğmesine tıklayın.

Bu işlem serileştirilmiş verileri bozmadan değiştirir. Ayrıntılar için WordPress sitesi sayfasına bakın.

7. .htaccess kurallarını kontrol edin

WampServer ve XAMPP Apache kullanır; Coduva Nginx kullanır. Nginx .htaccess dosyalarını okumaz.

• WordPress kalıcı bağlantıları ve Laravel rotaları ek ayar gerektirmeden çalışır; Coduva bulunamayan adresleri index.php dosyasına yönlendirir.
• .htaccess içine elle yazdığınız yönlendirme, erişim kısıtlama veya önbellek kuralları uygulanmaz.

Apache desteği v1.x için planlanıyor.

Kontrol listesi

• [ ] Veritabanı eski sunucudan .sql olarak alındı
• [ ] Eski sunucu durduruldu veya Coduva portları değiştirildi
• [ ] Veritabanı Coduva'da oluşturuldu ve içe aktarıldı
• [ ] Proje Klasör ekle ile eklendi, PHP sürümü seçildi
• [ ] wp-config.php veya .env güncellendi
• [ ] WordPress adresleri ara-değiştir ile değiştirildi
• [ ] Site http://ad.test/ adresinde açılıyor

Bir adımda takılırsanız Hata teşhisi ekranında Kontrolleri çalıştır düğmesine tıklayın. Bkz. Sorun giderme.

Sonraki adım: PHP sürümleri ve ayarları.