ServBay'in Dahili Xdebug Modülü Nasıl Etkinleştirilir?

ServBay, güçlü bir entegre web geliştirme aracı olarak Xdebug modülü ile birlikte gelir ve etkinleştirme süreci oldukça basittir. Xdebug, geliştiricilere kod hata ayıklama, performans analizi ve kod kapsam tespiti gibi işlemlerde yardımcı olan bir PHP hata ayıklama ve analiz aracıdır. PHP uygulamalarının geliştirilmesi ve bakımında önemli bir araçtır.

Xdebug Modülü Tanıtımı

Xdebug, PHP kodunu hata ayıklama ve analiz etme amacıyla kullanılan güçlü bir PHP uzantısıdır. Kapsamlı hata ayıklama özellikleri sunar; bunlar arasında break-point hata ayıklama, yığın izleme ve değişken izleme yer alır. Ayrıca Xdebug, performans analizi ve kod kapsama tespiti gibi yetenekler de sunarak geliştiricilere kod performansını optimize etme ve kod kalitesini sağlama konusunda yardımcı olur.

Ana Özellikler

1. Break-point Hata Ayıklama: Xdebug, kodda break-point eklemeyi ve adım adım hata ayıklamayı destekler, böylece hataları bulmak ve düzeltmek kolaylaşır.
2. Yığın İzleme: Hata oluştuğunda, Xdebug ayrıntılı bir yığın izleme bilgisi üreterek geliştiricilerin sorunları hızlıca tespit etmesine yardımcı olur.
3. Performans Analizi: Xdebug, detaylı performans raporları oluşturarak geliştiricilerin kod performansını optimize etmesine imkan tanır.
4. Kod Kapsama: Xdebug, kod kapsama tespitini destekleyerek geliştiricilerin testlerin tüm kod yollarını kapsadığını garanti eder.
5. Entegre Geliştirme Ortamı Desteği: Xdebug, PHPStorm, Visual Studio Code gibi çeşitli entegre geliştirme ortamlarıyla entegre çalışarak kolay hata ayıklama deneyimi sunar.

ServBay'in Dahili Xdebug Modül Sürümleri

ServBay, birden fazla PHP sürümünü destekler ve her sürüme karşılık gelen Xdebug modülü önceden yüklenmiştir. Sürüm detayları şöyledir:

• PHP 5.6, 7.0, 7.1: Xdebug 2.5.5
• PHP 7.2, 7.3, 7.4: Xdebug 3.1.6
• PHP 8.0, 8.1, 8.2, 8.3: Xdebug 3.3.1
• PHP 8.4: Xdebug 3.4.0-dev

Uyarı

Her bir PHP sürümünün Xdebug portu birbirinden bağımsızdır ve sürüm numarasıyla ilişkilidir, örneğin PHP 7.2 için Xdebug portu 39072, PHP 8.3 için Xdebug portu 39083'dir.

Xdebug Modülü Nasıl Etkinleştirilir?

Varsayılan olarak, Xdebug modülü devre dışıdır. Xdebug modülünü etkinleştirmek için şu adımları izleyin: language - PHP'ye gidin, etkinleştirmek istediğiniz PHP sürümünü seçin, örneğin PHP 8.4, sağ taraftaki extensions'ı tıklayın ve Xdebug modülünün sol tarafındaki düğmeyi açın, kaydedin.

Kullanıcılar modül yapılandırmasını manuel olarak da açabilir veya değiştirebilirler. Aşağıda adım adım açıklanmıştır:

Adım 1: Yapılandırma Dosyasını Bulma

Öncelikle, ilgili PHP sürümünün conf.d dizinine gidin. Örneğin, PHP 8.3 için Xdebug modülünü etkinleştirmek istiyorsanız, şu dosyayı düzenlemelisiniz:

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

Adım 2: Yapılandırma Dosyasını Düzenleme

xdebug.ini dosyasını açın, aşağıdaki satırın yorumunu kaldırın:

[Xdebug]
; XDebug'u etkinleştirmek için bu satırın yorumunu kaldırın
zend_extension = xdebug.so

Adım 3: Xdebug Parametrelerini Yapılandırma

Xdebug'un tüm işlevlerinden yararlanmak için xdebug.inide bazı yaygın parametreleri yapılandırabilirsiniz. Örneğin:

xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

Adım 4: PHP Hizmetini Yeniden Başlatma

