PDO Nedir ve PHP Projelerinde Nasıl Kullanılır? PDO ile Veritabanı İşlemleri

PHP ile geliştirilen dinamik web uygulamalarında veritabanı bağlantıları, kullanıcı bilgilerinin yönetilmesi ve SQL sorgularının çalıştırılması önemli bir yer tutar. Bu işlemler için PHP'nin sunduğu yöntemlerden biri PDO (PHP Data Objects) teknolojisidir.

PDO, PHP uygulamalarının farklı veritabanı sistemleriyle ortak bir arayüz üzerinden iletişim kurmasını sağlayan bir veritabanı erişim katmanıdır.

MySQL, PostgreSQL ve SQLite gibi veritabanlarıyla çalışabilen PDO; hazırlanmış sorgular, hata yönetimi ve transaction desteği sayesinde modern PHP projelerinde yaygın olarak kullanılmaktadır.

Bu rehberde PDO'nun ne olduğu, nasıl çalıştığı, PHP 8.x projelerinde nasıl kullanıldığı ve güvenli veritabanı işlemlerinin nasıl gerçekleştirildiği örneklerle açıklanmaktadır.

1. PDO Nedir?

PDO, İngilizce PHP Data Objects ifadesinin kısaltmasıdır.

PHP'nin veritabanlarına erişmek için sunduğu nesne yönelimli bir arayüzdür.

PDO, tek başına bir veritabanı yönetim sistemi değildir. PHP uygulaması ile veritabanı sürücüsü arasında ortak bir programlama arayüzü sağlar.

Örneğin bir PHP uygulaması PDO kullanarak MySQL veritabanına bağlanabilir.

Aynı PDO arayüzü, uygun sürücü kullanıldığında PostgreSQL veya SQLite ile de çalışabilir.

Ancak farklı veritabanlarının SQL sözdizimleri ve desteklediği özellikler aynı olmadığından PDO kullanılması, bütün SQL sorgularının değişiklik yapılmadan taşınabileceği anlamına gelmez.

2. PDO Nasıl Çalışır?

PDO, PHP uygulaması ile veritabanı sürücüsü arasında ortak bir bağlantı arayüzü sunar.

Genel çalışma süreci şöyledir:

1. PHP uygulaması PDO nesnesini oluşturur.

2. PDO, belirtilen veritabanı sürücüsünü kullanır.

3. Veritabanı sunucusuyla bağlantı kurulur.

4. SQL sorguları hazırlanır ve çalıştırılır.

5. Veritabanından dönen sonuçlar PHP tarafından işlenir.

PDO ile kullanılabilecek sürücüler arasında şunlar bulunur:

Bu sürücülerin kullanılabilmesi için ilgili PHP uzantılarının kurulu ve etkin olması gerekir.

3. PDO Kullanmanın Avantajları

PDO, PHP projelerinde veritabanı işlemlerini yönetmek için çeşitli özellikler sunar.

Ortak veritabanı arayüzü: Farklı veritabanı sistemleriyle benzer PHP metotları üzerinden çalışılabilir.

Prepared Statements: SQL sorgularında parametre kullanımı desteklenir.

Transaction yönetimi: Birden fazla veritabanı işlemi birlikte yönetilebilir.

Hata yönetimi: Veritabanı hataları istisnalar aracılığıyla ele alınabilir.

Nesne yönelimli yapı: PHP sınıfları ve modern uygulama mimarileriyle birlikte kullanılabilir.

Veri çekme yöntemleri: Sorgu sonuçları ilişkisel dizi, sayısal dizi veya nesne olarak alınabilir.

Bununla birlikte PDO'nun kullanılması tek başına uygulamanın güvenli veya hızlı olmasını garanti etmez. SQL sorgularının doğru hazırlanması ve uygun güvenlik önlemlerinin uygulanması gerekir.

4. PHP'de PDO Desteği Nasıl Kontrol Edilir?

PDO kullanmadan önce PHP ortamında ilgili uzantıların etkin olduğundan emin olunmalıdır.

Komut satırında:

php -m

Çıktıda şu modüller kontrol edilebilir:

PDO
pdo_mysql

