.. _TYPO3v11Installation: ================================================================================================ Neuinstallation ================================================================================================ Es gibt nur noch die Variante diese Distribution via composer zu installieren. Lassen Sie den Betrieb Ihrer Internetseite professionell begleiten. Vorrausetzungen ================================================================================================ .. container:: row m-0 p-0 .. container:: col-md-6 pl-0 pr-3 py-3 m-0 .. container:: card px-0 h-100 .. rst-class:: card-header h3 .. rubric:: Downloads .. container:: card-body Zur Inbetriebnahme sind die folgenden Downloads der DRK Service GmbH nötig * Filedump * Datenbankdump .. container:: card-footer pb-0 .. rst-class:: horizbuttons-striking-m - `Download Datei- und Datenbankdump `_ .. container:: col-md-6 pl-0 pr-3 py-3 m-0 .. container:: card px-0 h-100 .. rst-class:: card-header h3 .. rubric:: Tools und PHP Umgebung .. container:: card-body Grundlage für die folgenden Schritte ist eine Umgebung, in der die folgenden Tools installiert und vorhanden sind: * PHP 8.1 * composer 2.x .. container:: card-footer pb-0 .. rst-class:: horizbuttons-striking-m - :ref:`FAQ / Installation zu den Tools ` .. hint:: Eine lokale Testumgebung kann mit der Software `DDEV `_ aufgebaut werden. Wenn hier Bedarf besteht, wird diese ggf. in die Distribution mit aufgenommen. Installation via composer ================================================================================================ .. seealso:: Zusatzinformationen zu dem untenstehenden Prozess finden sich hier: * TYPO3 Installationguide with composer https://docs.typo3.org/m/typo3/guide-installation/10.4/en-us/Composer/Index.html Bitte beachten Sie den Prozess hier zu befolgen, statt dem für ein blankes TYPO3 .. hint:: Es wird empfohlen die folgenden Schritte auf einem Linux auszuführen, dazu können die folgenden Umgebungen genutzt werden: * Unter Windows * WSL 2 * DDEV mit WSL2 * Unter MacOS DDEV * Bash oder ZSH auf OSX * DDEV mit WSL2 * Unter Linux nativ * Bash oder ZSH auf Linux * DDEV Die Schritte sind nun die folgenden: .. rst-class:: bignums-xxl 1. Installieren der oben genannten Tools 2. Ordner anlegen z.B.: 'KV-Musterstadt' 3. Öffnen der Kommandozeile (hier Bash, Zsh) in dem Ordner 4. Dann wird das folgende Kommando ausgeführt: .. code-block:: shell :linenos: composer create-project drkservice/project-template-kv . --repository=https://gitlab.com/api/v4/group/7483790/-/packages/composer/packages.json ^11 Dadurch wird die folgende Verzeichnisstruktur erstellt: .. code-block:: shell :linenos: -rw-r--r-- .gitlab-ci.yml -rw-r--r-- Readme.md -rw-r--r-- composer.json -rw-r--r-- composer.lock drwxr-xr-x config drwxr-xr-x public drwxrwsr-x var drwxr-xr-x vendor Die Ordner haben dabei die folgenden Funktionen: * config, den Inhalt findet sich erklärt in der TYPO3 Dokumentation, stand jetzt liegt dort die `SiteConfig `_ * public, hier liegt nun der fileadmin Ordner und die Erweiterungen, außerdem ist das der sogenannte Documentroot, der bei Ihrem Hoster eingestellt werden sollte * var, hier liegen diverse log files * vendor, hier liegen alle Softwarepakete, die keine reinen Extensions sind Zusätzlich sind noch einige Dateien im Ordner vorhanden: * .gitlab-ci.yml, steuert das CI System, hier wird nun das Paket veröffentlicht * Readme.md, Informationen zur Verwendung und zu den Musterseiten * composer.json, definiert die nötigen Softwarepakete * composer.lock, listet die installierten Softwarepakete auf Durch diese Schrittfolge werden nun alle nötigen Software-Pakete heruntergeladen. 5. Prüfen der Systemvorausetzungen .. code-block:: shell :linenos: vendor/bin/drkcms platform:check Sollten hier Fehler auftreten müssen ggf. Abhängigkeiten nachinstalliert werden. Kontaktieren Sie in dem Fall Ihren Provider. 6. Zusammenführen mit dem Datenbankdump und den Assets (Dateien) Sobald Sie den Datenbankdump und die Dateien aus den Filedump ergänzt haben, können Sie die Dateien direkt auf Ihren Webspace hochladen. Folgende Dateien und Ordner sind im Filedump enthalten und werden benötigt: * public/fileadmin Ordner * aus dem Ordner public/typo3conf die Dateien `image_autoresize.config.php`, `LocalConfiguration.php`, `PackageStates.php` 7. Hochladen aller Dateien - insofern Sie die Schritte nicht beim Provider ausgeführt haben Laden Sie alle Dateien über eines der folgenden Transferverfahren auf Ihren Webspace: * SFTP (aber kein FTP oder FTPS) * RSync 8. Datenbankdump Nun wird der Datenbankdump in die MySQL Datenbank geladen. 9. Konfiguration Für die folgenden Schritte ist eine SSH Verbindung zur Ihrem Hostingpaket nötig. .. hint:: Falls PHP Scripte mit der falschen Version ausgeführt werden, kann diese vor dem jeweiligen Kommando hinzugefügt werden: .. code-block:: shell vendor/bin/typo3 upgrade:prepare Nun werden die folgenden Dateien mit dem "execute" - Bit markiert, damit diese ausgeführt werden können. .. code-block:: shell :linenos: chmod -R +x vendor/bin/* Nun werden die Optionen gesetzt, damit TYPO3 auf die Datenbank zugreifen kann. Bitte passen sie hierzu die Datenbankverbindung in der LocalConfiguration.php an: .. code-block:: shell :linenos: 'dbname' => 'name-der-datenbank', 'host' => 'datenbank-server', 'user' => 'datenbank-nutzer', 'password' => 'datenbank-passwort', Dann werden noch einige Kommandos zum Sicherstellen der Struktur ausgeführt: .. code-block:: shell :linenos: vendor/bin/typo3 install:fixfolderstructure vendor/bin/typo3 install:extensionsetupifpossible vendor/bin/typo3 upgrade:prepare Konfigurieren Sie Ihren Webserver so, dass dieser den **public** Ordner als Startverzeichnis nutzt. .. danger:: Es ist Sicherzustellen, dass der Encryptionkey nach der Installation geändert wird 10. Hostingprovider Um dem Webserver mitzuteilen, wo der Webserver seine Dateien findet, setzen Sie bitte die Einstellungen wie folgt: Document Root: public/ Ordner im Projekt .. _big-nums: