Dieses kurze Tutorial beschreibt eine Typo3-Installation (v4.2.1) unter Debian etch mit Zend Core (v2.5). Dieses System ist nicht für den produktiven Einsatz im Web gedacht sondern sollte nur als Entwicklungssystem (z.B. für ein Laptop bzw. Workstation) eingesetzt werden.
Es wird davon ausgegangen, dass Debian etch und Zend Core inkl. MySQL (v5) fertig installiert vorliegt und läuft. Ein vhost-Eintrag und ein host-Eintrag z.B. meintypo3projekt.localhost sollten ebenfalls fertig vorliegen. Zur Einfachheit wird nachfolgend der Document-Root des vhosts meintypo3projekt.localhost als Doc-Root bezeichnet.
1. Schritt (Download): Die Pakete Dummy.tar.gz und Source.tar.gz von http://typo3.org/download/packages/ besorgen und in einem temporären Ordner (z.B. auf dem Desktiop) speichern.
2. Schritt (Extraction): Die Pakete entpacken
tar -xvzf typo3_src-4.2.1.tar.gz tar -xvzf dummy-4.2.1.tar.gz
3. Schritt (Merge): Die Pakete zusammen führen
Im Verzeichnis dummy-4.2.1 sehen wir einige Verzeinisse, die einen symbolischen Link auf unsere Sourcen (typo3_src-4.2.1) haben. Kopieren wir nun den Inhalt des Dummy-Verznisses in unseren Doc-Root, so müssen die Sourcen ebenfalls kopiert werden und zwar parallel dazu.
Das könnte am Ende so aussehen:
/srv/www/meintypo3projekt/htdocs/ [Inhalt von dummy-4.2.1]
/srv/www/meintypo3projekt/typo3_src-4.2.1/ [Inhalt von typo3_src-4.2.1]
4. Schritt (Test): Testen wir nun nach unserer Kopieraktion die symbolischen Links:
cd /srv/www/meintypo3projekt/htdocs/typo3_src
sollte uns ins Verzeichnis /srv/www/meintypo3projekt/typo3_src_4.2.1 führen.
Wenn das nicht der Fall ist kann mit dem Befehl:
ln -s /srv/www/meintypo3projekt/htdocs/typo3_src /srv/www/meintypo3projekt/typo3_src-4.2.1
der symbolische Link neu gesetzt werden.
5. Schritt (Rights): Rechte setzen
Der wohl wichtigste Schritt ist das setzen der Verzenisrechte damit Konfigurations und Cachedateien geschrieben werden können. ZendCore startet den Apache2 als nobody:nogroup. Die Befehle lauten somit:
sudo chown -R nobody:nogroup htdocs/* sudo chown -R nobody:nogroup typo3_src-4.2.1/*
wir befinden uns dabei eine Ebene über dem Doc-Root.
6. Schritt (mod_rewrite):
mv _.htaccess .htaccessaktviert die entsprechenden Rewrite-Rules unter Typo3.
Verwendet man in seiner Apache vhost Konfiguration die Directive “VirtualDocumentRoot” kann unter Umständen das auskommentieren von “RewriteBase /” nötig sein.
7. Schritt (Installer): Im Browser wird nun das Projekt aufgerufen. Es erscheint die Meldung “The Install Tool is locked.”
Ein touch typo3conf/ENABLE_INSTALL_TOOL im Doc-Root Verzeinis aktiviert den Installer, der mit einem Reload der Seite neu gestartet werden kann. Der Installer ist selbsterklärend und sollte problemlos durch die Installation führen. Im Anschluss ist die Datei ENABLE_INSTALL_TOOL wieder zu löschen.
Die abschließenden Hinweise im Install-Tool unter “Important” sollte man mindestens mal gelesen haben.
Optionaler 8. Schritt (utf8):
http://wiki.typo3.org/index.php/UFT-8_support
Meine Erfahrungen dazu:
Die Anweisungen im Wiki sind sehr leicht zu befolgen, die Aktivierung der Extension “iconv” ist z.B. über http://localhost/ZendCore unter Configuration/Extensions sehr leicht durchzuführen. Die Änderung der php.ini was “mbstring.internal_encoding” betrifft würde ich eher in ans Ende der .htaccess schieben (php_value mbstring.internal_encoding UTF-8, php_flag mbstring.encoding_translation on), genauso “AddDefaultCharset utf-8″. Die my.cf würde ich ebenfalls nicht bearbeiten. Der Rest betrifft die Typo3 Konfiguration, die sich über das Backend unter dem Punkt Install befindet. Einzig die Konvertierung der Datenbank erfordert ein bisschen mehr Zeit.
Wenn man die Möglichkeiten hat, sollte man generell auf UTF-8 umstellen. Ob auf dem Zielsystem UTF-8 aktiviert werden kann sollte allerdings vorher überprüft werden!
Sonstiges:
ImageMagick:
sudo apt-get install imagemagick
anschließend im Typo3 Install Tool: Pfad /usr/local/bin verwenden
Tags: debian, typo3 installation, zend core