PHP içerisinden kullanılabilir PDO sürücülerini listelemek için:

<?php

$drivers = PDO::getAvailableDrivers();

print_r($drivers);

Örnek çıktı:

Array
(
    [0] => mysql
    [1] => sqlite
)

Gerçek çıktı, sunucuda kurulu sürücülere bağlıdır.

Linux cPanel hostinglerde PDO MySQL uzantısı, PHP sürümünün uzantı yönetimi bölümünden kontrol edilebilir. Bu seçeneklerin kullanılabilirliği hosting sağlayıcısına göre değişir.

5. PDO ile MySQL Veritabanı Bağlantısı

PDO ile MySQL bağlantısı oluşturmak için new PDO() kullanılır.

Örnek:

<?php

$host = "localhost";
$dbname = "forum_db";
$username = "forum_user";
$password = "GUCLU_SIFRENIZ";

try {

    $pdo = new PDO(
        "mysql:host=$host;dbname=$dbname;charset=utf8mb4",
        $username,
        $password,
        [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES => false
        ]
    );

    echo "Veritabanı bağlantısı başarılı.";

} catch (PDOException $e) {

    error_log($e->getMessage());

    http_response_code(500);

    exit("Veritabanı bağlantısı kurulamadı.");
}

PDO Bağlantı Kodunun Açıklaması

$host: Veritabanı sunucusunun adresidir.

$dbname: Bağlantı kurulacak veritabanının adıdır.

$username: MySQL kullanıcı adıdır.

$password: MySQL kullanıcı parolasıdır.

charset=utf8mb4: Bağlantının Unicode karakterleri desteklemesini sağlar.

PDO::ATTR_ERRMODE: Hataların istisna olarak yönetilmesini sağlar.

PDO::ATTR_DEFAULT_FETCH_MODE: Varsayılan veri çekme biçimini belirler.

PDO::ATTR_EMULATE_PREPARES: PDO'nun desteklenen sorgularda yerel hazırlanmış ifadeleri kullanmasını sağlar.

Veritabanı parolaları gerçek projelerde kaynak kod depolarına eklenmemeli ve mümkün olduğunda web erişimine kapalı yapılandırma dosyalarında veya ortam değişkenlerinde saklanmalıdır.

6. PDO ile Veritabanından Veri Çekme

PDO ile SELECT sorguları kullanılarak veritabanındaki kayıtlar okunabilir.

Örnek olarak bir kullanıcı tablosu oluşturalım:

