Ordner und Dateien in Contao 4: Unterschied zwischen den Versionen
Aus Contao Community Documentation
K (→app/Resources/contao/) |
K (→/app/Resources/ContaoCoreBundle/views/) |
||
Zeile 98: | Zeile 98: | ||
Beispiel: | Beispiel: | ||
+ | |||
Error/service_unavailable.html.twig (Template für den Maintenance Mode. | Error/service_unavailable.html.twig (Template für den Maintenance Mode. | ||
Version vom 25. Oktober 2017, 23:44 Uhr
betrifft | |
---|---|
Contao Version | Contao 4 latest managed edition |
Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.
Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis. |
Hier sollen die Ordner und Dateien von Contao 4 dokumentiert werden, welche zum Verständnis und zur Anpassung des Systems relevant sind.
In Contao 3 waren dies:
.htaccess files/ system/ config/ dcaconfig.php initconfig.php langconfig.php localconfig.php modules/ templates/
Legende:
- Anwendung: Contao (Contao ist eine Symfony Anwendung). Hiermit ist die komplette Installation gemeint.
- BE: Backend
- FE: Frontend
- Kommandozeile: Auch Konsole oder bei Windows Eingabeaufforderung genannt. Dafür muss man sich über einen SSH Zugang zum Server verbinden. Bekannte Clients sind Putty und "Bitvise SSH Client".
Inhaltsverzeichnis
.htaccess
Die Datei ist leer. Hier kann ein Passwortschutz aufgesetzt werden.
composer.json
composer.lock
app/
app/config/
app/config/parameters.yml
Konfigurationsparameter der Anwendung, dies sind u.a. Datenbank-Zugangsdaten usw.
app/config/config.yml
Gemeinsame Konfigurationsdatei der Website, hier werden alle "services" konfiguriert.
Die Parameter aus "parameters.yml" werden hier oftmals verwendet (z.B. in `secret: "%secret%"`, welches den Parameter "secret" aus "parameters.yml" hier einträgt).
app/config/config_dev.yml
Konfigurationsdatei für das Entwicklungs-Environment (siehe auch web/app_dev.php)
app/config/config_prod.yml
Konfigurationsdatei für das Produktiv-Environment (siehe auch web/app.php)
app/Resources/
Alle Anwendungsressourcen werden hier abgelegt, dies sind u.a. twig Templates.
app/Resources/contao/
Dieser Ordner verhält sich wie eine eigene Erweiterung bei Contao 3.5.
app/Resources/contao/config/
Alle Contao relevanten Konfigurationen landen hier, dies sind lokale Anpassungen.
app/Resources/contao/dca/
Hier abgelegte Dinge ersetzen die aus Contao 3.5 bekannten dca-Dateien einer "z_custom" extension und system/config/dcaconfig.php
Beispiel:
Für ein neues Feld in den Seiteneinstellungen, hier eine Datei tl_page.php erstellen und die Feldkonfiguration eintragen.
app/Resources/contao/languages/
Hier abgelegte Dinge ersetzen die aus Contao 3.5 bekannten languages einer "z_custom" extension und system/config/langconfig.php
Beispiel:
Für die Beschriftung eines neuen Feldes in den Seiteneinstellungen, hier eine Datei en/tl_page.php erstellen und die Sprachvariablen eintragen.
/app/Resources/ContaoCoreBundle/
/app/Resources/ContaoCoreBundle/views/
Hier kann man geänderte BE-Templates von Contao reinlegen.
Beispiel:
Error/service_unavailable.html.twig (Template für den Maintenance Mode.
contao-manager/
Konfigurations-Verzeichnis des Contao Managers.
contao-manager/cache/
Cache-Verzeichnis des Contao Managers.
contao-manager/logs/
Log-Verzeichnis des Contao Managers.
system/
DEPRECATED - hier sollte man nichts rein tun.
Der Contao-Manager legt hier Legacy-Erweiterungen ab, damit diese im Contao 3.5 Modus in Contao 4 lauffähig gemacht werden. Diese Verzeichnisse werden außerdem nach web/system symlinked, damit die assets derselbigen Module lauffähig sind.
system/config/
system/config/initconfig.php
DEPRECATED - wie in Contao 3.5 kommt hier Initialisierungscode rein, welchen Contao beim "Start" ausführen soll.
Sollte man nicht mehr verwenden, lieber ein app-bundle bauen und saubere services.
system/config/localconfig.php
Konfigurationsdatei für Einstellungen, welche noch nicht im Manager bzw. parameters.yml sind.
Entspricht der Konfigurationsmaske im Backend (System/Einstellungen).
AN ENTWICKLER: Bitte nichts mehr in dca/tl_settings.php und localconfig.php hinzufügen. Eigene Dinge mittelfristig hieraus auch wieder entfernen. Verwendet stattdessen bundle-Konfigurationsparameter.
files/
Dateien, welche auf der Website veröffentlicht werden. jpg, png, pdf, mp3, mp4, css, js usw.
Unterordner müssen über die Dateiverwaltung explizit freigegeben werden.
templates/
Eigene Templates für die FE-Ausgabe.
var/
Ablageverzeichnis der Anwendung für u.a. cache, logs etc.
var/cache/
var/cache/dev/
Cache für den app_dev.php Modus.
Löschen über die Kommandozeile:
vendor/bin/contao-console cache:warmup --env=dev
var/cache/prod/
Dies ist der Ordner, den man löschen soll, wenn man aufgefordert wird, manuell den Cache zu löschen. Anschließend soll man das Installtool aufrufen.
Der Contao-Manager erledigt diese Aufgabe unter dem Punkt "Systemwartung - Cache neu erstellen".
Oder über die Kommandozeile:
vendor/bin/contao-console cache:clear --no-warmup vendor/bin/contao-console cache:warmup oder vendor/bin/contao-console cache:warmup --env=prod
vendor/
Composer Bibliotheksverzeichnis - hier wird der Code von Erweiterungen und Bundles abgelegt.
vendor/bin/
vendor/bin/contao-console
Diese Datei kann auf der Kommandozeile aufgerufen werden.
Beispiel:
php vendor/bin/contao-console cache:clear
web/
Auf diesen Ordner muss die Domain geroutet werden.
web/.htaccess
Apache Konfiguration um u.a. auf app.php zu redirecten.
web/app.php
Produktiver entrypoint der Anwendung aus dem Web. Entspricht in etwa "index.php" in Contao 3.5.
web/app_dev.php
Entwicklungs entrypoint der Anwendung aus dem Web. Entspricht in etwa "index.php" mit aktiviertem Debug Modus in Contao 3.5.
Um über app_dev aufrufen zu können muss die Zugangskontrolle eingerichtet werden (nicht bei localhost):
siehe https://contao.ninja/contao-4-login-fuer-app_dev-php-setzen.html
Ist über die .htaccess im Installationsverzeichnis ein Passwortschutz aufgesetzt, dann muss die User/Password-Kombination dort auch freigegeben werden.
BE-Zugang: example.org/app_dev.php/contao FE-Zugang: example.org/app_dev.php
web/bundles/
Hier werden alle assets von Bundles hineingelinkt um diese via web erreichbar zu machen.
web/system/
Siehe "system", hier werden assets von legacy Erweiterungen hin-gelinkt.
Wo findet man die DCA settings der Core Module?
Beispiel:
Für tl_news wäre dies hier:
vendor/contao/news-bundle/src/Resources/contao/dca/
--Andreas Burg (Diskussion) 18:19, 18. Okt. 2017 (CEST)
--Xtra (Diskussion) 20:08, 18. Okt. 2017 (CEST)