Laravel ile API Geliştirme Rehberi: Adım Adım Basit Bir Başlangıç

Merhaba dostum! Eğer bu yazıyı okuduysan, Laravel ile API geliştirme konusunda bir şeyler öğrenmeye karar vermişsin demektir. Harika bir seçim! Laravel, PHP dünyasında geliştiricilerin gönlünde taht kurmuş bir framework ve API geliştirme konusunda da oldukça güçlü. Hadi gel, Laravel ile sıfırdan bir API nasıl geliştirilir, adım adım keşfedelim.

API (Application Programming Interface), farklı yazılım sistemlerinin birbirleriyle iletişim kurmasını sağlayan bir araçtır. Bir uygulama, başka bir uygulamanın verilerini çekmek, işlemek ya da paylaşmak için API’leri kullanır. Laravel ise, bu API’leri hızlı ve güvenli bir şekilde oluşturabilmen için mükemmel bir araç.

Laravel ile API geliştirme sürecine başlamadan önce, Laravel kurulumunun yapılmış olması gerektiğini unutma. Eğer Laravel’i henüz kurmadıysan, terminale şu komutları yazıp hemen kurulumu tamamlayabilirsin:

composer create-project --prefer-dist laravel/laravel api-app

Bu komut, sana "api-app" adında bir proje oluşturacak. Şimdi her şey hazır, hadi API geliştirmeye başlayalım!

Laravel'de API route'larını `routes/api.php` dosyasından tanımlarsın. Bu dosya, API’ler için özel olarak ayrılmıştır ve genellikle burada tüm route (yol) tanımlarını yaparsın. Laravel, otomatik olarak API route'ları için bir grup middleware (ara yazılım) kullanır. Bu, senin için harika bir avantaj çünkü güvenliği sağlamak adına çeşitli işlemleri zaten hazır olarak sunar.

İlk API route’umuzu oluşturuyoruz:

use Illuminate\Support\Facades\Route;

Route::get('/users', function () {
    return response()->json([
        'users' => [
            ['name' => 'John Doe', 'email' => 'john@example.com'],
            ['name' => 'Jane Doe', 'email' => 'jane@example.com']
        ]
    ]);
});

Bu, basit bir GET isteği yaparak iki kullanıcıyı döndüren bir API endpoint'idir. Bu kadar basit! Eğer `http://localhost:8000/api/users` adresine gidersen, JSON formatında kullanıcı bilgilerini görebileceksin.

Laravel, kodunun daha düzenli ve sürdürülebilir olmasını sağlamak için controller kullanmanı önerir. API route'ları doğrudan controller metodlarına yönlendirebiliriz. Bu sayede kodumuz çok daha modüler ve temiz olur.

Hadi, bir controller oluşturalım:

php artisan make:controller UserController

Bu komut, `app/Http/Controllers` klasöründe `UserController.php` dosyasını oluşturur. Şimdi, bu controller'ı route'larımızla bağlayalım:

use App\Http\Controllers\UserController;

Route::get('/users', [UserController::class, 'index']);

Şimdi controller’da `index` metodunu tanımlayalım:

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    public function index()
    {
        return response()->json([
            'users' => [
                ['name' => 'John Doe', 'email' => 'john@example.com'],
                ['name' => 'Jane Doe', 'email' => 'jane@example.com']
            ]
        ]);
    }
}

Bu, API route’unu controller’a bağlamamıza yardımcı oldu. Şimdi, `http://localhost:8000/api/users` adresine gittiğinde aynı veriyi alacaksın, ancak artık controller üzerinden yönetiliyorsun. Kod çok daha düzenli oldu!

Çoğu API, veritabanı ile etkileşimde bulunur. Laravel’in Eloquent ORM (Object-Relational Mapping) sistemi, veritabanı işlemlerini çok kolay hale getirir. Örneğin, bir "users" tablosuna sahip olduğumuzu varsayalım ve bu tablodan veri çekmek istiyoruz.

Öncelikle, veritabanı bağlantısını yapılandıralım. `.env` dosyasına gidip şu ayarları yap:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=api_db
DB_USERNAME=root
DB_PASSWORD=

Ardından, bir `User` modelini oluşturuyoruz:

php artisan make:model User

Ve bu modeli controller’da kullanarak veritabanındaki verileri çekelim:

use App\Models\User;

class UserController extends Controller
{
    public function index()
    {
        $users = User::all(); // Veritabanındaki tüm kullanıcıları al

        return response()->json([
            'users' => $users
        ]);
    }
}

Bu kadar! Artık veritabanındaki kullanıcılar API aracılığıyla dönecek. `http://localhost:8000/api/users` adresinde veritabanındaki verileri görmelisin.

API geliştirme sürecinin bir başka önemli kısmı da CRUD (Create, Read, Update, Delete) işlemlerini yapabilmektir. Hadi, bir kullanıcı eklemek için POST isteği ekleyelim.

Öncelikle, route'umuzu tanımlayalım:

Route::post('/users', [UserController::class, 'store']);

Şimdi controller’a `store` metodunu ekleyelim:

use App\Models\User;
use Illuminate\Http\Request;

class UserController extends Controller
{
    public function store(Request $request)
    {
        $request->validate([
            'name' => 'required|string|max:255',
            'email' => 'required|string|email|max:255|unique:users',
        ]);

        $user = User::create([
            'name' => $request->name,
            'email' => $request->email,
        ]);

        return response()->json($user, 201);
    }
}

Bu kod parçası, kullanıcı adı ve email’i alıp veritabanına kaydedecek. Şimdi, bir POST isteği gönderdiğinde yeni kullanıcı oluşturulmuş olacak.

API’lerini test etmek için Postman veya Insomnia gibi araçlar kullanabilirsin. Bu araçlarla, API'ye çeşitli istekler gönderip doğru cevapları aldığından emin olabilirsin. Örneğin, yeni bir kullanıcı eklemek için Postman üzerinden POST isteği gönderebilir ve JSON cevabını görebilirsin.

Laravel ile API geliştirmek aslında düşündüğünden çok daha basit! Route’lar, controller’lar ve modeller ile API’ni hızlıca oluşturabilir, veritabanı işlemleri yapabilir ve hatta doğrulama işlemleri ekleyebilirsin. Laravel, tüm bu işlemleri kolaylaştıran bir dizi araç ve fonksiyon sunar.

Bundan sonra, API'ni daha da geliştirebilir, autentikasyon (kimlik doğrulama) ekleyebilir ve veri filtreleme gibi özellikler ekleyebilirsin. Laravel’in sunduğu zengin özellikler ile projelerini çok daha hızlı geliştirebilirsin!