Entwicklungsmaschine aufsetzen

Ubuntu installieren: Interaktiv, Standard, nix empfohlenes installieren.

  1. Systemaktualisierung:
    Aktualisiere dein System, um sicherzustellen, dass alle Pakete auf dem neuesten Stand sind.
    sudo apt update
    sudo apt upgrade
  2. Docker installieren:
    DDEV erfordert Docker, um zu funktionieren. Installiere Docker mit den folgenden Befehlen:
    Docker herunterladen
    The latest Ubuntu 24.04 LTS is not yet supported. Docker Desktop will fail to start. Due to a change in how the latest Ubuntu release restricts the unprivileged namespaces,
    sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
    needs to be run at least once.
    sudo apt install docker.io
    Nach der Installation kannst du überprüfen, ob Docker ordnungsgemäß installiert ist, indem du den folgenden Befehl ausführst:
    sudo systemctl status docker
  3. Docker-Compose installieren:
    DDEV benötigt auch Docker-Compose. Installiere Docker-Compose mit den folgenden Befehlen:
    sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep -oP '"tag_name": "\K(.*)(?=")')/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    sudo chmod +x /usr/local/bin/docker-compose
    Überprüfe die Installation:
    docker-compose --version
    Der eigene User muss dann noch zur berechtigten Gruppe hinzugefügt werden mit sudo usermod -aG docker $USER. $USER durch den eigenen Usernamen ersetzen. Danach das System neu starten. An- und Abmelden genügt scheinbar nicht!?
  4. DDEV installieren:
    Lade das DDEV-Installationsskript herunter und führe es aus:
    curl -fsSL https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh | bash
    Die Hinweise auf certutil für FF und Chrome beachten, daher sudo apt install libnss3-tools ausführen und gleich anschließend mkcert -install, damit certutil für FF und Chrome zur Verfügung steht.
    Alternativ kannst du DDEV manuell installieren, indem du die neueste Version von DDEV von GitHub herunterlädst:
    DDEV_VERSION=$(curl -s https://api.github.com/repos/drud/ddev/releases/latest | grep -oP '"tag_name": "\K(.*)(?=")')
    sudo curl -L "https://github.com/drud/ddev/releases/download/${DDEV_VERSION}/ddev_linux.amd64" -o /usr/local/bin/ddev
    sudo chmod +x /usr/local/bin/ddev
  5. Installation überprüfen:
    Überprüfe, ob DDEV ordnungsgemäß installiert ist, indem du den folgenden Befehl ausführst:
    ddev --version
  6. xDebug installieren:
    Schritt 1: Bestehende Xdebug-Version deinstallieren
    Falls du bereits eine ältere Version von Xdebug installiert hast, deinstalliere sie zuerst:
    sudo apt remove php-xdebug
    Schritt 2: Abhängigkeiten aktualisieren
    Stelle sicher, dass dein System und deine PHP-Version auf dem neuesten Stand sind:
    sudo apt update
    sudo apt upgrade
    Schritt 3: PECL installieren
    PECL (PHP Extension Community Library) ist ein Tool, um PHP-Erweiterungen zu installieren:
    sudo apt install php-pear php-dev
    Schritt 4: Xdebug 3 installieren
    Installiere Xdebug 3 mit PECL:
    sudo pecl install xdebug
    Schritt 5: Xdebug in PHP konfigurieren
    Finde die xdebug.so-Datei, die PECL installiert hat. Dies wird normalerweise angezeigt, nachdem die Installation abgeschlossen ist. Die Datei befindet sich typischerweise in einem Verzeichnis wie /usr/lib/php/20200930/xdebug.so, wobei sich der Pfad je nach PHP-Version unterscheiden kann.
    Füge die Xdebug-Konfiguration zu deiner PHP-Konfigurationsdatei hinzu. Die Datei, die du bearbeiten musst, hängt von deiner PHP-Version und deiner Umgebung ab (CLI, FPM, Apache). Für die CLI-Umgebung könntest du z.B. die Datei /etc/php/7.4/cli/php.ini bearbeiten:
    sudo nano /etc/php/7.4/cli/php.ini
    Für PHP-FPM:
    sudo nano /etc/php/7.4/fpm/php.ini
    Füge die folgenden Zeilen am Ende der Datei hinzu oder aktualisiere bestehende Xdebug-Einträge:
    zend_extension=xdebug.so
    xdebug.mode=debug
    xdebug.start_with_request=yes
    xdebug.client_port=9003
    xdebug.client_host=127.0.0.1
    Passe xdebug.client_host und xdebug.client_port nach Bedarf an. xdebug.mode kann auch auf develop oder profile gesetzt werden, je nachdem, welche Funktionen du benötigst.
    Schritt 6: PHP-Dienste neu starten
    Damit die Änderungen wirksam werden, starte die PHP-Dienste neu:
    Für PHP-FPM:
    sudo systemctl restart php7.4-fpm
    Für Apache (falls du Apache verwendest):
    sudo systemctl restart apache2
    Schritt 7: Überprüfen der Installation
    Überprüfe, ob Xdebug korrekt installiert ist:
    php -v
    Du solltest eine Ausgabe sehen, die etwas Ähnliches wie folgendes enthält:
    PHP 7.4.3 (cli) (built: Feb 23 2020 07:23:35) ( NTS )
    Copyright (c) The PHP Group
    Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Xdebug v3.0.0, Copyright (c) 2002-2020, by Derick Rethans
    Alternativ kannst du ein PHP-Skript mit phpinfo(); erstellen und es in deinem Webbrowser aufrufen, um die Xdebug-Konfiguration zu überprüfen.
  7. Für den Zugriff auf die anderen Systeme im Netz wird sudo apt install cifs-utils benötigt. Damit werden Windowslaufwerke gemountet.
  8. Das Anwendungszentrum öffnen und nach PhpStorm suchen und auf installieren klicken. Zum einfacheren Aufruf an die Taskleiste anheften.
  9. Mit Hilfe von sudo apt install filezilla FileZilla installieren und am besten gleich noch aus einem Bestehenden FileZilla die Einstellungen exportieren und hier importieren.
  10. npm installieren mit sudo apt install npm.
  11. den Komprimierer für CSS installieren mit sudo npm install -g csso-cli.
  12. den Komprimierer für JS installieren mit sudo npm install --g uglify-js.
  13. Beide Komprimierer in PHPstorm in den Einstellungen unter File Watchers hinzufügen.