archived-doc-de/chapters/tutorial.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1fd637525fd3bbaec04f6fff80eeb33fce880b10 Maintainer: cmb Status: ready -->
 <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <info><title>Ein kleines Tutorial</title></info>

  <para>
   Auf diesen Seiten möchten wir Ihnen die Grundlagen von PHP in einem kleinen
   Tutorial vorstellen. Dieser Text behandelt nur das Erstellen von
   dynamischen Webseiten, obwohl PHP natürlich nicht nur dafür geeignet ist.
   Weitere Informationen finden Sie im Abschnitt
   <link linkend="intro-whatcando">Was kann PHP?</link>.
  </para>
  <para>
   Mit PHP erweiterte Webseiten werden wie normale HTML-Seiten behandelt. Sie
   können sie genauso wie normale HTML-Seiten erstellen und bearbeiten.
  </para>

  <section xml:id="tutorial.requirements">
   <info><title>Was brauche ich?</title></info>
   <para>
    In diesem Tutorial gehen wir davon aus, dass auf Ihrem Server die
    PHP-Unterstützung aktiviert ist und dass die Dateiendung
    <filename class="extension">.php</filename> PHP zugeordnet ist. Auf den
    meisten Servern ist dies die Standardeinstellung für PHP-Dateien, aber
    fragen Sie bitte Ihren Server-Administrator, um sicherzugehen. Wenn Ihr
    Server PHP unterstützt, müssen Sie nichts machen. Erstellen Sie einfach
    Ihre <filename class="extension">.php</filename>-Dateien und legen Sie
    diese in Ihr Web-Verzeichnis - der Server wird sie dann für Sie parsen. Sie
    müssen nichts kompilieren und auch keine Zusatz-Tools installieren. Stellen
    Sie sich diese PHP-erweiterten Dateien wie normale HTML-Seiten mit einer
    ganzen Familie von "magischen" Tags vor, die Sie verschiedenste Dinge tun
    lassen.
   </para>
   <para>
    Angenommen, Sie möchten Bandbreite sparen und lokal entwickeln. In diesem
    Fall müssen Sie einen Webserver wie &zb;
    <link xlink:href="&url.apache;">Apache</link> und natürlich
    <link xlink:href="&url.php.downloads;">PHP</link> installieren. Sehr
    empfehlenswert ist auch die Installation einer Datenbank wie &zb;
    <link xlink:href="&url.mysql.docs;">MySQL</link>.
   </para>
   <para>
    Sie können diese Programme entweder eins nach dem anderen selbst
    installieren oder den folgenden einfacheren Weg gehen. Unser Handbuch
    bietet ausführliche
    <link linkend="install">Installationsanweisungen für PHP</link> (dabei
    gehen wir davon aus, dass Sie schon einen Webserver installiert haben).
    Falls Sie Probleme bei der Installation von PHP haben, dann empfehlen wir
    Ihnen, dass Sie Ihre Fragen auf unserer
    <link xlink:href="&url.php.mailing-lists;">Installations-Mailingliste</link>
    stellen. Noch einfacher ist es,
    <link xlink:href="&url.installkits;">vorkonfigurierte Pakete</link> für
    Ihr Betriebssystem zu verwenden, die alle oben genannten Programme mit
    einigen wenigen Mausklicks installieren. Es ist ziemlich einfach, einen
    Webserver mit PHP-Unterstützung auf jedem Betriebssystem, wie macOS, Linux
    oder Windows, aufzusetzen. Unter Linux sind
    <link xlink:href="&url.rpmfind;">rpmfind</link> und
    <link xlink:href="&url.rpmfind.pbone;">PBone</link> hilfreich, wenn Sie
    RPM-Pakete suchen. Wenn Sie Pakete für Debian suchen, dann besuchen Sie
    bitte <link xlink:href="&url.apt-get;">apt-get</link>.
   </para>
  </section>

  <section xml:id="tutorial.firstpage">
   <info><title>Ihre erste PHP-erweiterte Seite</title></info>
   <para>
    Erstellen Sie eine Datei mit dem Namen <filename>hallo.php</filename> und
    speichern Sie diese im Wurzelverzeichnis Ihres Webservers
    (<varname>DOCUMENT_ROOT</varname>) mit dem folgenden Inhalt:
   </para>
   <para>
    <example>
     <info><title>Unser erstes PHP-Skript: <filename>hallo.php</filename></title></info>
     <programlisting role="php">
