Windows’ta WSL ile web geliştirme düzenim
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
-
WSL ve Ubuntu. İşin en kolay kısmı burası. PowerShell'e tek satır yazıp bilgisayarı yeniden başlatıyorsun:
wsl --install -d Ubuntu-26.04 -
Apache, PHP ve MariaDB. Ubuntu'da hepsi
aptile geliyor. Bir şey indirip kurulum sihirbazında "İleri" demek yok: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 -
Apache'nin ayarı. İlk ciddi takıldığım yer burası oldu. Apache normalde
www-dataadı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'datempnam()diye bir hata var. Meğer Ubuntu 26.04, güvenlik için Apache'nin ev klasörüne yazmasını engelliyormuş. Laravel destorageklasörüne yazamayınca patlıyormuş. Şu birkaç satırla ikisini birden çözdüm: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 apache2Bunu sadece kendi bilgisayarında yap, canlı sunucuda değil.
-
Her projeye kendi adresi. XAMPP'ta her şey
localhost/projegibi bir alt klasördeydi. Şimdi her projenin kendi adresi var,crm.localhostgibi. Projeleri~/sitesaltında tutuyorum. Windows diskinde, yani/mnt/caltı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üzdennewsitediye küçük bir fonksiyon yazdım: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ınArka planda yaptığı şey aslında basit. Apache'ye şöyle bir dosya yazıyor, Laravel projesiyse kökü
public/klasörü yapıyor:<VirtualHost *:80> ServerName crm.localhost DocumentRoot /home/kullanici/sites/crm/public <Directory /home/kullanici/sites/crm/public> AllowOverride All Require all granted </Directory> </VirtualHost>.localhostile biten adresler tarayıcıda kendiliğinden bilgisayarın kendisine gidiyor.hostsdosyasını bir kere bile açmadım. -
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
;5Dyazdı. Birkaçbindkeysatı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.livedüz PHP projelerinde kaydettikçe sayfayı yeniliyor.sharesiteyi geçici bir linkle dışarı açıyor.logshata kayıtlarını VS Code'da açıyor.grabWindows'taki dosyayı bulunduğum klasöre çekiyor. Hepsini unutmamak için decmdsdiye bir komut yazdım, bana kendi komutlarımı listeliyor. Bir keresindenewsiteyerinenewwsiteyazdım ve terminal her seferinde bu yanlışı önermeye başladı. Onun için de geçmişten komut silenforget'i yazdım. Kendi derdime kendim çare buluyorum yani. -
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.enviçinde iki satır değiştirmek yetiyor:MAIL_MAILER=smtp MAIL_PORT=1025 -
Müşteriye göstermek.
sharekomutu 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:->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.phpya da.envgibi 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:
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:
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:
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.