CREATE TABLE members (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(100) NOT NULL,
    email VARCHAR(255) NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

Örnek kayıtlar:

INSERT INTO members(username, email)
VALUES
('ahmet', 'ahmet@example.com'),
('mehmet', 'mehmet@example.com'),
('ayse', 'ayse@example.com');

fetchAll() Kullanımı

Aşağıdaki PHP örneklerinde $pdo değişkeninin önceden oluşturulmuş PDO bağlantısını içerdiği varsayılmaktadır.

<?php

$stmt = $pdo->query(
    "SELECT id, username, email FROM members"
);

$members = $stmt->fetchAll();

foreach ($members as $member) {

    echo htmlspecialchars(
        $member["username"],
        ENT_QUOTES,
        "UTF-8"
    );

    echo "<hr>";
}

fetchAll(), sonuç kümesindeki kalan kayıtları dizi olarak döndürür.

Çok büyük sonuç kümelerinde bütün kayıtları belleğe almak yerine fetch() ile satır satır okumak daha uygun olabilir.

7. PDO fetch() ve fetchAll() Arasındaki Fark

PDO'da sorgu sonuçlarını almak için farklı yöntemler bulunmaktadır.

fetch() Örneği

<?php

$stmt = $pdo->prepare(
    "SELECT id, username, email
     FROM members
     WHERE id = :id"
);

$stmt->execute([
    "id" => 1
]);

$member = $stmt->fetch();

if ($member !== false) {
    echo htmlspecialchars(
        $member["username"],
        ENT_QUOTES,
        "UTF-8"
    );
}

Bu örnekte yalnızca belirtilen kullanıcı kaydı alınır.

fetchColumn() Örneği

Toplam kullanıcı sayısını bulmak için:

<?php

$stmt = $pdo->query(
    "SELECT COUNT(*) FROM members"
);

$total = $stmt->fetchColumn();

echo "Toplam kullanıcı: " . $total;

Bu yöntem, tek değer döndüren sorgular için kullanılabilir.

8. PDO Prepared Statements Nedir?

Prepared Statements, SQL komutlarının parametrelerle birlikte güvenli biçimde çalıştırılmasını sağlayan mekanizmadır.

Kullanıcıdan alınan verilerin SQL komutuna doğrudan birleştirilmesi güvenlik sorunlarına neden olabilir.

Güvensiz örnek:

<?php

$sql = "SELECT * FROM members
        WHERE username = '$username'";

Bu yaklaşımda kullanıcı girdisi SQL komutunun yapısını etkileyebilir.

PDO ile hazırlanmış sorgu:

<?php

$stmt = $pdo->prepare(
    "SELECT id, username, email
     FROM members
     WHERE username = :username"
);

$stmt->execute([
    "username" => $username
]);

$member = $stmt->fetch();

Bu yöntemde kullanıcı adı parametre olarak gönderilir.

Prepared Statements, SQL enjeksiyonu riskinin azaltılmasında temel güvenlik önlemlerinden biridir.

Ancak tablo adı, sütun adı veya ORDER BY yönü gibi SQL tanımlayıcıları parametre olarak bağlanamaz. Bu tür dinamik alanlarda güvenilir izin listeleri kullanılmalıdır.

9. PDO bindParam() ve bindValue() Kullanımı

PDO, parametre bağlamak için iki farklı metot sunar.

bindValue()

Parametrenin değerini bağlar.

<?php

$stmt = $pdo->prepare(
    "SELECT * FROM members WHERE id = :id"
);

$stmt->bindValue(
    ":id",
    5,
    PDO::PARAM_INT
);

$stmt->execute();

bindParam()

Parametreyi bir PHP değişkenine referans olarak bağlar.

<?php

$id = 5;

$stmt = $pdo->prepare(
    "SELECT * FROM members WHERE id = :id"
);

$stmt->bindParam(
    ":id",
    $id,
    PDO::PARAM_INT
);

$stmt->execute();

Temel fark, bindValue() metodunun bağlama anındaki değeri kullanması; bindParam() metodunun ise değişkeni referansla bağlamasıdır.

Bu nedenle bindParam() ile bağlanan değişkenin değeri, execute çağrısından önce değiştirilirse yeni değer kullanılabilir.

10. PDO ile INSERT İşlemi

Veritabanına yeni kayıt eklemek için INSERT sorgusu kullanılır.

<?php

$username = "yenikullanici";
$email = "yeni@example.com";

$stmt = $pdo->prepare(
    "INSERT INTO members(username, email)
     VALUES(:username, :email)"
);

$stmt->execute([
    "username" => $username,
    "email" => $email
]);

echo "Kayıt oluşturuldu.";

Bu örnekte kullanıcı adı ve e-posta adresi parametre olarak gönderilir.

lastInsertId() Kullanımı

Yeni oluşturulan otomatik artan ID değerini almak için:

<?php

$lastId = $pdo->lastInsertId();

echo "Yeni kayıt ID: " . $lastId;

Bu metot, desteklenen veritabanı sürücülerinde son ekleme işlemine ilişkin kimlik değerini döndürür.

MySQL'de AUTO_INCREMENT kullanılan tablolarla birlikte yaygın olarak kullanılır.

11. PDO ile UPDATE İşlemi

Mevcut kayıtları güncellemek için UPDATE komutu kullanılır.

<?php

$stmt = $pdo->prepare(
    "UPDATE members
     SET email = :email
     WHERE id = :id"
);

$stmt->execute([
    "email" => "guncel@example.com",
    "id" => 5
]);

echo "Güncelleme sorgusu tamamlandı.";

Güncelleme sonucunda etkilenen satır sayısını kontrol etmek için:

<?php

$affectedRows = $stmt->rowCount();

echo "Etkilenen satır: " . $affectedRows;

MySQL'de rowCount() davranışı bağlantı seçeneklerine göre değişebilir. Varsayılan durumda UPDATE için genellikle gerçekten değiştirilen satırların sayısı döndürülür.

12. PDO ile DELETE İşlemi

Kayıt silmek için DELETE komutu kullanılır.

<?php

$stmt = $pdo->prepare(
    "DELETE FROM members WHERE id = :id"
);

$stmt->execute([
    "id" => 5
]);

echo "Silme sorgusu tamamlandı.";

Gerçek projelerde silme işlemleri gerçekleştirilmeden önce kullanıcı yetkileri kontrol edilmelidir.

Web formlarından gelen silme isteklerinde CSRF koruması gibi ek güvenlik önlemleri de uygulanmalıdır.

13. PDO ile Transaction Kullanımı

Transaction, birden fazla veritabanı işleminin birlikte yönetilmesini sağlar.

Örneğin bir sipariş oluşturulurken sipariş kaydı ve sipariş kalemleri tutarlı biçimde eklenmelidir.

PDO'da transaction yönetimi için şu metotlar kullanılır:

• beginTransaction()

• commit()

• rollBack()

Örnek:

<?php

try {

    $pdo->beginTransaction();

    $stmt = $pdo->prepare(
        "INSERT INTO orders(user_id, total)
         VALUES(:user_id, :total)"
    );

    $stmt->execute([
        "user_id" => 5,
        "total" => 250.00
    ]);

    $orderId = $pdo->lastInsertId();

    $stmt = $pdo->prepare(
        "INSERT INTO order_items(
            order_id,
            product_id,
            quantity
        )
        VALUES(
            :order_id,
            :product_id,
            :quantity
        )"
    );

    $stmt->execute([
        "order_id" => $orderId,
        "product_id" => 10,
        "quantity" => 2
    ]);

    $pdo->commit();

    echo "Sipariş oluşturuldu.";

} catch (Throwable $e) {

    if ($pdo->inTransaction()) {
        $pdo->rollBack();
    }

    error_log($e->getMessage());

    echo "İşlem tamamlanamadı.";
}