<![CDATA[
<?php

echo "Hello World!";

?>
]]>
     </programlisting>
     <simpara>
      Verwenden Sie Ihren Browser, um die Datei über die Webserver-URL
      aufzurufen. Die URL muss mit <literal>/hallo.php</literal> enden. Wenn
      Sie lokal entwickeln, sieht die URL &zb; so aus:
      <literal>http://localhost/hallo.php</literal> oder so:
      <literal>http://127.0.0.1/hallo.php</literal> - andere Adressen sind
      aber, abhängig vom Webserver, auch möglich. Wenn alles korrekt
      konfiguriert ist, wird die Datei von PHP geparst und Sie sehen die
      Ausgabe "Hallo Welt" in Ihrem Browser.
     </simpara>
     <simpara>
      PHP kann in eine normale HTML-Webseite eingebettet werden. Das bedeutet,
      dass Sie innerhalb Ihres HTML-Dokuments die PHP-Anweisungen schreiben
      können, wie im folgenden Beispiel gezeigt:
     </simpara>
     <programlisting role="php">
<![CDATA[
<!DOCTYPE html>
<html>
    <head>
        <title>PHP-Test</title>
    </head>
    <body>
        <?php echo '<p>Hallo Welt</p>'; ?>
    </body>
</html>
]]>
     </programlisting>
     <simpara>
      Dies führt zur folgenden Ausgabe:
     </simpara>
     <screen role="html">