ServBay hizmet yönetim panelinden ilgili PHP hizmetini yeniden başlatın. Örneğin, PHP 8.3 hizmetini yeniden başlatın. Yeniden başlatma tamamlandıktan sonra Xdebug modülü başarılı bir şekilde yüklenmiş olacaktır.

Xdebug Modülünün Başarıyla Yüklenip Yüklenmediğini Doğrulama

Xdebug modülünün başarıyla yüklenip yüklenmediğini basit bir PHP dosyası oluşturarak doğrulayabilirsiniz. Web sunucusunun kök dizininde bir phpinfo.php dosyası oluşturun, içeriği şöyle olmalıdır:

<?php
phpinfo();
?>

https://servbay.host/phpinfo.php adresine gidin, PHP bilgisi sayfasında Xdebug modülünü arayın. Xdebug ile ilgili bilgileri görüyorsanız, modül başarıyla yüklenmiş demektir.

PHPStorm'da Xdebug Yapılandırması

PHPStorm'da Xdebug'u hata ayıklama için kullanmak amacıyla aşağıdaki yapılandırma adımlarını izleyin:

Adım 1: PHPStorm'u Açma ve Ayarlara Giriş

1. PHPStorm'u açın.
2. Menü çubuğunda File'a tıklayın ve Settings (Windows/Linux) veya Preferences (macOS) seçin.

Adım 2: PHP Yorumlayıcıyı Yapılandırma

1. Ayarlar penceresinde Languages & Frameworks -> PHPye gidin.
2. CLI Interpreter bölümünde sağdaki ... butonuna tıklayın.
3. Açılan pencerede + simgesine tıklayın ve yeni bir PHP yorumlayıcı ekleyin, Localu seçin.
4. PHP yorumlayıcı yolunu ServBay'de ilgili PHP sürümünün yolu olarak ayarlayın, örneğin /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. OK a tıklayarak ayarları kaydedin.

Adım 3: Xdebug Hata Ayıklama Yapılandırması

Uyarı

Her bir PHP sürümünün Xdebug portu birbirinden bağımsızdır ve sürüm numarasıyla ilişkilidir, örneğin PHP 7.2 için Xdebug portu 39072, PHP 8.3 için Xdebug portu 39083'dir.

1. Ayarlar penceresinde Languages & Frameworks -> PHP -> Debuga gidin.
2. Xdebug bölümünde Debug Portunu 39083 olarak ayarlayın, xdebug.client_port yapılandırması ile uyumlu.
3. Can accept external connections seçeneğinin işaretli olduğundan emin olun.
4. Applye tıklayın ardından OKe tıklayarak ayarları kaydedin.

Adım 4: PHP Web Uygulama Sunucusunu Yapılandırma

1. Ayarlar penceresinde Languages & Frameworks -> PHP -> Serverse gidin.
2. Sağdaki + simgesine tıklayarak yeni bir sunucu yapılandırması ekleyin.
3. Sunucu adını ayarlayın, örneğin ServBay Localhost.
4. Hostu ServBay üzerinde size atanmış olan host ismi olarak ayarlayın, örneğin servbay.new, portu ise 443 (HTTPS) olarak ayarlayın.
5. Debuggerı Xdebug olarak ayarlayın.
6. OKe tıklayarak ayarları kaydedin.

Adım 5: Hata Ayıklama Oturumunu Başlatma

1. PHPStorm'da hata ayıklamak istediğiniz PHP projesini açın.
2. Koddaki bir satıra break-point ekleyin (satır numarasının solundaki boş alana tıklayın).
3. PHPStorm üst araç çubuğunda Start Listening for PHP Debug Connections butonuna tıklayın (küçük böcek simgesi).
4. Tarayıcıda PHP uygulamanıza erişin, Xdebug PHPStorm'a otomatik olarak bağlanacak ve break-pointte yürütmeyi duraklatacaktır.

Sonuç

ServBay, Xdebug modülünü yönetmek ve etkinleştirmek için kolay bir yol sunar. Basit yapılandırma ve yeniden başlatma işlemleriyle geliştiriciler, farklı PHP sürümlerinde Xdebug modülünü hızla etkinleştirebilirler. Böylece güçlü hata ayıklama ve analiz işlevlerinden yararlanarak PHP uygulamalarının geliştirme ve bakım verimliliğini artırabilirler. Xdebug'un break-point hata ayıklama, performans analizi ve kod kapsam tespiti özellikleri, onu PHP geliştiricileri için vazgeçilmez bir araç haline getirir.