Adım 1: Symfony Projesi Oluşturma
Symfony'ye adım atmak için ilk olarak bir Symfony projesi oluşturmalısınız. Bunu terminal üzerinden yapabilirsiniz. Symfony, işinizi kolaylaştıran harika komutlar sunar. Şimdi terminalinizi açın ve aşağıdaki komutları çalıştırarak yeni bir Symfony projesi oluşturun:
composer create-project symfony/skeleton my_api_project
Bu komut, `my_api_project` isminde boş bir Symfony projesi oluşturur. Projeyi oluşturduktan sonra, bu projede API geliştirme sürecine odaklanacağız.
Adım 2: API Platform Kurulumu
API geliştirmek için Symfony'nin sunduğu API Platform paketini kullanacağız. API Platform, hızlı ve verimli bir şekilde RESTful API’ler oluşturmanıza olanak sağlar. Komut satırına şu komutu yazın:
composer require api
Bu paket, JSON formatında veri alışverişi yapabilen sağlam bir API kurmanızı sağlar. API Platform ayrıca çok sayıda özellik ve otomatik dokümantasyon desteği sunarak işinizi daha da kolaylaştırır.
Adım 3: Veritabanı Modeli Oluşturma
Artık API’miz için veritabanı modeline geçelim. Bu örnekte basit bir “Product” (Ürün) modelini kullanacağız. Symfony ile hızlıca Doctrine ORM (Object-Relational Mapping) aracını kullanarak veritabanı ile etkileşime geçebilirsiniz.
Aşağıdaki komutla bir entity (varlık) sınıfı oluşturun:
php bin/console make:entity
Bu komut, Symfony'nin sihirli elini gösteriyor. "Product" modelinin gerekli alanlarını ekledikten sonra, veritabanı tablolarını oluşturmak için:
php bin/console doctrine:schema:update --force
Bu komut, veritabanınızdaki tabloları otomatik olarak oluşturur. Böylece "Product" modeliniz veritabanında bir tabloya dönüşür.
Adım 4: API Sonuçlarını Göstermek
Şimdi, bu modelimizi API olarak sergileyelim. API Platform, otomatik olarak veritabanı modellerini API uç noktalarına dönüştürür. Yani, GET isteği ile tüm ürünleri alabiliriz. Projeyi başlatmak için şu komutu kullanın:
php bin/console server:run
Artık tarayıcınızda `http://127.0.0.1:8000/api/products` adresine giderek ürünlerinizi görebilirsiniz. Hızla çalışır hale gelen bu API, size zaman kazandırır ve hemen kullanmaya başlamak için hazır olur.
Adım 5: API’yi Özelleştirmek ve Güvenlik
Bu noktada API’niz çalışıyor, ancak güvenlik eklemek çok önemlidir. Symfony, API’nizin sadece yetkili kullanıcılar tarafından erişilmesini sağlamak için kolayca entegre edilebilen JWT (JSON Web Tokens) gibi güvenlik özelliklerine sahiptir.
JWT güvenlik yapılandırmasını eklemek için şu komutları kullanabilirsiniz:
composer require lexik/jwt-authentication-bundle
Yapılandırma dosyasını düzenleyerek güvenliği artırabilirsiniz. API'nize gelen her isteği kontrol edebilir ve sadece doğru yetkilendirilmiş kullanıcıların işlem yapmasını sağlayabilirsiniz.
Adım 6: Test Etme ve Yayımlama
Artık API'niz hazır, ancak test etmek önemlidir. Symfony, geliştirdiğiniz API'yi test etmek için bir dizi araç ve özelliğe sahiptir. Symfony'deki WebTestCase sınıfını kullanarak uç noktalarınızı test edebilirsiniz.
Testlerinizi yazdıktan sonra, API'nizi yayına almak için sunucunuza yüklemeniz yeterli. Symfony'nin yüksek performanslı yapısı sayesinde, API'niz yüksek trafikli uygulamalarda bile sorunsuz bir şekilde çalışacaktır.
Sonuç
Symfony ile API geliştirmek, gerçekten güçlü bir deneyim sunuyor. Hızlı kurulum, güçlü güvenlik özellikleri ve gelişmiş test araçları ile Symfony, API geliştiricileri için ideal bir framework. Eğer bir API geliştirmeyi düşünüyorsanız, Symfony'nin sunduğu araçları ve özellikleri keşfetmek işinizi çok kolaylaştıracaktır.
