Instalacja symfony

Tworzenie katalogu projektu

Przed instalacją symfony, na początku musisz stworzyć katalog, w którym będziesz trzymać wszystkie plik związane z Twoim projektem:

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

Lub w Windows-ie:

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

Wybór wersji Symfony

Teraz możesz zainstalować symfony. Framework symfony ma kilka stabilnych wersji i powinieneś wybrać, która z nich chcesz zainstalować, po przeczytaniu strony o instalacji na symfony.pl lub
instalation page na na oficjalnej stronie symfony.

W tym przewodniku zakładamy, że chcesz zainstalować symfony w wersji 1.3.

Wybór katalogu do instalacji symfony

Możesz zainstalować symfony globalnie dla całej maszyny lub ograniczyć się do Twojego projektu. Druga metoda jest zalecana tylko gdy projekt jest całkowicie niezwiązany z pozostałymi. Aktualizacja symfony w takim odseparowam projekcie nie spowoduje żadnych problemów w pozostałych projektach. Oznacza to, że możesz mieć różne projekty, z różnymi wersjami symfony i aktualizować je jeden po drugim wg Twojej potrzeby.

Wśród wielu użytkowników, przyjęła się praktyka, że framework symfony instalowany jest w katalogu projektu lib/vendor. Na początku utwórzmy sobie taki katalog:

$ mkdir -p lib/vendor

Instalacja Symfony

Instalacja z spakowanego pliku

Najłatwiejszą formą instalacji symfony, jest pobranie spakowanego pliku z wybraną na stronie wersją symfony. Aby to zrobić, przejdź na stronę instalacyjną wersji symfony 1.3 for instance.

Pod linkiem "Źródło" lub "Source Download", znajdziesz pliki archiwum .tgz lub .zip. Pobierz plik archiwum i umieść go w nowo utworzonym katalogu lib/vendor/, rozpakuj go i zmień nazwę katalogu na symfony:

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

W Windowsie, możesz rozpakować plik zip, korzystając Explorera Windows. Po zmianie nazwy katalogu na symfony, struktura katalogów powinna być podobna do c:\dev\sfproject\lib\vendor\symfony.

Instalacja z repozytorium Subversion (zalecane)

Jeśli korzystasz z Subversion, dużo lepiej jest skorzystać z atrybutu svn:externals aby umiejścić symfony w projekcie w katalogu lib/vendor/:

$ svn pe svn:externals lib/vendor/

Jeżeli nie będzie problemów, powyższa komenda uruchomi domyślny edytor, dając Ci dostęp do konfiguracji zewnętrznego repozytorium Subversion.

Jeśli jesteś tradycjonallistą, możesz również ograniczyć się do ściśle określonego wydania (subversion tag):

symfony http://svn.symfony-project.com/tags/RELEASE_1_3_0

Za każdym razem, gdy zostanie wydana nowa wersja (dowiesz się o tym na oficjalnym blogu), wtedy będziesz musiał/a zmienić adres URL na nową wersję.

Jeśli chcesz zaufać naszym aktualizacjion, skorzystać z branchy 1.3:

symfony http://svn.symfony-project.com/branches/1.3/

Korzystając z branchy, ustrzeżesz projekt od odkrytych błędów dzięki automatycznej aktualizacji, za każdym razem gdy wywołasz svn update.

Weryfikacja instalacji

Gdy symfony mamy już zainstalowane, sprawdź czy wszystko udało się pomyślnie podając w wierszu poleceń, komendę wyświetlającą wersję symfony (pamiętaj o dużej literze V):

$ cd ../..
$ php lib/vendor/symfony/data/bin/symfony -V

Lub w Windowsie:

c:\> cd ..\..
c:\> php lib\vendor\symfony\data\bin\symfony -V

Opcja -V wyświetla również ścieżkę do katalogu instalacyjnego symfony, która jest określona w pliku config/ProjectConfiguration.class.php.

Jeżeli ścieżka do symfony jest absolutna, a nie relatywna (domyślnie nie powinna być, jeśli podążałeś/aś wg powyższej instrukcji), zmień to, żeby zachować lepszą migrowalność projektu:

// config/ProjectConfiguration.class.php
require_once dirname(__FILE__).'/../lib/vendor/symfony/lib/autoload/sfCoreAutoload.class.php';

Dzięki temu, możesz przenosić katalog projektu gdziekolwiek na maszynie lub na inny komputer i będzie on działać bez problemów.

$ php lib/vendor/symfony/data/bin/symfony

c:\> php lib\vendor\symfony\data\bin\symfony