<![CDATA[
<!DOCTYPE html>
<html>
    <head>
        <title>PHP-Test</title>
    </head>
    <body>
        <p>Hallo Welt</p>
    </body>
</html>
]]>
     </screen>
    </example>
   </para>
   <para>
    Das Beispiel ist extrem einfach und natürlich brauchen Sie PHP nicht, um
    eine Seite wie diese zu erstellen. Denn es macht nicht mehr, als mit der
    <function>echo</function>-Anweisung von PHP <literal>Hallo Welt</literal>
    auszugeben. Bitte beachten Sie, dass die Datei <emphasis>nicht
    ausführbar</emphasis> sein muss. Der Server erkennt anhand der Dateiendung
    ".php", dass sie durch PHP interpretiert werden muss. Stellen Sie sich
    eine normale HTML-Datei vor, die eine Menge von speziellen Tags enthält,
    mit denen Sie einige interessante Dinge tun können.
   </para>
   <para>
    Wenn Sie dieses Beispiel ausprobiert haben und Sie aber keine Ausgabe
    erhalten haben oder zum Download aufgefordert worden sind oder die
    komplette Datei als Text erhalten haben, dann ist es sehr wahrscheinlich,
    dass auf Ihrem Server PHP nicht aktiviert oder falsch konfiguriert ist.
    Fragen Sie in diesem Fall Ihren Administrator und weisen Sie ihn auf das
    <link linkend="install">Installations-Kapitel</link> hin. Wenn Sie lokal
    entwickeln, lesen Sie bitte das Installations-Kapitel, um festzustellen,
    ob alles richtig konfiguriert wurde. Stellen Sie sicher, dass Sie die
    Datei über das HTTP-Protokoll aufrufen können. Wenn Sie die Datei direkt
    aus Ihrem Dateisystem aufrufen, wird sie nicht durch PHP geparst. Sollten
    Ihre Probleme nach Lesen dieses Kapitels immer noch bestehen, zögern Sie
    nicht und nutzen Sie eines der vielen
    <link xlink:href="&url.php.support;">Support</link>-Angebote.
   </para>
   <para>
    Der Sinn des Beispiels ist es, Ihnen das spezielle PHP Tag-Format zu
    zeigen. Im Beispiel wurde <literal>&lt;?php</literal> verwendet, um den
    Beginn eines PHP-Tags zu kennzeichnen. Anschließend folgte die
    PHP-Anweisung. Mit dem schließenden Tag, <literal>?&gt;</literal>, wurde
    der PHP-Modus wieder verlassen. Sie können an jeder Stelle und so oft Sie
    wollen, in den PHP-Modus wechseln und ihn wieder verlassen. Für weitere
    Details lesen Sie bitte den Abschnitt zu den
    <link linkend="language.basic-syntax">Grundlagen der Syntax</link> von
    PHP.
   </para>

   <note>
    <info><title>Anmerkungen zu Zeilenwechseln</title></info>
    <para>
     Zeilenwechsel sind in HTML nur von geringer Bedeutung, trotzdem ist es
     sinnvoll, HTML-Code durch Zeilenwechsel zu formatieren um die Lesbarkeit
     zu erhöhen. Ein Zeilenwechsel, der direkt auf ein schließendes
     <literal>?&gt;</literal> folgt, wird von PHP bei der Ausgabe entfernt.
     Dies ist äußerst nützlich, wenn Sie viele PHP-Blöcke einfügen oder
     Dateien inkludieren, die keine Ausgabe erzeugen sollen. Auf der anderen
     Seite kann es aber auch verwirrend sein. Sie können einen Zeilenwechsel
     erzwingen, indem Sie entweder ein zusätzliches Leerzeichen hinter
     <literal>?&gt;</literal> einfügen oder explizit mit echo oder print ein
     Zeilenwechselzeichen am Ende Ihres Codes ausgeben.
    </para>
   </note>

   <note>
    <info><title>Anmerkung zu Text-Editoren</title></info>
    <para>
     Es gibt eine ganze Reihe von Text-Editoren und integrierten
     Entwicklungsumgebungen (Integrated Development Environments, IDEs), mit
     denen Sie Ihre PHP-Dateien erstellen, bearbeiten und verwalten können.
     Eine Liste solcher Programme finden Sie hier:
     <link xlink:href="&url.phpeditorlist;">List of PHP editors</link>. Wenn
     Sie einen Editor vorschlagen möchten, besuchen Sie bitte die genannte
     Seite und bitten Sie den Betreiber der Seite, dass er den Editor der
     Liste hinzufügt. Wir empfehlen Ihnen einen Editor zu verwenden, der
     Syntax-Highlighting (die farbliche Hervorhebung von Code) bietet.
    </para>
   </note>

   <note>
    <info><title>Anmerkung zu Textverarbeitungsprogrammen</title></info>
    <para>
     Textverarbeitungsprogramme wie StarOffice Writer, Microsoft Word und
     Abiword sind keine gute Wahl, um PHP-Dateien zu bearbeiten. Wenn Sie
     eines dieser Programme für dieses Test-Skript nutzen möchten, dann müssen
     Sie sicherstellen, dass die Datei als <emphasis>"Nur
     Text"</emphasis>-Datei gespeichert wird, da PHP sonst das Skript nicht
     lesen und nicht ausführen kann.
    </para>
   </note>

   <para>
    Nachdem Sie jetzt erfolgreich ein einfaches, funktionierendes PHP-Skript
    geschrieben haben, wird es Zeit, das berühmteste PHP-Skript zu schreiben.
    Rufen Sie die Funktion <function>phpinfo</function> auf und Sie bekommen
    viele nützliche Informationen über Ihr System und Ihre Installation wie
    &zb; die verfügbaren
    <link linkend="language.variables.predefined">vordefinierten Variablen</link>,
    die geladenen PHP-Module und die
    <link linkend="configuration">Konfigurations</link>-Einstellungen. Nehmen
    Sie sich etwas Zeit und schauen Sie sich diese wichtigen Informationen an.
   </para>
   <para>
    <example>
     <info><title>Anzeigen von Systeminformationen mit PHP</title></info>
     <programlisting role="php">
