====== Konfiguration von macOS – ab M1 mit PHP 8.3 (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! | ^ ** :!: ACHTEN SIE AUF DIE SICHERHEIT IHRES SERVERS!! ** ^ | Apache, PHP, MySQL muss wie auch untermStrich aktuell gehalten werden. Dies gilt besonders, wenn der Server im Internet verfügbar sein soll. | ===== Hinweis zum Start von Apache ===== Homebrew kann Apache als Benutzer-Dienst oder als Systemdienst verwalten: * **Benutzer-Dienst:** Start mit ''brew services ...'' ohne ''sudo''. Der Dienst wird beim Anmelden des Benutzers gestartet. * **Systemdienst:** Start mit ''sudo brew services ...''. Der Dienst wird als Systemdienst eingerichtet und beim Hochfahren des Macs gestartet. Für diese Anleitung wird standardmäßig der **Benutzer-Dienst** verwendet. Root- und Benutzer-Dienst nicht gleichzeitig starten, da beide denselben Port belegen könnten. Weitere Informationen: [[https://docs.brew.sh/Manpage|Homebrew-Dokumentation zu brew services]]. ===== I. Homebrew installieren ===== Falls Probleme mit bereits installierten CommandLineTools auftreten, kann deren Entfernung erforderlich sein: sudo rm -rf /Library/Developer/CommandLineTools **Achtung:** Dieser Befehl löscht die CommandLineTools. Nur ausführen, wenn dies zur Fehlerbehebung tatsächlich erforderlich ist. Siehe [[https://brew.sh/index_de|brew.sh]]. Typischerweise erfolgt die Installation mit: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" Homebrew niemals als root oder mittels ''sudo'' installieren. Je nach Netzwerkverbindung kann die Installation einige Minuten dauern. ==== Version und Installation prüfen (optional) ==== brew --version brew doctor Homebrew niemals als root oder mittels ''sudo'' starten. Eventuelle Fehlermeldungen mit der Systembetreuung oder der Homebrew-Community klären. ===== II. Webserver und PHP installieren ===== brew install httpd brew install php@8.3 brew link --force php@8.3 Die Befehle ohne ''sudo'' ausführen. ==== Apache starten und testen ==== Apache erstmals als Benutzer-Dienst starten: brew services start httpd Wenn Apache bereits als Benutzer-Dienst läuft, neu starten: brew services restart httpd Der Zugriff erfolgt über **Port 8080**. Am Server öffnen: [[http://localhost:8080|http://localhost:8080]]. ===== III. httpd.conf konfigurieren ===== Die Datei ''/opt/homebrew/etc/httpd/httpd.conf'' mit einem Texteditor öffnen. ==== Apache-Module aktivieren ==== Die Kommentarzeichen ''#'' vor den folgenden drei Modulen entfernen (auskommentieren): LoadModule expires_module lib/httpd/modules/mod_expires.so {{:de:installation:mac14_web7_1.png?900}} LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so {{:de:installation:mac14_web7_2.png?900}} LoadModule env_module lib/httpd/modules/mod_env.so {{:de:installation:mac14_web7_3.png?900}} ==== PHP-Modul einfügen ==== Direkt nach den Modulzeilen folgende Konfiguration einfügen: LoadModule php_module /opt/homebrew/opt/php@8.3/lib/httpd/modules/libphp.so SetHandler application/x-httpd-php {{:de:installation:httpc.conf.png}} ==== AllowOverride aktivieren ==== Im Abschnitt '''' den Wert ''None'' durch ''All'' ersetzen. {{:de:installation:mac14_web3.png?500}} \\ * Nach Änderungen an der Apache-Konfiguration Apache als Benutzer-Dienst neu starten: brew services restart httpd ===== IV. ionCube Loader in php.ini einrichten ===== * [[https://downloads.ioncube.com/loader_downloads/ioncube_loaders_mac_arm64.zip|ionCube Loader herunterladen]]. * Die Datei entpacken. Das Verzeichnis ''ioncube'' sollte sich anschließend unter ''/Users/IHR_BENUTZERNAME/Downloads/ioncube'' befinden. * Das Verzeichnis ''ioncube'' nach ''/opt/homebrew/opt/php@8.3/'' kopieren. Anschließend sollte ''/opt/homebrew/opt/php@8.3/ioncube'' vorhanden sein. {{:de:installation:mac_goto.png?300}} * Die Datei ''/opt/homebrew/etc/php/8.3/php.ini'' bearbeiten. Diese Datei muss existieren. * Unter dem Abschnitt ''[PHP]'' folgende Zeile eintragen: zend_extension = /opt/homebrew/opt/php@8.3/ioncube/ioncube_loader_mac_8.3.so * In der Datei folgende Werte finden und anpassen: upload_max_filesize = 50M post_max_size = 55M Nach Änderungen an ''php.ini'' Apache als Benutzer-Dienst neu starten: brew services restart httpd ==== ionCube unter macOS freigeben ==== * Unter macOS kann beim ersten Start eine Meldung erscheinen, ob die ionCube-Datei in den Papierkorb gelegt werden soll. * **Abbrechen** oder **Fertig** wählen. * :!: Die Meldung kann mehrmals erscheinen. {{:de:installation:mac_bigusr0.png?300}} Die Freigabe in den Systemeinstellungen im Bereich „Sicherheit“ erlauben: {{:de:installation:mac_bigusr1.png?300}} {{:de:installation:mac_bigusr2.png?300}} * Starten Sie den Server erneut brew services restart httpd * Anschließend erneut auf „Öffnen“ klicken: {{:de:installation:mac_bigusr3.png?400}} Falls angezeigt, auf „Öffnen“ oder „Dennoch öffnen“ klicken: {{:de:installation:mac_bigusr3_2.png?400}} ===== V. Apache neu starten ===== brew services restart httpd Falls Apache noch nicht als Benutzer-Dienst eingerichtet ist: brew services start httpd A ==== V. Alternative: Apache als Systemdienst starten ==== :righty: Nur verwenden, wenn Apache bereits beim Hochfahren des Macs und unabhängig von einer Benutzeranmeldung verfügbar sein soll. Dies startet den Dienst im Root-Kontext: sudo brew services start httpd Einen bereits gestarteten Systemdienst neu starten: sudo brew services restart httpd Für diesen Systemdienst die Verwaltungsbefehle ebenfalls mit ''sudo'' ausführen. Nicht gleichzeitig zusätzlich den Benutzer-Dienst starten. ===== VI. Apache-Seite öffnen ===== Der Zugriff erfolgt über **Port 8080**. Am Server öffnen: [[http://localhost:8080|http://localhost:8080]]. ===== VII. untermStrich herunterladen und installieren ===== Die aktuelle Version von untermStrich finden Sie unter [[https://webservices.untermstrich.com/update/|untermStrich Updates]]. Die Datei ''ustrich.4.zip'' nach ''/opt/homebrew/var/www'' entpacken. Sicherstellen, dass das Verzeichnis ''ustrich'' heißt. Die Rechte setzen: chmod a+rx /opt/homebrew/var/www/ustrich Der Zugriff erfolgt über Port 8080: [[http://localhost:8080/ustrich/|http://localhost:8080/ustrich/]]. ===== macOS aktualisieren ===== [[de:installation:mac_update|macOS: Serverkomponenten aktualisieren und Störungen beheben]].