TR EN
erengelgec.dev

Ben Eren, full-stack web geliştirici.

Şu an yeni projelere açığım.

Gökyüzü

TR EN

© 2026 Eren Gelgeç

← Blog

Windows’ta WSL ile web geliştirme düzenim

Koyu terminal penceresinde newsite ve share komutlarının çıktısı, yanında “XAMPP’ı bıraktım” başlığı

Uzun süre XAMPP kullandım. Kontrol panelini açar, Apache ile MySQL'i başlatır, htdocs içinde çalışırdım. Bitince de dosyaları FileZilla ile hosting'e atardım. Alışmıştım, dokunmuyordum.

Ta ki bilgisayara format atma vakti gelene kadar. Sıfırdan kuracaksam bari düzgün kurayım dedim ve XAMPP'ı bir daha kurmadım. Yerine Windows'un içinde çalışan gerçek bir Linux, yani WSL geldi. Aşağıda bu düzeni ve kurarken başıma gelenleri anlatıyorum. Uzun oldu ama aynı yoldan geçecek biri varsa epey vakit kazandırır diye düşünüyorum.

XAMPP'tan WSL'e neden geçtim

İşlerimin çoğu Laravel, düz PHP ve kurumsal siteler. Hepsi de sonunda Linux bir sunucuda çalışıyor. Ben ise Windows'ta geliştiriyordum. Windows dosya adlarında büyük küçük harfe bakmaz, Linux bakar. Logo.PNG yerelde açılır, canlıda 404 verir. Bu tür sürprizleri canlıda değil kendi bilgisayarımda görmek istiyordum.

Önce Docker'ı düşündüm, Laragon'a da baktım. Docker'dan açıkçası biraz çekiniyordum. Bir projeyi bir süre Docker'da çalıştırdım ama sonunda onu da normal kuruluma taşıdım. Kafamda bir de kural vardı. Ücretli hiçbir şey kullanmayacağım, her şey olabildiğince sade olacak.

Neler kullanıyorum

Windows 11 üzerinde WSL2 ve Ubuntu 26.04. Ubuntu'nun içinde Apache 2.4, PHP 8.5 (PHP-FPM ile) ve MariaDB 11.8 var. PHP paketleri için Composer, ön yüz için fnm ile kurduğum Node 26 LTS kullanıyorum. Editör VS Code, WSL eklentisiyle Ubuntu'ya bağlı çalışıyor. Terminalde zsh var.

Veritabanına HeidiSQL ile bakıyorum, phpMyAdmin'in yerini o aldı. Test e-postaları Mailpit'e düşüyor, tarayıcı testleri için Playwright duruyor. Siteyi müşteriye göstermek için Cloudflare'in ücretsiz tünelini, hosting'e yüklemek için de yine eski dostum FileZilla'yı kullanıyorum.