<![CDATA[
<?php phpinfo(); ?>
]]>
     </programlisting>
    </example>
   </para>
  </section>

  <section xml:id="tutorial.useful">
   <info><title>Etwas Nützliches</title></info>
   <para>
    Kommen wir nun zu einem etwas nützlicheren Beispiel. Wir wollen prüfen,
    welchen Browser der Besucher verwendet. Um das zu tun, prüfen wir den
    "user agent"-String, den der Browser als Teil seiner HTTP-Anforderung
    sendet. Diese Information ist in einer
    <link linkend="language.variables">Variablen</link> abgelegt. In PHP
    beginnen Variablen immer mit einem Dollar-Zeichen. Die Variable, die uns
    jetzt interessiert, ist <varname>$_SERVER['HTTP_USER_AGENT']</varname>.
   </para>
   <note>
    <para>
     <varname>$_SERVER</varname> ist eine speziell reservierte PHP-Variable,
     die alle Informationen über den Webserver enthält. Diese Variable wird
     auch als Superglobal bezeichnet. Mehr Informationen darüber finden Sie im
     Handbuch auf der Seite über
     <link linkend="language.variables.superglobals">Superglobals</link>.
    </para>
   </note>
   <para>
    Um die Variable auszugeben, schreiben Sie einfach:
   </para>
   <para>
    <example>
     <info><title>Variable ausgeben (Array-Element)</title></info>
     <programlisting role="php">
<![CDATA[
<?php
echo $_SERVER['HTTP_USER_AGENT'];
?>
]]>
     </programlisting>
     <para>
      Die Ausgabe dieses Beispiels könnte so aussehen:
     </para>
     <screen role="html">
<![CDATA[
Mozilla/5.0 (Linux) Firefox/112.0
]]>
     </screen>
    </example>
   </para>
   <para>
    Es gibt viele <link linkend="language.types">Typen</link> von Variablen.
    Im obigen Beispiel haben wir ein Element einer
    <link linkend="language.types.array">Array</link>-Variable ausgegeben.
    Arrays können sehr nützlich sein.
   </para>
   <para>
    <varname>$_SERVER</varname> ist nur eine von vielen Variablen, die Ihnen
    automatisch von PHP zur Verfügung gestellt werden. Eine Liste finden Sie
    auf der Seite
    <link linkend="reserved.variables">Reservierte Variablen</link> im
    Handbuch. Eine vollständige Liste können Sie auch bekommen, wenn Sie sich
    die Ausgabe der Funktion <function>phpinfo</function> ansehen, die im
    Beispiel des vorigen Abschnitts verwendet wurde.
   </para>
   <para>
    Sie können mehrere PHP-Anweisungen innerhalb eines PHP-Tags platzieren und
    so kleine Code-Blöcke schreiben, die mehr als nur eine Ausgabe mit
    <function>echo</function> enthalten. Wenn wir zum Beispiel prüfen möchten,
    ob es sich beim Browser des Besuchers um den Firefox handelt, können wir
    folgenden Code verwenden:
   </para>
   <para>
    <example>
     <info><title>Beispiel, das
     <link linkend="language.control-structures">Kontrollstrukturen</link> und
     <link linkend="language.functions">Funktionen</link> verwendet</title></info>
     <programlisting role="php">
<![CDATA[
<?php
if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
    echo 'Sie verwenden Firefox.';
}
?>
]]>
     </programlisting>
     <para>
      Die Ausgabe dieses Skripts könnte so aussehen:
     </para>
     <screen role="html">
