Previous Next

Zend_Db_Select

Übersicht des Select Objekts

Das Zend_Db_Select Objekt repräsentiert ein SQL SELECT Anfrage Statement. Die Klasse bietet Methoden um einzelne Teile der Anfrage hinzuzufügen. Einzelne Teile der Anfrage können mit Hilfe von PHP Methoden und Datenstrukturen angegeben werden, und die Klasse erzeugt korrekte SQL Syntax. Nachdem die Anfrage formuliert wurde kann sie ausgeführt werden als wäre sie mit einem normalen String geschrieben worden.

Zend_Db_Select bietet folgenden Nutzen:

  • Objekt Orientierte Methoden um SQL Anfragen Stück für Stück zu formulieren.

  • Datenbank unabhängige Abstraktion einiger Teile der SQL Anfrage.

  • In den meisten Fällen automatische Quotierung von Metadaten um Bezeichner zu unterstützen welche reservierte SQL Wörter und spezielle Zeichen enthalten.

  • Quotierung von Bezeichnern und Werten um dabei zu helfen das Risiko von SQL Injektion Attacken zu reduzieren.

Nutzung von Zend_Db_Select ist nicht zwingend erforderlich. Für einfache SELECT Anfragen ist es normalerweise einfacher die gesamte SQL Anfrage in einem String zu formulieren und mit Hilfe der Methoden der Adapterklasse, wie fetch() oder fetchAll(), auszuführen. Die Nutzung von Zend_Db_Select ist hilfreich wenn eine SELECT Anfrage prozedural oder basierend auf der konditionellen Logik der Anwendung zusammengesetzt wird.

Erzeugung eines Select Objekts

Die Instanz eines Zend_Db_Select Objekts kann mit Hilfe der select() Methode des Zend_Db_Adapter_Abstract Objekts erzeugt werden.

Example #1 Beispiel für die Nutzung der select() Methode der Datenbankadapterklasse

select();

Ein anderer Weg ein Zend_Db_Select Objekt zu erzeugen ist die Nutzung des Konstruktors unter Angabe des Datenbankadapters als Argument.

Example #2 Beispiel für die Erzeugung eines Select Objektes




        

Erstellung von Select Anfragen

Wenn die Anfrage erstellt wird können Bedingungen der Anfrage nacheinander hinzugefügt werden. Es gibt eine seperate Methode für das Hinzufügen von verschiedenen Bedingungen zum Zend_Db_Select Objekt.

Example #3 Beispiele für die Nutzung der Methoden zum Hinzufügen von Bedingungen

select();

// Hinzufügen einer FROM Bedingung
$select->from( ...Angabe von Tabelle und Spalten... )

// Hinzufügen einer WHERE Bedingung
$select->where( ...Angabe von Suchkriterien... )

// Hinzufügen einer ORDER BY Bedingung
$select->order( ...Angabe von Sortierkriterien... );

Die meisten Methoden des Zend_Db_Select Objekts lassen sich auch über das bequeme Fluent Interface nutzen. Fluent Interface bedeutet das jede Methode eine Referenz auf das aufrufende Objekt zurück gibt, daher kann direkt eine andere Methode aufgerufen werden.

Example #4 Beispiel für die Nutzung der flüssigen Schnittstelle

select()
    ->from( ...Angabe von Tabelle und Spalten... )
    ->where( ...Angabe von Suchkriterien... )
    ->order( ...Angabe von Sortierkriterien... );

Die Beispiele in diesem Abschnitt zeigen die Nutzung des Fluent Interface, es kann aber auch immer das normale Interface verwendet werden. Häufig ist es nötig das normale Interface zu nutzen, zum Beispiel wenn die Anwendung vor dem Hinzufügen der Bedingung Berechnungen durchführen muss.

Hinzufügen eines FROM Abschnitts

Um die Tabelle für die Anfrage an zu geben wird die from() Methode verwendet. Der Tabellenname kann als einfacher String übergeben werden. Zend_Db_Select wendet Bezeichner Quotierung an, es können also auch spezielle Zeichen verwendet werden.

Example #5 Beispiel für die from() Methode

select()
    ->from( 'products' );

Es kann auch der Beziehungsname (auch Aliasname genannt) einer Tabelle angegeben werden. Anstelle eines einfachen Strings muss dann ein assoziatives Array übergeben werden, welches den Beziehungsnamen dem tatsächlichen Tabellennamen zuordnet. In anderen Bedingungen der SQL Anfrage kann dann dieser Beziehungsname verwendet werden. Wenn die Anfrage mehr als eine Tabelle verbindet, generiert Zend_Db_Select eindeutige Beziehungsnamen basierend auf den Tabellennamen, wenn keine Beziehungsnamen angegeben wurden.

Example #6 Beispiel für das Angeben eines Beziehungsnamens

select()
    ->from( array('p' => 'products') );

Einige RDBMS Marken unterstützen einen voran stehenden Schemenbezeichner für eine Tabelle. Der Tabellenname kann mit "schemaName.tabellenName" angegeben werden, Zend_Db_Select Quotiert die einzelnen Teile für sich. Der Schemaname kann aber auch separat angegeben werden. Ein Schemaname, der mit dem Tabellennamen angegeben wurde bekommt Vorrang, falls beides angegeben wurde.

Example #7 Beispiel für das Angeben eines Schemanamens

select()
    ->from( 'myschema.products' );

// oder

$select = $db->select()
    ->from('products', '*', 'myschema');

Hinzufügen von Spalten

