Caution: You are browsing the legacy symfony 1.x part of this website.

Symfony-Installation

Projekt-Verzeichnis initialisieren

Vor der Installation von symfony müssen Sie zuerst ein Verzeichnis erstellen, das alle Dateien zu Ihrem Projekt beinhalten wird:

$ mkdir -p /home/sfproject
$ cd /home/sfproject

Oder mit Windows:

c:\> mkdir c:\dev\sfproject
c:\> cd c:\dev\sfproject

note

Windows-Anwender sind gut beraten, den Betrieb von symfony und das Aufsetzen ihres neuen Projekts in einem Pfad durchzuführen, der keine Leerzeichen enthält. Vermeiden Sie das Dokumente und Einstellungen-Verzeichnis, inklusive Allem unter Eigene Dateien.

tip

Wenn Sie das symfony Projekt-Verzeichnis im Webroot-Verzeichnis erstellen, müssen Sie Ihren Web-Server nicht konfigurieren. Für Produktionsumgebungen raten wir natürlich dringend zur Konfiguration Ihres Web-Servers, so wie im Kapitel Webserver-Konfiguration beschrieben.

Die symfony-Version auswählen

Jetzt müssen Sie symfony installieren. Da das symfony-Framework mehrere stabile Versionen hat, müssen Sie die auswählen, die Sie installieren möchten. Lesen Sie dazu die Installations-Seite auf der symfony-Website.

Diese Anleitung geht davon aus, dass Sie die symfony-Version 1.4 installieren möchten.

Den Ort der symfony-Installation auswählen

Sie können symfony global auf Ihrem Rechner installieren, oder Sie betten symfony in jedes Ihrer Projekte ein. Die letztere Variante ist die empfehlenswertere, da die Projekte auf diese Weise absolut unabhängig voneinander sind. Das Upgraden einer solchen lokalen symfony-Installation führt dann nicht zu einer unerwarteten Beschädigung eines Ihrer anderen Projekte. D.h., dass Sie mehrere Projekte mit unterschiedlichen symfony-Versionen betreiben können, und Sie können eines nach dem anderen im geeigneten Moment upgraden.

Als bewährte Methode installieren viele Menschen das symfony-Framework in das Projekt-Verzeichnis lib/vendor. Also, erzeugen Sie jetzt zuerst diese Verzeichnis:

$ mkdir -p lib/vendor

Symfony installieren

Installation aus einem Archiv

Der einfachste Weg symfony zu installieren besteht im Herunterladen des Archivs der Version, die Sie von der symfony-Website ausgesucht haben. Gehen Sie zur Installations-Seite der gewählten Version, z.B. symfony 1.4.

Im Abschnitt "Download as an Archive" finden Sie das Archiv im .tgz oder im .zip Format. Laden Sie das Archiv herunter, speichern es im frisch erstellten Verzeichnis lib/vendor, entpacken es und benennen das Verzeichnis um zu symfony:

$ cd lib/vendor
$ tar zxpf symfony-1.4.8.tgz
$ mv symfony-1.4.8 symfony
$ rm symfony-1.4.8.tgz

Mit Windows kann die zip-Datei mit dem Windows Explorer entpackt werden. Nachdem Sie das Verzeichnis zu symfony umbenannt haben, sollte die Verzeichnis-Struktur ähnlich aussehen wie: c:\dev\sfproject\lib\vendor\symfony.

Installation aus Subversion (empfohlenes Verfahren)

Arbeiten Sie mit Subversion, dann ist es sogar besser, die svn:externals-Eigenschaft zu nutzen, um symfony in Ihr Projekt in das lib/vendor/-Verzeichnis einzubetten:

$ svn pe svn:externals lib/vendor/

Wenn alles glatt läuft wird dieses Kommando Ihren bevorzugten Editor starten und Ihnen die Möglichkeit geben, die externen Subversion-Sourcen zu konfigurieren.

tip

Mit Windows können Sie Tools wie z.B. TortoiseSVN einsetzen. Damit können Sie alles machen ohne die Konsole benutzen zu müssen.

Wenn Sie eher vorsichtig eingestellt sind, knüpfen Sie Ihr Projekt an eine bestimmte Release (ein Subversion-Tag):

svn checkout http://svn.symfony-project.com/tags/RELEASE_1_4_8 symfony

Immer dann, wenn eine neue Release erscheint (angekündigt im symfony Blog, müssen Sie die URL auf die neue Version setzen.

Wollen Sie den Weg an der vordersten Front gehen, dann verwenden Sie den 1.4-Branch:

svn checkout http://svn.symfony-project.com/branches/1.4/ symfony

Durch die Verwendung des Branch profitiert Ihr Projekt automatisch von den Bugfixes, sobald Sie ein svn update starten.