Neden ezSQL?

Bu bana sorulduğunda her zaman verdiğim cevap pratikliği ve wordpress gibi bir devin kullanması. Yapımcısı Justin Vincent ise şöyle cevaplamış;

• PHP sistemlerinizde veritabanınızı hızlı ve kolay bir şekilde yönetmek. ( mySQL / Oracle8/9 / InterBase/FireBird / PostgreSQL / MS-SQL / SQLite / SQLite c++)
• Scriptinizin üstüne eklediğiniz tek bir php dosyasından oluşur ve standart veritabanı fonksiyonlarını hızlı ve kolay birşekilde kullanmanızı sağlar.
• Sunucu ekstra yük bindirmemek için sorguları otomatik olarak önbelleğe alır ve kullanmanıza izin verir.
• Çok rahat bir şekilde sorgularınızı debug etme imkanı sunar.
• Çoğu ezSQL fonksiyonu Objects, Associative Arrays, veya Numerical Arrays olarak sonuç döndürür.
• Proje geliştirme sürenize katlı sağlar, kodlarınızı hızlandırır ve optimizasyon sağlar.
• Küçük bir sınıftır ve sisteminize yük bindirmez.

Kurulumu

1. ezSQL sınıfının en son sürümünü buradan indirin
2. Betiğinizin ana dizinine bir klasör oluşturun ve adını ezSQL yapın (Opsiyonel)
3. İndirdiğiniz ezSQL klasörünün içindeki shared klasörüne girin ve ez_sql_core.php dosyasını 2. adımda oluşturduğunuz klasör içine atın.
4. mySQL için ana dizinden  mysql klasörüne girin ve içindeki ez_sql_mysql.php dosyasını 2.adımda oluşturduğunuz klasör içine atın.
5. Bu iki dosyayı include ederek veritabanı bağlantınızı yapın (Aşağıdaki kodu inceleyin)

            // ezSQL çekirdeğini dahil edin
            include_once "ezSQL/ez_sql_core.php";
            // mySQL istemcisi için dosyayı dahil edin
            include_once "ezSQL/ez_sql_mysql.php";
            // Veritabanı bağlantısını yapın
            $db = new ezSQL_mysql('db_user','db_password','db_name','db_host');

Yukarıdaki kodları mysqlBaglan.php olarak kayıt ederek veritabanı işlemi yapacağınız sayfalara dahil ederek kullanabilirsiniz.

ezSQL fonksiyonları

1. $db->get_results — birden fazla satırdan oluşan sonuç kümesi döndürür
2. $db->get_row — tek bir satır için sonuç kümesi getirir
3. $db->get_col — tek bir sutündaki değeri getirir
4. $db->get_var — tek bir satırdaki tek bir değeri getirir
5. $db->query — veritabanına sorgu gönderir (INSERT, UPDATE, DELETE vb işlemler için)
6. $db->debug — son sorguyu ve sonuç kümesini yazdırır
7. $db->vardump — sonucu ve yapısını yazdırır
8. $db->select — yeni bir veritabanı seçer
9. $db->get_col_info — sutünların bilgilerini getirir
10. $db->hide_errors — ezSQL hatalarını deaktif eder
11. $db->show_errors — ezSQL hatalarını aktif eder
12. $db->escape — Zararlı karakterleri temizler (addslashes gibi)
13. $db = new db — Yeni veritabanı nesnesi oluşturur.

ezSQL değişkenleri

1. $db->num_rows – Eğer varsa son sorgudaki dönen satır sayısını verir.
2.  $db->insert_id — INSERT sql sorgusu kullanıldığında oluşan AUTO_INCRIMENT değerini verir
3. $db->rows_affected – Son yapılan INSERT, UPDATE veya DELETE sql sorgularında etkilenen satır sayısını verir.
4. $db->num_queries – Scriptte çalıştırılan gerçek (önbellekte olmayan) sorgu sayısını verir.
5. $db->debug_all – Eğer true değer alırsa (Bknz: $db->debug_all = true;) Scriptteki TÜM sorguları ve TÜM sonuçları verir.
6. $db->cache_dir – Önbellekleme dosyalarının dizini.
7. $db->cache_queries – Sorgu sonuçlarını önbelleğe almayı sağlar (Bknz: mysql/disk_cache_example.php)
8. $db->cache_inserts – Girişleri önbelleğe alır (Bknz: mysql/disk_cache_example.php)
9. $db->use_disk_cache – Disk önbellek sistemini kullanmayı sağlar (Bknz: mysql/disk_cache_example.php)
10. $db->cache_timeout – Önbellek zaman aşım süresi (Bknz: mysql/disk_cache_example.php)

$db->query

Veritabanına sorgu göndermeye yarar, genelde INSERT,DELETE,UPDATE gibi işlemler için kullanılır.

Örnek

// Veritabanına yeni kayıt ekler
$db->query("INSERT  INTO uyeler (id,isim) VALUES (1,'ali')") ;
// Veritabanındaki kaydı günceller
$db->query("UPDATE uyeler SET isim= 'ali' WHERE id = 1") ;

$db->get_var

// Uyeler tablosundaki toplam satır sayısını getirir
$uyeSayisi = $db->get_var("SELECT COUNT(*) FROM uyeler");
// 15 id'sine sahip kullanıcının mail adresini getirir
$uyeMail = $db->get_var("SELECT mail FROM uyeler WHERE id=15");

$db->get_row

Veritabanından tek bir satır getirmeye yarar, örneğin bir üye’ye ait bilgileri almak istiyorsunuz.

//Üyenin adını ve mail adresini getir
$uye = $db->get_row("SELECT isim,email FROM uyeler WHERE id = 22") ;
// Gelen verileri yazdır
echo "$uye->isim isimli üyeye ait mail adresi: $uye->email";
//Çıktı:
//test isimli üyeye ait mail adresi: test@bilisim34.com

$db->get_results

if ( $uyeler = $db->get_results("SELECT isim, mail FROM uyeler") ){
            // Gelen verileri döndür
                        foreach ( $uyeler as $uye){
                                    echo $uye->isim- $uye->mail."
”;
                        }
} else {
            // Eğer üye yoksa, false dönerse
            echo "Üye bulunamadı.";
}

Bu kadar bilginin ezSQL’i kullanmaya başlamak için yeterli olacağını düşünüyorum, siz öyle düşünmüyorsanız burdan  bir bakın