From 6e5032a338d1b0d36fe95e662b278a7876a453f2 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Fri, 29 May 2026 20:19:54 +0200 Subject: [PATCH 1/4] [Sync EN] Update tutorial chapter to match upstream rewrite Brings chapters/tutorial.xml up to date with the upstream rewrite (EN-Revision 1340d3595bde8489ea1385868ffd75471a56999b): - Drop the obsolete "Was brauche ich?" requirements section. - Replace the DOCUMENT_ROOT-based instructions with the modern `php -S localhost:8000` development server flow. - Drop the troubleshooting paragraph that no longer applies. - Reformat the inline PHP examples (blank lines around code, indentation in the HTML/PHP mode example). - Rewrite the "Und weiter?" section: drop the dead conference-talks link, add pointers to filesystem/curl/PDO/sessions, Packagist, Composer, the community PeerTube, and a breakdown example for beginners. Existing Maintainer (cmb) is kept. --- chapters/tutorial.xml | 202 ++++++++++++++++++++++++------------------ 1 file changed, 114 insertions(+), 88 deletions(-) diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index 08e1b7199..2e0988698 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -1,6 +1,5 @@ - - + Ein kleines Tutorial @@ -16,58 +15,16 @@ können sie genauso wie normale HTML-Seiten erstellen und bearbeiten. -
- Was brauche ich? - - In diesem Tutorial gehen wir davon aus, dass auf Ihrem Server die - PHP-Unterstützung aktiviert ist und dass die Dateiendung - .php 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 .php-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. - - - Angenommen, Sie möchten Bandbreite sparen und lokal entwickeln. In diesem - Fall müssen Sie einen Webserver wie &zb; - Apache und natürlich - PHP installieren. Sehr - empfehlenswert ist auch die Installation einer Datenbank wie &zb; - MySQL. - - - Sie können diese Programme entweder eins nach dem anderen selbst - installieren oder den folgenden einfacheren Weg gehen. Unser Handbuch - bietet ausführliche - Installationsanweisungen für PHP (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 - Installations-Mailingliste - stellen. Noch einfacher ist es, - vorkonfigurierte Pakete 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 - rpmfind und - PBone hilfreich, wenn Sie - RPM-Pakete suchen. Wenn Sie Pakete für Debian suchen, dann besuchen Sie - bitte apt-get. - -
-
Ihre erste PHP-erweiterte Seite + + Dieses Tutorial setzt voraus, dass PHP bereits installiert ist. + Installationsanweisungen finden Sie auf der + Download-Seite. + - Erstellen Sie eine Datei mit dem Namen hallo.php und - speichern Sie diese im Wurzelverzeichnis Ihres Webservers - (DOCUMENT_ROOT) mit dem folgenden Inhalt: + Erstellen Sie eine Datei mit dem Namen hallo.php mit + dem folgenden Inhalt: @@ -79,17 +36,24 @@ echo "Hello World!"; ?> +]]> + + + Navigieren Sie im Terminal in das Verzeichnis, das diese Datei enthält, + und starten Sie mit folgendem Befehl einen Entwicklungsserver: + + + Verwenden Sie Ihren Browser, um die Datei über die Webserver-URL - aufzurufen. Die URL muss mit /hallo.php enden. Wenn - Sie lokal entwickeln, sieht die URL &zb; so aus: - http://localhost/hallo.php oder so: - http://127.0.0.1/hallo.php - 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. + aufzurufen. Die URL muss mit /hallo.php enden. + Gemäß dem zuvor ausgeführten Befehl lautet die URL + http://localhost:8000/hallo.php. + Wenn alles korrekt konfiguriert ist, wird die Datei von PHP geparst und + Sie sehen die Ausgabe "Hello World!" in Ihrem Browser. PHP kann in eine normale HTML-Webseite eingebettet werden. Das bedeutet, @@ -137,21 +101,7 @@ echo "Hello World!"; eine normale HTML-Datei vor, die eine Menge von speziellen Tags enthält, mit denen Sie einige interessante Dinge tun können. - - 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 - Installations-Kapitel 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 - Support-Angebote. - + Der Sinn des Beispiels ist es, Ihnen das spezielle PHP Tag-Format zu zeigen. Im Beispiel wurde <?php verwendet, um den @@ -223,7 +173,11 @@ echo "Hello World!"; Anzeigen von Systeminformationen mit PHP + ]]> @@ -259,7 +213,9 @@ echo "Hello World!"; ]]> @@ -303,9 +259,11 @@ Mozilla/5.0 (Linux) Firefox/112.0 ]]> @@ -364,15 +322,15 @@ Sie verwenden Firefox. -

str_contains() hat true zurückgegeben

-

Sie verwenden Firefox

- +

str_contains() hat true zurückgegeben

+

Sie verwenden Firefox

+ -

str_contains() hat false zurückgegeben

-

Sie verwenden nicht Firefox

- +

str_contains() hat false zurückgegeben

+