Bu örnekte orders ve order_items tablolarının mevcut olduğu varsayılmıştır.

Transaction işlemlerinin beklenen şekilde çalışması için InnoDB gibi transaction destekleyen depolama motorları kullanılmalıdır.

Ayrıca MySQL'de bazı DDL komutları örtük COMMIT oluşturabilir. Bu nedenle transaction içerisinde tablo oluşturma veya değiştirme işlemleri dikkatle ele alınmalıdır.

14. PDO Hata Yönetimi Nasıl Yapılır?

PDO, veritabanı hatalarını istisnalar aracılığıyla yönetebilir.

<?php

try {

    $stmt = $pdo->query(
        "SELECT * FROM olmayan_tablo"
    );

} catch (PDOException $e) {

    error_log(
        "Veritabanı hatası: " . $e->getMessage()
    );

    echo "İşlem sırasında bir hata oluştu.";
}

Bu örnekte SQL sorgusu hata oluşturduğunda hata yakalanır.

Teknik ayrıntılar sunucunun hata günlüğüne yazılırken ziyaretçiye genel bir mesaj gösterilir.

Üretim ortamlarında veritabanı hatalarının doğrudan ziyaretçilere gösterilmesi önerilmez.

15. PDO ile LIKE Sorgusu Kullanımı

Arama işlemlerinde LIKE operatörü kullanılabilir.

Örneğin kullanıcı adında belirli bir kelimeyi aramak için:

<?php

$search = "ah";

$stmt = $pdo->prepare(
    "SELECT id, username
     FROM members
     WHERE username LIKE :search"
);

$stmt->execute([
    "search" => "%" . $search . "%"
]);

$members = $stmt->fetchAll();

Bu sorgu, kullanıcı adında belirtilen ifadeyi içeren kayıtları arar.

Ancak LIKE içerisinde kullanılan % ve _ karakterlerinin özel anlamları bulunmaktadır.

Kullanıcının girdiği bu karakterlerin düz metin olarak aranması gerekiyorsa uygun kaçış işlemleri uygulanmalıdır.

