01 Temmuz 2007

ezSQL Veritabanı Sınıfı

Tasarım ve Programlama, WordPress Yorum Ekle

ezSQL PHP scriptlerinizde veritabanınızı (MySQL / Oracle8/9 / interBase / FireBird / PostreSQL / MS-SQL / SQLite / SQLite c++) kullanmanızı hızlandıran ve kolaylaştıran bir PHP sınıfı. Oldukça da güçlü bir sınıf olup, WordPress'in veritabanı alt yapısını da oluşturuyor. Sınıfın genel özellikleri şunlar;

  • Scriptinizin başında include ettiğiniz tek bir dosyadan oluşur. Ardından standart PHP veritabanı fonksiyonları erine daha kısa ve anlaşılır ezSQL fonksiyonlarını kullanabilirsiniz.
  • ezSQL otomatik olarak sorguları önbelleğe alır ve kolayca kullanabilmenize izin verir ayrıca da sunucuya ekstra yük bindirmez.
  • SQL sorgunuzu kontrol etmek (debug) etmeniz için harika fonksiyonlar sunar.
  • ezSQL fonksiyonlarının birçoğu Object (Nesne), Associative Arrays (Bağımlı Diziler) veya Numerical Arrays (Sayısal Diziler) şeklinde sonuç döndürebilirler.
  • Kod geliştirme sürenizi ve kod satır sayınızı oldukça düşürür, kodlarınızı hızlandırır, veritabanı sorgularınızı optimize etmenizi ve hata kontrolünüzü kolaylaştırır.
  • ezSQL küçük bir sınıftır ve web sitenize yük bindirmez.

Örnek Kullanımlar:

Örnek 1:
// Veritabanından çoklu kayıt seçimi ve bunların yazdırılması

$users = $db->get_results("SELECT name, email FROM users");
foreach ( $users as $user )
{
// Access data using object syntax
echo $user->name;
echo $user->email;
}
Örnek 2: Veritabanından bir kaydın alınıp, yazdırılması
$user = $db->get_row("SELECT name,email FROM users WHERE id = 2");
echo $user->name;
echo $user->email;
Örnek 3: Veritabanından tek bir değerin alınıp, yazdırılması
$var = $db->get_var("SELECT count(*) FROM users");
echo $var;
Örnek 4: Veritabanına kayıt işlemi
$db->query("INSERT INTO users (id, name, email) VALUES (NULL,'justin','jv@foo.com')");
Örnek 5: Kayıt güncelleme işlemi
$db->query("UPDATE users SET name = 'Justin' WHERE id = 2)");
Örnek 6: Son sorguyu ve sorgunun bütün sonuçlarını görüntüleme
$db->debug();
Örnek 7: Herhangi bir sorgunun ya da değişkenin yapısını ve içeriğini görüntüler
$results = $db->get_results("SELECT name, email FROM users");
$db->vardump($results);
Örnek 8: Veritabanından tek bir sütunu (sütun indeksine bağlı olarak) alma ve yazdırma işlemi
$names = $db->get_col("SELECT name,email FROM users",0)
foreach ( $names as $name )
{
echo $name;
}
Örnek 9: Yukarıdakinin aynısı fakat daha hızlı
foreach ( $db->get_col("SELECT name,email FROM users",0) as $name )
{
echo $name;
}
Örnek 10: Verilen veritabanının bütün yapısını görüntüleme
$db->select("my_database");
foreach ( $db->get_col("SHOW TABLES",0) as $table_name )
{

$db->debug();
$db->get_results("DESC $table_name");

}
$db->debug();

Sayfalar: 1 2 3 4 5


Bu yazının kısa bağlantısı http://www.yakupgovler.com/?p=65.

Yazılarımı RSS aboneliği ile takip edebilir, yeni yazılarıma kolaylıkla ulaşabilirsiniz. Bunun için ise RSS adresimi kullanabilirsiniz.


“ezSQL Veritabanı Sınıfı” yazısı için 29 Yorum

