TYPO3 Neos installieren

Die folgenden Schritte zur Installation von TYPO3 Neos sind aus dem Neos-Kompendium entnommen und wurden auf die Besonderheiten bei Hostsharing angepasst.

Systemvoraussetzungen

Das TYPO3 Neos Kompendium nennt die folgenden Systemvoraussetzungen die bei Hostsharing bereits in allen shared hosting Paketen erfüllt sind:

• Webserver (empfohlen ist Apache 2.x mit aktiviertem mod_rewrite Modul)
• PHP 5.3.7 - 5.4.x (minimal wäre PHP 5.3.2 - dort kann es zu Problemen kommen)
• Folgende Funktionen müssen in PHP aktiviert sein: system(), shell_exec(), escapeshellcmd() und escapeshellarg()
• php.ini: memory_limit = 256M oder höher
• php.ini: xdebug.max_nesting_level = 500 (sofern xdebug verwendet wird)
• php.ini: Fügen sie die folgende Optionen ans Ende hinzu: detect_unicode = Off
• php.ini: Zudem muss Magic_Quotes ausgeschaltet werden: magic_quotes_gpc = Off
• php.ini: Die Kommandozeile von Flow benötigt ferner noch eine Zeitzoneneinstellung: date.timezone= "Europe/Berlin"
• MySQL 5.1.50 - 5.x.x (zum Beispiel - grundsätzlich kann jede zum Doctrine DBAL kompatible Datenbank verwendet werden)
• Zugang zur Konsole (root User) TODO: Prüfen - "root" könnte hier bei HS das falsche Wort sein.

Darüber hinaus erfüllt derzeit lediglich die PHP-Kommandozeilenversion (PHP-CLI) nicht die geforderte Versionsnummer von 5.3.7, sondern ist auf dem Stand Debian "Squeeze" php5-cli 5.3.3-7+squeeze18. TODO: Ob dies bei Hostsharing für die Installation kritisch ist, muss noch geprüft werden. Die Versionsnummer alleine sagt im Falle der Debian-Pakete aufgrund der stetig einfließenden Backports aus neueren Original-Paketen wenig aus (siehe Diskussion zum Thema Systemvoraussetzungen bei TYPO3 CMS 6.0).

Die Versionsnummer von PHP-CLI kann mit dem folgenden Befehl in der Kommandozeile überprüft werden:

php --version

Umsetzung der Einstellungen für php.ini

Die php.ini für PHP via FastCGI muss in diesem Verzeichnis liegen:

/home/pacs/xyz00/users/username/doms/example.org/fastcgi

(existiert dort keine php.ini, kann sie manuell leer angelegt werden und anschließend mit einem Editor (z.B. nano) bearbeitet werden):

touch php.ini
nano php.ini

Die nötigen Einstellungen für TYPO3 Neos hier gesammelt als Block für copy&paste an das Ende der php.ini

memory_limit = 256M             ; default ist 128M
;; xdebug.max_nesting_level = 500  ; Einkommentieren sofern xdebug verwendet wird
detect_unicode = Off
date.timezone= "Europe/Berlin"
magic_quotes_gpc = Off

Zum Erzwingen einer direkten Übernahme der Änderungen an der php.ini bei FastCGI müssen die PHP Prozesse des Users neu gestartet werden. Es ist im Folgenden keine Ersetzung von $USER nötig:

killall php -u $USER

Notwendige Schritte zur Installation

1. Composer herunterladen und installieren
2. TYPO3 Neos und Abhängigkeiten herunterladen, installieren und konfigurieren

(Insbesondere ist es nicht erforderlich, dass TYPO3 CMS installiert wird, da TYPO3 CMS und TYPO3 Neos keinerlei technische Gemeinsamkeiten besitzen.)

Optional: Virtuellen Host einrichten

Das Neos Kompendium empfiehlt dass man einen eigenen virtuellen Host in seiner Apache-Konfiguration einrichtet. Dies ist bei Hostsharing nur dann manuell erforderlich wenn ein Rootserver gebucht wurde oder auf einem lokalen Apache (kostenpflichtige Option "Betrieb eines eigenen Serverdienstes") entwickelt wird.

Notwendigkeit der Paket-Option "Betrieb eines eigenen Serverdienstes"

Mit der Paket-Option "Betrieb eines eigenen Serverdienstes" lässt sich ein eigener Apache (oder nginx, oder ...) betreiben und nach eigenen Vorstellungen frei konfigurieren. Dies ist allerding nur erforderlich wenn

1. TYPO3 Neos mit der Hostsharing Standard-Konfiguration nicht funktioniert oder
2. die Performance von PHP über FastCGI für eine Seite mit hohem Traffic nicht ausreicht.

Die Installation eines eigenen Apache ist im HS-Wiki unter Apache installieren beschrieben.

Ohne Paket-Option "Betrieb eines eigenen Serverdienstes"

Auf Hostsharing Systemen läuft für die shared Hosting-Pakete ein zentraler Apache, der standardmäßig die Anfragen für die in den Paketen aufgeschalteten Domains verarbeitet und die Webseiten ausliefert.

Durch ein zentrales Template wird für jede aufgeschaltete Domain im Apache automatisch (von hsadmin) ein Virtual Host eingerichtet. Die Konfiguration lässt sich lediglich durch einige der HSAdmin-Domain-Options beeinflussen die Konfiguration.

Zentrales Template des Virtual Hosts für shared hosting-Pakete

Als Template-"Sprache" kommt velocity zum Einsatz. Template des Virtual Hosts so wie es beim Apachen über PHP via FastCGI bei HS betrieben wird:

TODO: Hier Template des Virtual Hosts einfügen

Composer herunterladen und installieren

Composer ist ein Dependency Manager für PHP. Mit diesem Befehl wird Composer heruntergeladen und die Datei composer.phar im aktuellen Verzeichnis angelegt:

curl -sS https://getcomposer.org/installer | php

TYPO3 Neos und Abhängigkeiten herunterladen und installieren

Composer sorgt für das Herunterladen von TYPO3 Neos und TYPO3 Flow mitsamt der benötigten Module (z.B. Doctrine 2, Aloha, ...). Hierzu ist dieser Befehl nötig (alles in einer Zeile):

php /home/pacs/xyz00/users/username/doms/example.org/composer.phar create-project typo3/neos-base-distribution TYPO3-Neos

Document root für TYPO3 Neos

Nach der Installation von TYPO3 Neos muss das "document root" auf folgendes Verzeichnis zeigen:

/home/pacs/xyz00/users/username/doms/example.org/TYPO3-Neos/Web

Dieses Verzeichnis wurde durch Composer bei der Installation automatisch angelegt und enthält alle Dateien von TYPO3 Neos.