16. PDO ile LIMIT ve Sayfalama Kullanımı

Forum ve e-ticaret sitelerinde çok sayıda kaydı tek seferde listelemek yerine sayfalama kullanılabilir.

Örnek:

<?php

$page = 1;
$limit = 20;

$offset = ($page - 1) * $limit;

$stmt = $pdo->prepare(
    "SELECT id, username
     FROM members
     ORDER BY id DESC
     LIMIT :limit OFFSET :offset"
);

$stmt->bindValue(
    ":limit",
    $limit,
    PDO::PARAM_INT
);

$stmt->bindValue(
    ":offset",
    $offset,
    PDO::PARAM_INT
);

$stmt->execute();

$members = $stmt->fetchAll();

Bu yöntem, kayıtların belirli sayıda görüntülenmesini sağlar.

Büyük tablolarda yüksek OFFSET değerleri performans sorunlarına yol açabileceğinden anahtar tabanlı sayfalama da değerlendirilebilir.

17. PDO ile Güvenli Veritabanı Sınıfı Oluşturma

PHP projelerinde veritabanı bağlantısını merkezi olarak yönetmek için bir sınıf oluşturulabilir.

Örnek:

<?php

class Database
{
    private PDO $connection;

    public function __construct(
        string $host,
        string $dbname,
        string $username,
        string $password
    ) {
        $this->connection = new PDO(
            "mysql:host=$host;dbname=$dbname;charset=utf8mb4",
            $username,
            $password,
            [
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::ATTR_EMULATE_PREPARES => false
            ]
        );
    }

    public function getConnection(): PDO
    {
        return $this->connection;
    }
}

Kullanımı:

<?php

require_once "Database.php";

$db = new Database(
    "localhost",
    "forum_db",
    "forum_user",
    "GUCLU_SIFRENIZ"
);

$pdo = $db->getConnection();

Bu yapı, bağlantı yönetimini uygulamanın diğer bölümlerinden ayırmaya yardımcı olur.

Gerçek projelerde bağlantı bilgileri ayrı ve güvenli bir yapılandırma kaynağından alınmalıdır.

18. PDO ile MySQLi Arasındaki Farklar

PDO ve MySQLi, doğru kullanıldığında güvenli veritabanı uygulamaları geliştirmek için uygundur.

PDO'nun en belirgin avantajlarından biri farklı veritabanı sürücülerini destekleyen ortak bir arayüz sunmasıdır.

Ancak mevcut MySQLi projelerinin yalnızca PDO kullanmak amacıyla yeniden yazılması zorunlu değildir.

19. cPanel Hosting Üzerinde PDO Kullanımı

Linux cPanel hostinglerde PDO kullanabilmek için ilgili PHP uzantısının etkin olması gerekir.

PDO Kontrol Adımları

1. cPanel yönetim paneline giriş yapın.

2. PHP sürüm yönetimi veya PHP uzantıları bölümünü açın.

3. PDO ve pdo_mysql uzantılarını kontrol edin.

4. MySQL veritabanını oluşturun.

5. MySQL kullanıcı hesabını veritabanına ekleyin.

6. Bağlantı bilgilerini PHP yapılandırmasına tanımlayın.

7. Bağlantıyı test edin.

Hosting panelinin sunduğu özellikler sağlayıcıya göre farklı olabilir.

cPanel Veritabanı İsimleri

cPanel üzerinde veritabanı ve kullanıcı adlarına çoğunlukla hesap ön eki eklenir.

Örnek:

Veritabanı: hostingadi_forumdb
Kullanıcı: hostingadi_forumuser
Host: localhost

PDO bağlantısında tam veritabanı ve kullanıcı adlarının kullanılması gerekir.

20. PDO Performansını Artırmak İçin Öneriler

PDO kullanımı sırasında veritabanı performansını korumak için bazı noktalara dikkat edilmelidir.

Gereksiz sorguları azaltın. Aynı veriyi tekrar tekrar sorgulamak yerine uygun önbellekleme yöntemlerini değerlendirin.

Doğru indeksler oluşturun. Sık kullanılan WHERE ve JOIN koşullarını inceleyin.

