Demo-Modus: EXP_DEMO_MODE=1 für öffentliche Demonstrationsseiten (6.0.15)
Eine öffentliche Demo von Exponential veröffentlicht ihre Administrator-Anmeldung, damit Besucher die Administration ausprobieren können. Ohne Hilfe geht dann zweierlei schief:
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.
- Ein Besucher ändert das Administratorpasswort oder setzt es zurück, und der nächste Besucher kann sich nicht anmelden. Bei einer Demo, die alle paar Stunden neu gebaut wird, ist die Demo damit bis zum nächsten Neubau kaputt; bei einer, die nicht neu gebaut wird, für immer.
- Seit 6.0.15 lehnen die Installationsprogramme ein bekanntes Administratorpasswort ab (schwache Passwörter), sodass ein Demo-Installationsprogramm das Passwort, das es veröffentlicht, nicht installieren konnte und es nach der Installation zurücksetzen musste.
Der Demo-Modus löst beides. Er wird durch eine Umgebungsvariable eingeschaltet, nie durch eine Einstellung:
EXP_DEMO_MODE=1Er ist auf jeder Installation aus, die sie nicht setzt, also auf jeder Installation, die nicht absichtlich als Demo eingerichtet wurde. Dort ändert sich nichts.
Inhalt
- Was der Demo-Modus tut
- Wer als Administrator gilt
- Jeder geschlossene Weg
- Die Installationsprogramme akzeptieren das Demo-Passwort
- Warum er sich nicht versehentlich einschalten lässt
- Einschalten
- Banner und Protokoll
- Risiken
- Das Demo-Installationsprogramm auf dem Demo-Host
- Für Entwickler
- Kompatibilität
- Tests
- Wo der Demo-Modus sonst dokumentiert ist
Was der Demo-Modus tut
Solange EXP_DEMO_MODE=1 gilt:
- Das Passwort eines Administrators kann nicht geändert oder zurückgesetzt werden, auf keinem Weg: die Seite
Passwort ändern, das Formular Passwort vergessen? und seine Links, das Benutzerkonto im Bearbeitungsformular,
exp:resetuserpassword(auch mit--allow-root-user), die Webdienste und jeder andere Code, der einen Benutzer speichert (siehe Jeder geschlossene Weg). Jede Ablehnung sagt, übersetzt: „Diese Installation ist eine öffentliche Demo: Die Passwörter von Administratoren können nicht geändert oder zurückgesetzt werden.“ - Jedes andere Konto behält jede Regel: Ein Redakteur oder ein registrierter Besucher ändert sein eigenes Passwort wie gewohnt und setzt es zurück, und neue Passwörter werden weiterhin gegen die Liste bekannter Passwörter geprüft.
- Die Installationsprogramme akzeptieren das Demo-Passwort: ein bekanntes Administratorpasswort beliebiger Länge,
etwa
publishoderpublishing. Betroffen ist nur das Administratorpasswort einer neuen Installation; ein leeres wird weiterhin abgelehnt (Die Installationsprogramme akzeptieren das Demo-Passwort). - Die Administration zeigt auf jeder Seite ein Banner (admin4, admin4l und die klassische Administration): „Demo-Modus. Diese Installation ist eine öffentliche Demo: Jeder kann ihr Administratorpasswort kennen, und Administratorpasswörter können nicht geändert oder zurückgesetzt werden. Geben Sie hier nichts Privates ein.“
- Jeder Prozess verzeichnet einmal, dass der Demo-Modus eingeschaltet ist: eine Zeile in
var/log/security.logund das Audit-Ereignissystem.demo.mode(Banner und Protokoll).
Der Demo-Modus macht eine Installation nicht schreibgeschützt, setzt keine Inhalte zurück und schränkt nicht ein, was ein Administrator außer dem Passwort tun darf. Eine Demo, die rückgängig machen muss, was Besucher tun, wird nach Zeitplan neu gebaut (siehe Das Demo-Installationsprogramm auf dem Demo-Host).
Wer als Administrator gilt
Ein Konto gilt als Administrator, wenn seine Rollen ihm uneingeschränkten Zugriff auf jede Funktion jedes Moduls
geben: eine Richtlinie für alle Module und alle Funktionen ohne Einschränkung, wie sie die ausgelieferte Rolle
Administrator hat. Das umfasst das Konto admin, jedes Konto in Administrator users und jedes Konto, dem eine
solche Rolle direkt gegeben wurde.
Ein Konto, dessen Rollen sich nicht lesen lassen (ein Datenbankfehler), gilt bei eingeschaltetem Demo-Modus als
Administrator: Ein Fehler öffnet nie das Passwort eines Administrators. Die Prüfung ist
expDemoMode::isAdministrator().
Ein Konto mit weitem, aber eingeschränktem Zugriff (ein Redakteur, ein Administrator einer Sektion) ist nicht geschützt. Veröffentlicht eine Demo auch die Anmeldung eines solchen Kontos, geben Sie ihm eine Rolle, deren Übernahme sich nicht lohnt, oder bauen Sie die Demo oft neu.
Jeder geschlossene Weg
| Weg | Was im Demo-Modus geschieht | Code |
|---|---|---|
Passwort ändern (user/password), jedes Design | das Formular sagt, warum, und ändert nichts; in admin und admin4 zeigt die Seite den Grund, bevor etwas eingegeben wird | kernel/private/classes/views/user/password.php |
Passwort vergessen? (user/forgotpassword), die Anforderung | kein Schlüssel und keine E-Mail für einen Administrator; die Antwort ist dieselbe, die jede Adresse erhält, und die Seite sagt jedem Besucher, dass Administratorpasswörter nicht zurückgesetzt werden können, sodass das Formular nicht verrät, welche Adressen einem Administrator gehören | kernel/private/classes/views/user/forgotpassword.php |
| Passwort vergessen?, der Link | ein Link eines Administrators (verschickt, bevor der Modus eingeschaltet wurde) wird abgelehnt und entfernt | ebenda |
| Das Benutzerkonto in content/edit (auch das eigene Profil) | ein neues Passwort für einen Administrator ist ein Validierungsfehler mit dem Grund; die anderen Felder lassen sich weiterhin ändern | kernel/classes/datatypes/ezuser/ezusertype.php |
exp:resetuserpassword / bin/php/resetuserpassword.php | mit dem Grund und Exit-Code 1 abgelehnt, auch mit --allow-root-user | kernel/private/classes/commands/resetuserpassword.php |
Webdienste: expaccount.reset, expaccount.changePassword, expuser.setPassword | HTTP 403 mit dem Grund | extension/expservices/classes/users/expusersbase.php |
Webdienste: expaccount.forgotRequest | kein Schlüssel und keine E-Mail für einen Administrator; dieselbe Antwort wie für jede Adresse | extension/expservices/classes/users/expaccountservices.php |
Die Operationen user/password und user/forgotpassword (Workflows, Erweiterungen) | Status false mit dem Grund demo_mode | kernel/user/ezuseroperationcollection.php |
| Alles andere, was einen Benutzer speichert: ein Import aus CSV oder einem Paket, eine Erweiterung, ein Skript | eZUser::store() behält das gespeicherte Passwort eines Administrators und speichert alles andere; die Ablehnung wird verzeichnet | kernel/classes/datatypes/ezuser/ezuser.php, expDemoMode::guardStore() |
Jede Ablehnung wird im Audit-Protokoll als access.user.password.change.failed oder
access.user.password.reset.failed mit dem Grund demo_mode und dem Weg verzeichnet
(audit.md), und als Warnung in der Debug-Ausgabe.
Nicht betroffen: die Anmeldung (ein vorhandenes Passwort wird nie abgelehnt) und das Hash-Upgrade bei der Anmeldung
([UserSettings] UpdateHash), das dasselbe Passwort mit einem neueren Verfahren speichert.
Die Installationsprogramme akzeptieren das Demo-Passwort
Jedes Installationsprogramm fragt dieselben Funktionen, ob ein Administratorpasswort installiert werden darf:
eZStepSiteAdmin::isWeakDefaultPassword() (die Liste bekannter Passwörter) und
eZStepSiteAdmin::isTooShortAdminPassword() ([UserSettings] MinPasswordLength, im Auslieferungszustand 10). Das sind
der Setup-Assistent, der Kickstarter (kickstart.ini), exp:install (bin/php/install.php) und jedes darauf
aufgebaute Demo-Installationsprogramm. Im Demo-Modus akzeptieren beide das Demo-Passwort. Genau:
- Gelockert: die Prüfung gegen die Liste bekannter Passwörter (
expWeakPasswordList, mit ihren Varianten) und die Mindestlänge, nur für das Administratorpasswort einer neuen Installation. Die Installation speichert es innerhalb vonexpDemoMode::installing()undexpDemoMode::settingInstallationAdministratorPassword(); nur dort lässteZUser::validatePassword()ein Passwort durch, das kürzer alsMinPasswordLengthist. - Nicht gelockert: Ein leeres Passwort wird weiterhin abgelehnt (der Kickstarter und
exp:installerzeugen eines, der Assistent fragt erneut); jedes andere Konto, das die Installation anlegt, jedes nach der Installation gesetzte Passwort und jedes Formular (user/password, Registrierung, das Formular zur Benutzerbearbeitung, die Konsole, die Webdienste) behaltenMinPasswordLength, die Regeln aus[PasswordSettings]und die Liste bekannter Passwörter.
Eine Demo kann also publish (sieben Zeichen, der Klassiker) oder publishing unverändert installieren, mit den
ausgelieferten Einstellungen.
Der Setup-Assistent sagt auf seiner Seite für den Administrator, dass der Demo-Modus eingeschaltet ist und was das
bedeutet. Das Speichern des Administratorpassworts durch die Installation geht durch den Speicherschutz, weil es
innerhalb von expDemoMode::installing() läuft.
Warum er sich nicht versehentlich einschalten lässt
- Nur über die Umgebung. Es gibt dafür keine INI-Einstellung, keinen Anfrageparameter, kein Cookie und keine Seite
in der Administration. Eine von einer Demo kopierte Einstellungsdatei, eine daraus wiederhergestellte Datenbank, ein
Paket oder eine präparierte Anfrage können ihn nicht einschalten. Ein HTTP-Header kommt als
HTTP_EXP_DEMO_MODEan und wird nie gelesen. - Nur der exakte Wert
1.0,true,yes,on, ein leerer Wert und alles andere lassen ihn aus. - Bei jedem Aufruf gelesen. Nichts wird gecacht, sodass ein persistenter Worker (Exponential Velocity, FrankenPHP) für die Umgebung antwortet, die er gerade hat, und ein kompiliertes Template bei jeder Ausführung erneut fragt.
- Sichtbar. Das Banner auf jeder Seite der Administration, der Hinweis im Setup-Assistenten, die Warnung auf der
Konsole (
Demo mode is on (EXP_DEMO_MODE=1) ...auf der Standardfehlerausgabe) und die Log-Zeile jedes Prozesses.
Der Wert wird zuerst mit getenv() gelesen (die Umgebung des Prozesses; unter PHP-FPM auch die FastCGI-Parameter),
dann aus $_SERVER (Apache SetEnv mit mod_php und ähnlichen SAPIs). Ein Wert in der Umgebung des Prozesses gewinnt:
EXP_DEMO_MODE=0 dort hält den Modus aus, egal was $_SERVER sagt.
Einschalten
Setzen Sie die Variable für jeden Prozess der Demo: das PHP des Webservers, Exponential Velocity, wenn er die Website ausliefert, die Cronjobs und jeden Konsolenbefehl. Ein Prozess ohne sie läuft mit ausgeschaltetem Demo-Modus.
| Wo PHP läuft | Wie |
|---|---|
| PHP-FPM | im Pool der Demo: env[EXP_DEMO_MODE] = 1 (ein Pool mit clear_env = no übergibt auch die Umgebung des Masters) |
| Apache mit mod_php oder mit Weiterleitung an PHP-FPM | SetEnv EXP_DEMO_MODE 1 im virtuellen Host der Demo (mit PHP-FPM über mod_proxy_fcgi erreicht es PHP als FastCGI-Parameter) |
| Exponential Velocity | export EXP_DEMO_MODE=1 in den eigenen Site-envvars der Demo, /etc/vc/sites-available/<site>.envvars (<site> ist der Name, den ./console exp:velocity layout ausgibt). exp:velocity start liest die Datei nur für den Server dieser Installation, sodass Neustarts und Deploys aus jeder Shell sie behalten. Die Umgebung des Prozesses, der den Server dieser Installation startet, funktioniert ebenfalls (Environment=EXP_DEMO_MODE=1 in seiner eigenen systemd-Unit oder einem Drop-in). Nie /etc/vc/envvars: Der Server jeder Installation auf dem Host liest diese Datei, und ein Velocity-Worker lehnt einen Wert für den Demo-Modus ab, der von dort kommt (Velocity: nur eine Installation) |
| FrankenPHP, RoadRunner | in der Umgebung des Serverprozesses |
| Cronjobs und Konsolenbefehle | in der Crontab (EXP_DEMO_MODE=1 auf einer eigenen Zeile oben) und in der Shell dessen, der Befehle ausführt |
| Ein Container | ENV EXP_DEMO_MODE=1 im Demo-Image oder -e EXP_DEMO_MODE=1 / environment: nur für den Demo-Dienst |
Prüfen Sie es: Das Banner erscheint in der Administration, und grep 'demo/mode' var/log/security.log führt die
Prozesse auf, die damit gestartet sind.
Velocity und Neustarts. Setzen Sie die Variable in die Site-envvars der Demo, neben ihre Site-Datei:
# /etc/vc/sites-available/<site>.envvars (<site>: siehe ./console exp:velocity layout)
export EXP_DEMO_MODE=1exp:velocity start liest diese Datei bei jedem Start des Servers dieser Installation und übergibt, was sie setzt, nur
diesem Server, sodass exp:velocity restart und exp:velocity deploy den Demo-Modus eingeschaltet lassen, gleich
welche Shell sie ausführt. ./console exp:velocity layout führt die gesetzten Namen in der Zeile site envvars auf.
Eine Variable, die bereits in der Umgebung gesetzt ist, die den Server startet, wird von der Site-Datei überschrieben.
Um den Demo-Modus zu beenden, entfernen Sie die Zeile und starten Velocity neu. Die Datei wird gelesen, nie
ausgeführt, nach denselben Regeln wie envvars: ein NAME=value pro Zeile, und sie kann PATH, LD_*, DYLD_*,
MALLOC_*, HTTP_*, PHPRC, PHP_INI_SCAN_DIR, GLIBC_TUNABLES, HOME, USER und die anderen Variablen von Loader
und Shell nicht setzen (expVelocityConfigLayout::ENV_DENIED, dieselbe Liste wie die der Engine). Ein Neustart mit dem
eigenen qbixctl der Engine statt mit exp:velocity liest die Site-Datei nicht: Der Demo-Modus ist dann bis zum
nächsten exp:velocity restart ausgeschaltet (aus ist die sichere Richtung: Die Website funktioniert, nur könnten
Besucher das Passwort ändern).
Velocity: nur eine Installation
Die gemeinsame Datei /etc/vc/envvars (oder /etc/qbix/envvars) liest der Velocity-Server jeder Installation auf
dem Host, so wie jeder virtuelle Host /etc/apache2/envvars liest. Ein dort gesetzter Demo-Modus würde ihn auch für
Produktivsites einschalten, deren Administratoren dann kein Passwort mehr ändern könnten. Deshalb gilt seit diesem
Release:
exp:velocity startübergibtEXP_DEMO_MODEnie aus den gemeinsamen envvars (expVelocityConfigLayout::SITE_ONLY_ENV);- ein Velocity-Worker lehnt einen Wert ab, den die Engine selbst aus einer envvars-Datei eines Konfigurationsverzeichnisses
außerhalb der Installation exportiert hat (
expDemoMode::isSharedEnvvarsValue(), das den eigenen EintragQ_WebServer_Layout::$exportedder Engine und die von ihr gelesenen Verzeichnisse auswertet). Der Demo-Modus bleibt ausgeschaltet, und der Worker verzeichnet einmal pro Prozess invar/log/security.logund als Debug-Warnung:demo/refused pid=... EXP_DEMO_MODE=1 came from an envvars file other installations share ...; - ein Konfigurationsbaum innerhalb der Installation (
var/vc/qbix/etc, von einem Konto ohne root verwendet) gehört allein dieser Installation, und seine envvars werden wie bisher übernommen.
Eine Installation, die mit einem früheren Release über /etc/vc/envvars mit eingeschaltetem Demo-Modus gestartet
wurde, hat ihn nach dem Neustart des Updates ausgeschaltet, bis die Zeile in die Site-envvars verschoben ist.
Verschieben Sie sie vor dem Neustart: grep EXP_DEMO_MODE /etc/vc/envvars, dann tragen Sie sie nur in
/etc/vc/sites-available/<site>.envvars der Demo ein und entfernen sie aus der gemeinsamen Datei.
PHP-FPM, Apache, LiteSpeed, FrankenPHP und die Konsole sind nicht betroffen: Jeder Pool, jeder virtuelle Host und jeder Prozess hat bereits seine eigene Umgebung.
Nie auf einer Website, die keine Demo ist. Eine Site-envvars-Datei gehört zu einer Installation; kopieren Sie die einer Demo nie auf eine andere Website.
Setzen Sie sie nie in einem gemeinsam genutzten PHP-FPM-Pool, einem serverweiten SetEnv, einem globalen
/etc/environment, einem Basis-Image für Container oder einer Deploy-Vorlage, die für andere Websites verwendet wird.
Banner und Protokoll
Banner:
design/admin4/templates/parts/exp_demo_mode_banner.tpl(admin4, und admin4l über seinen Rückfall) und dieselbe Datei indesign/admin(die klassische Administration, und admin3 über seinen Rückfall). admin4 zeichnet es oben im Hauptbereich (page_mainarea.tpl, unter dem festen Kopf), admin4l außerdem vor der Hauptzone eines Admin-Layouts, admin3 als eigenes Design oben in seinem eigenen Hauptbereich (design/admin3/templates/page_mainarea.tpl), die klassische Administration unter ihrem Kopf; immer außerhalb der Cache-Blöcke, sodass es der Umgebung jeder Anfrage folgt. Es verwendet die gemeinsame Komponente.a4-notice.is-warnauscomponents.css(Tokens mit hellen und dunklen Werten; kein eigenes CSS). Der Template-Operatorexp_demo_mode()gibt zurück, ob der Modus eingeschaltet ist; ein eigenes Design kann das Banner mit{include uri='design:parts/exp_demo_mode_banner.tpl'}anzeigen.Protokoll: Zu Beginn der ersten Webanfrage (
ezpKernelWeb::requestInit()) und jedes Skripts (eZScript::initialize()) schreibt jeder Prozess eine Zeile invar/log/security.log, im Format der Zeilen des Anfrage-Klassifizierers, sodass Setup > Logdateien sie alsdemo/modegruppiert:[ Oct 19 2026 18:00:00 ] [203.0.x.x] demo/mode on pid=4711 sapi=fpm-fcgi EXP_DEMO_MODE=1: administrator passwords cannot be changed or reset, the installers accept a well-known administrator password; never use it in productionund verzeichnet das Audit-Ereignis
system.demo.mode(Schweregrad warning, Kanal system, immer eingeschaltet). Ein geforkter Worker hat seine eigene PID und verzeichnet es erneut; ein persistenter Worker verzeichnet es einmal. Ein Webprozess, der jede Anfrage neu beginnt (PHP-FPM, mod_php, LiteSpeed, der eingebaute Server von PHP), legt je Prozess eine leere Markierungsdatei im Cache-Verzeichnis an (<cache>/demo-mode/<pid>-<start time>) und verzeichnet es so ebenfalls einmal statt bei jeder Anfrage; nach dem Leeren der Caches verzeichnen die laufenden Prozesse es erneut. Ein Konsolenbefehl meldet außerdemDemo mode is on (EXP_DEMO_MODE=1) ...auf der Standardfehlerausgabe.
Auf einer Produktivsite bedeutet ein Ereignis system.demo.mode oder eine Zeile demo/mode, dass die Variable einen
Prozess erreicht hat, den sie nicht hätte erreichen dürfen: Entfernen Sie sie sofort und prüfen Sie, wer die Umgebung
des Servers geändert hat.
Risiken
- Der Demo-Modus sagt allen, dass das Administratorpasswort bekannt ist. Betreiben Sie ihn nur auf einer Installation, deren Inhalte, Benutzer und Einstellungen alle wegwerfbar sind: keine echten Kundendaten, keine echten E-Mail-Adressen, keine Geheimnisse in Einstellungen, keine Verbindung zu anderen Systemen.
- Administratoren behalten jede andere Befugnis. Ein als Administrator angemeldeter Besucher kann Konten anlegen, Rollen ändern, Einstellungen in der Administration bearbeiten, Pakete installieren und Dateien hochladen. Der Demo-Modus schränkt das nicht ein. Bauen Sie die Demo nach Zeitplan neu, halten Sie sie auf einem eigenen Host oder Konto und geben Sie ihr keine Zugangsdaten, die anderswo funktionieren.
- Ein bekanntes Passwort wird installiert. Das ist der Zweck und der Grund, warum der Modus nie eine echte Website erreichen darf.
- E-Mail. Besucher können E-Mails auslösen (Registrierung, Benachrichtigungen). Senden Sie die E-Mails der Demo in eine Datei oder eine Senke, nie an echte Adressen.
- Eine verlorene Variable schaltet ihn stillschweigend aus. Ein Neustart ohne die Variable betreibt die Demo mit ausgeschaltetem Demo-Modus: Besucher können das Administratorpasswort dann wieder ändern. Setzen Sie sie dort, wo sie Neustarts überdauert, und achten Sie auf das Banner.
- Nur Administratoren sind geschützt. Andere veröffentlichte Anmeldungen (Redakteur, Mitglied) kann weiterhin ändern, wer sie verwendet.
- Eine gemeinsame Umgebung erreicht jede Website darin. Ein serverweites
SetEnv, ein gemeinsam genutzter PHP-FPM-Pool,/etc/environment, ein Basis-Image für Container oder die Shell eines Betreibers, der die Variable exportiert hat, schaltet den Demo-Modus für jede Installation ein, die diese Umgebung erreicht; deren Administratoren können dann ein kompromittiertes Passwort nicht mehr ändern. Für Velocity lehnt der Kernel die gemeinsame/etc/vc/envvarsselbst ab (Velocity: nur eine Installation); für die anderen setzen Sie sie nur pro Installation. Führen Sieexp:velocity start,exp:installoder den Kickstarter für eine andere Website nie aus einer Shell aus, die die Variable hat.
Das Demo-Installationsprogramm auf dem Demo-Host
Die öffentliche Demo wird alle zwei Stunden aus dem aktuellen Code neu gebaut, von einem Skript, das exp:install mit
SQLite ausführt und die neue Website einwechselt. Mit dem Demo-Modus sollte es die Variable zweimal setzen:
Für die Installation, sodass
exp:installdas veröffentlichte Demo-Passwort unverändert installiert, statt es durch ein zufälliges zu ersetzen und danach zurückzusetzen:EXP_DEMO_MODE=1 php bin/php/install.php --apply --db=sqlite --password='<the published demo password>' ...Der Schritt zum Zurücksetzen nach der Installation (
exp:resetuserpassword) wird dann nicht mehr gebraucht und im Demo-Modus ohnehin abgelehnt. Jedes nicht leere Passwort funktioniert, auch das siebenstelligepublish.Für die laufende Website, in der Umgebung des PHP der Demo (ihr PHP-FPM-Pool, die Umgebung von
lsphpunter LiteSpeed oder dasSetEnvdes virtuellen Hosts) und in der Crontab des Benutzers der Demo, sodass das Banner erscheint und das Administratorpasswort zwischen zwei Neubauten nicht geändert werden kann. Der Preloader, der nach dem Einwechseln läuft (bin/php/preload.php), braucht keine Variable.
Die Variable gehört nur zum eigenen Benutzer und virtuellen Host der Demo. Das Skript darf sie nicht in config.php,
settings/ oder irgendetwas anderes schreiben, das auf andere Websites kopiert wird.
So läuft die immer aktuelle Demo des Projekts seit dem 19. Oktober 2026, unter LiteSpeed mit lsphp: Ihr Build-Skript
exportiert EXP_DEMO_MODE=1 für jeden Schritt, exp:install übernimmt das veröffentlichte Passwort wie angegeben, ein
generiertes Passwort lässt den Build fehlschlagen (der alte Schritt zum Zurücksetzen ist entfernt), und die
.htaccess jedes Builds erhält SetEnv EXP_DEMO_MODE 1; security.log zeigt demo/mode on ... sapi=litespeed, und
die Seiten zur Anmeldung und für vergessene Passwörter zeigen den Hinweis. Die allgemeine Form:
Rezept: eine öffentliche Demo unter LiteSpeed und Plesk betreiben
und install-demo-sqlite.sh.
Für Entwickler
expDemoMode::enabled(): Der Modus ist eingeschaltet (EXP_DEMO_MODEist genau1); bei jedem Aufruf gelesen.expDemoMode::protectsPassword( $user ): Der Modus ist eingeschaltet, und das Konto (eineZUseroder eine ID eines Inhaltsobjekts) ist ein Administrator. Fragen Sie es, bevor Sie ein Passwort ändern, und zeigen SieexpDemoMode::refusalText().expDemoMode::refused( $user, $path, $event ): verzeichnet eine Ablehnung (Audit-Protokoll und Debug-Ausgabe).expDemoMode::installing( $callable ): führt die Arbeit eines Installationsprogramms aus, die das Administratorpasswort setzt; der Speicherschutz lässt sie durch. Der Geltungsbereich endet mit dem Aufruf, auch bei einer Ausnahme. Ein eigenes Installationsprogramm, das das Administratorpasswort nach den Schritten des Kernels setzt, muss es verwenden, sonst wird seine Änderung im Demo-Modus abgelehnt.expDemoMode::guardStore( $user ): voneZUser::store()aufgerufen; behält das gespeicherte Passwort eines Administrators, solange der Modus eingeschaltet ist. Code, derezuser.password_hashmit eigenem SQL schreibt, umgeht das: Tun Sie das nicht.- Der Template-Operator
exp_demo_mode()(expDemoModeOperator). - Prüfen Sie den Modus mit
class_exists( 'expDemoMode' ) && expDemoMode::enabled()in Code, der in einem persistenten Worker laufen kann, der gestartet wurde, bevor die Klasse existierte.
Kompatibilität
- Ohne
EXP_DEMO_MODE=1ändert sich nichts: keine Einstellung, keine Datenbankänderung, kein neuer Standard. - Neue Klassen:
expDemoMode(kernel/classes/expdemomode.php),expDemoModeOperator(kernel/common/expdemomodeoperator.php); erzeugen Sie die Autoloads des Kernels neu, wenn Sie durch Kopieren von Dateien aktualisieren. Exponential Velocity lädt Klassen beim Start: Führen Sie nach dem Updateexp:velocity deploy --kernelaus (oder starten Sie es neu). - Neues Audit-Ereignis
system.demo.mode; die vorhandenen Ereignisseaccess.user.password.change.failedundaccess.user.password.reset.failedkönnen den Grunddemo_modehaben. - Neue Template-Variablen (alle optional, sodass ein älteres Design weiterhin rendert):
demo_mode_lockedunddemo_mode_textinuser/password.tpl,demo_mode_textunddemo_mode_refusedinuser/forgotpassword.tpl,demo_modeinsetup/init/site_admin.tpl. - Die Operationen
user/passwordunduser/forgotpasswordkönnenstatus => falsemitreason => demo_modezurückgeben. - Die Webdienste können für eine Änderung oder ein Zurücksetzen des Passworts eines Administrators mit HTTP 403 antworten.
- Exponential Velocity:
EXP_DEMO_MODEin der gemeinsamen/etc/vc/envvarsschaltet den Demo-Modus nicht mehr ein (früher galt das für jede Installation auf dem Host); verwenden Sie die Site-envvars/etc/vc/sites-available/<site>.envvars, dieexp:velocity startliest, oder die Umgebung, die den Server dieser Installation startet.exp:velocity layoutzeigt die Zeilesite envvars. - Neues Template
design/admin3/templates/page_mainarea.tpl(das Banner für admin3 als eigenes Design): Leeren Sie nach einem Update durch Kopieren von Dateien den Cache der Template-Overrides.
Tests
tests/tests/kernel/classes/user/expDemoModeTest.php(ohne Datenbank): die Regeln für den Wert, getenv vor$_SERVERund nie die Anfrage, kein Caching, wer Administrator ist, die Entscheidung des Speicherschutzes, der Geltungsbereich voninstalling(), die Lockerung der Installationsprogramme und ihre Grenzen, die Aufzeichnung einmal pro Prozess, der Template-Operator, das Banner (ein Teil-Template, gemeinsame Komponente, kein Inline-CSS, außerhalb jedes Cache-Blocks der drei Pagelayouts), jeder Weg zum Passwort, der Audit-Katalog und die Kataloge.expAuditRecordTestzählt das neue Audit-Ereignis.
Wo der Demo-Modus sonst dokumentiert ist
Jede Seite unten sagt, was sie über den Demo-Modus sagen muss, und verlinkt hierher zurück.
- Für jede Zielgruppe: Demo-Modus (Administratoren), FAQ zum Demo-Modus, Demo-Modus für Hoster, Demo-Modus für Entwickler.
- Rezepte und Fehlerbehebung: Rezept: eine öffentliche Demo unter LiteSpeed und Plesk betreiben,
Runbook: Probleme mit dem Demo-Modus,
Beispiele zum Demo-Modus (
.htaccess, virtueller Host, PHP-FPM-Pool, nginx, systemd-Drop-in, Crontab, Container-Umgebung, ein Skript für den Neubau), Umgebungsvariablen. - Installation: der Überblick, der Index der Kapitel, 2 Anforderungen, 4 Eine Installationsmethode wählen, 5 Setup-Assistent, 6 Kickstarter, 7 exp:install, 8 Die Website ausliefern, 9 Datenbanken, 10 Nach der Installation, 11 Aktualisieren, 12 Fehlerbehebung, 13 Sicherheitshärtung, Mit einem Befehl installieren.
- Upgrade und Einstellungen: Aktualisieren, Umgebungseinstellungen,
config.php-RECOMMENDEDundconfig.env.php.example(der Demo-Modus ist keine Konstante), Bekannte Passwörter werden abgelehnt. - Benutzer, Passwörter und Rollen: Ihr Passwort ändern, Ein Benutzerpasswort zurücksetzen, Rollen und Richtlinien, Das Administratorpasswort ändern, Das Standard-Administratorpasswort, Konten und Anmeldung, In der Administration anmelden.
- Sicherheit, Audit und Logs: Audit, Sicherheit und Audit, Log-Viewer, Sicherheitshärtung, Härtung für Hoster, Audit-Protokoll für Hoster, security.log, Erste Anmeldung und Standardpasswörter.
- Server, Panels und Cron: Velocity-Engines, Velocity für Hoster, LiteSpeed, Apache mit PHP-FPM, nginx mit PHP-FPM, FrankenPHP, Plesk, cPanel, PHP-Auswahl und FPM-Pools, Cron und Shell-Zugang, Cronjobs, Cronjobs, Container, SQLite für Hoster, die Checklisten für Hoster (neuer Server, Go-live, Sicherheitsprüfung) und die Bereitstellung mit exp:install, dem Kickstarter und dem Setup-Assistenten.
- Webdienste und Entwickler: Dienste, REST-API, expservices, eZUser und Zugriff, Konsolenbefehle.
- Glossare: Glossar, für Hoster, für Erweiterungsentwickler, für Fürsprecher, für Partner.
- Presse, Fürsprecher, Trainer, Partner und Vertrieb: Eine Demo-Installation einrichten, Presse: hier beginnen, Sicherheit bei Live-Demos, Fürsprecher: hier beginnen, FAQ für Neulinge, Trainer: hier beginnen, Partner: hier beginnen, Vertrieb und Marketing: hier beginnen, Demo-Skripte, Demo-Websites für Designer.