Im zweiten Argument der from() Methode kann angegeben werden, welche Spalten der Tabelle ausgelesen werden sollen. Werden keine Spalten angegeben, so gilt der Standardwert *, der SQL Platzhalter für alle Spalten.

Die Spalten können in einem einfachen Array von Strings oder einem assoziativen Array, in dem Aliasnamen a Spaltennamen zugewiesen werden, angegeben werden. Soll nur eine einzelne Spalte ohne Aliasnamen ausgelesen werden, so kann auch ein einfacher String übergeben werden.

Wird ein leeres Array übergeben, so werden auch keine Spalten der Tabelle in den Ergebnissatz aufgenommen. Ein Codebeispiel gibt es unter code example bei der join() Methode.

Der Spaltenname kann mit "beziehungsName.spaltenName" angegeben werden. Zend_Db_Select Quotiert die einzelnen Teile für sich. Wird kein Beziehungsname für die Spalte angegeben, dann wird der Beziehungsname der Tabelle der aktuellen from() Methode verwendet.

Example #8 Beispiele für das Angeben von Spalten

select()
    ->from(array('p' => 'products'),
        array('product_id', 'product_name'));

// Erzeugt dieselbe Anfrage, Angabe von Beziehungsnamen:
//   SELECT p."product_id", p."product_name"
//   FROM "products" AS p

$select = $db->select()
    ->from(array('p' => 'products'),
        array('p.product_id', 'p.product_name'));

// Erzeugt diese Anfrage mit einem Alias für eine Spalte:
//   SELECT p."product_id" AS prodno, p."product_name"
//   FROM "products" AS p

$select = $db->select()
    ->from(array('p' => 'products'),
        array('prodno' => 'product_id', 'product_name'));

Hinzufügen von Spalten mit Expressions

Spalten in einer SQL Anfrage sind manchmal Expressions, keine einfachen Spaltennamen einer Tabelle. Expressions dürfen keine Beziehungsnamen oder Quotierungen bekommen. Wenn der Spaltenstring runde Klammern enthält erkennt Zend_Db_Select dies als eine Expression.

Es kann auch ein Objekt des Typs Zend_Db_Expr erzeugt werden um zu verhindern das ein String wie ein Spaltenname behandelt wird. Zend_Db_Expr ist eine Minimalklasse die einen String enthält. Zend_Db_Select erkennt Objekte des Typs Zend_Db_Expr und konvertiert diese in Strings, nimmt aber keine Änderungen daran vor, wie Quotierung oder Beziehungsnamen.

Note:

Benutzung von Zend_Db_Expr für Spaltennamen ist nicht nötig wenn Spaltennamen Expressions runde Klammern enthalten. Zend_Db_Select erkennt diese und behandelt den String als eine Expression und lässt Quotierung und Beziehungsnamen aus.

Example #9 Beispiel für das angeben von Spaltennamen, die Expressions enthalten

select()
    ->from(array('p' => 'products'),
        array('product_id', 'LOWER(product_name)'));

// Erzeugt diese Anfrage:
//   SELECT p."product_id", (p.cost * 1.08) AS cost_plus_tax
//   FROM "products" AS p

$select = $db->select()
    ->from(array('p' => 'products'),
        array('product_id', 'cost_plus_tax' => '(p.cost * 1.08)'));

// Erzeugt diese Anfrage unter ausdrücklicher Verwendung  von Zend_Db_Expr:
//   SELECT p."product_id", p.cost * 1.08 AS cost_plus_tax
//   FROM "products" AS p

$select = $db->select()
    ->from(array('p' => 'products'),
        array('product_id', 'cost_plus_tax' => new Zend_Db_Expr('p.cost * 1.08')));

In den oben stehenden Fällen ändern Zend_Db_Select den String nicht mit Beziehungsnamen oder Bezeichnerquotierung. Wenn diese Änderungen notwendig sein sollten um doppeldeutigkeiten auf zu lösen, muss dies manuell am String geändert werden.

Wenn die Spaltennamen aus SQL Schlüsselwörtern besteht oder spezielle Zeichen enthält sollte die quoteIdentifier() Methode verwendet werden und der Rückgabewert in den String eingefügt werden. Die quoteIdentifier() Methode verwendet SQL Quotierung um Bezeichner abzugrenzen, wodurch klar wird, das es sich um einen Bezeichner für eine Tabelle oder Spalte handelt, und nicht um einem anderen Teil der SQL Syntax.

Der Code wird Datenbank unabhängiger wenn die quoteIdentifier() Methode anstelle von direkter Eingabe der Quotierungszeichen verwendet wird, da einige RDBMS Marken nicht-Standard Symbole für die Quotierung von Bezeichnern verwenden. Die quoteIdentifier() Methode wählt die passenden Quotierungssymbole für den Adaptertyp aus, und ersetzt außerdem alle Quotierungszeichen innerhalb des Bezeichners.

Example #10 Beispiel für die Quotierung von Spalten in einer Expression

select()
    ->from(array('p' => 'products'),
        array('origin' => '(p.' . $db->quoteIdentifier('from') . ' + 10)'));

Spalten zu einer existierenden FROM oder JOIN Tabelle hinzufügen

Es kann Fälle geben wo es gewünscht ist Spalten zu einer bestehenden FROM oder JOIN Tabelle hinzuzufügen nachdem diese Methoden aufgerufen wurde. Die columns() Methode erlaubt es spezifische Spalten an jedem Punkt hinzuzufügen bevor die Abfrage aufgeführt wird. Die Spalte kann entweder als String oder Zend_Db_Expr oder als Array dieser Elemente angegeben werden. Das zweite Argument dieser Methode kann unterdrückt werden, was impliziert das die Spalten zu der FROM Tabelle hinzugefügt werden sollen, andernfall muß ein bestehender Korrelationsname verwendet werden.

