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

<WRAP center round alert 50%>
Installation nur mit untermStrich X4 14.3 oder neuer!
</WRAP>

^ **:!: 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/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 - 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>

==== Test ====
  - Starten Sie den Server neu
    * <code bash>
sudo brew services restart httpd
</code>
  - :righty: Der Zugriff erfolgt über **Port 8080**. Am Server: [[http://localhost:8080|http://localhost:8080]]

==== III. httpd.conf ====
  -  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:
      * {{: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 /opt/homebrew/opt/php@8.1/lib/httpd/modules/libphp.so
 
<FilesMatch \.php$>
  SetHandler application/x-httpd-php
</FilesMatch>
</code>


  - AllowOverride aktivieren
    * In **<Directory** ''"/opt/homebrew/var/www"'' 
    * Dazu ''None'' gegen ''All'' ersetzen:
      * {{:de:installation:mac14_web3.png?500|}}
  - Starten Sie den Server neu
    * <code bash>
sudo brew services restart httpd
</code>
===== IV. ionCube Loader in php.ini =====

  - [[https://downloads.ioncube.com/loader_downloads/ioncube_loaders_dar_arm64.zip|ionCube Loader herunterladen]] 
  - Entpacken Sie die Datei. 
    * Sie sollte nun unter ''/Users/IHR_BENUTZERNAME/Downloads/ioncube'' liegen.
  - Kopieren Sie das Verzeichnis ''ioncube'' nach ''/opt/homebrew/opt/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 /opt/homebrew/opt/php@8.1/ ein.
    - Fügen Sie ioncube ein. Sie sollten nun das Verzeichnis /opt/homebrew/opt/php@8.1/ioncube haben.
  - Editieren Sie nun die ''/opt/homebrew/etc/php/8.1/php.ini'':
    * Diese Datei /opt/homebrew/etc/php/8.1/php.ini muss existieren.
    * <code ini>[PHP]
zend_extension = /opt/homebrew/opt/php@8.1/ioncube/ioncube_loader_dar_8.1.so
</code>
    * Bitte in der Datei finden und anpassen:<code ini>
upload_max_filesize = 50M 
post_max_size = 55M
</code>
  - Starten Sie den Server neu
    * <code bash>
sudo brew services restart httpd
</code>

==== 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"**
    * {{:de:installation:mac_bigusr0.png?300|}}
  * Freigabe unter Sicherheit

<WRAP group>
<WRAP half column>
    * Ö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?400|}}
</WRAP>
<WRAP half column>
    * Öffnen Sie die Konfiguration von macOS im Bereich Sicherheit und erlauben Sie den ioncube loader
      * {{:de:installation:mac_bigusr10.png?400|}}
</WRAP>
</WRAP>


  * 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|}}

===== V. 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>

===== VI. Apache Seite öffnen =====
:righty: Der Zugriff erfolgt über **Port 8080**. Am Server: [[http://localhost:8080|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/|http://localhost:8080/ustrich/]]


>
===== ⓘ Update von macOS =====
| :righty: [[de:installation:mac_update|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! |


\\
\\
.
\\
\\