archived-doc-de/reference/pgsql/functions/pg-execute.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: conni Status: ready -->
<refentry xml:id="function.pg-execute" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_execute</refname>
  <refpurpose>Fordert den Datenankserver auf, eine vorbereitete Anfrage
   mit den angegebenen Parametern auszuführen und wartet auf das
   Ergebnis</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>pg_execute</methodname>
   <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam>
   <methodparam><type>string</type><parameter>stmtname</parameter></methodparam>
   <methodparam><type>array</type><parameter>params</parameter></methodparam>
  </methodsynopsis>
  <para>
    Fordert den Datenankserver auf, eine vorbereitete Anfrage mit den
    angegebenen Parametern auszuführen und wartet auf das Ergebnis.
  </para>
  <para>
    <function>pg_execute</function> ist ähnlich wie
    <function>pg_query_params</function>, mit dem Unterschied, dass das
    auszuführende Kommando zuvor als vorbereitete Abfrage definiert wurde und
    kein SQL-String ist. Damit werden Abfragen, die wiederholt gebraucht werden,
    nur ein einziges Mal geparst und geplant und nicht jedesmal, wenn sie
    ausgeführt werden. Das Kommando muss zuvor in der aktuellen
    Datenbanksitzung vorbereitet worden sein.
    <function>pg_execute</function> wird von PostgreSQL ab der Version
    7.4 unterstützt und wird in allen früheren Versionen fehlschlagen.
  </para>
  <para>
    Die Parameter sind identisch zu denen in <function>pg_query_params</function>,
    außer dass der Name eines vorbereiteten Kommandos anstatt einer
    SQL-Abfrage übergeben wird.
  </para>
 </refsect1>

<refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      <para>
       PostgreSQL Verbindungskennung. Wenn <parameter>connection</parameter>
       fehlt, wird die Standardverbindung angenommen. Dies ist die Verbindung,
       die zuletzt mit den Funktionen <function>pg_connect</function>
       oder <function>pg_pconnect</function> geöffnet wurde.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>stmtname</parameter></term>
     <listitem>
      <para>
       Der Name der vorbereiteten Abfrage, die ausgeführt werden soll.
       Falls "" angegeben wurde, wird die unbenannte Abfrage
       ausgeführt. Dieser Name muss zuvor mit  <function>pg_prepare</function>,
       <function>pg_send_prepare</function> oder dem SQL-Kommando
       <literal>PREPARE</literal> vorbereitet worden sein.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>params</parameter></term>
     <listitem>
      <para>
       Ein Array, das die Parameter enthält, mit denen die Platzhalter
       $1, $2 usw. im originalen Abfragestring ersetzt werden. Die
       Anzahl der Arrayelemente muss mit der Anzahl der Platzhalter
       übereinstimmen.
      </para>
      <warning>
       <para>
        Beim Aufruf dieser Funktion werden die Elemente in Strings konvertiert.
       </para>
      </warning>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Bei Erfolg wird eine Ergebniskennung zurückgegeben und bei einem
   Fehler &false;.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>pg_execute</function> benutzen:</title>
    <programlisting role="php">
<![CDATA[
<?php
// Zu der Datenbank "mary" verbinden
$dbconn = pg_connect("dbname=mary");

// Eine Abfrage zur Ausführung vorbereiten
$result = pg_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1');

// Die vorbereitete Abfrage ausführen. Es ist nicht notwendig,
// den String "Joe's Widgets" zu maskieren
$result = pg_execute($dbconn, "my_query", array("Joe's Widgets"));

// Dieselbe vorbereitete Abfrage nochmal ausführen,
// diesmal mit einem anderen Parameter
$result = pg_execute($dbconn, "my_query", array("Clothes Clothes Clothes"));

?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pg_prepare</function></member>
    <member><function>pg_send_prepare</function></member>
    <member><function>pg_query_params</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>


<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->