Installieren, damals und heute: die Dateien, die Datenbank, der virtuelle Host
Kapitel 1 des Buchs Learning eZ Publish beginnt mit der Arbeit, die jede Installation braucht: die Dateien besorgen, eine Datenbank anlegen, den Webserver auf die Dateien zeigen lassen, die Bildkonvertierung und eine regelmäßige Aufgabe einrichten und lernen, wo die Einstellungen liegen. Die Schritte gibt es noch. Die meisten sind heute ein einziger Befehl. Diese Seite folgt der Reihenfolge des Buchs und sagt, was Sie heute tun.
Warnung
.htaccessbremst jede Anfrage. Sind.htaccess-Dateien erlaubt (AllowOverridealles außerNone), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten:AllowOverride Noneim virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auchstaticcache_offload.conf), setzen SieAllowOverride None, führen Sieapachectl configtestaus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.
Die Installation entpacken
Das Buch lud ein Archiv von etwa 4 MB herunter, entpackte es auf etwa 20 MB und übertrug die Ordner auf den Webserver. Exponential bietet drei Wege zu denselben Dateien (siehe Erste Schritte):
- einen Git-Klon des Kernels, mit den Erweiterungen als Klone (der Weg, eine Website zu bauen, die Sie pflegen),
composer create-project se7enxweb/exponential,- und, für einzelne Zusätze später, Pakete, die mit
ezpminstalliert werden.
Nach jedem der ersten beiden Wege sind alle Ordner da, die das Buch aufgezählt hat:
| Buch | Exponential 6 |
|---|---|
design | design/: die Standard-Templates und -Stile. Ihre eigenen gehören in den Ordner design/ einer Erweiterung, nicht hierher. |
index.php | index.php: Jede Seitenanfrage kommt weiterhin hier herein. |
kernel, lib | kernel/, lib/: der Code. Bearbeiten Sie ihn nicht; siehe Kernel-Overrides, das letzte Mittel. |
runcronjobs.php | runcronjobs.php: weiterhin das Skript, das eine regelmäßige Aufgabe ausführt (Cronjobs). |
settings | settings/: Standardwerte, dazu override/ und siteaccess/ für Ihre eigenen. |
var | var/: hochgeladene Dateien, Caches und Protokolle. Der Benutzer des Webservers muss hier schreiben können. |
Neu in Exponential: extension/ (Zusätze), console (die Kommandozeilenoberfläche, ./console list) und vendor/
(Composer-Pakete).
Die Datenbank initialisieren
Das Buch legte eine MySQL-Datenbank und einen Benutzer an, der nur diese Datenbank verwenden darf, mit CREATE DATABASE
und GRANT ALL PRIVILEGES, und empfahl diesen Benutzer statt eines mächtigen, weil das Passwort im Klartext in einer
Einstellungsdatei steht. Dieser Rat gilt unverändert. Neu sind zwei Dinge:
- Für den Anfang brauchen Sie keinen Datenbankserver: Standard ist SQLite in einer Datei. MySQL oder MariaDB,
PostgreSQL, MongoDB und Oracle sind Optionen von
exp:install --db=und des Setup-Assistenten (Datenbanken). - In
GRANTakzeptieren MySQL 8 und MariaDB keinIDENTIFIED BYmehr; legen Sie den Benutzer zuerst mitCREATE USERan, dannGRANT. Das Installationsbuch zeigt die Anweisungen.
Der virtuelle Host und das Umschreiben
Das Buch erklärt, warum ein virtueller Host mit mod_rewrite die richtige Einrichtung ist: Alle Anfragen gehen an
index.php, URLs wie /node/view/253 werden zu lesbaren Adressen wie /contact, und nur dieses eine Skript ist
erreichbar. Die beiden Rewrite-Zeilen des Buchs (alles, was kein Skript, Bild oder Stil ist, geht an index.php) sind
das, was die mitgelieferte .htaccess heute tut, in längerer und sichererer Form. Verwenden Sie unter Apache die
mitgelieferte .htaccess oder übernehmen Sie ihre Regeln in die Konfiguration des Hosts. Um eine Website ganz ohne
Webserver auszuprobieren, bringt Exponential einen eigenen mit, Velocity
(Die Website ausliefern).
Die Website in einem Unterordner zu betreiben, was das Buch erlaubt, wird nicht mehr empfohlen: Die Logik der Siteaccesses und URL-Aliase ist für eine Website im Wurzelverzeichnis eines Hostnamens gebaut.
Bildeinstellungen: ImageMagick und GD
Bilder werden auf dem Server konvertiert: Aus dem Original, das Sie hochladen, werden die Größen, die Ihre Templates
anfordern (die Bild-Aliase). Das Buch nennt zwei Konverter, ImageMagick (ein eigenes Programm, das leistungsfähigere)
und GD (eine Bibliothek in PHP, eine Ausweichlösung). Beide gibt es noch, in settings/image.ini. Der Unterschied
heute: GD steht an erster Stelle der Liste (es arbeitet innerhalb von PHP und startet kein Programm), und ImageMagick
ist die Ausweichlösung für Formate, die GD nicht lesen kann, etwa TIFF oder PDF, und für Filter, die nur es hat. Um
wieder ImageMagick zu bevorzugen, überschreiben Sie die Liste in settings/override/image.ini.append.php:
[ImageConverterSettings]
ImageConverters[]
ImageConverters[]=ImageMagick
ImageConverters[]=GDDer alte Hinweis des Buchs zu GD vor Version 2 (schlechte Skalierung) ist Geschichte: Jedes GD in einem PHP, auf dem
Exponential läuft, hat Version 2 oder höher. Der Setup-Assistent schaltet ImageMagick von selbst ab, wenn er kein
Programm convert findet.
Cronjobs
Das Buch verlangt eine Aufgabe alle 15 Minuten, die runcronjobs.php ausführt, für Workflows, Benachrichtigungen und
andere regelmäßige Arbeit. Das gilt auch heute. Die Zeile des Buchs übergab PHP die Option -C; sie wird nicht
gebraucht, und die Optionen, auf die es ankommt, sind -q (still) und -s <siteaccess>. Die Cron-Tabelle in
Nach der Installation, 10.3 ist die aktuelle, mit einer eigenen
Zeile für jeden Teil (frequent, der Standard, infrequent, cache_cleanup). Ohne die Aufgabe funktioniert die
Website, aber Workflows, die auf die Aufgabe warten, und Benachrichtigungen per E-Mail nicht.
Konfigurationsdateien
Die Erklärung des Buchs stimmt noch genau: Einstellungen liegen in .ini-Dateien; die Standardwerte stehen in
settings/; die Ordner settings/siteaccess/<name>/ und settings/override/ ändern sie; die Reihenfolge ist
Override, dann Siteaccess, dann die Standardwerte (der erste gefundene Wert einer Einstellung gewinnt, von oben).
Extensions bringen Schichten hinzu, die das Beispiel des Buchs nicht brauchte: Eine aktive Extension in
ActiveExtensions[] liegt zwischen Override und Siteaccess, ihr Wert schlägt also den des Siteaccess
(Konfigurieren, Abschnitt 2).
Die Dateien, die ein Builder am häufigsten anfasst, sind wie im Buch: site.ini, override.ini, image.ini und
i18n.ini für Sprachen. Der Dateiname sollte auf .ini.append.php enden. Der Grund, den das Buch nennt, ist immer
noch der Grund: Würde ein Webserver die Datei jemals ausliefern, liefe sie als PHP, und die Einstellungen stehen als
PHP-Kommentare darin, sodass nichts angezeigt wird.
Was sich geändert hat: Sie müssen diese Dateien selten von Hand bearbeiten. ./console exp:ini ändert eine Einstellung
mit einer Sicherung und zeigt den Unterschied (Einstellungen mit exp:ini ändern),
und die Administration hat eine Einstellungsseite (Einstellungen in der Administration).
Die Einzelheiten der Reihenfolge stehen in Geltungsbereiche von Einstellungen und ihre Reihenfolge.
Weiter
Der Setup-Assistent, damals und heute.
Quelle und Lizenz
Bearbeitet nach Kapitel 1, „Installing eZ publish“, von Learning eZ publish: Building Content Management Solutions von Paul Borgermans, Tony Wood, Paul Forsyth, Martin Bauer, Björn Dieding und Ben Pirt (zusätzliches Material von Bruce Morrison), zweite Auflage, 2024, Book-Learning-eZPublish. Copyright (c) 2004-2024 7x und Graham Brookins. Lizenziert unter der GNU Free Documentation License, Version 1.3 oder einer späteren Version, ohne unveränderliche Abschnitte, ohne vordere und ohne hintere Umschlagtexte (die Lizenz). Änderungen: gekürzt und umgestellt; jeder Schritt, jeder Pfad und jede Einstellung gegen Exponential 6 geprüft und aktualisiert; das Produkt heißt Exponential.