Veritabanlarıyla çalışırken çoğu zaman aşağıdaki dört temel işlemi yapmak isteriz.
- Ekleme ve güncelleme gibi sonuç döndürmeyen bir sorgu işletmek.
- Veritabanından tek bir değer almak.
- VT’den tek bir satır almak.
- VT’den gelen sonuçları listelemek
ezSQL bu dört işlemi aşağıdaki dört basit fonksiyon ile yapmamızı sağlar.
$db->query(sorgu)
$db->get_var(sorgu)
$db->get_row(sorgu)
$db->get_results(sorgu)
ezSQL’deki bu dört fonksiyon ile ihtiyaçlarımızın %99.9′unu karşılayabiliriz. Elbette ki bunların dışında farklı ve oldukça faydalı fonksiyonlar da var.
Önemli Not: Eğer ezSQL’i yazdığınız fonksiyonlarınızın içerisinde kullanmak istersek, sınıf değişkenini (Örnek: global $db;) global olarak fonksiyonun başında tanımlamalısınız.
Kurulum:
ezSQL’i indirin, zipli dosyayı web sunucunuza açın. Aslında zipli dosya içerisindeki shared klasöründeki ez_sql_core.php dosyasına ve eğer mysql ile kullanacaksanız mysql klasörü içerisindeki ez_sql_mysql.php dosyalarına ihtiyacınız var. Bu iki dosyayı çıkartıp, scriptinizle aynı klasöre koyduktan sonra aşağıdaki kodları scriptinizin başına ekleyin. Artık ezSQL fonksiyonlarını kullanabilirsiniz.
// ezSQL core include ediliyor
include_once “ez_sql_core.php”;
// ezSQL’le kullanmak istediğiniz veritabanı eklentisini include ediyoruz (burada mySQL kullanıyoruz)
include_once “ez_sql_mysql.php”;
// Veritabanı nesnesi oluşturuluyor ve veritabanına bağlantı kuruluyor
// Tek satırda – vt_kullanıcı_adı / vt_şifre / vt_ismi / vt_sunucu
$db = new ezSQL_mysql(‘vt_kullanıcı_adı’,'vt_şifre’,'vt_ismi’,'vt_sunucu’);
Not: Çoğu sistemde veritabanı sunucu ismi olarak “localhost†kullanılır. Ancak sunucu isminizin ne olduğunu bilmiyor ya da emin değilseniz, yöneticinizle irtibata geçmelisiniz.
ezSQL Fonksiyonları:
$db->get_results — Veritabanından (ya da önbelleğe alınan önceki sorgudan) çoklu kayıt sonuçlarını alır, listelemelerde kullanılabilir.
$db->get_row — VT’den (ya da önceki sorgudan) tek bir kaydı alır.
$db->get_col — Bir sorgunun (ya da önceki sorgunun) sonucunda tek bir sütunu alır. Sütun indeksine bağımlıdır.
$db->get_var — Bir kayıttan ya da veritabanından tek bir değeri alır.
$db->query — Veritabanına sorgu gönderir (ve eğer bir sonuç üretiliyorsa da bunu önbelleğe alır). Kayıt ekleme, silme, güncelleme, seçme sorguları için idealdir.
$db->debug — En son yapılan sorguyu ve eğer varsa sorgunun sonuçlarını görüntüler.
$db->vardump — Herhangi bir değişkenin yapısını ve içeriğini görüntüler.
$db->select — Kullanmak için farklı bir veritabanı seçer.
$db->get_col_info — Alan ismi, tipi gibi alanlarla ilgili bilgileri alır.
$db->hide_errors — Hataların görüntülenmesini engeller.
$db->show_errors — Hataların görünür olmasını sağlar.
$db->escape — Kullanıcıdan gelen değerleri zararsız hale getirir. Addslash fonksiyonu gibi çalışır.
$db = new db — Yeni veritabanı nesnesi oluştulur.
ezSQL değişkenleri
$db->num_rows — En son yapılan sorgudan dönen kayıt sayısını verir.
$db->insert_id — INSERT sql komutu kullanıldığında AUTO_INCRIMENT fonksiyonunun ürettiği ID’yi verir.
$db->rows_affected — Son yapılan kayıt ekleme, güncelleme veya silme işlemleri sonucunda etkilenen satır sayısını verir.
$db->num_queries — Script içerisinde çalıştırılan sorgu sayısını (önbelleğe alınanlar dışında) verir.
$db->debug_all — Eğer true (örnek: $db->debug_all = true;) değeri verilirse scriptin bütün sorguları ve sonuçlarını görüntüler.
$db->cache_dir — mySQL önbelleği için kullanılacak dizini belirtir.
$db->cache_queries — Sorgu sonuçlarını önbelleğe alınmasını ayarlar (bkz. mysql/disk_cache_example.php)
$db->cache_inserts — (bkz. mysql/disk_cache_example.php)
$db->use_disk_cache — (bkz. mysql/disk_cache_example.php)
$db->cache_timeout — Önbellek zaman aşımı süresi(bkz. mysql/disk_cache_example.php)
Şimdi de bu fonksiyon ve değişkenleri ayrıntılı olarak inceleyelim.
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.
Bu yazıya yapılan yorumları dilerseniz, ( 
Tarih: 27 Ekim 2007 Saat: 16:17
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.
Tarih: 27 Ekim 2007 Saat: 20:57
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 .”‘”);
Tarih: 27 Ekim 2007 Saat: 21:28
Ç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
Tarih: 27 Ekim 2007 Saat: 21:31
Rica ederim, ben de birşeyler öğrendim.
Tarih: 12 Aralık 2007 Saat: 00:04
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…
Tarih: 12 Aralık 2007 Saat: 00:06
Afedersiniz galiba yukarıdaki yazım pek
Tarih: 12 Aralık 2007 Saat: 00:14
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.
Tarih: 12 Aralık 2007 Saat: 00:27
İ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.
Tarih: 12 Aralık 2007 Saat: 00:35
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) {Tarih: 12 Aralık 2007 Saat: 00:41
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.
Tarih: 12 Aralık 2007 Saat: 00:47
İ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
Tarih: 12 Aralık 2007 Saat: 00:49
Projenizin bitmesini sabırsızlıkla bekliyor olacağım. Kendinize iyi bakın, projenizde başarılar.
Tarih: 12 Aralık 2007 Saat: 00:50
Çok teşekkürler
Tarih: 28 Aralık 2007 Saat: 16:22
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.
Tarih: 28 Aralık 2007 Saat: 17:18
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.
Tarih: 29 Aralık 2007 Saat: 00:19
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.
Tarih: 12 Şubat 2008 Saat: 11:30
Bu güzel döküman için teşekkürler.
Tarih: 26 Eylül 2008 Saat: 19:46
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
Tarih: 27 Eylül 2008 Saat: 14:18
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(…
.
.
.
}
Tarih: 28 Eylül 2008 Saat: 14:58
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?
Tarih: 09 Şubat 2009 Saat: 18:54
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
Tarih: 09 Şubat 2009 Saat: 19:03
foreach ( $db->get_col(“SELECT uid FROM user order by uid desc limit 1″,0) as $son )
{
echo $son+1;
}
şeklinde yaptım
Tarih: 17 Şubat 2009 Saat: 19:37
rand() kullanımı nasıl peki ezSQL sınıfında ?
Tarih: 17 Nisan 2009 Saat: 23:52
[...] 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. [...]
Tarih: 28 Nisan 2009 Saat: 17:55
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 :/
Tarih: 28 Nisan 2009 Saat: 18:26
@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.
Tarih: 28 Nisan 2009 Saat: 18:32
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 :/
Tarih: 28 Nisan 2009 Saat: 19:58
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.
Tarih: 09 Ekim 2009 Saat: 10:11
“Oldukça da güçlü bir sınıf olup, WordPress’in veritabanı alt yapısını da oluşturuyor.”
. Doyurucu anlatımınız için teşekkürler.
Hocam bu cümlen kullanmak için yeterli bir sebep