Kural
Sınıf adı şu şekilde dosya dosya adıyla
Birçok dil için sınıf adlarının
'nin dosya dosya adlarıyla tam olarak ya da başarısız
başarısız başarısız büyük/küçük harf duyarlı dosya sistemlerinde (Linux).
Desteklenen diller: PHPGiriş
PHP’nin PSR-4 otomatik yükleme standardı, sınıf adlarının dosya adlarıyla büyük/küçük harf ayrımı da dahil olmak üzere tam olarak eşleşmesini gerektirir. Adı Kullanıcı Deposu içinde bulunmalıdır UserRepository.php, değil userrepository.php. Bu, Windows ve macOS gibi büyük/küçük harf ayrımı yapmayan dosya sistemlerinde çalışır, ancak Linux sunucularında hata verir ve üretim ortamında “Sınıf bulunamadı” hatalarına neden olur.
Neden önemli?
Üretim ortamındaki arızalar: Büyük/küçük harf duyarlı dosya sistemlerine sahip Linux sunucularında, isimlerdeki uyumsuzluklar otomatik yükleme hatalarına yol açar. Yerel ortamda sorunsuz çalışan kodlar, üretim ortamında çalışmaz hale gelir; bu da acil düzeltme yamaları gerektirir ve hizmet kesintilerine neden olur.
PSR-4 uyumluluğu: Modern PHP çerçeveleri, PSR-4 otomatik yükleme özelliğine dayanır. Adlandırma kurallarına uymayan sınıflar otomatik olarak yüklenemez; bu da bağımlılık enjeksiyonunu, hizmet kapsayıcılarını ve çerçeve özelliklerini bozabilir.
Kod örnekleri
❌ Uygun değil:
<?php
// File: userrepository.php
namespace App\Repositories;
class UserRepository
{
public function findById($id)
{
return User::find($id);
}
public function save(User $user)
{
return $user->save();
}
}
Neden yanlış: Sınıf adı şudur: Kullanıcı Deposu ama dosya adı şudur: userrepository.php (küçük harf). PSR-4 otomatik yükleyici şunu arayacaktır: UserRepository.php ve büyük/küçük harf duyarlı Linux dosya sistemlerinde bunu bulamadıklarında, üretim ortamında ciddi hatalara yol açar.
✅ Uygunluk:
<?php
// File: UserRepository.php
namespace App\Repositories;
class UserRepository
{
public function findById($id)
{
return User::find($id);
}
public function save(User $user)
{
return $user->save();
}
}
Bunun önemi: Dosya adı UserRepository.php sınıf adıyla eşleşir Kullanıcı Deposu Aynen öyle, büyük/küçük harf ayrımı da dahil. PSR-4 otomatik yükleyici, herhangi bir dosya sisteminde sınıfı güvenilir bir şekilde bulup yükleyebilir; böylece ortama özgü hataları ortadan kaldırır ve geliştirme ile üretim ortamları arasında tutarlı bir davranış sağlar.
Sonuç
Projenizin başlangıcından itibaren dosya adı ile sınıf adı arasında sıkı bir eşleşme kuralı uygulayın. Sınıf oluştururken dosyaların otomatik olarak doğru şekilde adlandırılması için IDE’nizi yapılandırın. Dağıtım öncesinde uyuşmazlıkları tespit etmek için CI/CD boru hatlarında otomatik kontroller kullanın. Doğru adlandırmayı sağlamak için harcadığınız beş dakika, üretim ortamındaki otomatik yükleme hatalarını gidermek için harcanacak saatlerce süren hata ayıklama çalışmalarını önler.
