Das kostenfreie Opensource Content Management System Typo3 ist zwar schon etwas in die Jahre gekommen, aber zweifelsohne immer noch ein König in Sachen Funktionsumfang. Allerdings ist es nicht sehr Mächtig sondern auch sehr Komplex. Hier gibt es ein paar spezielle Tips rund um die Installation von Typo3 unter MISH. Allgemein Interessant ist unser PHP-Script sein, welches die benötigten Symlinks ohne Shellzugriff für die aktuellste Typo3 Version erstellt. Getestet mit Typo3 4.3., April 2010.

Inhaltsverzeichnis

1 Vorher
2 Zwei Installations-Arten von Typo3
3 Typo3 Runter- und Hochladen
- 3.1 Installation & Ausführung des Typo3 Symlink Skriptes
4 Upgrade auf eine neue Typo3 Version
5 Quelltext für Initialisierungsskript

Vorher

ein Webprojekt anlegen (mit FTP Konto und PHP)
eine MySQL Datenbank anlegen (mit Benutzer)

Zwei Installations-Arten von Typo3

Es gibt eine einfache und eine etwas komplizierte aber bessere Installations-Version von Typo3. Typo3 lässt sich am saubersten Installieren, wenn man mit "symbolischen Links" arbeitet.

Ein symbolischer Link, (symbolische Verknüpfung, symbolischer Link, Symlink, Softlink) ist eine Verknüpfung in einem Dateisystem. Hierbei verweist eine Referenzdatei auf den eigentlich Ordner oder die Zieldatei. Quelle: http://de.wikipedia.org/wiki/Symbolische_Verkn%C3%BCpfung

Symbolische Links werden von Unix-basierten Betriebssystemen, wie Linux oder Mac Os X verstanden. Windows kennt keine Symlinks. Da unsere MISH Server alle unter Linux laufen, ist es also bei uns erstmal theoretisch möglich Symlinks zu nutzen. Das Problem: Symbolische Links können nicht via FTP transferiert werden.

Wie bei Shared Hosting auch, bieten wir (zur Zeit noch) keinen Shell-Zugriff für unsere Kunden an. Es ist so also nicht möglich eine gepackte Datei (tar.gz) mit Symlinks auf unseren Servern zu entpacken (das geht allerdings alternativ über unser WebFTP), oder die Symlinks von Hand auf dem Server zu erstellen. Hierfür haben wir ein kleines PHP-Script geschrieben, welches die benötigten symbolischen Links für die jeweils neuste Version von Typo3, also auch nach einem Update erzeugt, siehe unten. Aber erstmal der Reihe nach:

Typo3 Runter- und Hochladen

Aktuelle Version von typo3.org herunterladen (wahrscheinlich die "Source + Dummy" Version, dafür bitte die Installationsanleitung von Typo3 referieren) und lokal entpacken. Die Entpackten Verzeichnisse per FTP in das /www Verzeichnis des Webprojektes hochladen.

Installation & Ausführung des Typo3 Symlink Skriptes

Bevor die richtige Installation von Typo3 anfängt muss nun das Symlink-Skript durchlaufen. Das Skript gibt es hier zum Download:

https://frbit.de/static/misc/typo3_init_symlinks.php (Quelltext ist außerdem nochmal an Fuße dieses Howtos.)

Lokal abspeichern und wiederum per FTP in den /www Ordner des Webprojektes Kopieren. Danach per Browser aufrufen (z.B. http://web12345.test.frbit.de/typo3_init_symlinks.php).

Wird im Browser "Alle Links erfolgreich angelegt" gezeigt, ist alles OK und das Skript sollte wieder gelöscht werden.

Upgrade auf eine neue Typo3 Version

Ein Upgrade von Typo3 erfolgt normalerweise einfach durch den Upload des aktuellen typo3-src Verzeichnisses. Nachdem das Verzeichnis in /www hochgeladen wurde einfach nochmal das Symlink Skript - wie unter Installation beschrieben - runterladen, ins /www Verzeichnis kopieren und ausführen.

Quelltext für Initialisierungsskript

<?php

// symlink structure
$links = array(
	'typo3_src'	=> '',
	't3lib'		=> 'typo3_src/t3lib',
	'typo3'		=> 'typo3_src/typo3',
	'index.php'	=> 'typo3_src/index.php'
);

// check pre-conditions
foreach ( array_keys( $links ) as $path )
	if ( ( is_dir( $path ) || is_file( $path ) ) && ! is_link( $path ) )
		die( "Das Verzeichnis/die Datei '$path' existiert schon, es kann kein Symlink erstellt werden!" );

// get typo3 latest src dir
$src_dirs = glob( "typo3_src-*" );
if ( empty( $src_dirs ) )
	die( "Kann kein 'typo3_src' Verzeichnis finden!" );
sort( $src_dirs );
$links[ 'typo3_src' ] = array_pop( $src_dirs );

// create symlinks
foreach ( $links as $target => $src ) {
	if ( is_link( $target ) ) unlink( $target );
	if ( ! is_dir( $src ) && ! is_file( $src ) && ! is_link( $src ) )
		die( "Kann '$src' nicht finden also keinen Symlink darauf erstellen" );
	exec( "ln -s \"$src\" \"$target\"" );
}

echo "<h1>Alle Links erfolgreich angelegt</h1>"

?>

Installation: Typo3