Bu yazıya yapılan yorumları dilerseniz, ( RSS 2.0 ) beslemesini kullanarak takibe alabilirsiniz.

  1. Muharrem ERİN dedi ki:

    Merhabalar. ezSQL isimli sınıfı bir projemde kullanıyorum ama bir sorunla karşılaştım. utf8_general_ci ile oluşturduğum veritabanımda, gene utf8 ile kodlanan sayfamdan veri eklediğimde Türkçe karakterlerde problem yaşıyorum. WordPress'de bu sınıf modifiye edilerek kullanılmış ve gerekli ayarlar yapılarak Türkçe karakterlerdeki problem çözülmüş. Ancak ben bir türlü bu problemi aşamadım. Bir çözüm yolu biliyorsanız anlatabilir misiniz?

    Şimdiden teşekkürler. 🙂

  2. Yakup Gövler dedi ki:

    WordPress'in dışında başka bir projede kullanmadığımdan böyle bir problemin varlığından haberim yoktu. Ceviz forumda yaptığım aramada aşağıdaki koda ulaştım ve bende başarılı oldu.
    Veritabanı nesnenizi oluşturduğunuz satırın hemen altına bunu ekleyin, yani kodlarınız aşağıdaki gibi görünmesi lazım.
    $db = new ezSQL_mysql('root','','deneme','localhost');

    define('DILADI', 'utf8');
    define('DILKARSILASTIRMASI','utf8_turkish_ci');
    $db->query("SET NAMES '". DILADI. "'");
    $db->query("SET CHARACTER SET " . DILADI);
    $db->query("SET COLLATION_CONNECTION = '". DILKARSILASTIRMASI ."'");

  3. Muharrem ERİN dedi ki:

    Çok teşekkür ediyorum. Denedim ve oldu. Karakter kodlamasını tanımlamayı düşündüm ama nerede kullanacağımı bilmiyordum. Tekrar tekrar teşekkür ediyorum. Bugün bütün gün kafamı ağrıtmıştı. Nasıl teşekkür etsem azdır 🙂

  4. Yakup Gövler dedi ki:

    Rica ederim, ben de birşeyler öğrendim. 😆

  5. Muharrem ERİN dedi ki:

    Merhabalar sayın hocam, gene bir problem yaşadım ve sizi rahatsız ettim. ezSQL ile herhangi bir recursive sorgu yaptığımda sorgu sonlanmıyor ve istediğim de olmuyor. Kodum şu şekilde:


    function page_tree_list($page_id) {
    global $db;
    $pages = $db -> get_results("SELECT id, page_id, title FROM "._SQLPREFIX_."pages WHERE page_id = '$page_id' ORDER BY line ASC");
    echo '';
    foreach ($pages as $page) {
    echo ''.$page -> title.'';
    page_tree_list($page -> page_id);
    }
    echo '';
    }

    Ama normalde kendim bir sorgu yazdığımda problemsiz döngü sonlanıyor.

    Eğer bu konuda bir bilginiz varsa yardımcı olabilirseniz sevinirim.

    Görüşmek üzere...

  6. Muharrem ERİN dedi ki:

    Afedersiniz galiba yukarıdaki yazım pek ❓

  7. Muharrem ERİN dedi ki:

    Afedersiniz klavyeme çay döküldü, tam yorum yazarken telaşa verdim eksik gönderdim, silebilirseniz sevinirim.

    Recursive fonksiyon ile ilgili eksik bilgi verdim galiba.

    Eğer sayfa herhangi bir sayfaya bağlı değilse page_id alanı 0 değerinde. Ama herhangi bir sayfaya bağlı ise page_id değeri bağlı bulunduğu sayfanın id'sine eşit.

    Yani fonksiyonumuzu
    page_tree_list(0);
    şeklinde çağırdığımızda buna benzer bir sonuç çıkması gerek:

    Kök sayfa 1
    - Sayfa 1 - 1
    - Sayfa 1 - 2
    -- Sayfa 1 - 1 - 2
    Kök Sayfa 2
    - Sayfa 2 - 1
    -- Sayfa 2 - 1 - 1
    -- Sayfa 2 - 1 - 2
    - Sayfa 2 - 2
    - Sayfa 2 - 3

    Ama yukarıda yazdığım gibi sorgu sonuçlanmıyor.

    Ayrıca yukarıda kodda ul ve li tagları çıkmamış.

    Yardımlarınızı bekliyorum, teşekkürler.

  8. Yakup Gövler dedi ki:

    İlk bakışta bir hata yok gibi görünse de sorgunuza daha dikkatli baktığımda, sorgu sonucunda sonsuz döngü oluşuyor gibi geldi bana. Şöyle ki;
    Fonksiyona ilk girdiğinde page_id=0 olanlardan birincisini aldı, dolayısıyla $page => page_id = 0 olur ve tekrar fonksiyona 0 değeri gönderilir. Acaba yanlış mı düşünüyorum?
    Çözüm döngü içerisindeki page_tree_list($page -> page_id); ifadesini page_tree_list($page -> id); yapmanız olabilir.

  9. Muharrem ERİN dedi ki:

    Aaa evet, nasıl oldu da gözümden kaçtı..

    Hızlı cevap için teşekkürler Hocam.

    Veriler listeleniyor ama, döngünün sonlandığı her noktada şu hatayı alıyırum:
    Warning: Invalid argument supplied for foreach() in C:\xampp\htdocs\root\card\admin\do_act\pages\new.php on line 20

    20. satırdaki kodumuz ise;
    foreach ($pages as $page) {

  10. Yakup Gövler dedi ki:

    Sorgu boş döndüğünde for each döngüsü hata verecektir. Malum bilgi yoksa atama da yok, atama yoksa döngü de yok.
    Bir if ile sorgunun boş olup olmadığını kontrol etmelisiniz.
    if ($pages) {
    foreach ($pages as $page) {
    bla bla bla
    } //for sonu
    } // if sonu
    Böyle ya da buna benzer bir kod ile sorgunun sonucunu kontrol etmelisiniz.

  11. Muharrem ERİN dedi ki:

    İnanın çok yardımcı oldunuz. Geliştirmekte olduğum bir haber sisteminde kullanıyorum bu sınıfı. İki defa problem yaşadım ikisinde de çok yardımcı oldunuz. Biter bitmez size de göndermek isterim, incelemeniz ve yorum yapmanız hoşuma gider.

    Tekrar tekrar teşekküler 🙂

  12. Yakup Gövler dedi ki:

    Projenizin bitmesini sabırsızlıkla bekliyor olacağım. Kendinize iyi bakın, projenizde başarılar.

  13. Muharrem ERİN dedi ki:

    Çok teşekkürler 🙂

  14. Doç.Dr. Süleyman Tarman dedi ki:

    Merhaba,
    Siteme üye olanların verilerini mysql veri tabanında tutuyorum. Üyelerin çeşitli bilgileri yanında bir de e-posta adresleri var. Bu veritabanına sürekli eklemeler oluyor. Zaman zaman üyelerin veritabanında kayıtlı bulunan e-posta adreslerine toplu HTML mesaj göndermek istiyorum ancak bu konuda çok aramama karşın bir bilgi bulamadım. Yardımcı olabilir misiniz?

    Teşekkürler ve iyi çalışmalar.

  15. Yakup Gövler dedi ki:

    Süleyman Bey,
    PHP ve veritabanı bilginizin düzeyini bilmiyorum. Sitenize baktım, sanırım html ile tasarlanmış ama sanırım sizin üyelikten kastınız forumunuza üye olunması. Eğer böyleyse forumunuzun yönetim panelinde üyelere mail atma fonksiyonu olması lazım. Forum scriptleri ile aram iyi değil.
    Yok eğer php ve veritabanı bilginiz varsa bu durumda PHP'nin mail() fonksiyonunu incelemenizi öneririm.
    forum.ceviz.net adresinin php bölümünde sorunuzu sorarsanız ya da arama yaparsanız, html mail yollama ile ilgili bayağı bir konuya ulaşabilirsiniz.
    Ayrıca http://www.dmry.net/php-ile-mail-gondermek adresinden php ile mail yollama hakkında ayrıntılı bilgi bulabilirsiniz.

  16. Doç.Dr. Süleyman Tarman dedi ki:

    Tekrar merhaba. Konu, forum üyeliği ya da php ile e-posta yollamak değil. Amacım veri tabanında kayıtlı olan e-posta adreslerine -adresleri mysql'den almak kaydıyla- mesaj gönderecek yazılımı ya da scripti bulmak. Yine de yanıtınız için teşekkür ederim.

  17. Fatih dedi ki:

    Bu güzel döküman için teşekkürler.

  18. hasan iltemir dedi ki:

    Merhabalar hocam ez sql ile çalışıyorum fakat farklı bir class oluşturup o class içerisinde get_results yada başka ez sql fonksiyonlarını çağırınca..

    "Fatal error: Call to a member function get_results() on a non-object in"

    hatası veriyor ez_sql.php yi bu classı oluşturduğum dosyada tanımladım...
    iyi çalışmalar

  19. Yakup Gövler dedi ki:

    Fonksiyonlarınızda ezSQL sınıfını kullanmak için
    $db değişkenini fonksiyon içerisinde global olarak tanımlamanız gerekir. Tabi buradaki $db sizin ezSQL'i kullanımınıza göre değişebilir.
    Örnek:
    function deneme() {
    global $db;
    $db->get_results(...
    .
    .
    .
    }

  20. hasan iltemir dedi ki:

    Teşekkürler hocam 2. sayfada açıklamışsınız zaten.. 🙂
    kafama takılan bir nokta ise oluşturulan sorguları işi bitince kendisi yok ediyor
    mysql_free_result($sorgu); tarzında bir ekleme yapmaya gerek kalmıyor dimi?

  21. tufan dedi ki:

    ezSQL framework'une yeni başlıyorum. Bu konuda makaleniz gerçekten faydalı oldu elinize sağlık.
    Benim bir sorum olacak;
    mysql_fetch_assoc($id) ile database de girilmiş son id'yi alıyordum.
    Bunu ezSQL de nasıl yapacağımı bulamadım?
    Yardımcı olursanız sevinirim.
    Teşekkürler

  22. tufan dedi ki:

    foreach ( $db->get_col("SELECT uid FROM user order by uid desc limit 1",0) as $son )
    {
    echo $son+1;
    }

    şeklinde yaptım 🙂

  23. Günay Yılmaz dedi ki:

    rand() kullanımı nasıl peki ezSQL sınıfında ?

  24. WordPress’in Veritabanı Sınıfı ve Kullanımı · Yakup Gövler'in Not Defteri dedi ki:

    [...] Gerçekten güçlü bir sınıf olan ezSQL ile ilgili ayrıntılı bilgiye benim yazdığım makale'den ya da post2cat (post_id, category_id) VALUES (13, 2)"); ID'si 13 olan yazıyı siler. [...]

  25. Ertuğrul Erkan dedi ki:

    Merhaba hocam. Sql kodlarını sql.php ye post ediyorum ve çalıştırılmasını sağlayama çalışıyorum fakat şöyle bir hata alıyorum;

    You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '\"insert into kelimeler(sozcuk,karsilik)values(\'ceo\',\'yonetici\')\"' at line 1 in C:\AppServ\www\sql\ez_sql_mysql.php on line 204
    \"insert into kelimeler(sozcuk,karsilik)values(\'ceo\',\'yonetici\')\"

    burada slashlar var, onları temizletiyorum fakat yine hata alıyorum acaba sorun nedir? unutmadan;

    "insert into kelimeler(sozcuk,karsilik)values('ceo','yonetici')"

    bu kodu post ediyorum sayfaya ve $db->query($_POST["sql"]); şeklinde çalıştırmaya çalışıyorum :/

  26. Yakup Gövler dedi ki:

    @Ertuğrul, muhtemelen sunucunuzda magic_quotes özelliği açıktır. Bu nedenle gönderilen bütün form bilgileri otomatik olarak addslash işleminden geçiriliyordur. Yani
    "insert into kelimeler(sozcuk,karsilik)values('ceo','yonetici')" şeklinde bir bilgiyi post ettiğinizde, diğer sayfadaki $_POST["sql"] değişkeninin değeri
    \"insert into kelimeler(sozcuk,karsilik)values(\'ceo\',\'yonetici\')\"
    olacaktır. Bu nedenle
    $db->query($_POST["sql"]); şeklinde kullanmadan önce $_POST["sql"] değişkenini bir yazdırın eğer slash olan şekliyle geliyorsa bu değişkene stripslashes fonksiyonunu uygulamanız gerekir.
    $db->query(stripslashes($_POST["sql"]));
    şeklinde kullanmanız uygun olacaktır.
    SQL ile ilgili uygulamalarda SQL sorgusunu çalıştırmadan önce oluşan SQL cümlesini echo ile yazdırmak her zaman hataları kontrol açısından önemlidir.
    Sitenizi inceledim, çok güzel, çalışmalarınızın devamını ve başarılar dilerim.

  27. Ertuğrul Erkan dedi ki:

    Teşekkürler hocam 🙂 Yakında daha güzel uygulama yayımlayacağım fakat biraz sorunlu 🙂 Bu arada dediğiniz gibi yaptım ( önceden de denemiştim ) problem devam ediyor :/ Ayrıca dediğiniz gibi sql kodlarını ( yani yolladığım kodlarıda ) kontrol ediyorum tabi;

    You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '"INSERT INTO kelimeler(sozcuk, karsilik) VALUES ('speed','hiz')"' at line 1 in C:\AppServ\www\sql\ez_sql_mysql.php on line 204

    yine de kodlarda problem var :/

  28. Ertuğrul Erkan dedi ki:

    Herkesten çok özür diliyorum fakat çözümü buldum ve paylaşmak istiyorum;

    Arkadaşlar ben kodu tırnaklı halde veriyormuşum;

    "INSERT INTO kelimeler(sozcuk, karsilik) VALUES ('speed','hiz')"

    fakat çift tırnak zaten karşı tarafta string olarak okunuyormuş tabi ki iki adet tırnakta hata veriyormuş.

    INSERT INTO kelimeler(sozcuk, karsilik) VALUES ('speed','hiz')

    diyerek direkt yolladım ve metin bazlı kabul edilerek okundu. iyi günler herkese.

  29. ffatih dedi ki:

    "Oldukça da güçlü bir sınıf olup, WordPress’in veritabanı alt yapısını da oluşturuyor."
    Hocam bu cümlen kullanmak için yeterli bir sebep :). Doyurucu anlatımınız için teşekkürler.