Sie verwenden nicht Firefox

+ ]]> @@ -480,16 +438,84 @@ Hallo Joe. Sie sind 22 Jahre alt.
Und weiter? + + Mit dem neuen Wissen sollten Sie das meiste aus diesem Handbuch verstehen + können. + - 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. + Insbesondere könnten folgende Funktionalitäten interessant sein: + + Dateien lesen und schreiben mit den Filesystem-Funktionen + Datei-Uploads verarbeiten + Entfernte Seiten und Dateien mit Curl abrufen + + Daten in einer Datenbank speichern und auswerten mit PDO + (SQLite kann ohne laufenden Datenbankserver verwendet werden) + + Daten über mehrere Requests hinweg persistieren mit Sessions + + + Im Packagist-Repository findet sich für nahezu jeden Anwendungsfall + eine Vielzahl von Bibliotheken und Frameworks, + die alle über den Composer-Paketmanager installiert werden können. + + + Hilfe und Rat aus der Community gibt es auf der Hilfe-Seite. + + + Eine Auswahl an Podcasts, Präsentationen und weiteren Videos findet sich auf dem + Community-PeerTube. + + + Weitere Community-Ressourcen, die hilfreich sein können, sind sogenannte "awesome lists" (kuratierte + Linksammlungen) und "developer roadmaps" (Listen verwandter Themen). + - Wenn Sie an verschiedenen Präsentationen, die Ihnen zeigen, was PHP alles - tun kann, interessiert sind, dann besuchen Sie doch folgende Seite: - &url.php.talks;. + Wenn Sie nicht wissen, wo Sie anfangen sollen, hilft es oft, das Projekt oder Problem in kleinere Teile zu + zerlegen. So lässt sich leichter erkennen, was Sie bereits können und was Sie noch lernen müssen. Die Liste + darf so detailliert werden, wie nötig. Der Bau eines Blogs ließe sich zum Beispiel folgendermaßen aufgliedern: + + + Auflisten und Anzeigen von Seiten + + + Datensätze (Seiten) aus einer Datenbank lesen + + + + + Seiten erstellen + + + Formularübermittlung verarbeiten + + + Datensätze (Seiten) in eine Datenbank schreiben + + + + + Admin-Login + + + Datensätze (Benutzer) aus einer Datenbank lesen + + + Mit Passwörtern umgehen + + + Daten (Benutzer-Login) über Requests und Seiten hinweg persistieren (Sessions) + + + + + + Wenn Sie nichts Bestimmtes bauen möchten, können Sie nach Coding-Übungen wie Katas, Challenges oder + "Code Golf" suchen. Auch wenn sie nicht speziell auf PHP ausgerichtet sind, lassen sich die meisten + umsetzen und werden Ihr Wissen und Denken herausfordern. +
From 22fec059eee6138c1762bed2ce9e1ca876c7dc01 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Sun, 31 May 2026 18:47:05 +0200 Subject: [PATCH 2/4] Update tutorial.xml Co-authored-by: Martin Samesch --- chapters/tutorial.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index 2e0988698..b3d760efc 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -512,7 +512,7 @@ Hallo Joe. Sie sind 22 Jahre alt.
- Wenn Sie nichts Bestimmtes bauen möchten, können Sie nach Coding-Übungen wie Katas, Challenges oder + Wenn Sie nichts Bestimmtes entwickeln möchten, können Sie nach Coding-Übungen wie Katas, Challenges oder "Code Golf" suchen. Auch wenn sie nicht speziell auf PHP ausgerichtet sind, lassen sich die meisten umsetzen und werden Ihr Wissen und Denken herausfordern. From 7da2c5a141673a36d45cea3679f8da2e55314127 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Sun, 31 May 2026 18:47:20 +0200 Subject: [PATCH 3/4] Update tutorial.xml Co-authored-by: Martin Samesch --- chapters/tutorial.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index b3d760efc..f902fedf7 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -445,7 +445,7 @@ Hallo Joe. Sie sind 22 Jahre alt. Insbesondere könnten folgende Funktionalitäten interessant sein: - Dateien lesen und schreiben mit den Filesystem-Funktionen + Dateien lesen und schreiben mit den Dateisystem-Funktionen Datei-Uploads verarbeiten Entfernte Seiten und Dateien mit Curl abrufen From d8e318b9ebdd549d03cfa216e1d67a4c41211add Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Sun, 31 May 2026 18:47:29 +0200 Subject: [PATCH 4/4] Update tutorial.xml Co-authored-by: Martin Samesch --- chapters/tutorial.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index f902fedf7..c13ad9c78 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -452,7 +452,7 @@ Hallo Joe. Sie sind 22 Jahre alt. Daten in einer Datenbank speichern und auswerten mit PDO (SQLite kann ohne laufenden Datenbankserver verwendet werden) - Daten über mehrere Requests hinweg persistieren mit Sessions + Daten über mehrere Requests hinweg beibehalten mit Sessions