Example #11 Beispiel für das hinzufügen von Spalten mit der columns() Methode

select()
    ->from(array('p' => 'products'), 'product_id')
    ->columns('product_name');

// Die selbe Abfrage bauen, durch spezifizierung der Korrelationsnamen:
//   SELECT p."product_id", p."product_name"
//   FROM "products" AS p

$select = $db->select()
    ->from(array('p' => 'products'), 'p.product_id')
    ->columns('product_name', 'p'); // Alternativ kann columns('p.product_name') verwendet werden

Hinzufügen einer weiteren Tabelle zu der Anfrage mit JOIN

Viele nützliche Anfragen benötigen ein JOIN um mehrere Spalten verschiedener Tabellen miteinander zu kombinieren. Tabellen können zu einer Zend_Db_Select Anfrage mit der join() Methode hinzugefügt werden. Die Nutzung dieser Methode ist ähnlich der from() Methode, außer das in den meisten Fällen zusätzlich eine Join Bedingung angegeben werden kann.

Example #12 Beispiel für die join() Methode

select()
    ->from(array('p' => 'products'),
        array('product_id', 'product_name'))
    ->join(array('l' => 'line_items'),
        'p.product_id = l.product_id');

Das zweite Argument der join() Methode ist ein String mit der Join Bedingung. Dies ist eine Exspression die Kriterien angibt, welche Zeilen in der einen Tabelle mit Zeilen einer anderen Tabelle verknüpft werden. Es können Beziehungsnamen in dieser Expression verwendet werden.

Note:

Es wird keine Quotierung auf die Expression für die Join Bedingung angewendet. Werden Spaltennamen verwendet, welche Quotierung benötigen, so muss quoteIdentifier() verwendet werden wenn der String für die Join Bedingung formuliert wird.

Das dritte Argument für join() ist ein Array von Spaltennahmen, entsprechend des Arrays der from() Methode. Der Standard ist ebenfalls "*" und unterstützt Beziehungsnamen, Expressions und Zend_Db_Expr in der gleichen Weise wie dem Array von Spaltennamen der from() Methode.

Wenn keine Spalten einer Tabelle ausgewählt werden soll muss ein leeres Array für die Liste der Spaltennamen übergeben werden. Diese Nutzung funktioniert ebenfalls in der from() Methode, aber normalerweise werden einige Spalten der primären Tabelle in den Anfragen benötigt, während möglicherweise keine Spalten der verbundenen Tabelle ausgewählt werden sollen.

Example #13 Beispiel für das Angeben keiner Spalten

select()
    ->from(array('p' => 'products'),
        array('product_id', 'product_name'))
    ->join(array('l' => 'line_items'),
        'p.product_id = l.product_id',
        array() ); // leere Liste von Spalten

Zu beachten ist das leere array() in dem oben stehenden Beispiel, am Stelle einer Liste von Spalten der verbundenen Tabelle.

SQL kennt verschiedene Typen von Joins. In der unten stehen Liste sind Methoden zu finden, für die verschiedenen Join Typen die Zend_Db_Select unterstützt.

  • INNER JOIN mit den join(tabelle, join, [spalten]) oder joinInner(tabelle, join, [spalten]) Methoden.

    Dies wird der gebräuchlichste Typ von Join sein. Zeilen jeder Tabelle werden mit Hilfe der angegebenen Join Bedingung verglichen. Der Ergebnissatz enthält nur die Zeilen die der Join Bedingungen entsprechen. Der Ergebnissatz kann leer sein, wenn keine Zeile die Bedingung erfüllt.

    Alle RDBMS Marken unterstützen diesen Join Typ.

  • LEFT JOIN mit der joinLeft(tabelle, bedingung, [spalten]) Methode.

    Alle Zeilen der links vom Operanden stehenden Tabelle sind enthalten, passende Zeilen der rechts stehenden Tabelle sind ebenfalls enthalten. Die Spalten der rechts stehenden Tabelle werden mit NULL aufgefüllt, wenn keine zu der linken Tabelle passenden Zeilen existieren.

    Alle RDBMS Marken unterstützen diesen Join Typ.

  • RIGHT JOIN mit der joinRight(tabelle, bedingung, [spalten]) Methode.

    Right Outer Join ist das Gegenstück zu Left Outer Join. Alle Zeilen der rechts vom Operanden stehenden Tabelle sind enthalten, passende Zeilen der links stehenden Tabelle sind ebenfalls enthalten. Die Spalten der links stehenden Tabelle werden mit NULL aufgefüllt, wenn keine zu der rechten Tabelle passenden Zeilen existieren.

    Einige RDBMS Marken unterstützen diesen Join Typ nicht, aber grundsätzlich kann jeder Right Join durch einen Left Join mit umgekehrter Sortierung der Tabellen dargestellt werden.

  • FULL JOIN mit der joinFull(tabelle, bedingung, [spalten]) Methode.

    Ein Full Outer Join ist wie eine Kombination eines Left Outer Join mit einem Right Outer Join. Alle Zeilen beider Tabellen sind enthalten, gepaart miteinander in der gleichen Zeile des Ergebnissatzes wenn die Join Bedingung erfüllt wird, oder wenn nicht, mit NULL an Stelle der Spalten der anderen Tabelle.

    Einige RDBMS Marken unterstützen diesen Join Typ nicht.

  • CROSS JOIN mit der joinCross(tabelle, [spalten]) Methode.

    Ein Cross Join ist ein Kartesisches Produkt. Jede Zeile der ersten Tabelle wird mit jeder Zeile der zweiten Tabelle verbunden. Daher ist die Anzahl der Zeilen im Ergebnissatz gleich dem Produkt der Zeilenanzahlen der beiden Tabellen. Der Ergebnissatz kann mit Bedingungen einer WHERE Bedingung gefiltert werden. Ein Cross Join ist ähnlich der alten SQL-89 JOIN Syntax.

    Die joinCross() Methode hat keinen Parameter für die Join Bedingung. Einige RDBMS Marken unterstützen diesen Join Typ nicht.

  • NATURAL JOIN mit der joinNatural(tabelle, [spalten]) Methode.

    Ein Natural Join vergleicht alle Spalten die in beiden Tabellen mit gleichem Namen vorkommen. Der Vergleich prüft Gleichheit aller Spalten, ein Vergleich auf Ungleichheit ist kein Natural Join. Von dieser API werden nur Natural Inner Joins unterstützt, auch wenn SQL auch Natural Outer Joins erlaubt.

    Die joinNatural() Methode hat keinen Parameter für die Join Bedingung.

