Lernseite · Web- und PHP-Grundlagen
Das Handwerkszeug der Integratorin – HTML, CSS, JavaScript, PHP, YAML und CSV
TYPO3 setzt auf Webtechniken auf, die du als Integratorin oder Integrator lesen und vorsichtig ändern können musst. Auf dieser Seite begleitest du Mara, die die Website der Musikschule Lindenau baut. Unterwegs triffst du auf HTML, CSS, JavaScript, ein wenig PHP, YAML und CSV. Am Ende kennst du außerdem die Grundregeln zu Urheberrecht und Datenschutz und die Formatregeln des TYPO3-Projekts.
Das Gerüst einer Seite: HTML
Mara arbeitet in einem Composer-Projekt mit TYPO3 14.3. Ihr Sitepackage heißt lindenau_site, das Composer-Paket lindenau/site.
HTML steht für HyperText Markup Language. Es beschreibt Struktur und Inhalt einer Webseite mit Elementen wie Überschriften, Absätzen, Links und Bildern. Ein gültiges Dokument hat immer dasselbe Grundgerüst:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Musikschule Lindenau</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<header>
<nav><a href="/kurse">Kurse</a></nav>
</header>
<main>
<h1>Willkommen in der Musikschule</h1>
</main>
<footer>Impressum</footer>
</body>
</html>- Das Dokument beginnt mit dem Doctype für HTML.
- Der Kopf steht genau einmal im Dokument. Er enthält Metadaten wie den Zeichensatz und den Titel, den der Browser im Tab anzeigt.
- Der Körper, also das Element body, steht ebenfalls genau einmal. Er enthält alles, was Besucher sehen.
Überschriften reichen von h1 bis h6. Das Element h1 kennzeichnet die wichtigste Überschrift der Seite. Darunter gliederst du sinnvoll abwärts mit h2, h3 und so weiter. Verwechsle das nicht mit head, dem Kopf des Dokuments, oder mit header, dem Kopfbereich auf der sichtbaren Seite.
Links erzeugt das Element a mit dem Attribut href für das Ziel. Das Element link dagegen ist kein Link zum Anklicken. Es bindet im Kopf Ressourcen ein, zum Beispiel ein Stylesheet.
Semantische Elemente beschreiben die Bedeutung eines Bereichs. Es gibt header für den Kopfbereich, nav für die Navigation, main für den Hauptinhalt, article für einen Beitrag und footer für den Fußbereich. Suchmaschinen und Screenreader verstehen die Seite dadurch besser. Elemente wie font und center legten früher nur die Darstellung fest und gelten heute als veraltet.
Bilder brauchen das Attribut alt. Es liefert einen Textersatz, wenn jemand das Bild nicht sehen kann oder es nicht lädt. Screenreader lesen diesen Text vor. Das ist ein Kern der Barrierefreiheit.
Formulare brauchen Beschriftungen, die mit dem Feld verknüpft sind. Das Element label bekommt im Attribut for die id des Eingabefelds:
<label for="email">E-Mail-Adresse</label>
<input type="email" id="email" name="email">So kann man auf die Beschriftung klicken, um ins Feld zu springen, und Screenreader lesen sie zum Feld vor.
Darstellung mit CSS
CSS steht für Cascading Style Sheets. CSS legt fest, wie HTML aussieht, also Farben, Schriften, Abstände und Layout. Eine externe CSS-Datei bindest du im Kopf der Seite mit dem Element link und dem Attribut rel mit dem Wert stylesheet ein. Im Grundgerüst oben siehst du die Zeile. In TYPO3 übernimmt das bei Mara oft der ViewHelper f:asset.css im Template oder die TypoScript-Einstellung page.includeCSS.
Eine CSS-Regel besteht aus einem Selektor und Deklarationen. Der Selektor bestimmt, welche Elemente gemeint sind:
- Ein Elementselektor wie p trifft alle Absätze.
- Ein Klassenselektor beginnt mit einem Punkt. So trifft
.teaseralle Elemente mit der Klasse teaser. - Ein ID-Selektor beginnt mit einer Raute. So trifft
#maindas eine Element mit der ID main. - Der Universalselektor, ein Stern, trifft alles.
- Das At-Zeichen leitet besondere Regeln ein, zum Beispiel
@mediafür Regeln je Bildschirmgröße.
Cascading heißt: Mehrere Regeln können dasselbe Element treffen, und der Browser entscheidet, welche Deklaration gilt. Dabei zählen Wichtigkeit, Spezifität und Reihenfolge.
Die Spezifität entscheidet vor der Reihenfolge. ID-Selektoren sind spezifischer als Klassen, Klassen spezifischer als Elemente. Der Stern hat gar keine Spezifität. Ein Style direkt im HTML-Element, ein Inline-Style, steht noch über allen Selektoren.
.box p { color: red; }
#teaser p { color: blue; }Nur bei gleicher Spezifität gewinnt die später definierte Regel. Deshalb spielt auch die Reihenfolge der CSS-Dateien eine Rolle. Mit !important setzt sich eine Deklaration über normale Regeln hinweg. Nutze das sparsam, denn es erschwert die Pflege. Viele Eigenschaften wie die Schriftfarbe werden außerdem an Kindelemente vererbt.
Das Boxmodell beschreibt den Platz, den ein Element einnimmt. Von innen nach außen liegen dort vier Schichten.
- padding ist der Innenabstand zwischen Inhalt und Rahmen.
- border ist der Rahmen.
- margin ist der Außenabstand zu benachbarten Elementen.
Interaktion mit JavaScript
JavaScript läuft in aller Regel im Browser der Besucher, nicht auf dem Webserver und nicht in der Datenbank. Es macht Seiten interaktiv, etwa ein aufklappbares Menü oder eine Prüfung im Formular.
Auf einen Klick reagierst du mit der Methode addEventListener(). Sie registriert eine Funktion für ein Ereignis, zum Beispiel click. An dasselbe Element darfst du mehrere solche Funktionen hängen.
const button = document.querySelector('#menu-toggle');
button.addEventListener('click', () => {
document.querySelector('nav').classList.toggle('open');
console.log('Menü umgeschaltet');
});Variablen legst du mit const, let oder var an:
- Eine Variable mit const kann man nicht neu zuweisen. Ein Objekt darin bleibt aber änderbar, man kann also seine Eigenschaften ändern.
- let und const gelten nur im umgebenden Block, etwa innerhalb einer Schleife.
- var ist der alte Weg. Es gilt für die ganze Funktion, nicht nur im Block.
Fehlersuche: Mit console.log() schreibst du einen Wert in die Konsole der Entwicklerwerkzeuge. Die Befehle echo und print stammen dagegen aus PHP. JavaScript-Fehler erscheinen ebenfalls in der Browser-Konsole. Dort kannst du auch Haltepunkte setzen. Im TYPO3-Log oder in den Logdateien auf dem Server findest du sie nicht, denn der Code lief ja im Browser.
In Fluid bindet Mara das Skript mit dem ViewHelper f:asset.script ein und setzt dort das Argument defer. Ohne das Argument priority landet das Skript außerdem am Ende des Body. Mit priority kommt es in den Kopf der Seite. Der klassische TypoScript-Weg ist page.includeJS.
<f:asset.script identifier="menu" src="EXT:lindenau_site/Resources/Public/JavaScript/Menu.js" defer="1" />PHP lesen: Variablen, Typen und Arrays
PHP begegnet dir in Konfigurationsdateien, vor allem in settings.php und additional.php im Ordner config/system. Du musst sie lesen und vorsichtig ändern können.
Variablen beginnen in PHP mit einem Dollarzeichen, etwa die Variable title. In TYPO3 begegnet dir vor allem das große globale Array für die Konfiguration, kurz TYPO3_CONF_VARS.
PHP kennt unter anderem diese Datentypen:
- string für Text, in Anführungszeichen. Die 14 in Anführungszeichen ist ein String.
- int für ganze Zahlen. Die 14 ohne Anführungszeichen ist ein Integer, also ein anderer Typ.
- float für Kommazahlen.
- bool für Wahrheitswerte, also true oder false.
- array für Listen von Werten. Ein Array ist kein String.
- null steht für „kein Wert“.
In der settings.php stehen Zahlen teils als Text, teils als Zahl. Die Dateirechte 0664 stehen zum Beispiel als String da, damit die führende Null erhalten bleibt.
Ein Array speichert mehrere Werte. Ein indiziertes Array nummeriert sie von null an. Ein assoziatives Array verwendet Schlüssel. Schlüssel und Wert verbindet ein Gleichheitszeichen mit Größer-Zeichen, der sogenannte Doppelpfeil. Arrays lassen sich verschachteln. Genau so ist settings.php aufgebaut.
['name' => 'TYPO3', 'version' => 14]
<?php
return [
'SYS' => [
'sitename' => 'Musikschule Lindenau',
],
'BE' => [
'fileCreateMask' => '0664',
],
];Warum return? Die Datei settings.php gibt mit return ein Konfigurations-Array zurück. TYPO3 bindet die Datei ein und liest dieses Array. Viele Konfigurationsdateien von Extensions arbeiten genauso, etwa die Dateien im Ordner Configuration.
Arrays zusammenführen: Die Funktion array_merge() hängt Arrays aneinander. Haben zwei Arrays denselben Textschlüssel, überschreibt der spätere Wert den früheren. Es gibt keinen Fehler und keinen doppelten Schlüssel. Der Spread-Operator mit drei Punkten verhält sich seit PHP 8.1 bei Textschlüsseln genauso.
array_merge(['a' => 1, 'b' => 2], ['b' => 3]);
// Ergebnis: ['a' => 1, 'b' => 3]
[...$defaults, ...$overrides];PHP verstehen: Bedingungen, Funktionen und Namespaces
In der additional.php wählt Mara Werte je Application Context, also je nachdem, ob die Seite in Entwicklung oder Produktion läuft. Dafür nutzt PHP Bedingungen:
- if prüft eine Bedingung und führt je nach Ergebnis Code aus. Das funktioniert auch in Konfigurationsdateien.
- switch vergleicht einen Wert mit mehreren case-Zweigen. Der Vergleich ist locker, also wie mit zwei Gleichheitszeichen. Ohne break läuft switch in den nächsten Zweig weiter.
- match vergleicht strikt, also wie mit drei Gleichheitszeichen, und liefert einen Wert zurück. Ein Durchfallen in den nächsten Zweig gibt es bei match nicht.
$context = (string)\TYPO3\CMS\Core\Core\Environment::getContext();
$GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] = match ($context) {
'Development' => 1,
default => 0,
};Funktionen und Methoden: Eine Funktion rufst du direkt auf, zum Beispiel strlen() für die Länge eines Textes. Eine Methode gehört zu einem Objekt. Du rufst sie mit einem Pfeil aus Bindestrich und Größer-Zeichen am Objekt auf. Statische Methoden rufst du mit zwei Doppelpunkten an der Klasse auf, so wie getContext() oben.
strlen($text);
$site->getSettings();Parse Error: Eine Datei wie additional.php lädt TYPO3 bei jeder Anfrage, im Frontend wie im Backend. Fehlt darin ein Semikolon, bricht PHP mit einem Parse Error ab, bevor TYPO3 irgendetwas ausgeben kann. Dann zeigt die ganze Website einen Fehler. Cache leeren hilft hier nicht. Prüfe Änderungen vorher auf der Kommandozeile mit dem Befehl php und der Option für den Syntax-Check, also php -l mit dem Dateinamen.
Namespaces geben Klassen eindeutige Namen. Zwei Klassen dürfen gleich heißen, solange ihr Namespace verschieden ist. Du legst ihn mit dem Schlüsselwort namespace am Anfang der Datei fest. In Extensions folgt er meist dem Vendor und dem Extension-Namen. Maras Klassen liegen also im Namespace Lindenau, Backslash, Site.
Fluid-Namespaces: Mara schreibt einen eigenen ViewHelper und will ihn in allen Templates unter dem Präfix lindenau nutzen. Seit TYPO3 14.1 meldet sie ihn global in der Datei Configuration/Fluid/Namespaces.php ihrer Extension an. Die Datei gibt ein Array aus Präfix und PHP-Namespaces zurück. TYPO3 liest diese Dateien aus allen geladenen Extensions und führt sie zusammen.
<?php
return [
'lindenau' => ['Lindenau\\Site\\ViewHelpers'],
];YAML: Einrückung ist Struktur
TYPO3 nutzt YAML an vielen Stellen. Dazu gehören die Site-Konfiguration in der Datei config.yaml jeder Site, Route Enhancer, Site Sets, das Form Framework und die Presets des Rich-Text-Editors.
In YAML bestimmen Einrückung und Doppelpunkte die Struktur. Ein Schlüssel steht vor einem Doppelpunkt, dahinter der Wert. Was tiefer eingerückt ist, gehört zum Eintrag darüber. Es gibt keine Semikolons und keine geschweiften Klammern um Blöcke.
# Site der Musikschule Lindenau
rootPageId: 1
base: 'https://www.musikschule-lindenau.example/'
dependencies:
- lindenau/site
languages:
- title: 'Deutsch: Hauptsprache'
languageId: 0
locale: de_DE.UTF-8- Einrückung nur mit Leerzeichen. Tabs sind in YAML nicht erlaubt. TYPO3 nutzt 2 Leerzeichen je Ebene.
- Listen schreibst du mit einem Bindestrich und einem Leerzeichen vor jedem Eintrag, jeder Eintrag in eigener Zeile und gleich eingerückt. Daneben gibt es eine Kurzform in eckigen Klammern.
- Kommentare beginnen mit einer Raute. Alles danach ignoriert YAML, außer die Raute steht in Anführungszeichen.
- Anführungszeichen setzt du besser um Texte mit Doppelpunkt. Ein Doppelpunkt mit Leerzeichen im Wert kann sonst als neuer Schlüssel gelesen werden.
TYPO3 ergänzt YAML um eigene Hilfen. Mit imports bindest du andere YAML-Dateien ein. Platzhalter mit env lesen Werte aus Umgebungsvariablen. Andere Platzhalter übernehmen einen Wert aus derselben Konfiguration.
Den Unterschied zu TypoScript solltest du kennen: In YAML bedeutet die Einrückung Struktur. In TypoScript bilden Punkte und geschweifte Klammern die Struktur, die Einrückung dient dort nur der Lesbarkeit.
CSV: Tabellen als Text
Die Musikschule will ihre Lehrkräfte aus einer Tabelle übernehmen. Dafür ist CSV das gängige Format, kurz für Comma-Separated Values, also kommagetrennte Werte. Trotz des Namens sind auch andere Trennzeichen üblich.
Eine CSV-Datei ist eine reine Textdatei. Jede Zeile ist ein Datensatz. Ein Trennzeichen trennt die Felder. Weil es nur Text ist, öffnest du die Datei mit jedem Texteditor. Eine Tabellenkalkulation zeigt die Werte in Spalten an.
Trennzeichen: Üblich sind Komma, Semikolon und Tabulator. Punkt oder Bindestrich sind keine üblichen Trennzeichen. Welches Zeichen ein Programm nutzt, hängt auch von der Region ab. Deutsche Tabellenkalkulationen nehmen oft das Semikolon, weil das Komma dort als Dezimaltrenner dient.
Einschlusszeichen: Enthält ein Wert selbst das Trennzeichen, umschließt man ihn mit einem Einschlusszeichen, meist dem doppelten Anführungszeichen. Der Name Müller, Hans bleibt so ein einziges Feld. Steht im Wert selbst ein Anführungszeichen, wird es verdoppelt. So regelt es RFC 4180. Manche Programme erlauben stattdessen ein Escape-Zeichen wie den Backslash.
Lehrkraft,Instrument,Gerät
"Müller, Hans",Klavier,"12"" Monitor"Kodierung: Ältere Programme exportieren oft ISO-8859-1, auch Latin-1 genannt. Moderne Programme nutzen UTF-8. Liest ein Programm die Datei mit der falschen Kodierung, erscheinen Umlaute falsch.
CSV in TYPO3: Im Modul Records lädt man die Datensätze einer Tabelle herunter. Für CSV bietet der Download drei Trennzeichen an: Komma, Semikolon und den senkrechten Strich, genannt Pipe. Als Einschlusszeichen gibt es das doppelte Anführungszeichen, das einfache Anführungszeichen und das Leerzeichen. Voreingestellt sind Komma und doppeltes Anführungszeichen. Statt CSV kann man auch JSON wählen.
Urheberrecht, Datenschutz und KI
Fotos sind urheberrechtlich geschützt. Bevor Mara ein fremdes Foto auf die Website stellt, klärt sie, ob die Musikschule die Rechte zur Nutzung hat. Man braucht eine Lizenz oder eine Erlaubnis und muss oft den Urheber nennen. Ein Foto im Internet ist nicht automatisch frei.
Creative Commons sind verbreitete freie Lizenzen. Die Lizenz CC BY erlaubt die Nutzung unter einer Bedingung: Man nennt den Urheber und die Lizenz. CC-Fotos sind also nicht gemeinfrei. Andere Varianten schränken mehr ein. NC verbietet zum Beispiel die kommerzielle Nutzung, ND verbietet Bearbeitungen.
Personenbezogene Daten sind alle Angaben, die sich einer Person zuordnen lassen. Dazu gehören Name, E-Mail-Adresse und IP-Adresse, nicht nur Passwörter oder Bankdaten. Für sie gelten Datenschutzregeln wie die DSGVO. Die rechtlichen Details hängen vom Land ab. Im TYPO3-Projekt heißt das:
- IP-Adressen in Logs und Datensätzen können personenbezogen sein. Der Scheduler bietet dafür eine Aufgabe, die IP-Adressen in Datenbanktabellen anonymisiert.
- Eingaben in Formulare, etwa Name und E-Mail bei einer Anmeldung zum Probeunterricht, sind personenbezogen.
- Auch Daten im Backend können personenbezogen sein, etwa die Benutzerkonten der Lehrkräfte.
- Daten speichert man nur so lange wie nötig. Für alte Datei-Uploads aus Formularen gibt es den Konsolenbefehl
form:cleanup:uploads.
Externe Ressourcen sind heikel. Bindet Mara eine Schrift oder ein Video von einem fremden Server ein, schickt der Browser jedes Besuchers beim Laden dessen IP-Adresse an diesen Server. Die IP-Adresse geht also an Dritte. Das kann eine Einwilligung nötig machen. Oft ist es einfacher, die Schrift lokal im Sitepackage mitzuliefern.
KI-Inhalte prüft man vor der Veröffentlichung. Ein KI-Text kann falsche Fakten enthalten, auch wenn er überzeugend klingt. Er kann außerdem fremde Texte nahezu wörtlich übernehmen. Ein rein maschinell erzeugter Text ist auch nicht automatisch urheberrechtlich geschützt. Das Bundesamt für Sicherheit in der Informationstechnik empfiehlt, Ergebnisse nie ungeprüft zu übernehmen.
Ordnung im Code: die Coding Guidelines
Das TYPO3-Projekt hat Coding Guidelines für die Dateiformate, mit denen du täglich arbeitest. Sie legen Dateiendungen und Einrückung fest:
- TypoScript-Dateien müssen auf
.typoscriptenden. In statischen Templates heißen sieconstants.typoscriptundsetup.typoscript. - TSconfig-Dateien enden auf
.tsconfig. Sie nutzen die Syntax von TypoScript. - TypoScript, TSconfig, YAML und XLIFF rückst du mit 2 Leerzeichen je Ebene ein, nicht mit Tabs.
- PHP-Dateien folgen dem Standard PSR-12. Er regelt zum Beispiel die Einrückung mit 4 Leerzeichen, die Klammern und die Namespaces. Das gilt auch für PHP-Dateien im Sitepackage. Das Paket
typo3/coding-standardsprüft heute nach PER Coding Style, dem fortgeschriebenen Nachfolger von PSR-12. - JavaScript in Extensions rückt man mit 2 Leerzeichen statt Tabs ein und schreibt Strings in einfache Anführungszeichen.
XLIFF ist das Standardformat für Sprachdateien in Extensions, mit der Endung xlf. Die Quelltexte stehen etwa in locallang.xlf. Jede Übersetzung liegt in einer eigenen Datei mit dem Sprachcode als Präfix, die deutsche heißt also de.locallang.xlf. Seit TYPO3 14.1 rückt der Core alle XLIFF-Dateien mit 2 Leerzeichen statt mit Tabs ein. Extensions sollen nachziehen.
Damit das nicht jeder selbst einstellen muss, gibt es die Datei .editorconfig. Sie legt je Dateityp Einrückung, Zeilenenden und Zeichensatz fest. Viele Editoren übernehmen diese Regeln automatisch.
root = true
[*]
charset = utf-8
end_of_line = lf
indent_style = space
indent_size = 2
[*.php]
indent_size = 4Das Wichtigste in Kürze
- HTML gibt die Struktur vor: Doctype, ein Kopf mit Titel, ein Body mit Inhalt, semantische Bereiche, Überschriften ab h1, alt-Texte und label mit for.
- In CSS entscheidet erst important, dann die Spezifität, dann die Reihenfolge. Eine ID schlägt eine Klasse, eine Klasse schlägt ein Element.
- padding ist der Innenabstand, margin der Außenabstand.
- JavaScript läuft im Browser. Fehler stehen in der Browser-Konsole, und defer lässt ein Skript erst nach dem Dokument laufen.
- PHP-Konfigurationsdateien geben mit return ein Array zurück. Ein Parse Error in der
additional.phplegt die ganze Website lahm. - Globale Fluid-Namespaces gehören seit TYPO3 14.1 in die Datei
Configuration/Fluid/Namespaces.php. - In YAML ist Einrückung Struktur: Leerzeichen statt Tabs, Listen mit Bindestrich, Kommentare mit Raute.
- In CSV verdoppelt man Anführungszeichen im Wert. Beim Import zählen Trennzeichen und Kodierung.
- Fremde Fotos brauchen Rechte, externe Ressourcen geben die IP-Adresse weiter, und KI-Texte prüft man vor der Veröffentlichung.
- TypoScript endet auf typoscript, TSconfig auf tsconfig. Beide werden mit 2 Leerzeichen eingerückt, PHP folgt PSR-12, und die
.editorconfiggehört ins Repository.
Begriffe
- HTML
- Auszeichnungssprache, die Struktur und Inhalt einer Webseite beschreibt.
- Semantisches Element
- HTML-Element, das die Bedeutung eines Bereichs angibt, etwa nav, main oder footer.
- Spezifität
- Gewicht eines CSS-Selektors, das entscheidet, welche Regel gilt.
- Boxmodell
- Aufbau eines Elements aus Inhalt, padding, border und margin.
- defer
- Attribut, mit dem ein Skript erst nach dem Lesen des Dokuments läuft.
- Assoziatives Array
- PHP-Array, dessen Werte unter Schlüsseln statt Nummern stehen.
- Parse Error
- Syntaxfehler, bei dem PHP eine Datei gar nicht erst ausführt.
- Namespace
- Namensraum, der PHP-Klassen eindeutig benennt.
- YAML
- Konfigurationsformat, dessen Struktur aus Einrückung und Doppelpunkten entsteht.
- Einschlusszeichen
- Zeichen, meist ein Anführungszeichen, das einen CSV-Wert umschließt.
- Personenbezogene Daten
- Angaben, die sich einer bestimmten Person zuordnen lassen.
- CC BY
- Creative-Commons-Lizenz, die die Nutzung bei Nennung von Urheber und Lizenz erlaubt.
- XLIFF
- XML-Format für Sprachdateien in TYPO3-Extensions.
- EditorConfig
- Datei, die Editoren einheitliche Formatregeln je Dateityp vorgibt.