7.3. Zend_Db_Select

7.3.1. Wprowadzenie

Zend_Db_Select jest narzędziem pomagającym w budowaniu zapytań SQL SELECT w sposób niezależny od rodzaju bazy danych. Oczywiście nie może to być perfekcyjne, ale pomaga w tym, aby zapytania były przenośne pomiędzy różnymi systemami bazodanowymi. Dodatkowo pomaga to w uodpornieniu zapytań na ataki SQL injection.

Najprostszy sposób utworzenia instancji Zend_Db_Select to użycie metody Zend_Db_Adapter::select().

<?php
	
require_once 'Zend/Db.php';

$params = array (
    'host'     => '127.0.0.1',
    'username' => 'malory',
    'password' => '******',
    'dbname'   => 'camelot'
);

$db = Zend_Db::factory('PDO_MYSQL', $params);

$select = $db->select();
// $select jest teraz obiektem Zend_Db_Select skonfigurowanym do użycia z adapterem PDO_MYSQL.

?>

Wtedy konstruujesz zapytanie SELECT używając tego obiektu i jego metod, a następnie generujesz łańcuch znaków który przekazujesz spowrotem do obiektu Zend_Db_Adapter w celu wykonania zapytania.

<?php
	
//
// SELECT *
//     FROM round_table
//     WHERE noble_title = "Sir"
//     ORDER BY first_name
//     LIMIT 10 OFFSET 20
//

// możesz użyć stylu iteracyjnego...
$select->from('round_table', '*');
$select->where('noble_title = ?', 'Sir');
$select->order('first_name');
$select->limit(10,20);

// ...lub stylu łańcuchowego:
$select->from('round_table', '*')
       ->where('noble_title = ?', 'Sir')
       ->order('first_name')
       ->limit(10,20);

// pobieramy dane
$sql = $select->__toString();
$result = $db->fetchAll($sql);

// alternatywnie, możesz przekazać sam obiekt $select;
// Zend_Db_Adapter jest na tyle sprytny aby użyć funkcji __toString() 
// na obiektach Zend_Db_Select w celu otrzymania treści zapytania.
$result = $db->fetchAll($select);

?>

Możesz także użyć parametrów wstawianych w miejsce nazwanych znaczników, zamiast cytowania parametrów po kolei.

<?php
	
//
// SELECT *
//     FROM round_table
//     WHERE noble_title = "Sir"
//     ORDER BY first_name
//     LIMIT 10 OFFSET 20
//

$select->from('round_table', '*')
       ->where('noble_title = :title')
       ->order('first_name')
       ->limit(10,20);

// pobieramy wyniki używająć parametrów wstawianych w miejsce znaczników
$params = array('title' => 'Sir');
$result = $db->fetchAll($select, $params);

?>

7.3.2. Kolumny z tabel (FROM)

Aby wybrać kolumny z określonej tabeli, użyj metody from(), określając tabelę oraz kolumny których potrzebujesz. Możesz użyć aliasów dla tabel oraz kolumn, i możesz używać metody from() tyle razy ile potrzebujesz.

<?php
	
// tworzymy obiekt $db, zakładając, że adapter to Mysql
$select = $db->select();

