- Konu sahibi
- #1
PHP PEAR nedir?
PHP PEAR, PHP ile yazılmış yeniden kullanılabilir kütüphaneleri, komut satırı araçlarını ve uygulama bileşenlerini dağıtmak için oluşturulmuş bir paket ve kurulum altyapısıdır. “PEAR” adı, “PHP Extension and Application Repository” ifadesinden gelir. PEAR paketleri genellikle PEAR Installer aracılığıyla kurulur ve paketlerin bağımlılıkları ile dosya yerleşimleri paket tanımında belirtilir.
PEAR, PHP’nin kendisiyle aynı şey değildir; PEAR ile PHP motoruna yüklenen derlenmiş uzantıları aynı kavram sanmamak gerekir; bu uzantıları dağıtan PECL ayrı projedir ve PEAR kurulum altyapısıyla ilişkisi vardır. PHP uygulamasına dışarıdan kütüphane eklemeyi ve bu kütüphanelerin yönetimini amaçlayan bir ekosistemdir. Composer ise bağımlılıkları proje bazında yönetmek için ayrı bir seçenektir. Ancak eski veya kurumsal bir uygulama PEAR paketlerine dayanıyorsa, PEAR’ın ne yaptığını bilmek bakım ve hata çözümü açısından hâlâ önemlidir.
PEAR nasıl çalışır?
Bir PEAR paketi; PHP dosyalarının yanı sıra paket adı, sürümü, bağımlılıkları ve kurulacak dosyaların konumlarını açıklayan metadata içerir. PEAR Installer bu bilgiyi kullanarak paketi indirir, uygun dizine yerleştirir ve bağımlılıkları çözmeye çalışır. Uygulama daha sonra bu sınıflara PHP’nin include path ayarı üzerinden veya projenin kendi yükleme mekanizmasıyla erişir.
Bu yapı, Composer’daki
vendor/autoload.php yaklaşımından farklı olabilir. Bu nedenle eski bir projeye PEAR paketi eklerken yalnızca dosyaları kopyalamak yeterli olmayabilir; include path, PEAR yapılandırması veya uygulamanın mevcut autoloader düzeni de incelenmelidir.Somut örnek
Örneğin eski bir PHP uygulaması, e-posta oluşturmak için bir PEAR posta paketinin sınıflarını kullanıyor olsun. Uygulamada buna benzer bir kullanım görebilirsiniz:
Kod:
require_once 'Mail.php';
$mailer = Mail::factory('mail');Bu parça PEAR Mail paketinin ve bağımlılıklarının kurulu, dosya arama yolunun uygun olduğunu varsayar. Mailer nesnesi oluşturur; tek başına e-posta göndermez. Burada
Mail.php uygulamanın kendi dosyası olmak zorunda değildir; PEAR tarafından kurulmuş bir paketin parçası olabilir. Dosya bulunamıyorsa sorun genellikle PHP kodunun sözdiziminden değil, paketin kurulu olmamasından veya PEAR dizininin include path içinde bulunmamasından kaynaklanır.PEAR mı, Composer mı?
Seçim yaparken projenin yaşı, mevcut bağımlılıkları ve dağıtım yöntemi belirleyicidir. Yeni bir proje için yalnızca PEAR kullanılıyor olması, otomatik olarak en uygun seçeneğin PEAR olduğu anlamına gelmez. Buna karşılık çalışan eski bir uygulamayı sırf bağımlılık yöneticisi farklı olduğu için hemen dönüştürmek de riskli olabilir.
| Durum | Uygun yaklaşım | Dikkat edilecek nokta |
|---|---|---|
| Yeni PHP projesi | Önce Composer ve Composer uyumlu paketleri değerlendirin | Mevcut PEAR bağımlılığı gerekmiyorsa yeni sistemi karıştırmayın |
| Eski uygulama PEAR kullanıyor | Önce mevcut kurulumu ve bağımlılıkları belgeleyin | PEAR dizini, include path ve sürüm uyumluluğunu koruyun |
| PEAR paketi bulunamıyor | Kurulum kaydı ve dosya arama yolunu kontrol edin | Sadece kaynak dosyasını kopyalamak bağımlılıkları çözmeyebilir |
Mevcut bir PEAR projesini incelerken izlenecek adımlar
- Kodda
require_once,include_path, PEAR sınıf adları ve paket kurulum komutlarıyla ilgili yapılandırmaları arayın. - Kullanılan paketlerin adlarını, sürümlerini ve birbirlerine olan bağımlılıklarını bir listeye çıkarın.
- PHP’nin include path değerinde PEAR paketlerinin bulunduğu dizinin yer alıp almadığını kontrol edin.
- Eksik sınıf veya “failed to open stream” hatasında önce dosyanın gerçekten kurulu olup olmadığını, sonra include path ve PHP çalışma ortamını karşılaştırın.
- Uygulama çalışıyorsa PEAR paketlerini elle güncellemeden önce yedek ve geri dönüş planı oluşturun; paket sürümü değişikliği sınıf davranışlarını etkileyebilir.
- Yeni geliştirmelerde PEAR kullanma zorunluluğu yoksa bağımlılık yönetimini projenin standartlarına göre değerlendirin. Geçiş yapılacaksa paketleri tek seferde değil, bağımlılık ve test sonuçlarını izleyerek ayrı ayrı taşıyın.
Kurulumdan sonra beklenen sonuç, uygulamanın ilgili sınıfı hata vermeden yükleyebilmesidir. “Class not found” veya “failed to open stream” hatası devam ediyorsa bu, çoğunlukla paketin yanlış dizine kurulmasına, include path’in PHP’nin çalıştığı ortamda farklı olmasına ya da paketin başka bir bağımlılığa ihtiyaç duymasına işaret eder.
Sık yapılan hatalar
PEAR’ı PHP eklentisi sanmak: PEAR, PHP motoruna yüklenen bir uzantı değil; PHP kodu ve kurulum araçları etrafında oluşmuş bir paket ekosistemidir.
Composer ile PEAR’ı aynı kurulum biçimi sanmak: PEAR paketlerinin dosya yerleşimi ve yüklenmesi, Composer’ın proje içindeki
vendor yapısından farklı olabilir.Eksik sınıf hatasında yalnızca kodu değiştirmek: Sınıf bulunamıyorsa önce paketin kurulumunu ve PHP’nin dosya arama yolunu inceleyin.
Çalışan eski sistemi plansız güncellemek: PEAR paketleri uygulamanın başka bileşenlerine bağlı olabilir. Güncelleme veya Composer’a geçiş, önce test ortamında doğrulanmalıdır.
Sık sorulan sorular
PEAR paketleri PHP uzantısı gerektirir mi?
PEAR paketleri çoğunlukla PHP ile yazılmış kütüphanelerdir; ancak belirli bir paket, yaptığı işe bağlı olarak ayrıca bir PHP uzantısına ihtiyaç duyabilir. Gereksinim paket tanımından ve uygulamanın hata mesajından kontrol edilmelidir.
PEAR kurulmadan PEAR kullanan uygulama çalışır mı?
Sunucuda gerekli paket dosyaları ve yükleme yolu zaten mevcutsa uygulama çalışabilir. PEAR Installer’ın o makinede bulunması her çalışma için şart olmayabilir; fakat eksik veya yeni bağımlılıkları kurmak için kurulum yöntemine ihtiyaç duyulur.
