PHP Biçimlendirici

Bu araç ne yapar

PHP biçimlendirici, dağınık, küçültülmüş veya tutarsız girintili PHP kodunu topluluğun kodlama standardına uyan temiz koda dönüştürür. Tipli ve readonly özellikler, constructor promotion, arrow function’lar, enum’lar, match ifadeleri ve attribute’lar dahil modern söz dizimini destekler.

Prettier’ı resmi PHP eklentisiyle çalıştırır; bu, birçok Laravel ve Symfony ekibinin editörlerinde ve pre-commit hook’larında kullandığı kombinasyonun aynısıdır, dolayısıyla sonuç kendi araçlarınızın üreteceğiyle eşleşir.

Nasıl kullanılır

1. PHP kodunu yapıştırın veya bir .php dosyası açın. Kısa kod parçaları için açılış <?php etiketi isteğe bağlıdır.
2. Biçimlendirilmiş kod siz yazdıkça sağda görünür.
3. Seçenekleri ayarlayın:
   • Girinti: 4 boşluk PSR standardıdır; 2 boşluk ve tab da kullanılabilir.
   • Satır genişliği: bundan uzun satırlar, söz diziminin izin verdiği yerlerden kırılır.
   • Süslü parantezler: sınıf ve fonksiyon süslü parantezlerini sonraki satıra (PER / PSR-12) veya aynı satıra koyun.
   • PHP sürümü: kodun çalışması gereken en eski sürüm.
   • Çok satırlı listeler için Tek tırnak ve Sondaki virgüller.
4. Sonucu kopyalayın veya indirin.

Kodda bir söz dizimi hatası varsa, mesaj ayrıştırıcının ne beklediğini ve durduğu satır ile sütunu belirtir.

Örnek

Örnek, her şeyin birbirine sıkıştırıldığı Laravel tarzı bir controller’dır: gruplanmış bir use ifadesi, bir özellik dizisi, constructor promotion, bir doğrulama çağrısı, tek satırda yazılmış bir if ve arrow function’lı bir array_map. Biçimlendirmeden sonra her metodun süslü parantezi kendi satırına geçer, operatörler ve => boşluk alır, if gövdesi genişletilir ve uzun response()->json() çağrıları her satırda bir dizi öğesi ve sondaki virgüllerle kırılır.

Neleri değiştirmez

Biçimlendirici yalnızca düzeni değiştirir. Değişkenleri yeniden adlandırmaz, use ifadelerini yeniden sıralamaz, array() ifadesini kısa söz dizimine çevirmez veya mantığı düzeltmez. PHPDoc blokları dahil yorumlar korunur ve çevrelerindeki kodla birlikte yeniden girintilenir.

İpuçları

• Diff’lerde gereksiz değişiklikleri önlemek için projenizin Prettier veya PHP-CS-Fixer yapılandırmasıyla aynı satır genişliğini ve PHP sürümünü kullanın.
• Bir log’dan veya stack trace’ten kopyalanan bir kod parçasını biçimlendirmek onu çok daha okunur hale getirir.
• Bir issue’da kod paylaşıyorsanız, inceleyenlerin kodun ne yaptığına odaklanabilmesi için önce biçimlendirin.