Zusätzlich zu diesen Join Methoden können Abfragen durch Verwendung der JoinUsing Methoden vereinfacht werden. Statt das eine komplette Definition des Joins angegeben wird, kann einfach der Spaltenname übergeben werden auf welchem gejoint werden soll und das Zend_Db_Select Objekt vervollständigt die Bedingung alleine.

Example #14 Beispiel für die joinUsing() Methode

select()
    ->from('table1')
    ->joinUsing('table2', 'column1')
    ->where('column2 = ?', 'foo');

Jede der anwendbaren Join Methoden in der Zend_Db_Select Komponente hat eine entsprechende 'using' Methode.

  • joinUsing(table, join, [columns]) und joinInnerUsing(table, join, [columns])

  • joinLeftUsing(table, join, [columns])

  • joinRightUsing(table, join, [columns])

  • joinFullUsing(table, join, [columns])

Hinzufügen eines WHERE Abschnitts

Es können Kriterien die den Ergebnissatz einschränken mit der where() Methode angegeben werden. Das erste Argument dieser Methode ist eine SQL Expression, welche im WHERE Abschnitt der Anfrage steht.

Example #15 Beispiel für die where() Methode

 100.00

$select = $db->select()
    ->from(
        'products',
        array('product_id', 'product_name', 'price'))
    ->where('price > 100.00');

Note:

Auf Expressions die an where() oder orWhere() Methoden übergeben werden, wird keine Quotierung angewendet. Werden Spaltennamen verwendet die Quotiert werden müssen, so muss quoteIdentifier() verwendet werden wenn der String für die Bedingung formuliert wird.

Das zweite Argument der where() Methode ist optional. Es ist ein Wert der in die Expression eingesetzt wird. Zend_Db_Select Quotiert den Wert und ersetzt ihn für ein Fragezeichen ("?") in der Expression.

Wenn in eine Expression mehr als eine Variable eingesetzt werden soll muss der String manuell formatiert werden und die Variablen müssen von Hand quotiert und eingesetzt werden.

Example #16 Beispiel für einen Parameter in der where() Methode

 100.00)

$minimumPrice = 100;

$select = $db->select()
    ->from(
        'products',
        array('product_id', 'product_name', 'price'))
    ->where('price > ?', $minimumPrice);

Die where() Methode kann mehrere Male in dem selben Zend_Db_Select Objekt aufgerufen werden. Die daraus folgenden Anfrage kombiniert die unterschiedlichen Ausdrücke unter Benutzung von AND zwischen ihnen.

Example #17 Beispiel für mehrfach Aufruf der where() Methode

 100.00)
//     AND (price < 500.00)

$minimumPrice = 100;
$maximumPrice = 500;

$select = $db->select()
    ->from('products',
        array('product_id', 'product_name', 'price'))
    ->where('price > ?', $minimumPrice)
    ->where('price < ?', $maximumPrice);

Wenn mehrere Ausdrücke mit OR verknüpft werden sollen kann die orWhere() Methode verwendet werden. Sie wird genauso benutzt wie die where() Methode, außer das dem angegebene Ausdruck ein OR vorangestellt wird, anstelle eines AND.

Example #18 Beispiel für die orWhere() Methode

 500.00)

$minimumPrice = 100;
$maximumPrice = 500;

$select = $db->select()
    ->from('products',
        array('product_id', 'product_name', 'price'))
    ->where('price < ?', $minimumPrice)
    ->orWhere('price > ?', $maximumPrice);

Zend_Db_Select klammert Expressions automatisch mit runden Klammern ein wenn sie mit der where() oder orWhere() Methode angegeben wurden. Dies hilft sicher zu stellen dass das voranstellen von Boolean Operatoren keine unerwarteten Ergebnisse nach sich zieht.

Example #19 Beispiel für das einklammern von Boolean Expressions

 500.00)
//     AND (product_name = 'Apple')

$minimumPrice = 100;
$maximumPrice = 500;
$prod = 'Apple';

$select = $db->select()
    ->from('products',
        array('product_id', 'product_name', 'price'))
    ->where("price < $minimumPrice OR price > $maximumPrice")
    ->where('product_name = ?', $prod);

