====== Konfiguration von macOS - Intel mit PHP 8.1 (Als Server) ======


^ **:!: 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 Intel CPUs. ^
| Die alte macOS Server Software ist für diese Anleitung nicht notwendig oder sinnvoll. |


===== I. Homebrew installieren =====
Siehe [[https://brew.sh/index_de|https://brew.sh]]. Typischerweise:
<code bash>
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
</code>
<wrap round important 60%>
Niemals als root oder mittels ''sudo'' starten!
</wrap>
<wrap right round info 80%>
Je nach Netzwerkverbindung kann dieser Vorgang zwischen ein paar Minuten und ein paar Stunden benötigen!
</wrap>

==== Optional - System Apache deaktivieren ====
<wrap round help>Optional</wrap> Wenn Sie den bestehenden Apache Webserver des macOS 10.14 Grundsystems nicht benötigen, können Sie diesen über den folgenden Weg deaktivieren:
<code bash>
sudo apachectl stop
sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist 2>/dev/null
</code>
<wrap center round help 60%>
Bei der Eingabe des Kennworts wird dieses nicht dargestellt!
</wrap>

==== Optional - Version und brew Installation prüfen  ====
<wrap round help>Optional</wrap> 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.
<code bash>
brew --version
brew doctor
</code>
<wrap round important 60%>
Niemals als root oder mittels ''sudo'' starten!
</wrap>

===== II. Webserver & PHP installieren =====
<code>
brew install httpd
brew install php@8.1
</code>
<wrap round important 60%>
Niemals als root oder mittels ''sudo'' starten!
</wrap>

==== I. httpd.conf ====
  -  PHP 7, mod_expires und mod_rewrite aktivieren
    * Öffnen Sie die Datei ''/usr/local/etc/httpd/httpd.conf'' mit dem Texteditor.
    * Entfernen Sie nun 3x die ''#'' vor den Modulen:
      * {{:de:installation:mac14_web7_1.png?400|}}
      * {{:de:installation:mac14_web7_2.png?400|}}
      * {{:de:installation:mac14_web7_3.png?400|}}
    * Und fügen gleich danach die folgende Konfiguration ein:
      * <code ini>
LoadModule php_module /usr/local/opt/php@8.1/lib/httpd/modules/libphp.so

<FilesMatch \.php$>
  SetHandler application/x-httpd-php
</FilesMatch>
</code>
  - AllowOverride aktivieren
    * Dazu ''None'' gegen ''All'' ersetzen:
      * {{:de:installation:mac14_web3.png?500|}}
  - Starten Sie den Server neu
    * <code bash>
sudo brew services restart httpd
</code>
===== III. ionCube Loader in php.ini =====

  - [[https://downloads.ioncube.com/loader_downloads/ioncube_loaders_mac_x86-64.tar.gz|ionCube Loader herunterladen]] 
  - Entpacken Sie die Datei. 
    * Sie sollte nun unter ''/Users/IHR_BENUTZERNAME/Downloads/ioncube'' liegen.
  - Kopieren Sie das Verzeichnis ''ioncube'' nach ''/usr/local/etc/php/8.1/''
    - Kopieren Sie dazu das Verzeichnis ioncube.
    - Gehen Sie in den Finder und wählen Sie im Menü "Gehe zu" > "Gehe zu Ordner":
      * {{:de:installation:mac_goto.png?250|}}
    - Geben sie /usr/local/etc/php/8.1/ ein.
    - Fügen Sie ioncube ein. Sie sollten nun das Verzeichnis /usr/local/etc/php/8.1/ioncube haben.
  - Editieren Sie nun die ''/usr/local/etc/php/8.1/php.ini'':
    * Diese Datei /usr/local/etc/php/8.1/php.ini muss existieren.
    * <code ini>[PHP]
zend_extension = /usr/local/etc/php/8.1/ioncube/ioncube_loader_mac_8.1.so
</code>

==== ioncube erlauben ====
  * 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"**
    * {{:de:installation:mac_bigusr0.png?300|}}
  * Freigabe unter Sicherheit
    * Öffnen Sie die Konfiguration von macOS im Bereich Sicherheit
      * {{:de:installation:mac_bigusr1.png?250|}}
    * Erlauben Sie den ioncube loader
      * {{:de:installation:mac_bigusr2.png?430|}}
  * Starten Sie den Server neu
    * <code bash>
sudo brew services restart httpd
</code>
  * Und noch einmal auf "Öffnen" klicken
    * {{:de:installation:mac_bigusr3.png?300|}}


===== IV. Apache neu starten =====

Um den Apache neu zu starten, öffnen Sie das "Terminal" und geben Sie folgendes ein:
<code bash>
sudo brew services restart httpd
</code>

Der erste Start kann wie folgt erfolgen:
<code bash>
sudo brew services start httpd
</code>

===== V. Apache Seite öffnen =====
:righty: Der Zugriff erfolgt über **Port 8080**. Am Server: [[http://localhost:8080|http://localhost:8080]]

===== VI. Herunterladen =====
Die aktuelle Version von **untermStrich für PHP 8.1** finden Sie unter: https://webservices.untermstrich.com/update/

Entpacken Sie die ''ustrich.4_php81.zip'' nach ''/usr/local/var/www/ustrich/''

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


>
===== ⓘ Update von macOS =====
| :righty: [[de:installation:mac_update|Informationen zum Update von macOS (Von 10.14 auf 10.15 oder 11.3 auf 11.4 etwa)]] |
| Führen Sie **unbedingt vor dem Update von macOS** das Update auf X3 oder gleich X4 durch! |


\\
\\
.
\\
\\