Skip to content

13. Anhänge

13.1. Installation von PHP

Die Beispiele und die Fallstudie erfordern [PHP] 8.4 oder eine neuere Version mit den Erweiterungen [intl] (Zahlenformatierung, Beispiel 16), [pdo_mysql] (Zugriff auf [MySQL], Beispiel 28 und Fallstudie), [mbstring], und [openssl]. Sie wurden mit Version 8.4 getestet.

Unter [Windows] ist die einfachste Möglichkeit [Laragon] (laragon.org), das [PHP], [Composer], einen [MySQL]-Server und das Administrationswerkzeug [HeidiSQL] installiert. Ist die mitgelieferte Version von [PHP] älter als 8.4, laden Sie eine neuere Version von windows.php.net/download herunter (die Version *Thread Safe*, [.zip]-Archiv) und entpacken sie in den Ordner [bin\php] von [Laragon]; über das Menü PHP / [Laragon] version können Sie sie auswählen. Das Menü PHP / Extensions aktiviert eine Erweiterung mit einem einzigen Klick ([intl], [pdo_mysql]). Das Terminal von [Laragon] (Schaltfläche Terminal) unterstützt die Befehle [php], [composer], und [mysql].

Ohne [Laragon] entpacken Sie das Archiv von [PHP] in einen Ordner ([C:\php]), fügen diesen Ordner der Umgebungsvariablen [Path] hinzu, erstellen dann die Konfigurationsdatei [php.ini] durch Kopieren von [php.ini-development] und entfernen das Semikolon, das die Zeilen der benötigten Erweiterungen auskommentiert:

1
2
3
4
extension=intl
extension=mbstring
extension=openssl
extension=pdo_mysql

Unter [macOS] installiert der Paketmanager [Homebrew] [PHP] und seine Standarderweiterungen: [brew install php]. Unter [Linux] ([Ubuntu]) ist die von der Distribution bereitgestellte Version oft älter; das Repository [ppa:ondrej/php] liefert die aktuellsten Versionen:

sudo add-apt-repository ppa:ondrej/php
sudo apt install php8.4-cli php8.4-intl php8.4-mbstring php8.4-mysql php8.4-xml php8.4-curl php8.4-zip

Überprüfen Sie die Installation in einer neuen Konsole:

php -v
php -m

Der erste Befehl sollte eine Versionsnummer größer oder gleich 8.4 anzeigen (zum Beispiel [PHP 8.4.12]); der zweite listet die geladenen Erweiterungen auf, darunter [intl] und [pdo_mysql]. Der Befehl [php --ini] zeigt an, welche Datei, [php.ini], verwendet wird.

13.2. Composer

[Composer] ist der Paketmanager für [PHP] (getcomposer.org). Er wird von [Laragon] mitgeliefert; unter [Windows] verwendet man ohne [Laragon] dessen Installer ([Composer-Setup.exe]); unter [macOS] verwenden Sie [brew install composer]; unter [Linux] folgen Sie den Anweisungen auf der Seite getcomposer.org/download. Überprüfen Sie die Installation:

composer -V

Nützliche Befehle in einem Projektordner (dem Ordner, der [composer.json] enthält):

1
2
3
4
composer install            # Bibliotheken des Projekts installieren (Ordner vendor)
composer show               # die installierten Bibliotheken
composer update             # auf die neuesten von composer.json erlaubten Versionen aktualisieren
composer dump-autoload      # Class Loader neu erstellen (nach dem Hinzufügen eines Klassenordners)

[Composer] lädt die Bibliotheken aus dem Repository [Packagist] (packagist.org) herunter: Während der Installation ist eine Internetverbindung erforderlich. Befinden Sie sich hinter einem Firmenproxy, geben Sie den Proxy über die Umgebungsvariablen [HTTP_PROXY] und [HTTPS_PROXY] an. Der Ordner [vendor] wird nicht von einem Rechner auf einen anderen kopiert (er kann absolute Pfade enthalten und ist groß); er wird mit [composer install] neu erzeugt. Deshalb ist er nicht in den Kursunterlagen enthalten. Der Ordner [examples] hat einen eigenen Ordner [vendor], der von allen 28 Beispielen gemeinsam genutzt wird; die Fallstudie hat einen eigenen.

13.3. Installation von Visual Studio Code

[Visual Studio Code] wird von code.visualstudio.com heruntergeladen. Fügen Sie zwei Erweiterungen hinzu (Menü View / Extensions):

  • PHP Intelephense: Code-Vervollständigung, Code-Navigation (auch im Code von [Laravel] im Ordner [vendor]) und Fehlermeldungen;
  • Laravel (die offizielle Erweiterung): Syntaxhervorhebung für [Blade]-Views sowie automatische Vervollständigung für Routennamen, View-Namen, Konfigurationsschlüssel und Übersetzungsschlüssel.

Die Erweiterung PHP Debug ermöglicht es, den Code mit dem Debugger [Xdebug] schrittweise auszuführen (einer Erweiterung von [PHP], die separat installiert werden muss: xdebug.org).

Öffnen Sie den Ordner [examples] oder den Ordner der Fallstudie (Menü File / Open Folder). Das integrierte Terminal (Menü Terminal / New Terminal) ermöglicht es, Anwendungen zu starten, ohne den Editor zu verlassen.

13.4. Installation von MySQL mit Laragon

[Laragon] installiert unter [Windows] einen sofort einsatzbereiten [MySQL]-Server sowie das Administrationswerkzeug [HeidiSQL]. Nach der Installation:

  • Die Schaltfläche „Start All“ startet den [MySQL]-Server auf Port 3306;
  • der Benutzer [root] hat kein Passwort: Dies sind die Werte aus den [.env]-Dateien von Beispiel 28 und der Fallstudie ([DB_USERNAME=root], [DB_PASSWORD=]);
  • Die Schaltfläche „Database“ öffnet [HeidiSQL], wo der Menüpunkt File / Run a File (SQL) die Skripte [dbpersons.sql] (Beispiel 28) und [dbrdvmedecins2.sql] (Fallstudie) ausführt.

Unter [Linux] oder [macOS] installieren Sie [MySQL] oder [MariaDB] mit dem Paketmanager des Systems und führen die Skripte mit dem Kommandozeilen-Client [mysql] aus. Der Treiber [pdo_mysql] funktioniert mit beiden ohne jede Konfiguration. Unter [Linux] ist das [root]-Konto von [MariaDB] oft so konfiguriert, dass die Anmeldung nur über das Systemkonto [root] ([sudo mysql]) möglich ist: Dann wird für die Anwendungen ein Benutzer angelegt, und dieser Benutzer wird in deren [.env]-Datei angegeben:

sudo mysql -e "CREATE USER 'course'@'localhost' IDENTIFIED BY 'course'; GRANT ALL ON *.* TO 'course'@'localhost';"

13.5. Installation von curl

[curl] ist in [Windows] 10 und 11, [macOS] und den meisten [Linux]-Distributionen enthalten. In [PowerShell] müssen Sie [curl.exe] eingeben, nicht [curl]: In älteren Versionen von [PowerShell] ist [curl] ein Alias für einen anderen Befehl ([Invoke-WebRequest]), der andere Optionen hat. In der Eingabeaufforderung von [Windows] ([cmd]) werden die Anführungszeichen eines JSON-Strings als [\"] geschrieben (Beispiel 11), und eine URL, die [&] enthält, muss in doppelte Anführungszeichen gesetzt werden.