03 Einrichten

[muhme]

Erste Version des Kapitels 3 Einrichten. Issue #9

Wird ggf. noch angepasst, wenn das folgende Kapitel Installation überarbeitet wird.

[dautrich]

@muhme Wie versprochen, habe ich mir mal Dein Kapitel 3 angeschaut. Meine Findings hier in lockerer Reihenfolge:

Wie Stefan Wendhausen auch schon geschrieben hat, würde ich MySQL gleichrangig neben MariaDB aufnehmen (obwohl mit MariaDB zur Förderung von Open Source lieber wäre).
Begründung: Nicht jeder Hoster bietet MariaDB an (auch meiner nicht). Und wir sind uns sicher einig darin, dass gerade für einen unerfahrenen User (die Zielgruppe unseres Buches) die Entwicklungsumgebung so ähnlich wie möglich zur Live-Umgebung gestaltet werden sollte. Also sei so lieb und nimm MySQL zusätzlich auf.

Linux: Ich habe die Einrichtung unter Linux unter erschwerten Bedingungen (unter Windows mit WSL2) mal durchgespielt.
Dabei ist mir Folgendes aufgefallen:

• Gleich bei PHP 8.4 hast Du im ersten Kasten zweimal "sudo apt update". Das macht aus meiner Sicht (mit nicht allzu umfangreichen Linux-Know-How) keinen Sinn. Stattdessen sollte hier "sudo apt dist-upgrade" stehen.
• Am Ende dieser Seite lässt Du die PHP-Version anzeigen. Das dürfte nach Abschluss unseres Buches nicht mehr 8.4.15 sein (ich habe gestern 8.4.16 gesehen). Ich würde das so formulieren, dass die PHP-Version ähnlich angezeigt wird wie im Beispiel.
  Das Gleiche gilt auch bei der Version von MariaDB (und von MySQL, wenn Du es einbaust).
• Beim Apache Webserver gehst Du davon aus, dass der Benutzer schon einen Browser hat. Das stimmt natürlich für jedes normale Desktop-Linux. Bei WSL2 musste ich mir erst einmal per "sudo apt-get install firefox" oder "sudo apt-get install chromium" einen Browser besorgen. Ob man diesen Fall berücksichtigen sollte, weiß ich auch nicht; vielleicht mit einer Fußnote.
• phpMyAdmin habe ich nicht auf Port 8080 erreicht, sondern nur ohne.

Windows: Die Installation von Laragon habe ich nicht durchgespielt, weil ich es ohnehin schon installiert habe, allerdings noch in der Version 6.0. Dadurch finde ich natürlich unter Tools - Quick add nur ältere Versionen. Ansonsten passt das alles, ist aber ziemlich knapp gehalten.
Eventuell könntest Du per Fußnote auf diese URL verweisen: https://deltapapa.de/werkstatt. Hier gibt es weitere Informationen zu Laragon in Deutsch.

Mac: Leider habe ich keine Ahnung von MacOS. Deshalb habe ich nur mal auf Tippfehler durchgelesen und keine gefunden.

Firefox-Werkzeuge:

• Ich nutze immer F12 zum Starten der Devtools. Könntest Du als Alternative ergänzen?

Ansonsten aus meiner Sicht alles okay.

[muhme]

@dautrich vielen Dank für das Lesen, Testen und Kommentieren 👍
Ich hatte viel zu tun, will aber heute nun antworten:

würde ich MySQL gleichrangig neben MariaDB aufnehmen

Ich denke wir sollten auch zusehen, dass Buch so kurz wie möglich halten. Und eben explizit MariaDB für die Bevorzugung von OpenSource nehmen.

zweimal "sudo apt update" ... Stattdessen sollte hier "sudo apt dist-upgrade" stehen.

Das ist hier notwendig. Das erste aktualisiert die Paketlisten der aktuell bekannten Repositories.
Das zweite Update ist nach dem Hinzufügen des Repositories von Ondřej Surý Repository nötig.
Ein apt dist-upgrade ist eher für eine System Upgrade, wir wollen nur die erforderliche Software hinzufügen.

Am Ende dieser Seite lässt Du die PHP-Version anzeigen. Das dürfte nach Abschluss unseres Buches nicht mehr 8.4.15 sein (ich habe gestern 8.4.16 gesehen).

Ergänzt mit: „Patch-Version und Build-Datum können abweichen, zum Beispiel:”

Das Gleiche gilt auch bei der Version von MariaDB

Ergänzt mit: „Patch-Version und die Linux-Variante können abweichen, zum Beispiel:”

Beim Apache Webserver gehst Du davon aus, dass der Benutzer schon einen Browser hat.
Das stimmt natürlich für jedes normale Desktop-Linux. Bei WSL2 musste ich mir erst einmal per "sudo apt-get install firefox" oder "sudo apt-get install chromium" einen Browser besorgen. Ob man diesen Fall berücksichtigen sollte, weiß ich auch nicht; vielleicht mit einer Fußnote.

In meinem Verständnis sollte ein Windows-Benutzer die „Einrichten der Arbeitsumgebung unter Windows” benutzen. Es geht ja explizit um die Einrichtung für das eigene Host-Systems und so habe ich das auch getestet.

phpMyAdmin habe ich nicht auf Port 8080 erreicht, sondern nur ohne.

Liegt das an WSL2 unter Windows?

Eventuell könntest Du per Fußnote auf diese URL verweisen: https://deltapapa.de/werkstatt. Hier gibt es weitere Informationen zu Laragon in Deutsch.

Das würde ich definitiv nicht empfehlen, da es ein Drittanbieter ist.

Firefox-Werkzeuge: Ich nutze immer F12 zum Starten der Devtools. Könntest Du als Alternative ergänzen?

Das ist auf dem Mac dann ⌥⇧1 (Alt + Shift + 1) 😄 Da dieses Kapitel Betriebssystem-neutral geschrieben ist, würde ich das nicht aufnehmen wollen.

Herzlichen Dank für Deine Arbeit.

[dautrich]

Ich denke wir sollten auch zusehen, dass Buch so kurz wie möglich halten. Und eben explizit MariaDB für die Bevorzugung von OpenSource nehmen.

Das Buch so kurz wie möglich zu machen, finde ich gut. Wir sollten es aber auch so lang wie nötig gestalten. Und es sollte jedem Benutzer möglich sein, nach dem Buch seine Arbeitsumgebung einzurichten. Da jedoch manche (viele?) Hoster nur MySQL anbieten und nicht MariaDB, würden wir den Leser an dieser Stelle alleine lassen. Und deshalb möchte ich Dich bitten, Deine Entscheidung zu überdenken (auch wenn ich das Argument zur Unterstützung von Open Source grundsätzlich mittrage).