Laravel Sail ile VSCode’da Xdebug Kurulumu
Merhaba! Bu makalede, Laravel Sail kullanarak geliştirme yaparken Visual Studio Code (VSCode) ile Xdebug’ı nasıl kuracağınızı adım adım açıklayacağım. Xdebug, PHP kodunuzdaki hataları bulmanızı ve uygulamanızın nasıl çalıştığını adım adım izlemenizi sağlayan güçlü bir hata ayıklayıcıdır. Özellikle Laravel gibi karmaşık projelerde geliştirme sürecini oldukça hızlandırır ve kolaylaştırır. İşte, bu süreci adım adım inceleyelim.
1. Adım: Xdebug’ı Docker İçerisine Kurmak
Öncelikle, Laravel Sail’in kullandığı Docker ortamına Xdebug’ı eklememiz gerekiyor. Bunun için Dockerfile’ımızı düzenlememiz gerekmiyor. Sail, Xdebug desteği için sail up -d --xdebug komutunu kullanarak kolaylıkla yapılandırılmayı sağlar. Bu komut ile Docker konteynırlarınızı Xdebug ile birlikte başlatırsınız. Bu komutu çalıştırdıktan sonra, Xdebug, PHP ortamınıza eklenmiş olur. Daha sonraki adımlar, VSCode’u bu kurulum ile entegre etmeyi kapsayacaktır.
2. Adım: VSCode’da PHP Debugger Eklentisini Kurmak
VSCode’u açın ve Extensions (Uzantılar) bölümüne gidin. “PHP Debug” veya benzeri bir arama yaparak, PHP Debug eklentisini bulun ve kurun. Bu eklenti, VSCode’u Xdebug ile iletişim kurması için gerekli olan araçları sağlar. Kurulumdan sonra VSCode’u yeniden başlatmanız gerekebilir. Eklentiyi kurduktan sonra, bir sonraki adıma geçebilirsiniz.
3. Adım: launch.json Dosyasını Oluşturmak
Projenizin kök dizininde, “.vscode” klasörü oluşturun. Bu klasörün içine, “launch.json” adında bir dosya oluşturun. Bu dosya, VSCode’un Xdebug ile nasıl iletişim kuracağını tanımlar. İşte, “launch.json” dosyanız için kullanabileceğiniz bir örnek konfigürasyon:
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003, // Xdebug'ın dinlediği port
"pathMappings": {
"/app": "${workspaceFolder}/app" // Projenizin dizinini eşleştirin
}
}
]
}
Bu konfigürasyonda, port alanını, Sail’in Xdebug’ı dinlediği porta göre ayarlamanız önemlidir. Varsayılan olarak 9003 portu kullanılır. pathMappings alanı, VSCode’daki dosya yollarını, Docker konteynırı içindeki yollarla eşleştirmek için kullanılır. Projenizin yapısına göre bu alanı düzenlemeniz gerekebilir. Bu yapılandırma önemlidir, dikkatlice inceleyin ve gerektiğinde düzenleyin.
4. Adım: php.ini Dosyasını Yapılandırmak
Xdebug’ı etkinleştirmek için PHP konfigürasyon dosyanız olan php.ini dosyasını düzenlemeniz gerekir. Bu dosyayı Laravel Sail ortamında bulmak için php –ini komutunu çalıştırabilirsiniz. Bu komut, kullanılan php.ini dosyasının yolunu gösterir. Bu dosyayı düzenleyerek aşağıdaki satırları ekleyin (eğer zaten varsa, değerlerini doğrulayın):
zend_extension=xdebug
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=host.docker.internal // veya localhost
xdebug.client_port=9003
Bu satırlar, Xdebug’ı etkinleştirir ve VSCode ile bağlantı kurmak için gerekli ayarları yapar. xdebug.client_host alanını, VSCode’un çalıştığı makineye göre ayarlayın. Genellikle “host.docker.internal” Docker konteynırlarından hoste erişim sağlamak için uygun bir değerdir. Ancak, bazı durumlarda “localhost” kullanmanız gerekebilir. Bu aşamada yapılan düzenlemeler çok önemlidir, dikkatlice inceleyin.
5. Adım: Hata Ayıklamanın Başlatılması
Tüm adımları tamamladıktan sonra, VSCode’da “Listen for Xdebug” konfigürasyonunu seçin ve “Başlat” düğmesine tıklayın. Ardından, tarayıcınızda uygulamanızı açın. VSCode, Xdebug bağlantısını algılayacak ve hata ayıklama moduna geçecektir. Artık kodunuzda breakpoint’ler koyabilir ve uygulamanızı adım adım inceleyebilirsiniz. Bu işlemlerden sonra, uygulamanızda hata ayıklamaya başlayabilirsiniz.
Faydalı Kaynaklar
Daha fazla bilgi için aşağıdaki kaynaklara göz atabilirsiniz:
Umarım bu makale, Laravel Sail ortamında VSCode ile Xdebug kurulumunu anlamanıza yardımcı olmuştur. Herhangi bir sorunuz varsa, yorum yapmaktan çekinmeyin. Başarılar!
#Etiketler
Laravel, Sail, Xdebug, VSCode, Hata Ayıklama, Debugging, PHP, Docker, geliştirme, programlama