In dem oben stehenden Beispiel währen die Ergebnisse ohne den Klammern ziemlich anders, weil AND eine höhere Priorität als OR hat. Zend_Db_Select erzeugt runde Klammern wodurch jede Expression von aufeinander folgenden Aufrufen der where() Methode fester binden als das AND welches die Expressions kombiniert.

Hinzufügen eines GROUP BY Abschnitts

In SQL ermöglicht der GROUP BY Abschnitt die Zeilenzahl des Ergebnissatzes auf eine Zeile pro eindeutigem Wert der Spalte(n), welche in dem GROUP BY Abschnitt benannt sind, einzuschränken.

In Zend_Db_Select können diese Spalte(n) mit der group() Methode angegeben werden. Das Argument der Methode ist ein Spaltenname oder ein Array von Spaltennamen, welche im GROUP BY Abschnitt stehen sollen.

Example #20 Beispiel für die group() Methode

select()
    ->from(array('p' => 'products'),
        array('product_id'))
    ->join(array('l' => 'line_items'),
        'p.product_id = l.product_id',
        array('line_items_per_product' => 'COUNT(*)'))
    ->group('p.product_id');

Wie in dem Array von Spaltennamen der from() Methode, so können auch hier Beziehungsnamen in den Strings der Spaltennamen verwendet werden, und der Spaltenname wird als Bezeichner Quotiert, wenn er nicht in runden Klammern steht oder ein Objekt des Typs Zend_Db_Expr ist.

Hinzufügen eines HAVING Abschnittes

In SQL fügt der HAVING Abschnitt eine Beschränkungsbedingung für Gruppen von Zeilen ein. Dies ist ähnlich der Einschränkungsbedingungen auf Zeilen, des WHERE Abschnittes. Die beiden Abschnitte unterscheiden sich jedoch, denn die WHERE Bedingungen werden abgewendet bevor Gruppen definiert wurden. Im Gegensatz werden HAVING Bedingungen erst angewendet nach dem Gruppen definiert wurden.

In Zend_Db_Select können Bedingungen für die Einschränkung von Gruppen mit der having() Methode angegeben werden. Die Nutzung ist ähnlich wie die der where() Methode. Das erste Argument ist ein String, welcher eine SQL Expression enthält. Das zweite Argument ist optional und wird verwendet um einen positionierten Parameter Platzhalter in der SQL Expression zu ersetzen. Expressions die durch mehrfaches Aufrufen der having() Methode erzeugt wurden werden mit dem Boolean AND Operator verknüpft, oder mit dem OR Operator wenn die orHaving() Methode verwendet wird.

Example #21 Beispiel für die having() Methode

 10

$select = $db->select()
    ->from(array('p' => 'products'),
        array('product_id'))
    ->join(array('l' => 'line_items'),
        'p.product_id = l.product_id',
        array('line_items_per_product' => 'COUNT(*)'))
    ->group('p.product_id')
    ->having('line_items_per_product > 10');

Note:

Es wird keine Quotierung bei den Expressions welche an die having() oder orHaving() Methoden übergeben werden. Werden Spaltennamen verwendet die Quotiert werden müssen, so muss quoteIdentifier() verwendet werden wenn der String für die Bedingung formuliert wird.

Hinzufügen eines ORDER BY Abschnitts

In SQL gibt der ORDER BY Abschnitt eine oder mehrere Spalten oder Expressions an, wonach ein Ergebnissatz sortiert wird. Wenn mehrere Spalten angegeben sind, werden die sekundären Spalten verwendet um "ties" aufzulösen; die Sortierung wird von sekundären Spalten bestimmt, wenn vorhergehende Spalten identische Werte enthalten. Die standard Sortierung ist vom kleinsten zum größten Wert. Dieses Verhalten kann umgekehrt werden, wenn das Schlüsselwort DESC nach der Spalte angegeben wird.

In Zend_Db_Select kann die order() Methode verwendet werden um Spalten, oder Arrays von Spalten, anzugeben, nach denen sortiert werden soll. Jedes Element des Arrays ist ein String, welcher die Spalte benennt. Optional kann auf den Namen eines der Schlüsselwörter ASC DESC folgen, abgetrennt durch ein Leerzeichen.

Wie in den from() und group() Methoden, werden Spalten als Bezeichner Quotiert, wenn sie nicht von runden Klammern eingeschlossen oder vom Objekttyp Zend_Db_Expr sind.

Example #22 Beispiel für die order() Methode

select()
    ->from(array('p' => 'products'),
        array('product_id'))
    ->join(array('l' => 'line_items'),
        'p.product_id = l.product_id',
        array('line_items_per_product' => 'COUNT(*)'))
    ->group('p.product_id')
    ->order(array('line_items_per_product DESC', 'product_id'));

Hinzufügen eines LIMIT Abschnitts

Einige RDBMS Marken erweitern SQL mit einem Anfrage Abschnitt, bekannt als LIMIT Abschnitt. Dieser Abschnitt begrenzt die Anzahl der Zeilen in einem Ergebnissatz auf die angegebene Höchstanzahl. Es kann ebenfalls angegeben werden, dass eine Anzahl von Zeilen ausgelassen werden soll. Dieses Feature erlaubt es eine Untermenge des Ergebnissatzes zu holen, zum Beispiel wenn Anfrage Ergebnisse auf aufeinander folgenden Seiten angezeigt werden sollen.