Kurulum adım adım

  1. WSL ve Ubuntu. İşin en kolay kısmı burası. PowerShell'e tek satır yazıp bilgisayarı yeniden başlatıyorsun:

    terminal
    wsl --install -d Ubuntu-26.04
    
  2. Apache, PHP ve MariaDB. Ubuntu'da hepsi apt ile geliyor. Bir şey indirip kurulum sihirbazında "İleri" demek yok:

    bash
    sudo apt install -y apache2 mariadb-server composer \
      php php-cli php-mysql php-mbstring php-xml php-curl php-zip php-intl php-gd php-bcmath
    sudo a2enmod rewrite
    
  3. Apache'nin ayarı. İlk ciddi takıldığım yer burası oldu. Apache normalde www-data adında ayrı bir kullanıcıyla çalışıyor ve dosya izinleri sürekli başını ağrıtıyor. Geliştirme makinesinde kendi kullanıcımla çalıştırmaya karar verdim. Derken ilk Laravel projemi açtım, sayfa 500 verdi. Log'da tempnam() diye bir hata var. Meğer Ubuntu 26.04, güvenlik için Apache'nin ev klasörüne yazmasını engelliyormuş. Laravel de storage klasörüne yazamayınca patlıyormuş. Şu birkaç satırla ikisini birden çözdüm:

    bash
    sudo sed -i "s/=www-data/=$USER/g" /etc/apache2/envvars
    sudo mkdir -p /etc/systemd/system/apache2.service.d
    printf '[Service]\nReadWritePaths=%s/sites\nMemoryDenyWriteExecute=no\n' "$HOME" \
      | sudo tee /etc/systemd/system/apache2.service.d/dev.conf
    sudo systemctl daemon-reload && sudo systemctl restart apache2
    

    Bunu sadece kendi bilgisayarında yap, canlı sunucuda değil.

  4. Her projeye kendi adresi. XAMPP'ta her şey localhost/proje gibi bir alt klasördeydi. Şimdi her projenin kendi adresi var, crm.localhost gibi. Projeleri ~/sites altında tutuyorum. Windows diskinde, yani /mnt/c altında çalışmak her şeyi çok yavaşlatıyor, o yüzden projeler hep Linux tarafında. Her proje için Apache ayarı elle yazmak da can sıkıcı olacaktı. Bu yüzden newsite diye küçük bir fonksiyon yazdım:

    bash
    newsite crm             # http://crm.localhost hazır, klasör yoksa oluşturur
    newsite eski-site 8.2   # eski bir müşteri sitesi PHP 8.2 ile çalışsın
    

    Arka planda yaptığı şey aslında basit. Apache'ye şöyle bir dosya yazıyor, Laravel projesiyse kökü public/ klasörü yapıyor:

    /etc/apache2/sites-available/crm.conf
    <VirtualHost *:80>
      ServerName crm.localhost
      DocumentRoot /home/kullanici/sites/crm/public
      <Directory /home/kullanici/sites/crm/public>
        AllowOverride All
        Require all granted
      </Directory>
    </VirtualHost>
    

    .localhost ile biten adresler tarayıcıda kendiliğinden bilgisayarın kendisine gidiyor. hosts dosyasını bir kere bile açmadım.

  5. Terminal. Ubuntu'nun düz terminalini görünce açıkçası biraz soğudum. zsh kurdum, üstüne Powerlevel10k ile bir tema, yazarken geçmişten öneri getiren bir eklenti. Kurduktan hemen sonra Ctrl ve ok tuşlarıyla kelime atlamaya çalıştım, ekrana ;5D yazdı. Birkaç bindkey satırıyla düzeldi ama ilk anda ne olduğunu anlamadım. Sonra sık yaptığım her işi kısa bir komuta çevirdim. live düz PHP projelerinde kaydettikçe sayfayı yeniliyor. share siteyi geçici bir linkle dışarı açıyor. logs hata kayıtlarını VS Code'da açıyor. grab Windows'taki dosyayı bulunduğum klasöre çekiyor. Hepsini unutmamak için de cmds diye bir komut yazdım, bana kendi komutlarımı listeliyor. Bir keresinde newsite yerine newwsite yazdım ve terminal her seferinde bu yanlışı önermeye başladı. Onun için de geçmişten komut silen forget'i yazdım. Kendi derdime kendim çare buluyorum yani.

  6. E-posta testi. İletişim formlarını denerken mail yanlışlıkla gerçek birine gitmesin istiyordum. Mailpit tam bunun için var. Projelerin gönderdiği her mail, localhost:8025'teki kutuya düşüyor ve hiçbiri dışarı çıkmıyor. Laravel'de .env içinde iki satır değiştirmek yetiyor:

    .env
    MAIL_MAILER=smtp
    MAIL_PORT=1025
    
  7. Müşteriye göstermek. share komutu Cloudflare üzerinden geçici bir HTTPS linki açıyor, müşteri telefonundan girip bakabiliyor. Kendi sitemi ilk paylaştığımda sayfa stilsiz açıldı. Tarayıcı CSS dosyalarını hâlâ yerel adresten çekmeye çalışıyordu. Laravel'e tünele güvenmesini söyleyince düzeldi:

    bootstrap/app.php
    ->withMiddleware(function (Middleware $middleware): void {
        $middleware->trustProxies(at: ['127.0.0.1', '::1']);
    })
    

    Hosting'e yükleme işi değişmedi, FileZilla ile devam. Tek kuralım var, config.php ya da .env gibi yerel bağlantı dosyaları canlıya asla gitmiyor.

