{"id":6726,"date":"2024-12-16T02:00:18","date_gmt":"2024-12-15T23:00:18","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/laravel-sail-ile-vscodeda-xdebug-kurulumu\/"},"modified":"2024-12-16T02:00:18","modified_gmt":"2024-12-15T23:00:18","slug":"laravel-sail-ile-vscodeda-xdebug-kurulumu","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/laravel-sail-ile-vscodeda-xdebug-kurulumu\/","title":{"rendered":"Laravel Sail ile VSCode’da Xdebug Kurulumu"},"content":{"rendered":"

<\/p>\n

Laravel Sail ile VSCode’da Xdebug Kurulumu<\/p>\n

Merhaba! Bu makalede, Laravel Sail kullanarak geli\u015ftirme yaparken Visual Studio Code (VSCode) ile Xdebug’\u0131 nas\u0131l kuraca\u011f\u0131n\u0131z\u0131 ad\u0131m ad\u0131m a\u00e7\u0131klayaca\u011f\u0131m. Xdebug, PHP kodunuzdaki hatalar\u0131 bulman\u0131z\u0131 ve uygulaman\u0131z\u0131n nas\u0131l \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 ad\u0131m ad\u0131m izlemenizi sa\u011flayan g\u00fc\u00e7l\u00fc bir hata ay\u0131klay\u0131c\u0131d\u0131r. \u00d6zellikle Laravel gibi karma\u015f\u0131k projelerde geli\u015ftirme s\u00fcrecini olduk\u00e7a h\u0131zland\u0131r\u0131r ve kolayla\u015ft\u0131r\u0131r. \u0130\u015fte, bu s\u00fcreci ad\u0131m ad\u0131m inceleyelim.<\/p>\n

1. Ad\u0131m: Xdebug’\u0131 Docker \u0130\u00e7erisine Kurmak<\/h2>\n

\u00d6ncelikle, Laravel Sail’in kulland\u0131\u011f\u0131 Docker ortam\u0131na Xdebug’\u0131 eklememiz gerekiyor. Bunun i\u00e7in Dockerfile’\u0131m\u0131z\u0131 d\u00fczenlememiz gerekmiyor. Sail, Xdebug deste\u011fi i\u00e7in sail up -d --xdebug<\/code> komutunu kullanarak kolayl\u0131kla yap\u0131land\u0131r\u0131lmay\u0131 sa\u011flar. Bu komut ile Docker konteyn\u0131rlar\u0131n\u0131z\u0131 Xdebug ile birlikte ba\u015flat\u0131rs\u0131n\u0131z. Bu komutu \u00e7al\u0131\u015ft\u0131rd\u0131ktan sonra, Xdebug, PHP ortam\u0131n\u0131za eklenmi\u015f olur. Daha sonraki ad\u0131mlar, VSCode’u bu kurulum ile entegre etmeyi kapsayacakt\u0131r.<\/p>\n

2. Ad\u0131m: VSCode’da PHP Debugger Eklentisini Kurmak<\/h2>\n

VSCode’u a\u00e7\u0131n ve Extensions (Uzant\u0131lar) b\u00f6l\u00fcm\u00fcne gidin. “PHP Debug” veya benzeri bir arama yaparak, PHP Debug eklentisini bulun ve kurun. Bu eklenti, VSCode’u Xdebug ile ileti\u015fim kurmas\u0131 i\u00e7in gerekli olan ara\u00e7lar\u0131 sa\u011flar. Kurulumdan sonra VSCode’u yeniden ba\u015flatman\u0131z gerekebilir. Eklentiyi kurduktan sonra, bir sonraki ad\u0131ma ge\u00e7ebilirsiniz.<\/p>\n

3. Ad\u0131m: launch.json Dosyas\u0131n\u0131 Olu\u015fturmak<\/h2>\n

Projenizin k\u00f6k dizininde, “.vscode” klas\u00f6r\u00fc olu\u015fturun. Bu klas\u00f6r\u00fcn i\u00e7ine, “launch.json” ad\u0131nda bir dosya olu\u015fturun. Bu dosya, VSCode’un Xdebug ile nas\u0131l ileti\u015fim kuraca\u011f\u0131n\u0131 tan\u0131mlar. \u0130\u015fte, “launch.json” dosyan\u0131z i\u00e7in kullanabilece\u011finiz bir \u00f6rnek konfig\u00fcrasyon:<\/p>\n

\n{\n    \"version\": \"0.2.0\",\n    \"configurations\": [\n        {\n            \"name\": \"Listen for Xdebug\",\n            \"type\": \"php\",\n            \"request\": \"launch\",\n            \"port\": 9003, \/\/ Xdebug'\u0131n dinledi\u011fi port\n            \"pathMappings\": {\n                \"\/app\": \"${workspaceFolder}\/app\" \/\/ Projenizin dizinini e\u015fle\u015ftirin\n            }\n        }\n    ]\n}\n<\/code><\/pre>\n
Bu konfig\u00fcrasyonda,  port<\/code> alan\u0131n\u0131,  Sail’in Xdebug’\u0131 dinledi\u011fi porta g\u00f6re ayarlaman\u0131z \u00f6nemlidir.  Varsay\u0131lan olarak 9003 portu kullan\u0131l\u0131r.  pathMappings<\/code> alan\u0131,  VSCode’daki dosya yollar\u0131n\u0131,  Docker konteyn\u0131r\u0131 i\u00e7indeki yollarla e\u015fle\u015ftirmek i\u00e7in kullan\u0131l\u0131r.  Projenizin yap\u0131s\u0131na g\u00f6re bu alan\u0131 d\u00fczenlemeniz gerekebilir.  Bu yap\u0131land\u0131rma \u00f6nemlidir,  dikkatlice inceleyin ve gerekti\u011finde d\u00fczenleyin.<\/p>\n
4. Ad\u0131m: php.ini Dosyas\u0131n\u0131 Yap\u0131land\u0131rmak<\/h2>\n
  Xdebug’\u0131 etkinle\u015ftirmek i\u00e7in PHP konfig\u00fcrasyon dosyan\u0131z olan php.ini dosyas\u0131n\u0131 d\u00fczenlemeniz gerekir.  Bu dosyay\u0131 Laravel Sail ortam\u0131nda  bulmak i\u00e7in php –ini komutunu \u00e7al\u0131\u015ft\u0131rabilirsiniz.  Bu komut,  kullan\u0131lan php.ini dosyas\u0131n\u0131n yolunu g\u00f6sterir.  Bu dosyay\u0131 d\u00fczenleyerek a\u015fa\u011f\u0131daki sat\u0131rlar\u0131 ekleyin (e\u011fer zaten varsa,  de\u011ferlerini do\u011frulay\u0131n):<\/p>\n
\nzend_extension=xdebug\nxdebug.mode=debug\nxdebug.start_with_request=yes\nxdebug.client_host=host.docker.internal  \/\/ veya localhost\nxdebug.client_port=9003\n<\/code><\/pre>\n
Bu sat\u0131rlar,  Xdebug’\u0131 etkinle\u015ftirir ve VSCode ile ba\u011flant\u0131 kurmak i\u00e7in gerekli ayarlar\u0131 yapar.  xdebug.client_host<\/code> alan\u0131n\u0131,  VSCode’un \u00e7al\u0131\u015ft\u0131\u011f\u0131 makineye g\u00f6re ayarlay\u0131n.  Genellikle “host.docker.internal”  Docker konteyn\u0131rlar\u0131ndan hoste eri\u015fim sa\u011flamak i\u00e7in uygun bir de\u011ferdir.  Ancak,  baz\u0131 durumlarda  “localhost”  kullanman\u0131z gerekebilir.  Bu a\u015famada yap\u0131lan d\u00fczenlemeler \u00e7ok \u00f6nemlidir, dikkatlice inceleyin.<\/p>\n
5. Ad\u0131m: Hata Ay\u0131klaman\u0131n Ba\u015flat\u0131lmas\u0131<\/h2>\n
T\u00fcm ad\u0131mlar\u0131 tamamlad\u0131ktan sonra,  VSCode’da “Listen for Xdebug” konfig\u00fcrasyonunu se\u00e7in ve  “Ba\u015flat” d\u00fc\u011fmesine t\u0131klay\u0131n.  Ard\u0131ndan,  taray\u0131c\u0131n\u0131zda uygulaman\u0131z\u0131 a\u00e7\u0131n.  VSCode,  Xdebug ba\u011flant\u0131s\u0131n\u0131 alg\u0131layacak ve hata ay\u0131klama moduna ge\u00e7ecektir.  Art\u0131k kodunuzda breakpoint’ler koyabilir ve uygulaman\u0131z\u0131 ad\u0131m ad\u0131m inceleyebilirsiniz.  Bu i\u015flemlerden sonra, uygulaman\u0131zda hata ay\u0131klamaya ba\u015flayabilirsiniz.<\/p>\n
Faydal\u0131 Kaynaklar<\/h2>\n
Daha fazla bilgi i\u00e7in a\u015fa\u011f\u0131daki kaynaklara g\u00f6z atabilirsiniz:<\/p>\n