6.3. Zend_Db_Select
Poprzedni | Rozdział 6. Zend_Db | Następny

## 6.3. Zend_Db_Select

### 6.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);

    ?>

### 6.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');

    ?>

### 6.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.

### 6.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);

    ?>

### 6.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'));

    ?>

### 6.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);

    ?>

### 6.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'));

    ?>

### 6.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.
    //

    ?>

### 6.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
    //

    ?>

Poprzedni | Początek rozdziału | Następny
6.2. Zend_Db_Profiler | Spis treści | 6.4. Zend_Db_Table