<![CDATA[
Sie verwenden Firefox.
]]>
     </screen>
    </example>
   </para>
   <para>
    Hier stellen wir Ihnen eine ganze Reihe von neuen Konzepten vor. Wir haben
    hier zuerst eine
    <link linkend="control-structures.if">if</link>-Anweisung. Wenn Sie mit der
    grundlegenden Syntax der Programmiersprache C vertraut sind, sollte Ihnen
    dies logisch erscheinen. Andernfalls sollten Sie sich ein Buch mit einer
    PHP-Einführung besorgen und die ersten Kapitel lesen. Sie können natürlich
    auch in die <link linkend="langref">Sprachreferenz</link> des Handbuchs
    schauen.
   </para>
   <para>
    Das zweite hier vorgestellte Konzept ist der Aufruf der Funktion
    <function>str_contains</function>. <function>str_contains</function> ist
    eine in PHP eingebaute Funktion, die feststellt, ob eine gegebene
    Zeichenkette eine andere Zeichenkette enthält. In diesem Fall suchen wir
    nach <literal>'Firefox'</literal> (die so genannte Nadel, engl. needle) in
    <varname>$_SERVER['HTTP_USER_AGENT']</varname> (der so genannte Heuhaufen,
    engl. haystack). Wenn die Nadel im Heuhaufen gefunden wird, gibt die
    Funktion &true; zurück. Andernfalls wird &false; zurückgegeben. Wenn
    &true; zurückgeben wird, wird die
    <link linkend="control-structures.if">if</link>-Anweisung zu &true;
    ausgewertet und der Code innerhalb der geschweiften Klammern wird
    ausgeführt. Andernfalls wird der Code innerhalb der Klammern nicht
    ausgeführt. Probieren Sie weitere ähnliche Beispiele mit
    <link linkend="control-structures.if">if</link>,
    <link linkend="control-structures.else">else</link> und anderen Funktionen
    wie <function>strtoupper</function> oder <function>strlen</function>. Jede
    dieser Handbuch-Seiten enthält weitere Beispiele. Wenn Sie unsicher sind,
    wie die Funktionen verwendet werden, lesen Sie die Handbuch-Seite
    <link linkend="about.prototypes">Wie sind Funktionsdefinitionen (Prototypen) zu lesen?</link>
    und den Abschnitt zu den
    <link linkend="language.functions">PHP-Funktionen</link>.
   </para>
   <para>
    Wir können jetzt einen Schritt weitergehen und sehen, wie Sie innerhalb
    eines PHP-Blocks den PHP-Modus verlassen und wieder in ihn hinein gelangen
    können:
   </para>
   <para>
    <example>
     <info><title>HTML- und PHP-Modus vermischt</title></info>
     <programlisting role="php">
<![CDATA[
<?php
if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
?>
<h3>str_contains() hat true zurückgegeben</h3>
<p>Sie verwenden Firefox</p>
<?php
} else {
?>
<h3>str_contains() hat false zurückgegeben</h3>
<p>Sie verwenden nicht Firefox</p>
<?php
}
?>
]]>
     </programlisting>
     <para>
      Die Ausgabe dieses Skripts könnte so aussehen:
     </para>
     <screen role="html">
<![CDATA[
<h3>str_contains() hat true zurückgegeben</h3>
<p>Sie verwenden Firefox</p>
]]>
     </screen>
    </example>
   </para>
   <para>
    Anstatt die PHP-Anweisung echo für die Ausgabe zu verwenden, haben wir den
    PHP-Modus verlassen und normales HTML verwendet. Der wichtige und
    entscheidende Punkt hierbei ist, dass der logische Ablauf des Skripts
    dadurch nicht gestört wird. Nur einer der beiden HTML-Blöcke wird
    ausgegeben - abhängig davon, was <function>str_contains</function> zurückgibt
    bzw. ob die Zeichenkette <literal>Firefox</literal> gefunden wird oder nicht.
   </para>
  </section>

  <section xml:id="tutorial.forms">
   <info><title>Formulare verarbeiten</title></info>
   <para>
    Eine der mächtigsten Funktionen von PHP ist die Art, wie HTML-Formulare
    verarbeitet werden. Sie sollten wissen, dass jedes Element eines Formulars
    automatisch in Ihren PHP-Skripts verfügbar ist. Bitte lesen Sie die Seite
    <link linkend="language.variables.external">Variablen aus externen Quellen</link>
    für weitere Informationen und Beispiele über die Verwendung von Formularen
    mit PHP. Hier ist ein HTML-Beispielformular:
   </para>
   <para>
    <example>
     <info><title>Ein einfaches HTML-Formular</title></info>
     <programlisting role="html">
