====== Konfiguration von macOS – ab M1 mit PHP 8.5 (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 Nichtbenutzung dieser Anleitung entstehen. * **ACHTEN SIE AUF DIE SICHERHEIT IHRES SERVERS!** Apache, PHP und MySQL müssen wie auch untermStrich aktuell gehalten werden. Dies gilt besonders, wenn der Server im Internet erreichbar sein soll. Benötigt untermStrich ONE 15.2.4 für PHP 8.5 ===== Hinweis zum Start von Apache ===== Homebrew kann Apache als Benutzer-Dienst oder als Systemdienst verwalten: * **Benutzer-Dienst:** Befehle ''brew services ...'' ohne ''sudo''. Der Dienst startet beim Anmelden des Benutzers. * **Systemdienst:** Befehle ''sudo brew services ...''. Der Dienst startet beim Hochfahren des Macs, unabhängig von einer Anmeldung. :!: Diese Anleitung verwendet standardmäßig den **Benutzer-Dienst**. Starten Sie niemals beide Varianten gleichzeitig, da sie denselben Port (8080) belegen. Weitere Informationen: [[https://docs.brew.sh/Manpage|Homebrew-Dokumentation zu brew services]]. ===== I. Homebrew installieren ===== Homebrew installieren Sie laut der offiziellen Anleitung auf [[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 installieren Sie niemals als Root oder mit ''sudo''. Die Installation kann je nach Netzwerkverbindung einige Minuten dauern. Zur Kontrolle der Installation: brew --version brew doctor Die Meldungen von ''brew doctor'' sind nicht automatisch Fehler. Relevant sind nur Meldungen, die Ihre Installation betreffen. Bei Unklarheiten wenden Sie sich an Ihre Systembetreuung. ===== II. Webserver und PHP installieren ===== **Unbestätigt:** Die Homebrew-Formel ''php@8.5'' konnte zum Zeitpunkt der Erstellung nicht geprüft werden. Bitte vor der Installation prüfen, ob sie verfügbar ist. brew install httpd brew install php@8.5 brew link --force php@8.5 Führen Sie diese Befehle ohne ''sudo'' aus. ==== Apache starten und testen ==== Apache starten Sie als Benutzer-Dienst: brew services start httpd Ist Apache bereits als Benutzer-Dienst aktiv, starten Sie ihn neu: brew services restart httpd Der Zugriff erfolgt über **Port 8080**. Öffnen Sie dazu am Server: [[http://localhost:8080|http://localhost:8080]]. ===== III. httpd.conf konfigurieren ===== Öffnen Sie die Datei ''/opt/homebrew/etc/httpd/httpd.conf'' mit einem Texteditor. ==== 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 ==== Fügen Sie direkt nach den Modulzeilen folgende Konfiguration ein: LoadModule php_module /opt/homebrew/opt/php@8.5/lib/httpd/modules/libphp.so SetHandler application/x-httpd-php ==== AllowOverride aktivieren ==== Im Abschnitt '''' den Wert ''None'' durch ''All'' ersetzen. {{:de:installation:mac14_web3.png?500}} \\ * Nach Änderungen an der Apache-Konfiguration Apache neu starten: brew services restart httpd ===== IV. ionCube Loader einrichten ===== **Unbestätigt:** Ob für PHP 8.5 ein ionCube Loader zur Verfügung steht, ist nicht geprüft. Die folgenden Angaben gelten nur, wenn ein passender Loader vorhanden ist. * Laden Sie den ionCube Loader für macOS (ARM64) herunter: [[https://downloads.ioncube.com/loader_downloads/ioncube_loaders_mac_arm64.zip|ionCube Loader herunterladen]]. * Entpacken Sie die Datei. Das Verzeichnis ''ioncube'' kopieren Sie nach ''/opt/homebrew/opt/php@8.5/''. Anschließend muss ''/opt/homebrew/opt/php@8.5/ioncube'' vorhanden sein. * Bearbeiten Sie die Datei ''/opt/homebrew/etc/php/8.5/php.ini''. Die Datei muss existieren. * Tragen Sie unter dem Abschnitt ''[PHP]'' (direkt zu Beginn) folgende Zeile ein: zend_extension = /opt/homebrew/opt/php@8.5/ioncube/ioncube_loader_mac_8.5.so Passen Sie außerdem folgende Werte an: upload_max_filesize = 50M post_max_size = 55M Starten Sie Apache danach neu: 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 > Unterscheidet sich in der MacOS Version * :!: Die Meldung kann mehrmals erscheinen. {{:de:installation:mac_bigusr0.png?300}} * Die Freigabe in den Systemeinstellungen im Bereich „ Datenschutz & Sicherheit“ erlauben: {{:de:installation:mac_bigusr2.png?400}} * Starten Sie den Server erneut brew services restart httpd * Anschließend erneut auf „Öffnen“ oder „Dennoch öffnen“ klicken: {{:de:installation:mac_bigusr3.png?400}} {{: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 ==== 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 ===== 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]]. Entpacken Sie die Datei ''ustrich.4.zip'' nach ''/opt/homebrew/var/www''. Das Verzeichnis muss anschließend ''ustrich'' heißen. Setzen Sie die Rechte: 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]].