Sabahları artık XAMPP panelinde "Start" düğmesine basmıyorum. Apache ve MariaDB arka planda kendiliğinden açılıyor. Terminali açıp projeye geçiyorum, VS Code'u açıyorum, işe başlıyorum:

bash
z crm          # projeye atla
code .         # VS Code, Ubuntu'ya bağlı açılıyor
npm run dev    # Laravel'deysem. Düz PHP'de live

Çalışıyor mu, nasıl anlıyorum

Uzun proje adlarını her seferinde adres çubuğuna yazmaktan sıkıldım. Ben de localhost adresine kendime küçük bir açılış sayfası yaptım. Bütün projeleri kart kart gösteriyor, yanında türü ve PHP sürümü yazıyor. İki harf yazıp Enter'a basınca site açılıyor. Ortaya çıkınca epey hoşuma gitti, itiraf edeyim.

Bir site açılmıyorsa da paniğe kapılmadan önce cevap koduna bakıyorum:

bash
curl -I http://crm.localhost

500 gelirse sorun PHP'de, 301 gelirse bir yönlendirme var demektir. Sonra logs yazıp hata kayıtlarına bakıyorum. Çoğu zaman cevap orada oluyor.

Başıma gelen hatalar

Site açılmıyor, adres kendiliğinden https:// oluyor. XAMPP'tan getirdiğim bir projede yaşadım. Tarayıcı "bağlantı reddedildi" diyordu. Başka tarayıcıdan girdim, yine aynı. Meğer canlı sitenin .htaccess dosyasında herkesi HTTPS'e yönlendiren bir kural varmış. Yerelde HTTPS olmadığı için de site hiç açılmıyormuş. Kuralın üstüne tek satır ekledim, yerelde artık yönlendirmiyor, canlıda eskisi gibi çalışıyor:

.htaccess
RewriteCond %{HTTP_HOST} !\.localhost$ [NC]
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Laravel projesi açılmıyor. Bir projede newsite'ı dosyaları kopyalamadan önce çalıştırmışım. Fonksiyon public/ klasörünü bulamayınca kökü proje klasörü yapmış. Bu hem siteyi bozuyor hem de .env dosyasını tarayıcıdan okunur hale getiriyor. Dosyalar yerine gelince newsite'ı bir kez daha çalıştırmak yetti.

Klasörde garip :Zone.Identifier dosyaları. Windows Gezgini'nden WSL'e internetten indirilmiş dosyaları sürükleyince her birinin yanında bir tane çıkıyor. Windows'un "bu dosya internetten geldi" notu bunlar. Artık kopyalamayı terminalden grab ile yapıyorum, bu dosyalar hiç oluşmuyor.

HeidiSQL'de içe aktarma. Bir yedeği içe aktarırken önce kodlama uyarısı aldım, sonra da "tablo zaten var" hatası. Yarım kalan ilk deneme birkaç tablo oluşturmuş. Veritabanını boşaltıp dosyayı açarken alttan UTF-8'i seçince sorunsuz geldi.

Kısacası

Kurarken birkaç kez takıldım, yukarıdaki hataların hepsi gerçekten başıma geldi. Ama şimdi projelerim canlıya çok daha yakın bir ortamda çalışıyor, sık yaptığım her şey de tek bir komut.

İletişim

Bir projen mi var? Konuşalım.

Şu an yeni projelere açığım.