- Nach der Einrichtung Erfolgsmeldung auf der Anmeldeseite (per Parameter, da die Sitzung beim Wechsel auf den Datenbank-Speicher verloren geht) - Root-.htaccess für Hoster ohne einstellbaren Webroot: leitet intern nach public/, .env und Programmdateien bleiben unerreichbar - Begrüßungskarte: Namen nicht mehr abschneiden; Personenzahl mit korrekter Einzahl - docs/INSTALLATION.md für Kunden: Voraussetzungen, Einrichtung, Cron, Updates - CI: vendor-Vergleich ohne composer/installed.php (enthält den Projekt-Commit) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
3.1 KiB
Installation und Betrieb
Diese Anleitung richtet sich an die IT bzw. an die Person, die das Portal beim Hoster einrichtet. Shell-Zugang wird nicht benötigt.
Voraussetzungen
- PHP 8.3 oder neuer mit den Erweiterungen
pdo_mysql,mbstring,openssl,intl,gd,zip,fileinfo,tokenizer,ctype,xml,dom - MySQL ab 8.0 oder MariaDB ab 10.6 – eine leere Datenbank samt Benutzer
- Apache mit
mod_rewrite(Einstellungen per.htaccessmüssen erlaubt sein) - Empfohlen: OPcache,
memory_limit≥ 128M,upload_max_filesize≥ 8M, HTTPS - Ausgehende HTTPS-Verbindungen zu
update.loheide.cloudundapi.loheide.cloud(für Aktualisierungen und Rückmeldungen)
Einrichtung
- Das Installationsarchiv entpacken und alle Dateien per FTP/SFTP oder Dateimanager in das gewünschte Verzeichnis hochladen.
- Webroot festlegen:
- Empfohlen: Die Domain zeigt auf das Unterverzeichnis
public/. - Lässt der Hoster das nicht zu, zeigt die Domain auf das
Installationsverzeichnis – die mitgelieferte
.htaccessleitet dann alle Anfragen nachpublic/weiter.
- Empfohlen: Die Domain zeigt auf das Unterverzeichnis
- Schreibrechte für den Webserver:
storage/,bootstrap/cache/,public/uploads/und – damit Aktualisierungen per Klick funktionieren – für das gesamte Installationsverzeichnis. - Die Adresse des Portals im Browser aufrufen. Der Einrichtungsassistent führt durch Systemprüfung → Datenbank → Administrator. Lizenz-E-Mail und Lizenzschlüssel können dabei oder später eingetragen werden.
- Mit dem Administratorkonto anmelden und unter Administration → Systemzustand die Hinweise durchgehen.
Solange die Einrichtung nicht abgeschlossen ist, kann jede Person, die die Adresse kennt, den Assistenten ausfüllen. Die Einrichtung daher direkt nach dem Hochladen abschließen.
Hintergrundaufgaben
Rückmeldungen, geplante Inhalte und Aufräumarbeiten laufen im Hintergrund. Die genauen Angaben zeigt Systemzustand an.
- Am besten: Cronjob beim Hoster, jede Minute:
cd /pfad/zum/portal && php artisan schedule:run - Ohne Cron-Zugang: die unter Systemzustand angezeigte geheime Web-Cron-Adresse jede Minute von einem externen Cron-Dienst aufrufen lassen.
- Ohne beides laufen die Aufgaben beim Aufruf von Seiten mit – das funktioniert, ist aber weniger zuverlässig.
Aktualisierungen
Unter Administration → Aktualisierung: „Nach Updates suchen“ und „Jetzt
aktualisieren“. Das Portal zeigt währenddessen eine Wartungsseite, übernimmt
die neue Fassung, bringt die Datenbank auf den neuen Stand und ist nach
wenigen Minuten wieder erreichbar. .env, storage/, hochgeladene Dateien
und Plugins werden dabei nie verändert.
Voraussetzung ist eine gültige Lizenz. Ein Lizenzproblem schränkt die Nutzung des Portals nicht ein – es verhindert nur den Bezug neuer Fassungen.
Umzug auf einen anderen Server
Alle Dateien (inklusive .env und storage/) und die Datenbank übertragen.
Anschließend unter Aktualisierung die alte Installation abmelden bzw. die
Lizenz neu prüfen – jede Installation belegt einen Geräteplatz der Lizenz.