In Zend_Db_Select kann die limit() Methode verwendet werden um die Anzahl von Zeilen und die Anzahl der auszulassenden Spalten anzugeben. Das erste Argument ist die gewünschte Anzahl von Zeilen. Das zweite Argument gibt die Anzahl der auszulassenden Zeilen an.

Example #23 Beispiel für die limit() Methode

select()
    ->from(array('p' => 'products'), array('product_id', 'product_name'))
    ->limit(10, 20);

Note:

Die LIMIT Syntax wird nicht von allen RDBMS Marken unterstützt. Einige RDBMS benötigen eine unterschiedliche Syntax für eine ähnliche Funktionalität. Jede Zend_Db_Adapter_Abstract Klasse enthält eine Methode um für das RDBMS passende Syntax zu erzeugen.

Die limitPage() Methode kann als alternativer Weg verwendet werden um Zeilenanzahl und Offset zu spezifizieren. Diese Methode erlaubt den Ergebnissatz auf einen Subset, aus einer Serie von Subsets mit Reihen einer fixe Länge, auf dem totalen Ergebnissatz der Abfrage, zu limitieren. In anderen Worten, spezifiziert man die Länge einer Seite ("page") von Ergebnissen, und die ordinale Anzahl an Ergebnissen einer einzelnen Seite, die als von der Abfrage zurück gegeben werden sollen. Die Seitennummer ist das erste Argument der limitPage() Methode, nud die Seitenlänge ist das zweite Argument. Beide Argumente werden benötigt; sie haben keinen Standardwert.

Example #24 Beispiel der limitPage() Methode

select()
    ->from(array('p' => 'products'), array('product_id', 'product_name'))
    ->limitPage(2, 10);

Hinzufügen des DISTINCT Anfragewandlers

Die distinct() Methode ermöglicht es DISTINCT Schlüsselworte in die SQL Syntax einzufügen.

Example #25 Beispiel für die distinct() Methode

select()
    ->distinct()
    ->from(array('p' => 'products'), 'product_name');

Hinzufügen des FOR UPDATE Anfragewandlers

Die forUpdate() Methode ermöglicht es FOR UPDATE Schlüsselworte in die SQL Syntax einzufügen.

Example #26 Beispiel der forUpdate() Methode

select()
    ->forUpdate()
    ->from(array('p' => 'products'));

Ausführen von SELECT Anfrage

Dieser Abschnitt beschreibt wie Anfragen ausgeführt werden, die durch ein Zend_Db_Select Objekt repräsentiert werden.

Ausführen von Select Anfragen aus dem Db Adapter

Die Anfrage, die durch das Zend_Db_Select Objekt repräsentiert wird kann ausgeführt werden, indem sie als erstes Argument an die query() Methode des Zend_Db_Adapter_Abstract Objekts übergeben wird. Dabei wird das Zend_Db_Select anstelle eines Strings verwendet.

Die query() Methode gibt ein Objekt vom Typ Zend_Db_Statement oder PDOStatement zurück, je nachdem welcher Adaptertyp verwendet wird.

Example #27 Beispiel für die Nutzung der query() Methode des Db Adapters

select()
  ->from('products');

$stmt = $db->query($select);
$result = $stmt->fetchAll();

Ausführen von Select Anfragen mit dem objekt

Als Alternative zur Nutzung der query() Methode des Adapterobjekts kann auch die query() Methode des Zend_Db_Select Objekts verwendet werden. Beide Methoden geben ein Objekt vom Typ Zend_Db_Statement oder PDOStatement zurück, je nachdem welcher Adaptertyp verwendet wird.

Example #28 Beispiel für die Nutzung der query() Methode des Select Objekts

select()
    ->from('products');

$stmt = $select->query();
$result = $stmt->fetchAll();

Konvertieren eines Select Objekts in einen SQL String

Wenn Zugriff zu auf eine String Repräsentante der SQL Anfrage, entsprechend dem Zend_Db_Select, benötigt wird, kann die __toString() Methode verwendet werden.

Example #29 Beispiel für die __toString() Methode

select()
    ->from('products');

$sql = $select->__toString();
echo "$sql\n";

// Ausgabe ist dieser String:
//   SELECT * FROM "products"

Andere Methoden

Dieser Abschnitt beschreibt andere Methoden der Zend_Db_Select Klasse, welche bisher nicht beschrieben wurden: getPart() und reset().

Abfragen von Teilen des Select Objekts

Die getPart() Methode gibt eine Repräsentante eines Teils der SQL Anfrage zurück. Zum Beispiel kann diese Methode verwendet werden um, ein Array von Expressions des WHERE Abschnitts, ein Array von Spalten (oder Spalten Expressions) von SELECT oder die Werte der Spaltenzahl und Auslassungen des LIMIT Abschnitts, zu erhalten.

Die Rückgabe ist kein String der ein Fragment der SQL Syntax enthält. Der Rückgabewert ist eine interne Repräsentante, was typischerweise eine Arraystruktur ist, welche Werte und Expressions enthält. Jeder Teil der Anfrage hat eine unterschiedliche Struktur.

Das einzige Argument der getPart() Methode ist ein String der den zurück zu gebenden Teil der Anfrage bezeichnet. Zum Beispiel bezeichnet der String 'from' den Teil des Select Objekts, welcher Informationen über den FROM Abschnitt, einschließlich verbundener Tabellen enthält.

Die Zend_Db_Select Klasse definiert Konstanten die für Teile der SQL Anfrage verwendet werden können. Es können die Konstantendefinitionen oder die literalen Strings verwendet werden.

Konstanten die von getPart() und reset() verwendet werden
Konstante String Wert
Zend_Db_Select::DISTINCT 'distinct'
Zend_Db_Select::FOR_UPDATE 'forupdate'
Zend_Db_Select::COLUMNS 'columns'
Zend_Db_Select::FROM 'from'
Zend_Db_Select::WHERE 'where'
Zend_Db_Select::GROUP 'group'
Zend_Db_Select::HAVING 'having'
Zend_Db_Select::ORDER 'order'
Zend_Db_Select::LIMIT_COUNT 'limitcount'
Zend_Db_Select::LIMIT_OFFSET 'limitoffset'

Example #30 Beispiel der getPart() Methode

select()
    ->from('products')
    ->order('product_id');

// Ein literaler String kann verwendet werden um den Abschnitt zu definieren
$orderData = $select->getPart( 'order' );

// Eine Konstante kann verwendet werden um den selben Abschnitt zu definieren
$orderData = $select->getPart( Zend_Db_Select::ORDER );

// Der zurückgegebene Wert kann eine Array Struktur sein, kein String.
// Jeder Abschnitt hat eine unterschiedliche Struktur.
print_r( $orderData );

Zurücksetzen von Teilen des Select Objekts

Die reset() Methode ermöglicht es einen angegebenen Teil der SQL Anfrage zu löschen oder, wenn der Parameter ausgelassen ist, alle Teile zu löschen.

Das einzige Argument ist optional. Es kann der Teil der Anfrage angegeben werden, der gelöscht werden soll, unter Nutzung des gleichen Strings wie er als Argument der getPart() Methode verwendet wird. Der angegebene Teil wird auf ein Standardwert zurück gesetzt.

Wenn der Parameter ausgelassen wird, setzt reset() alle geänderten Teile auf einen Standardwert zurück. Dadurch ist das Zend_Db_Select Objekt gleichwertig mit einem neuen Objekt, wie wenn es gerade Instanziiert wurde.

Example #31 Beispiel der reset() Methode

