Konfiguration von macOS - M1/M2 mit PHP 8.1 (Als Server)

Installation nur mit untermStrich X4 14.3 oder neuer!

:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR.
Die Firma untermStrich software gmbh übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen!

.

Gültig für aktuelle macOS auf M1/M2 CPUs.
Die alte macOS Server Software ist für diese Anleitung nicht notwendig oder sinnvoll.

I. Homebrew installieren

(falls Probleme mit bereits installierten CommandLineTools vorher enfernen)

sudo rm -rf /Library/Developer/CommandLineTools

Siehe https://brew.sh. Typischerweise: 

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Niemals als root oder mittels sudo starten! Je nach Netzwerkverbindung kann dieser Vorgang zwischen ein paar Minuten und ein paar Stunden benötigen!

Optional - Version und brew Installation prüfen

Optional Mit dem ersten Kommando, kann die brew Version überprüft werden. Das doctor Kommando überprüft die Installation von brew. Eventuelle Fehlermeldungen klären Sie bitte mit Ihren SystembetreuerInnen ab oder wenden Sie sich an die homebrew community. 

brew --version
brew doctor

Niemals als root oder mittels sudo starten!

II. Webserver & PHP installieren

brew install httpd
brew install php@8.1

Niemals als root oder mittels sudo starten!

Test

  1. Starten Sie den Server neu
    • sudo brew services restart httpd
  2. :righty: Der Zugriff erfolgt über Port 8080. Am Server: http://localhost:8080

III. httpd.conf

  1. PHP 8.1, mod_expires und mod_rewrite aktivieren
    • Öffnen Sie die Datei /opt/homebrew/etc/httpd/httpd.conf mit dem Texteditor.
    • Entfernen Sie nun 3x die # vor den Modulen:
    • Und fügen gleich danach die folgende Konfiguration ein:
      • LoadModule php_module /opt/homebrew/opt/php@8.1/lib/httpd/modules/libphp.so
 
<FilesMatch \.php$>
  SetHandler application/x-httpd-php
</FilesMatch>
  1. AllowOverride aktivieren
    • In <Directory „/opt/homebrew/var/www“
    • Dazu None gegen All ersetzen:
  2. Starten Sie den Server neu
    • sudo brew services restart httpd

IV. ionCube Loader in php.ini

  1. ionCube Loader herunterladen
  2. Entpacken Sie die Datei.
    • Sie sollte nun unter /Users/IHR_BENUTZERNAME/Downloads/ioncube liegen.
  3. Kopieren Sie das Verzeichnis ioncube nach /opt/homebrew/opt/php@8.1/
    1. Kopieren Sie dazu das Verzeichnis ioncube.
    2. Gehen Sie in den Finder und wählen Sie im Menü „Gehe zu“ > „Gehe zu Ordner“:
    3. Geben sie /opt/homebrew/opt/php@8.1/ ein.
    4. Fügen Sie ioncube ein. Sie sollten nun das Verzeichnis /opt/homebrew/opt/php@8.1/ioncube haben.
  4. Editieren Sie nun die /opt/homebrew/etc/php/8.1/php.ini:
    • Diese Datei /opt/homebrew/etc/php/8.1/php.ini muss existieren.
    • [PHP]
zend_extension = /opt/homebrew/opt/php@8.1/ioncube/ioncube_loader_dar_8.1.so
    • Bitte in der Datei finden und anpassen:
      upload_max_filesize = 50M 
post_max_size = 55M
  5. Starten Sie den Server neu
    • sudo brew services restart httpd

macOS 10.15, 11.1 und neuer

  • macOS ab Catalina wird Sie nach dem ersten Start fragen, ob es die Datei ioncube loader Datei in den Papierkorb legen soll. Wählen Sie hier „Abbrechen“
  • Freigabe unter Sicherheit
  • Öffnen Sie die Konfiguration von macOS im Bereich Sicherheit
  • Erlauben Sie den ioncube loader
  • Öffnen Sie die Konfiguration von macOS im Bereich Sicherheit und erlauben Sie den ioncube loader
  • Starten Sie den Server neu
    • sudo brew services restart httpd
  • Und noch einmal auf „Öffnen“ klicken

V. Apache neu starten

Um den Apache neu zu starten, öffnen Sie das „Terminal“ und geben Sie folgendes ein: 

sudo brew services restart httpd

Der erste Start kann wie folgt erfolgen: 

sudo brew services start httpd

VI. Apache Seite öffnen

:righty: Der Zugriff erfolgt über Port 8080. Am Server: http://localhost:8080

VII. Herunterladen

Die aktuelle Version von untermStrich für PHP7.2 finden Sie unter: https://webservices.untermstrich.com/update/

Entpacken Sie die ustrich.4.zip nach /opt/homebrew/var/www und stellen Sie sicher, dass das Verzeichnis ustrich benannt wird.

Setzen Sie die Rechte chmod a+rx /opt/homebrew/var/www/ustrich

:righty: Der Zugriff erfolgt über Port 8080. Am Server: http://localhost:8080/ustrich/

ⓘ Update von macOS

:righty: Informationen zum Update von macOS (Von 10.13 auf 10.15 etwa)
Führen Sie unbedingt vor dem Update von macOS das Update auf X3 oder gleich X4 durch!



.