cvs: phpdoc /hu translation.xml /hu/functions dbx.xml

From: Date: Fri, 15 Feb 2002 00:10:41 +0000
Subject: cvs: phpdoc /hu translation.xml /hu/functions dbx.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969342323@lists.php.net to get a copy of this message
gerzson Thu Feb 14 19:10:41 2002 EDT Added files: /phpdoc/hu/functions dbx.xml Modified files: /phpdoc/hu translation.xml Log: dbx.xml translation added and translation.xml is updated (note that tagging in phpdoc/hu/dbx.xml differs from the original English version significantly. If it suffice my needs, I change the orginal one, too)

Index: phpdoc/hu/translation.xml diff -u phpdoc/hu/translation.xml:1.10 phpdoc/hu/translation.xml:1.11 --- phpdoc/hu/translation.xml:1.10 Thu Feb 14 12:49:58 2002 +++ phpdoc/hu/translation.xml Thu Feb 14 19:10:40 2002 @@ -30,7 +30,6 @@ </translators> <work-in-progress> - <file name="functions/dbx.xml" person="gerzson" type="translation" /> <file name="functions/errorfunc.xml" person="goba" type="translation" /> <file name="functions/filesystem.xml" person="nandi" type="translation" /> <file name="functions/ftp.xml" person="netman" type="translation" /> Index: phpdoc/hu/functions/dbx.xml +++ phpdoc/hu/functions/dbx.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.24 Maintainer: gerzson Status: ready / new layout --> <reference id="ref.dbx"> <title>dbx függvények</title> <titleabbrev>dbx</titleabbrev> <partintro> <simpara> A dbx modul adatbázis-kezelõ absztrakciós réteg, ahol az X jelenti a támogatott adatbáziskezelõket. A dbx függvényekkel azonos hívási konvenciókat használva lehet elérni a különbözõ támogatott adatbázisok mindegyikét. Annak érdekében, hogy ezeket a függvényeket használni lehessen, a PHP-t dbx támogatással - az <link linkend="install.configure.enable-dbx"><option role="configure">--enable-dbx</option></link> kapcsoló - és minden használni kívánt adatbázisnak megfelelõ kiterjesztéssel kell fordítani, azaz MySQL esetén <link linkend="install.configure.with-mysql"><option role="install.configure.with-mysql">--with-mysql</option></link> kapcsolót is meg kell adni. A dbx függvények önmagukban nem kommunikálnak az adatbázis-kiszolgálókkal, csak az õket támogató modulokkal/kiterjesztésekkel. Ahhoz, hogy dbx modullal lehessen elérni egy adatbázist két feltételnek kell teljesülnie: 1. a megfelelõ modult be kell tölteni (<function>dl</function> vagy <link linkend="ini.sect.extension">php.ini</link>), 2. a dbx modulnak támogatnia kell a használni kívánt adatbázis-kiszolgálót. Ezek jelenleg: MySQL, PostgreSQL, Microsoft SQL Server, FrontBase és ODBC, és majd többi követi ezeket. </simpara> <simpara> Arról, hogyan kell új adatbázis támogatást implementálni a dbx modulba <ulink url="&url.dbx.docs;">&url.dbx.docs;</ulink> címen találsz leírást. </simpara> </partintro> <refentry id="function.dbx-close"> <refnamediv> <refname>dbx_close</refname> <refpurpose>lezár agy nyitott adatbázis kapcsolatot</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <methodsynopsis> <type>bool</type><methodname>dbx_close</methodname> <methodparam><type>dbx_link_object</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> Sikeres végrehajtás esetén &true;-val tér vissza, egyébként hiba esetén &false;-szal. </para> <example> <title><function>dbx_close</function> példa</title> <programlisting role="php"> <![CDATA[ <?php $link = dbx_connect ("mysql", "localhost", "db", "username", "password") or die ("Nem sikerült kapcsolódni."); print("Sikeresen kapcsolódtam."); dbx_close($link); ?> ]]> </programlisting> </example> <note> <para> Használd mindig az adatbázis specifikus dokumentációt is! </para> </note> <para> Lásd még: <function>dbx_connect</function>! </para> </refsect1> </refentry> <refentry id="function.dbx-connect"> <refnamediv> <refname>dbx_connect</refname> <refpurpose>kapscolódik egy adatbázishoz</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <methodsynopsis> <type>dbx_link_object</type><methodname>dbx_connect</methodname> <methodparam><type>string</type><parameter>module</parameter></methodparam> <methodparam><type>string</type><parameter>host</parameter></methodparam> <methodparam><type>string</type><parameter>database</parameter></methodparam> <methodparam><type>string</type><parameter>username</parameter></methodparam> <methodparam><type>string</type><parameter>password</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>persistent</parameter></methodparam> </methodsynopsis> <para> Sikeres csatlakozáskor egy ún. dbx_link_object-et ad vissza, hiba esetén pedig &false;-t. Ha sikerült kapcsolatot felvenni, de a megadott adatbázis nem elérhetõ, akkor a kapcsolatot lezárja és &false;-t ad vissza. A <parameter>persistent</parameter> paraméternek <constant>DBX_PERSISTENT</constant> értéket adva tartós / perzisztens adatbázis kapcsolatot nyit. </para> <para> A <parameter>module</parameter> paraméter lehet sztring és egy állandó is. A lehetséges értékeket alább láthatók, de vedd figyelembe, hogy csak akkor mûködnek, ha az adott modul be van töltve. </para> <para> <itemizedlist> <listitem> <simpara> DBX_MYSQL : "mysql" </simpara> </listitem> <listitem> <simpara> DBX_ODBC : "odbc" </simpara> </listitem> <listitem> <simpara> DBX_PGSQL : "pgsql" </simpara> </listitem> <listitem> <simpara> DBX_MSSQL : "mssql" </simpara> </listitem> <listitem> <simpara> DBX_FBSQL : "fbsql" (CVS only) </simpara> </listitem> </itemizedlist> </para> <para> A dbx_link_object három tagváltozóval rendelkezik: <varname>handle</varname>, <varname>module</varname> és <varname>database</varname>. A <varname>database</varname> tagváltozó az aktuálisan kiválasztott adatbázis neve. A <varname>module</varname> tartalmazza a fent említett és éppen használt modul számát. A <varname>handle</varname> az érvényes kapcsolatazonosító az adatbázishoz, és így szükség esetén az adott modulra jellemzõ függvények hívásához használható. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php $link = dbx_connect ("mysql", "localhost", "db", "username", "password"); mysql_close ($link->handle); // dbx_close($link) használata itt sokkal jobb lenne... ?> ]]> </programlisting> </informalexample> </para> <para> A <parameter>host</parameter>, <parameter>database</parameter>, <parameter>username</parameter> és a <parameter>password</parameter> paraméterek kötelezõek, de nem mindig használtak a kapcsolatot létesítõ modul függvénytõl függõen. </para> <para> <example> <title><function>dbx_connect</function> példa</title> <programlisting role="php"> <![CDATA[ <?php $link = dbx_connect ("odbc", "", "db", "username", "password", DBX_PERSISTENT) or die ("Nem sikerült kapcsolódni."); print ("Sikeresen kapcsolódtam."); dbx_close ($link); ?> ]]> </programlisting> </example> <note> <para> Használd mindig az adatbázis specifikus dokumentációt is! </para> </note> </para> <para> Lásd még: <function>dbx_close</function>! </para> </refsect1> </refentry> <refentry id="function.dbx-error"> <refnamediv> <refname>dbx_error</refname> <refpurpose> visszaadja a modulban történt legutolsó hibát (nem feltétlenül a kapcsolathoz kötödõ hibát) </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <methodsynopsis> <type>string</type><methodname>dbx_error</methodname> <methodparam><type>dbx_link_object</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> A hiba szövegét tartalmazó sztringgel tér vissza, amely a modulban legutolsó függvényhívás óta történt, például a mysql modulban történt. Ha az adott modulban több kapcsolat is nyitva van, akkor is csak a legutolsó kerül visszadásra. Ha több modulhoz történt csatlakozás, akkor a <parameter>link_identifier</parameter> által meghatározott modul utolsó hibaüzenetét adja vissza. </para> <note> <simpara> Az ODBC modul jelen pillanatban nem támogatja a hiba jelzõ függvényt. </simpara> </note> <example> <title><function>dbx_error</function> példa</title> <programlisting role="php"> <![CDATA[ <?php $link = dbx_connect ("mysql", "localhost", "db", "username", "password") or die ("Nem sikerült kapcsolódni."); $result = dbx_query ($link, "select id from nem_letezo_tabla"); if ( $result == 0 ) { print dbx_error ($link); } dbx_close ($link); ?> ]]> </programlisting> </example> <note> <para> Használd mindig az adatbázis specifikus dokumentációt is! </para> <para> Microsoft SQL Server hibaüzenetei valójában a <function>mssql_get_last_message</function> függvény visszatérési értékei. </para> </note> </refsect1> </refentry> <refentry id="function.dbx-query"> <refnamediv> <refname>dbx_query</refname> <refpurpose> végrehajt egy lekérdezést és visszaadja a teljes végeredményt (ha van) </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <methodsynopsis> <type>dbx_result_object</type><methodname>dbx_query</methodname> <methodparam><type>dbx_link_object</type><parameter>link_identifier</parameter></methodparam> <methodparam><type>string</type><parameter>sql_statement</parameter></methodparam> <methodparam choice="opt"><type>long</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> Vagy 1-gyel vagy <type>dbx_result_object</type> típussal tér vissza sikeres végrehajtáskor ez utóbbit csak olyan esetben, ha SQL utasításnak van végeredménye, vagy 0-val hiba esetén. </para> <para> A <parameter>flags</parameter> paraméteren keresztül szabályozható a visszaadandó információ mennyisége. Ez a következõ állandók bármilyen logikai vagy mûveleti kombinációja lehet: <variablelist> <varlistentry> <term> <constant>DBX_RESULT_INFO</constant> </term> <listitem> <simpara> Az oszlopokról ad információt: a mezõk számáról, neveikrõl és típusaikról. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DBX_RESULT_INDEX</constant> </term> <listitem> <simpara> Ennek megadásával a függvény egy két dimenziós tömböt ad vissza, ahol az elsõ index a sorindex, a második az oszlopindex, azaz például a <varname>data[2][3]</varname>-ban a 2 jelöli a sort, a 3 az oszlopot. Az indexelés 0-tól kezdõdik. </simpara> <simpara> Ha a <constant>DBX_RESULT_ASSOC</constant> meg van adva, akkor a minden esetben a <constant>DBX_RESULT_INFO</constant>-nak megfelelõ értékeket is visszaadja a függvény. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DBX_RESULT_ASSOC</constant> </term> <listitem> <simpara> Ennek hatására az oszlopokértékeket az oszlopnevekkel lehet indexelni. </simpara> <simpara> Ezek az asszociatív indexek valójában referenciák a numerikus indexelésû értékekre, így a <varname>data[0][0]</varname>-t módosítva a <varname>data[0]['az_elsõ_oszlop_mezõ_neve']</varname> is megváltozik. </simpara> </listitem> </varlistentry> </variablelist> Megjegyzendõ, hogy a <constant>DBX_RESULT_INDEX</constant> mindig használja a függvény, függetlenül a <parameter>flags</parameter> paraméter értékétõl. Emiatt valójában csak az alábbi kombinációk értelmsek: <itemizedlist> <listitem> <simpara> <constant>DBX_RESULT_INFO</constant> </simpara> </listitem> <listitem> <simpara> <constant>DBX_RESULT_INDEX</constant> | <constant>DBX_RESULT_INFO</constant> </simpara> </listitem> <listitem> <simpara> <constant>DBX_RESULT_INDEX</constant> | <constant>DBX_RESULT_INFO</constant> | <constant>DBX_RESULT_ASSOC</constant> - alapértelmezés, ha nincs megadva a <parameter>flag</parameter> </simpara> </listitem> </itemizedlist> </para> <para> A visszaadott dbx_result_object típusnak négy vagy öt tagváltozója van a <parameter>flags</parameter>-tõl függõen: <varname>handle</varname>, <varname>cols</varname>, <varname>rows</varname>, <varname>info</varname> esetleg, és a <varname>data</varname>. A <varname>handle</varname> az érvényes kapcsolatazonosító az adatbázishoz, és így szükség esetén az adott modulra jellemzõ függvények hívásához használható: </para> <para> <informalexample role="php"> <programlisting> <![CDATA[ $result = dbx_query ($link, "SELECT id FROM tabla"); $length = mysql_field_len($result->handle, 0); ]]> </programlisting> </informalexample> </para> <para> A <varname>cols</varname> és <varname>rows</varname> tagváltozók tartalmazzák a vissza oszlopok/mezõk és sorok/rekordok számát. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ $result = dbx_query ($link, "SELECT id FROM tabla"); echo "Az eredmény mérete: " . $result->rows . " x " . $result->cols . "<br/>\n"; ]]> </programlisting> </informalexample> </para> <para> Az <varname>info</varname> tagváltozó csak akkor elérhetõ, ha a <constant>DBX_RESULT_INFO</constant> és/vagy <constant>DBX_RESULT_ASSOC</constant> szerepel a <parameter>flags</parameter> paraméterben. Ez olyan kétdimenzós tömb, amelynek két nevesített sora van ("name" és "type") mezõinformációk eléréséhez. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ $result = dbx_query ($link, "SELECT id FROM tabla"); echo "mezõ neve : " . $result->info["name"][0] . "<br>\n"; echo "mezõ típusa: " . $result->info["type"][0] . "<br>\n"; ]]> </programlisting> </informalexample> </para> <para> The <varname>data</varname> tagváltozó tartalmazza a tényleges végeredményt, lehetõség szerint a megfelelõ mezõnevekkel is elérhetõ módon. Ha <constant>DBX_RESULT_ASSOC</constant> be van állítva, akkor az adatok <literal>$eredmeny->data[2]["mezõ_neve"]</literal> alakban is elérhetõk. </para> <example> <title><function>dbx_query</function> példa</title> <programlisting role="php"> <![CDATA[ <?php $link = dbx_connect("odbc", "", "db", "username", "password") or die ("Nem sikerült kapcsolódni."); $result = dbx_query($link, "SELECT id, pid, leiras FROM tabla") or die ("Rossz lekérdezés"); if ( $result == 1 ) { echo "A lekérdezés sikeresen végrehajtva.\n<br>"; } else { $rows = $result->rows; $cols = $result->cols; echo "<p>A tábla mérete: {$result->rows} x {$result->cols}<br><table border=1>\n"; echo "<tr>"; for ( $col = 0; $col < $cols; ++$col ){ echo "<td>-{$result->info["name"][$col]}-<br>-{$result->info["type"][$col]}-</td>"; } echo "</tr>\n"; foreach ( $result->data as $row ) { echo "<tr>"; foreach ( $row as $field ) { echo "<td>-$field-</td>"; } echo "</tr>\n"; } echo "</table>\n"; echo "table dimension: {$result->rows} x id, parentid, description<br><table border=1>\n"; for ($row=0; $row<$rows; ++$row) { echo "<tr>"; echo "<td>-{$result->data[$row]['id']}-</td>"; echo "<td>-{$result->data[$row]['pid']}-</td>"; echo "<td>-{$result->data[$row]['leiras']}-</td>"; echo "</tr>\n"; } echo "</table><p>\n"; } dbx_close($link); ?> ]]> </programlisting> </example> <note> <para> Használd mindig az adatbázis specifikus dokumentációt is! </para> </note> <para> Lásd még: <function>dbx_connect</function>! </para> </refsect1> </refentry> <refentry id="function.dbx-sort"> <refnamediv> <refname>dbx_sort</refname> <refpurpose> dbx_query által visszaadott eredményhalmazt rendez tetszõleges függvény segítségével </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <methodsynopsis> <type>bool</type><methodname>dbx_sort</methodname> <methodparam><type>dbx_result_object</type><parameter>result</parameter></methodparam> <methodparam><type>string</type><parameter>user_compare_function</parameter></methodparam> </methodsynopsis> <para> Sikeres végrehajtás esetén &true;-val tér vissza, egyébként hiba esetén &false;-szal. </para> <example> <title><function>dbx_sort</function> példa</title> <programlisting role="php"> <![CDATA[ <?php function user_order ($a, $b) { $rv = dbx_compare($a, $b, "pid", DBX_CMP_DESC); // 'pid' szerint nem rendezhetõek sorba, akkor 'id' szerint if ( !$rv ) { $rv = dbx_compare($a, $b, "id"); } return $rv; } $link = dbx_connect("odbc", "", "db", "username", "password") or die ("Nem sikerült csatlakozni."); $result = dbx_query($link, "SELECT id, pid, leiras FROM tabla ORDER BY id"); // az eredmény most 'id' szerint van rendezve dbx_sort ($result, "user_re_order"); // az eredmény most csökkenõ 'pid' szerint és 'id' szerint van rendezve dbx_close ($link); ?> ]]> </programlisting> </example> <para> Lásd még <function>dbx_compare</function>! </para> </refsect1> </refentry> <refentry id="function.dbx-compare"> <refnamediv> <refname>dbx_compare</refname> <refpurpose>összehasonlít két sort rendezés céljából</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <methodsynopsis> <type>int</type><methodname>dbx_compare</methodname> <methodparam><type>array</type><parameter>row_a</parameter></methodparam> <methodparam><type>array</type><parameter>row_b</parameter></methodparam> <methodparam><type>string</type><parameter>columnname_or_index</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <literal>0</literal>-val tér vissza, ha a <varname>row_a[$columnname_or_index]</varname> egyenlõ <varname>row_b[$columnname_or_index]</varname> kifejezéssel, és <literal>1</literal>-gyel, ha az elsõ nagyobb, illetve <literal>-1</literal>, ha ez kisebb. Ha <parameter>flags</parameter> értéke <constant>DBX_CMP_DESC</constant>, akkor pont fordított értékek adódnak eltérõ bemenetek esetén. </para> <para> A <parameter>flags</parameter> használható arra, hogy beállítsuk az összehasonlítás irányát - csökkenõ vagy növekvõ legyen: <variablelist> <varlistentry> <term> <constant>DBX_CMP_ASC</constant> </term> <listitem> <simpara> növekvõ sorrendet ír elõ </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>DBX_CMP_DESC</constant> </term> <listitem> <simpara> csökkenõ sorrendet ír elõ </simpara> </listitem> </varlistentry> </variablelist> és az összehasonlítás típusát (milyen típusra konvertálja az értékeket): <variablelist> <varlistentry> <term><constant>DBX_CMP_NATIVE</constant></term> <listitem> <simpara>megszokott módon hasonlítja össze az elemeket</simpara> </listitem> </varlistentry> <varlistentry> <term><constant>DBX_CMP_NUMBER</constant></term> <listitem> <simpara>számként hasonlítja össze az elemeket</simpara> </listitem> </varlistentry> <varlistentry> <term><constant>DBX_CMP_TEXT</constant></term> <listitem> <simpara>szövegként hasonlítja össze az elemeket</simpara> </listitem> </varlistentry> </variablelist> Ezeket az állandókat logikai vagy kapcsolattal lehet kombinálni, az a <parameter>flags</parameter> paraméter alapértelmezése a DBX_CMP_ASC | DBX_CMP_NATIVE. </para> <example> <title><function>dbx_compare</function> példa</title> <programlisting role="php"> <![CDATA[ <?php function user_re_order ($a, $b) { $rv = dbx_compare ($a, $b, "pid", DBX_CMP_DESC); if (!$rv) { $rv = dbx_compare ($a, $b, "id"); } return $rv; } $link = dbx_connect("odbc", "", "db", "username", "password") or die ("Nem sikerült csatlakozni."); $result = dbx_query($link, "SELECT id, pid, leiras FROM tabla ORDER BY id"); // az eredmény most 'id' szerint van rendezve dbx_sort ($result, "user_re_order"); // az eredmény most csökkenõ 'pid' szerint és azon túl 'id' szerint van rendezve dbx_close ($link); ?> ]]> </programlisting> </example> <para> Lásd még <function>dbx_sort</function>! </para> </refsect1> </refentry> </reference> <!-- 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:"../../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 -->
« previous php.doc (#969342323) next »