// SELECT a, b, c FROM some_table
$select->from('some_table', 'a, b, c');
// równażnie:
$select->from('some_table', array('a', 'b', 'c');

// SELECT bar.col FROM foo AS bar
$select->from('foo AS bar', 'bar.col');

// SELECT foo.col AS col1, bar.col AS col2 FROM foo, bar
$select->from('foo', 'foo.col AS col1');
$select->from('bar', 'bar.col AS col2');

?>

7.3.3. Kolumny ze złączonych tabel (JOIN)

Aby wybrać kolumny używając złączonych tabel, użyj metody join(). Wpierw określ nazwę złączanej tabeli, następnie wyrażenie łączące, a na końcu kolumny które potrzebujesz dołączyć. Możesz użyć metody join() tyle razy ile potrzebujesz.

<?php
	
// tworzymy obiekt $db, zakładając, że adapter to Mysql
$select = $db->select();

//
// SELECT foo.*, bar.*
//     FROM foo
//     JOIN bar ON foo.id = bar.id
//
$select->from('foo', '*');
$select->join('bar', 'foo.id = bar.id', '*');

?>

Obecnie jedynie składnia JOIN jest obsługiwana; nie ma możliwości użycia składni LEFT JOIN, RIGHT JOIN, itp. W przyszłości składnia ta będzie obsługiwana w sposób niezależny dla każdego typu bazy danych.

7.3.4. Warunki WHERE

Aby dodać warunki WHERE, użyj metody where(). Możesz przekazać zwykły łańcuch znaków lub możesz przekazać łańcuch znaków ze znacznikiem w postaci znaku zapytania oraz wartość która ma być zacytowana. (wartość będzie zacytowana za pomocą metody Zend_Db_Adapter::quoteInto).

Kolejne wywołania where() będą łączyć warunki za pomocą AND; jeśli chcesz je złączyć za pomocą OR, użyj metody orWhere().

<?php
	
// tworzymy obiekt $db, a następie odbieramy narzędzie SELECT.
$select = $db->select();

//
// SELECT *
//     FROM round_table
//     WHERE noble_title = "Sir"
//     AND favorite_color = "yellow"
//
$select->from('round_table', '*');
$select->where('noble_title = "Sir"'); // osadzona wartość
$select->where('favorite_color = ?', 'yellow'); // cytowana wartość

//
// SELECT *
//     FROM foo
//     WHERE bar = "baz"
//     OR id IN("1", "2", "3")
//
$select->from('foo', '*');
$select->where('bar = ?', 'baz');
$select->orWhere('id IN(?)', array(1, 2, 3);

?>

7.3.5. Warunek GROUP BY

Aby grupować wiersze użyj metody group() tyle razy ile potrzebujesz.

<?php
	
// tworzymy obiekt $db, a następie odbieramy narzędzie SELECT.
$select = $db->select();

//
// SELECT COUNT(id)
//     FROM foo
//     GROUP BY bar, baz
//
$select->from('foo', 'COUNT(id)');
$select->group('bar');
$select->group('baz');

// wywołanie metody group():
$select->group('bar, baz');

// inny sposób wywołania metody group():
$select->group(array('bar', 'baz'));

?>

7.3.6. Warunki HAVING

Aby dodać warunki HAVING dla wybranych wyników użyj metody having(). Ta metoda jest identyczna w użyciu jak metoda where().

Kolejne wywołania having() będą łączyć warunki za pomocą AND; jeśli chcesz je złączyć za pomocą OR, użyj metody orHaving().

<?php
	
// tworzymy obiekt $db, a następie odbieramy narzędzie SELECT.
$select = $db->select();

//
// SELECT COUNT(id) AS count_id
//     FROM foo
//     GROUP BY bar, baz
//     HAVING count_id > "1"
//
$select->from('foo', 'COUNT(id) AS count_id');
$select->group('bar, baz');
$select->having('count_id > ?', 1);

?>

7.3.7. Warunek ORDER BY

Aby sortować dane użyj metody order() tyle razy ile potrzebujesz.

<?php
	
// tworzymy obiekt $db, a następie odbieramy narzędzie SELECT.
$select = $db->select();

//
// SELECT * FROM round_table
//     ORDER BY noble_title DESC, first_name ASC
//
$select->from('round_table', '*');
$select->order('noble_title DESC');
$select->order('first_name');

// wywołanie metody order():
$select->order('noble_title DESC, first_name');

// inny sposób wywołania metody order():
$select->order(array('noble_title DESC', 'first_name'));

?>

7.3.8. LIMIT w oparciu o ilość wyników i offset

Zend_Db_Select oferuje obsługę bazodanowej składni LIMIT. Dla wielu baz danych, np. MySQL czy PostgreSQL, jest to relatywnie proste, ponieważ obsługują one składnię "LIMIT :count [OFFSET :offset]".

Dla innych baz danych, takich jak Microsoft SQL czy Oracle, nie jest to takie proste, ponieważ nie obsługują one składni LIMIT. MS-SQL posiada jedynie składnię TOP, a Oracle wymaga zapytań napisanych w specjalny sposób aby emulować LIMIT. Dzięki temu, że Zend_Db_Select działa wewnętrznie, możemy w locie przepisać zapytanie SELECT aby emulować funkcjonalność LIMIT wyżej wymienionych systemów bazodanowych open-source.

Aby limitować zwracane wyniki na podstawie ilości i offsetu użyj metody limit() podając ilość oraz opcjonalny offset.

<?php
	
// na początek prosty "LIMIT :count"
$select = $db->select();
$select->from('foo', '*');
$select->order('id');
$select->limit(10);

//
// W MySQL/PostgreSQL/SQLite odpowiada to zapytaniu:
//
// SELECT * FROM foo
//     ORDER BY id ASC
//     LIMIT 10
//
// A w Microsoft SQL odpowiada to zapytaniu:
//
// SELECT TOP 10 * FROM FOO
//     ORDER BY id ASC
//
//

// a teraz bardziej złożony "LIMIT :count OFFSET :offset"
$select = $db->select();
$select->from('foo', '*');
$select->order('id');
$select->limit(10, 20);

//
// W MySQL/PostgreSQL/SQLite odpowiada to zapytaniu:
//
// SELECT * FROM foo
//     ORDER BY id ASC
//     LIMIT 10 OFFSET 20
//
// Ale w Microsoft SQL, który nie obsługuje offset, odpowiada to zapytaniu:
//
// SELECT * FROM (
//     SELECT TOP 10 * FROM (
//         SELECT TOP 30 * FROM foo ORDER BY id DESC
//     ) ORDER BY id ASC
// )
//
// Zend_Db_Adapter automatycznie tłumaczy zapytanie.
//

?>

7.3.9. LIMIT w oparciu o ilość wyników i numer strony

Zend_Db_Select oferuje limitowanie wyników oparte na stronach. Jeśli chcesz pobrać pewną stronę wyników, użyj metody limitPage(); wpierw przekaż numer strony którą potrzebujesz, a nąstępnie ilość wierszy jaka ma się pojawiać na każdej ze stron.

<?php
	
// budujemy podstawowe zapytanie select...
$select = $db->select();
$select->from('foo', '*');
$select->order('id');

// ... i limitujemy do strony 3 gdzie każda strona ma 10 wierszy
$select->limitPage(3, 10);

//
// W MySQL/PostgreSQL/SQLite, odpowiada to zapytaniu:
//
// SELECT * FROM foo
//     ORDER BY id ASC
//     LIMIT 10 OFFSET 20
//

?>