SELECT * kullanımını sınırlandırın. Yalnızca ihtiyaç duyulan sütunları alın.

Büyük sonuç kümelerini kontrollü okuyun. Gerektiğinde fetch() ve sayfalama kullanın.

Prepared Statements kullanın. Parametreli sorgularla güvenliği artırın ve tekrarlanan sorguları daha düzenli yönetin.

Transaction sürelerini kısa tutun. Gereksiz uzun işlemler kilit beklemelerine neden olabilir.

Sorguları ölçün. EXPLAIN ve uygun performans araçlarıyla yavaş sorguları tespit edin.

PDO, sorguların otomatik olarak optimize edilmesini sağlamaz. Sorgu performansı, MySQL yapılandırmasına ve SQL tasarımına bağlıdır.

21. PDO Kullanırken Sık Yapılan Hatalar

could not find driver

Bu hata, ilgili PDO sürücüsünün kurulu veya etkin olmadığını gösterebilir.

MySQL için pdo_mysql uzantısı kontrol edilmelidir.

Access denied for user

Kullanıcı adı, parola veya MySQL host erişim kuralları yanlış olabilir.

Bağlantı bilgileri ve kullanıcı yetkileri doğrulanmalıdır.

Unknown database

Belirtilen veritabanı bulunamıyor olabilir.

Veritabanı adı ve hosting ön eki kontrol edilmelidir.

SQLSTATE[HY093] Invalid parameter number

Sorgudaki parametre yer tutucuları ile bağlanan parametreler eşleşmiyor olabilir.

Örneğin:

<?php

$stmt = $pdo->prepare(
    "SELECT * FROM members WHERE id = :id"
);

$stmt->execute([
    "member_id" => 5
]);

Bu örnekte :id yerine member_id anahtarı gönderildiğinden parametre eşleşmesi hatalıdır.

Doğru kullanım:

<?php

$stmt->execute([
    "id" => 5
]);

22. PDO Hakkında Sık Sorulan Sorular

PDO PHP 8 ile Kullanılabilir mi?

Evet. PDO, PHP 8.x sürümlerinde desteklenmektedir.

PDO MySQL Dışında Kullanılabilir mi?

Evet. Uygun sürücülerle PostgreSQL, SQLite ve diğer desteklenen veritabanlarına bağlanabilir.

PDO SQL Injection Saldırılarını Önler mi?

PDO'nun prepared statements özelliği, değer parametreleri doğru kullanıldığında SQL enjeksiyonu riskini önemli ölçüde azaltır.

Ancak güvenlik için diğer giriş doğrulama ve yetkilendirme önlemleri de gereklidir.

PDO Bağlantısı Nasıl Kapatılır?

Bağlantı nesnesinin referansı kaldırılabilir:

<?php

$pdo = null;

PDO Her Projede Kullanılmalı mı?

PDO birçok PHP projesi için uygun bir seçenektir. Ancak MySQLi de desteklenen ve kullanılabilir bir arayüzdür.

Tercih, projenin gereksinimlerine ve mevcut yazılım mimarisine göre yapılmalıdır.

Sonuç

PDO, PHP uygulamalarında veritabanı bağlantılarının ve SQL işlemlerinin ortak bir arayüz üzerinden yönetilmesini sağlayan önemli bir teknolojidir.

PDO ile MySQL veritabanına bağlanmak, kayıtları listelemek, veri eklemek, güncellemek, silmek ve transaction işlemlerini yönetmek mümkündür.

Prepared Statements, parametreli sorguların güvenli şekilde çalıştırılmasına yardımcı olurken hata yönetimi özellikleri de uygulamaların daha kontrollü geliştirilmesini sağlar.

Özellikle PHP 8.x ile geliştirilen forum siteleri, e-ticaret sistemleri, yönetim panelleri ve özel web projelerinde PDO, veritabanı işlemlerini düzenli ve sürdürülebilir biçimde yönetmek için kullanılabilir.

Güvenli bir uygulama geliştirmek için PDO'nun doğru kullanılması, veritabanı kullanıcı yetkilerinin sınırlandırılması, sorguların optimize edilmesi ve hassas bağlantı bilgilerinin korunması önemlidir.