select()
    ->from(array('p' => 'products')
    ->order('product_name');

// Geänderte Anforderungen, stattdessen sortiert nach einer anderen Spalte:
//   SELECT p.*
//   FROM "products" AS p
//   ORDER BY "product_id"

// Lösche einen Abschnitt damit er neu defniert werden kann
$select->reset( Zend_Db_Select::ORDER );

// und definiere eine andere Spalte
$select->order('product_id');

// Lösche alle Abschnitte von der Abfrage
$select->reset();
Previous Next
Introduction to Zend Framework
Übersicht
Installation
Zend_Acl
Einführung
Verfeinern der Zugriffskontrolle
Fortgeschrittene Verwendung
Zend_Auth
Einführung
Datenbanktabellen Authentifizierung
Digest Authentication
HTTP Authentication Adapter
LDAP Authentifizierung
Open ID Authentifikation
Zend_Cache
Einführung
Die Theorie des Cachens
Zend_Cache Frontends
Zend_Cache Backends
Zend_Captcha
Introduction
Captcha Operation
Captcha Adapters
Zend_Config
Einleitung
Theory of Operation
Zend_Config_Ini
Zend_Config_Xml
Zend_Console_Getopt
Einführung in Getopt
Definieren von Getopt Regeln
Holen von Optionen und Argumenten
Konfigurieren von Zend_Console_Getopt
Zend_Controller
Zend_Controller Schnellstart
Zend_Controller Grundlagen
Der Front Controller
Das Request Objekt
Der Standard Router: Zend_Controller_Router_Rewrite
Der Dispatcher
Action Kontroller
Action Helfer
Das Response Objekt
Plugins
Eine konventionelle modulare Verzeichnis Struktur verwenden
MVC Ausnahmen
Migration von vorhergehenden Versionen
Zend_Currency
Einführung in Zend_Currency
Arbeiten mit Währungen
Migration von vorhergehenden Versionen
Zend_Date
Einführung
Theorie der Arbeitsweise
Basis Methoden
Zend_Date API Übersicht
Erstellen von Datumswerten
Konstanten für generelle Datums Funktionen
Funktionierende Beispiele
Zend_Db
Zend_Db_Adapter
Zend_Db_Statement
Zend_Db_Profiler
Zend_Db_Select
Zend_Db_Table
Zend_Db_Table_Row
Zend_Db_Table_Rowset
Zend_Db_Table Relationships
Zend_Debug
Variablen ausgeben
Zend_Dojo
Introduction
Zend_Dojo_Data: dojo.data Envelopes
Dojo View Helpers
Dojo Form Elements and Decorators
Zend_Dom
Introduction
Zend_Dom_Query
Zend_Exception
Verwenden von Ausnahmen
Zend_Feed
Einführung
Feeds importieren
Feeds von Websites abrufen
Einen RSS Feed konsumieren
Einen Atom Feed konsumieren
Einen einzelnen Atom Eintrag konsumieren
Verändern der Feed- und Eintragsstruktur
Eigene Klassen für Feeds und Einträge
Zend_File
Zend_File_Transfer
Validators for Zend_File_Transfer
Zend_Filter
Einführung
Standard Filter Klassen
Filter Ketten
Filter schreiben
Zend_Filter_Input
Zend_Filter_Inflector
Zend_Form
Zend_Form
Schnellstart mit Zend_Form
Erstellen von Form Elementen mit Hilfe von Zend_Form_Element
Erstellen von Form durch Verwendung von Zend_Form
Erstellen von eigenem Form Markup durch Zend_Form_Decorator
Standard Form Elemente die mit dem With Zend Framework ausgeliefert werden
Standard Form Dekoratore die mit dem Zend Framework ausgeliefert werden
Internationalisierung von Zend_Form
Fortgeschrittene Verwendung von Zend_Form
Zend_Gdata
Einführung zu Gdata
Authentifizierung mit AuthSub
Authentifizieren mit ClientLogin
Google Kalender verwenden
Verwenden der Google Dokumente Listen Daten API
Google Tabellenkalkulation verwenden
Google Apps Provisionierung verwenden
Google Base verwenden
Verwenden der YouTube Daten API
Picasa Web Alben verwenden
Gdata Ausnahmen auffangen
Zend_Http
Zend_Http_Client - Einführung
Zend_Http_Client - Fortgeschrittende Nutzung
Zend_Http_Client - Verbindungsadapter
Zend_Http_Cookie und Zend_Http_CookieJar
Zend_Http_Response
Zend_InfoCard
Einführung
Zend_Json
Einführung
Grundlegende Verwendung
JSON Objects
XML zu JSON Konvertierung
Zend_Json_Server - JSON-RPC server
Zend_Layout
Einführung
Zend_Layout Schnellstart
Zend_Layout Konfigurations Optionen
Erweiterte Verwendung von Zend_Layout
Zend_Ldap
Einleitung
Zend_Loader
Dynamisches Laden von Dateien und Klassen
Plugins laden
Zend_Locale
Einführung
Zend_Locale verwenden
Normalisierung und Lokalisierung
Arbeiten mit Daten und Zeiten
Unterstützte Sprachen für Gebietsschemata
Unterstützte Regionen für Gebietsschemata
Zend_Log
Übersicht
Writer
Formatter
Filter
Zend_Mail
Einführung
Versand über SMTP
Versand von mehreren E-Mails über eine SMTP Verbindung
Verwendung von unterschiedlichen Versandwegen
HTML E-Mail
Anhänge
Empfänger hinzufügen
Die MIME Abgrenzung kontrollieren
Zusätzliche Kopfzeilen
Zeichensätze
Kodierung
SMTP Authentifizierung
SMTP Übertragungen sichern
Lesen von Mail Nachrichten
Zend_Measure
Einführung
Erstellung einer Maßeinheit
Ausgabe von Maßeinheiten
Manipulation von Maßeinheiten
Arten von Maßeinheiten
Zend_Memory
Übersicht
Memory Manager
Memory Objekte
Zend_Mime
Zend_Mime
Zend_Mime_Message
Zend_Mime_Part
Zend_OpenId
Einführung
Zend_OpenId_Consumer Grundlagen
Zend_OpenId_Provider
Zend_Paginator
Introduction
Usage
Configuration
Advanced usage
Zend_Pdf
Einführung
Erstellen und Laden von PDF Dokumenten
Änderungen von PDF Dokumenten speichern
Dokument Seiten
Zeichnen
Dokument Informationen und Metadaten
Anwendungsbeispiel für die Zend_Pdf Komponente
Zend_Registry
Die Registry verwenden
Zend_Rest
Einführung
Zend_Rest_Client
Zend_Rest_Server
Zend_Search_Lucene
Überblick
Indexerstellung
Einen Index durchsuchen
Abfragesprache
Abfrage Erzeugungs API
Zeichensätze
Erweiterbarkeit
Zusammenarbeit Mit Java Lucene
Erweitert
Die besten Anwendungen
Zend_Server
Einführung
Zend_Server_Reflection
Zend_Service
Einführung
Zend_Service_Akismet
Zend_Service_Amazon
Zend_Service_Audioscrobbler
Zend_Service_Delicious
Zend_Service_Flickr
Zend_Service_Nirvanix
Zend_Service_ReCaptcha
Zend_Service_Simpy
Einführung
Zend_Service_StrikeIron
Zend_Service_StrikeIron: Mitgelieferte Services
Zend_Service_StrikeIron: Erweiterte Verwendung
Zend_Service_Technorati
Zend_Service_Yahoo
Zend_Session
Einführung
Grundsätzliche Verwendung
Fortgeschrittene Benutzung
Globales Session Management
Zend_Session_SaveHandler_DbTable
Zend_Soap
Zend_Soap_Server
Zend_Soap_Client
WSDL Zugriffsmethoden
AutoDiscovery. Einführung
Automatische Erkennung von Klassen.
Funktionen für Autodiscovery.
Automatische Erkennung. Datentypen.
Zend_Test
Introduction
Zend_Test_PHPUnit
Zend_Text
Zend_Text_Figlet
Zend_TimeSync
Einführung
Arbeiten mit Zend_TimeSync
Zend_Translate
Einführung
Adapter für Zend_Translate
Benutzen von Übersetzungs Adaptoren
Zend_Uri
Zend_Uri
Zend_Validate
Einführung
Standard Prüfklassen
Kettenprüfungen
Schreiben von Prüfern
Zend_Version
Auslesen der Version des Zend Frameworks
Zend_View
Einführung
Controller Skripte
View Scripte
View Helfer
Zend_View_Abstract
Zend_Wildfire
Zend_Wildfire
Zend_XmlRpc
Einführung
Zend_XmlRpc_Client
Zend_XmlRpc_Server
Zend Framework Voraussetzungen
PHP Version
PHP Erweiterungen
Zend Framework Komponenten
Zend Framework Abhängigkeiten
Zend Framework Coding Standard für PHP
Übersicht
PHP Dateiformatierung
Namens Konventionen
Code Stil
Urheberrecht Informationen