No Clickbait, No Nasıl Yapılır?

Modern web geliştirme dünyasında, PHP ekosistemi son yıllarda muazzam bir evrim geçirdi. Ancak internet, güncelliğini yitirmiş, güvenlik açıkçılarıyla dolu ve yüzeysel "nasıl yapılır" rehberleriyle dolup taşmaktadır. Bu rehber, zamanınızı çalacak yüzeysel bilgileri bir kenara bırakarak, doğrudan kurumsal seviyede bir mimari inşa etmeye odaklanan No Clickbait, No Nasıl Yapılır? felsefesiyle hazırlanmıştır. Bu makalede, PHP dilinin modern yeteneklerini kullanarak, production (canlı) ortamına hazır, güvenli ve sürdürülebilir bir uygulama mimarisinin nasıl kurulacağını derinlemesine inceleyeceğiz.

Bu eğitim, temel PHP bilgisine sahip, ancak kodunu spagetti tasarımlardan kurtarıp kurumsal standartlara (PSR standartları) yükseltmek isteyen yazılım geliştiriciler için yazılmıştır. Makale boyunca katı tip tanımlamalarından bağımlılık enjeksiyonuna (Dependency Injection), modern özniteliklerden (Attributes) asenkron programlamaya (Fibers) kadar kritik konuları adım adım ele alacağız. Amacımız, sadece çalışan bir kod yazmak değil; test edilebilir, güvenli ve yüksek performanslı bir sistem tasarlamaktır.

Gereksinimler ve Ön Hazırlık

Bu rehberdeki modern PHP özelliklerini ve tasarım desenlerini uygulayabilmeniz için sisteminizde belirli araçların ve yapılandırmaların hazır olması gerekmektedir. Aşağıdaki gereksinimler, 2026 yılı standartlarında güvenli ve optimize bir çalışma ortamı sağlamak için zorunludur:

• PHP Sürümü: Minimum PHP 8.3 veya üzeri (PHP 8.4 önerilir). Eski sürümlerdeki (PHP 7.x ve altı) birçok özellik artık "deprecated" (kullanımdan kaldırılmış) durumdadır.
• Composer: PHP bağımlılık yöneticisi Composer'ın en güncel sürümü (v2.6+).
• Veritabanı: PDO destekli PostgreSQL veya MySQL/MariaDB.
• IDE/Editör: PHPStan veya Psalm gibi statik analiz araçlarını destekleyen bir editör (örn. PHPStorm veya VS Code ile PHP Intelephense eklentisi).

Geliştirme ortamınızda hata raporlamanın tamamen açık olduğundan emin olun. Bunun için php.ini dosyanızda aşağıdaki ayarların etkinleştirilmiş olması gerekir:

error_reporting = E_ALL
display_errors = On
display_startup_errors = On

1. Modern PHP'de Katı Tip Tanımlama (Strict Types) ve Tip Güvenliği

PHP, doğası gereği dinamik tipli (dynamically typed) bir dildir. Ancak kurumsal projelerde bu durum, beklenmedik tip dönüşümlerine ve çalışma zamanı (runtime) hatalarına yol açar. Tip güvenliğini en üst düzeye çıkarmak için her PHP dosyasının en başında katı tip kontrolünü aktif etmeliyiz. Bu adım adım yaklaşımda, tip güvenliğinin neden zorunlu olduğunu ve değer nesneleri (Value Objects) ile verilerimizi nasıl sarmalayacağımızı göreceğiz.

Aşağıdaki örnek kod, katı tip kontrolü aktif edilmiş bir ortamda, kullanıcı e-posta adreslerini doğrulamak ve saklamak için tasarlanmış bir Değer Nesnesi (Value Object) sınıfını göstermektedir. Bu yaklaşım, geçersiz verilerin sistemin derinliklerine sızmasını engeller.