[PHP-DOC] cvs: phpdoc /de/functions misc.xml From: Thomas Schuermann (thomas.schuermann <email protected>)
Date: 07/09/00

tschuer Sun Jul 9 11:50:09 2000 EDT

  Modified files:
    /phpdoc/de/functions misc.xml
  Log:
  Added functions ans some minor corrections
  
Index: phpdoc/de/functions/misc.xml
diff -u phpdoc/de/functions/misc.xml:1.10 phpdoc/de/functions/misc.xml:1.11
--- phpdoc/de/functions/misc.xml:1.10 Sat Jun 24 00:38:42 2000
+++ phpdoc/de/functions/misc.xml Sun Jul 9 11:50:08 2000
@@ -962,10 +962,10 @@
 $stmt = odbc_prepare ($conn,
                       "UPDATE sessions SET data = ? WHERE id = ?");
 $sqldata = array (serialize($session_data), $PHP_AUTH_USER);
-if (!odbc_execute ($stmt, &$sqldata)) {
+if (!odbc_execute ($stmt, &amp;$sqldata)) {
     $stmt = odbc_prepare ($conn,
                           "INSERT INTO sessions (id, data) VALUES(?, ?)");
- if (!odbc_execute($stmt, &$sqldata)) {
+ if (!odbc_execute($stmt, &amp;$sqldata)) {
         /* Etwas lief schief. Fluche, heule und stöhne. */
     }
 }
@@ -1148,7 +1148,7 @@
 $conn = odbc_connect ("webdb", "php", "moorhuhn");
 $stmt = odbc_prepare ($conn, "SELECT data FROM sessions WHERE id = ?");
 $sqldata = array ($PHP_AUTH_USER);
-if (!odbc_execute ($stmt, &$sqldata) || !odbc_fetch_into ($stmt, &$tmp)) {
+if (!odbc_execute ($stmt, &amp;$sqldata) || !odbc_fetch_into ($stmt, &amp;$tmp)) {
     // wenn execute oder fetch fehlschlägt, initialisiere ein leeres Array
     $session_data = array();
 } else {
@@ -1179,8 +1179,8 @@
      </funcprototype>
     </funcsynopsis>
     <simpara>
- Mittels der Funktion <function>sleep</function> verzögern sie
- die weitere Skript-Ausführung um die gegebene Anzahl an
+ Mittels der Funktion <function>sleep</function> verzögern sie die
+ weitere Skript-Ausführung um die gegebene Anzahl an
      <parameter>micro_seconds</parameter>.
     </simpara>
     <simpara>
@@ -1188,10 +1188,158 @@
     </simpara>
     <note>
      <simpara>
- Dies Funktion steht unter Windows-Systemen nicht zur
- Verfügung.
+ Dies Funktion steht unter Windows-Systemen nicht zur Verfügung.
      </simpara>
     </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.highlight_string">
+ <refnamediv>
+ <refname>highlight_string</refname>
+ <refpurpose>Hervorhebung der Syntax eines Strings</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>highlight_string</function></funcdef>
+ <paramdef>string <parameter>str</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Die Funktion <function>highlight_string</function> gibt den String
+ <parameter>str</parameter> mit hervorgehobener Syntax (Syntax
+ highlighting) aus. Dabei werden die Farben des in PHP eingebauten
+ Syntax-Highlighter benutzt.
+ </simpara>
+ <simpara>
+ Siehe auch <function>higlight_file</function> und
+ <function>show_source</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.highlight_file">
+ <refnamediv>
+ <refname>highlight_file</refname>
+ <refpurpose>Syntax-Hervorhebung für eine Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>highlight_file</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Die Funktion <function>highlight_file</function> erzeugt die
+ Ausgabe des Codes der Datei <parameter>filename</parameter>
+ mit hervorgehobener Syntax. Dabei werden die Farben des in PHP
+ eingebauten Syntax-Highlighter benutzt.
+ </simpara>
+ <para>
+ <example>
+ <title>Erzeugung einer hervorgehobenen URL</title>
+ <simpara>
+ Zur Erzeugung einer URL, die Code eines ihm übermittelten
+ Skripts hervorgehoben dargestellen kann, machen wir Gebrauch von
+ der &quot;ForceType&quot;-Anweisung des Apachen um eine richtige
+ URL zu erzeugen. Zusätzlich benutzen wir die Funktion
+ <function>highlight_file</function>, um das Code-Listing wie
+ gewünscht an zu zeigen.
+ </simpara>
+ <simpara>
+ In ihrer httpd.conf sollten sie folgendes hinzu fügen:
+ </simpara>
+ <para>
+ <informalexample><programlisting>
+&lt;Location /source&gt;
+ ForceType application/x-httpd-php
+&lt;/Location&gt;
+ </programlisting></informalexample>
+ </para>
+ <simpara>
+ Jetzt erzeugen sie eine Datei namens &quot;source&quot; und
+ speichern es in dem Root-Verzeichnis ihrer Web-Seite.
+ </simpara>
+ <para>
+ <programlisting role="php">
+&lt;HTML&gt;
+&lt;HEAD&gt;
+&lt;TITLE&gt;Source Display&lt;/TITLE&gt;
+&lt;/HEAD&gt;
+&lt;BODY BGCOLOR=&quot;white&quot;&gt;
+&lt;?php
+ $script = getenv (&quot;PATH_TRANSLATED&quot;);
+ if(!$script) {
+ echo &quot;&lt;BR&gt;&lt;B&gt;Fehler: Skript-Name nötig&lt;/B&gt;&lt;BR&gt;&quot;;
+ } else {
+ if (ereg(&quot;(\.php|\.inc)$&quot;,$script)) {
+ echo &quot;&lt;H1&gt;Source von: $PATH_INFO&lt;/H1&gt;\n&lt;HR&gt;\n&quot;;
+ highlight_file($script);
+ } else {
+ echo &quot;&lt;H1&gt;ERROR: Nur PHP oder Include-Skripte sind erlaubt&lt;/H1&gt;&quot;;
+ }
+ }
+ echo &quot;&lt;HR&gt;Erzeugt: &quot;.date(&quot;Y/M/d H:i:s&quot;,time());
+?&gt;
+&lt;/BODY&gt;
+&lt;/HTML&gt;
+ </programlisting>
+ </para>
+ <simpara>
+ Jetzt können sie die u.a. URL benutzen, um eine farblich
+ hervorgehobene Version des Skriptes
+ &quot;/path/to/script.php&quot; innerhalb ihrer Web-Seite zu
+ zeigen.
+ </simpara>
+ <para>
+ <informalexample>
+ <programlisting>
+http://ihr.server.de/source/pfad/zu/script.php
+ </programlisting>
+ </informalexample>
+ </para>
+ </example>
+ </para>
+ <simpara>
+ Siehe auch <function>highlight_string</function> und
+ <function>show_source</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.show_source">
+ <refnamediv>
+ <refname>show_source</refname>
+ <refpurpose>Syntax-Highlighting einer Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>show_source</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Die Funktion <function>show_source</function> erzeugt die
+ Ausgabe des Codes der Datei <parameter>filename</parameter>
+ mit hervorgehobener Syntax. Dabei werden die Farben des in PHP
+ eingebauten Syntax-Highlighter benutzt.
+ </simpara>
+ <note>
+ <simpara>
+ Diese Funktion ist ein Alias der Funktion
+ <function>highlight_file</function>.
+ </simpara>
+ </note>
+ <simpara>
+ Siehe auch <function>highlight_string</function> und
+ <function>highlight_file</function>.
+ </simpara>
    </refsect1>
   </refentry>