<![CDATA[
<form action="action.php" method="post">
    <label for="name">Ihr Name:</label>
    <input name="name" id="name" type="text">

    <label for="age">Ihr Alter:</label>
    <input name="alter" id="alter" type="number">

    <button type="submit">Submit</button>
</form>
]]>
     </programlisting>
    </example>
   </para>
   <para>
    An diesem Formular ist nichts Besonderes. Es ist ein normales
    HTML-Formular ohne irgendwelche speziellen Tags. Wenn der Benutzer das
    Formular ausfüllt und den Submit-Button anklickt, wird die Seite
    <filename>action.php</filename> aufgerufen. Diese Datei könnte so
    aussehen:
   </para>
   <para>
    <example>
     <info><title>Daten des Formulars ausgeben</title></info>
     <programlisting role="php">
<![CDATA[
Hallo <?php echo htmlspecialchars($_POST['name']); ?>.
Sie sind <?php echo (int) $_POST['alter']; ?> Jahre alt.
]]>
     </programlisting>
     <para>
      Die Ausgabe des Skripts könnte dann so aussehen:
     </para>
     <screen role="html">
<![CDATA[
Hallo Joe. Sie sind 22 Jahre alt.
]]>
     </screen>
    </example>
   </para>
   <para>
    Abgesehen von den beiden Teilen <function>htmlspecialchars</function> und
    <literal>(int)</literal> sollte einfach zu verstehen sein, was hier
    geschieht. <function>htmlspecialchars</function> stellt sicher, dass die
    Zeichen, die in HTML eine spezielle Bedeutung haben, ordentlich kodiert
    werden, sodass niemand HTML-Tags oder Javascript-Code in Ihre Seite
    einschmuggeln kann. Da wir wissen, dass das Feld "alter" eine Zahl
    enthalten soll,
    <link linkend="language.types.typecasting">konvertieren</link> wir es in
    einen &integer;-Wert, wodurch automatisch überflüssige Zeichen entfernt
    werden. Sie können diese Aufgabe auch PHP überlassen, indem Sie die
    <link linkend="ref.filter">Filter</link>-Erweiterung verwenden. Die
    Variablen <varname>$_POST['name']</varname> und
    <varname>$_POST['alter']</varname> werden für Sie automatisch von PHP
    gesetzt. Weiter oben haben wir das superglobale Array
    <varname>$_SERVER</varname> eingeführt, jetzt verwenden wir hier das -
    ebenfalls superglobale - Array <varname>$_POST</varname>, welches alle
    POST-Daten enthält. Beachten Sie, dass die im Formular verwendete
    <emphasis>Methode</emphasis> POST ist. Hätten wir <emphasis>GET</emphasis>
    verwendet, wären die Daten unseres Formulars stattdessen im superglobalen
    Array <varname>$_GET</varname> verfügbar. Sie können auch das superglobale
    Array <varname>$_REQUEST</varname> verwenden, wenn die Quelle der Daten
    keine Rolle spielt. Dieses Array enthält die GET-, POST- und COOKIE-Daten.
   </para>
  </section>

  <section xml:id="tutorial.whatsnext">
   <info><title>Und weiter?</title></info>
   <para>
    Mit dem neuen Wissen sollte es Ihnen möglich sein, das meiste aus diesem
    Handbuch und die vielen Beispiel-Skripte in den Beispiel-Archiven zu
    verstehen.
   </para>
   <para>
    Wenn Sie an verschiedenen Präsentationen, die Ihnen zeigen, was PHP alles
    tun kann, interessiert sind, dann besuchen Sie doch folgende Seite:
    <link xlink:href="&url.php.talks;">&url.php.talks;</link>.
   </para>
  </section>
 </chapter>

<!-- 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
-->