Congratulations! You have successfully created your symfony project.

Project setup successful

This project uses the symfony libraries. If you see no image in this page, you may need to configure your web server so that it gains access to the symfony_data/web/sf/ directory.

Prawidłowa konfiguracja serwera www wydaje się najbardziej problematyczną częścią instalacji tego frameworka. Całe szczęście nie jest ona tak trudna jak może się wydawać. Ten krótki przewodnik opisuje dwie metody pozwalające szybko i sprawnie ustawić Apacha tak by polubił Symfony .

Zakładam że posiadacie poprawnie zainstalowaną Symfony (jeśli nie opis instalacji znajduje się tu). Ja osobiście pracuje na serwerze www zainstalowanego z paczki WAMP (Apache+MySQL+PHP) i taką instalację odzwierciedlają ścieżki, którymi posługuję się w przykładach.

Sposób 1 – ustawianie virtual hosta

Stworzenie dla każdego swojego projektu w Symfony wirtualnego hosta wydaje się najlepszym sposobem ich zarządzania w fazie tworzenia.

Zatem do dzieła – najpierw potrzebujemy znaleźć katalog zawierający pliki konfiguracyjne Apacha (u mnie będzie to C:\wamp\bin\apache\apache2.2.6\conf) i otworzyć httpd-vhosts.conf (który jest w podkatalogu extra – C:\wamp\bin\apache\apache2.2.6\conf\extra). W nim należy usunąć lub zakomentować (dodając ‘#’ na początku linijki) wszystkie linie co do których nie mamy pewności co robią – jeśli nie my je napisaliśmy to są to pewnie tylko przykłady konfiguracji vhostów).

W Symfony 1.2 (1.1 może też?) przykładowy plik z konfiguracją vhosta jest tworzony dla każdego projektu który wygenerujesz. Można go znaleźć pod config/vhost.sample – i oczywiście może być on wykorzystany zamiast kodu który znajduje się w przykładzie poniżej.

Zatem na końcu naszego pliku dodajemy następujące linijki (oczywiście to tylko jeden z wielu sposobów konfiguracji – można znaleźć masę innych przykładów ustawień vhostów – wszystke są dobre, jeśli tylko działają, prawda? ):

NameVirtualHost *:80

Listen 127.0.0.2:80

<VirtualHost 127.0.0.2:80>

ServerName your_application_name
DocumentRoot “c:\wamp\www\your_project\web”
DirectoryIndex index.php

<Directory “c:\wamp\www\your_project\web”>

AllowOverride All
Allow from All

</Directory>

Alias /sf “c:\wamp\bin\php\php5.2.5\PEAR\data\symfony\web\sf”

<Directory “c:\wamp\bin\php\php5.2.5\PEAR\data\symfony\web\sf”>

AllowOverride All
Allow from All

</Directory>

</VirtualHost>

Oczywiście w linijkach ” Alias /sf “c:\wamp\bin\php\php5.2.5\PEAR\data\symfony\web\sf” ” i ” <Directory “c:\wamp\bin\php\php5.2.5\PEAR\data\symfony\web\sf”> ” należy zastąpić ścieżki poprawną ścieżką do katalogu symfony data. Analogicznie w linijkach ” DocumentRoot “c:\wamp\www\your_project\web” ” oraz ” <Directory “c:\wamp\www\your_project\web”> ” należy umieścić ścieżkę do katalogu web swojego projektu.

Powinniśmy też określić własną nazwę wirtualnego hosta umieszczając ją zamiast your_server_name w linijce ‘ServerName your_server_name’.

Teraz musimy upewnić się, że w pliku httpd.conf (główny plik konfiguracyjny Apacha, który u mnie znajduje się w katalogu   C:\wamp\bin\apache\apache2.2.6\conf) linijka ‘Include conf/extra/httpd-vhosts.conf‘ nie jest zakomentowana (nie ma ‘#’ przed nią).

Pozostaje nam już tylko zadeklarować własną domenę lokalnie przez dodanie linijki ‘127.0.0.2 your_server_name’ (oczywiście zamiast your_server_name wpisz wcześniej zdefiniowaną nazwę wirtualnego hosta) ma końcu pliku host (C:\WINDOWS\system32\drivers\etc) . Linijka ‘127.0.0.1 localhost‘ powinna być pierwszą linijką pliku host. A BTW – jego edycja może wymagać uprawnień administratora.

Teraz – po zresetowaniu Apacha – jeśli wpiszemy w przeglądarce http://your_server_name/ nasza strona powitalna Symfony powinna zawierać wszystkie obrazki.

Sposób 2 – zamrażanie projektu

Możemy otrzymać gotową do wdrożenia paczkę z naszym projektem przez użycie komendy ‘freeze‘ – kopiuje ona wszystkie pliki Symfony do naszego projektu, również te “brakujące” z katalogu web/sf. Wystarczy w katalogu projektu wykonać polecenie:

symfony freeze [c:/sciezka/do/katalogu/symfony/data]

Freeze zmienia także niektóre scieżki określone w konfiguracji, więc nasz projekt teraz będzie odwoływał się do bibliotek Symfony umieszczonych w naszym projekcie a nie tych globalnych. Oczywistym minusem tego rozwiązania jest konieczność zrobienia unfreeze (polecenie przeciwne do freeze) i ponownego freeze dla wszystkich swoich projektów po uaktualnieniu Symfony. Mogą się pojawić również problemy ze ścieżkami jeśli nasz projekt nie będzie znajdował się głównym katalogu naszego serwerwa WWW.

Sposób 3 – ten głupi

Jeśli żadna z powyższych metod nie działa dla Ciebie – zawsze można spróbować skopiować zawartość katalogu ścieżka_do_symfony_data/web/sf/ do  twój_projekt/web/ (zatem w moim wypadku byłoby to przeniesienie plików z katalogu C:\wamp\bin\php\php5.2.5\PEAR\data\symfony\web\sf do C:\wamp\www\twoj_projekt\web). Nie jest to oczywiście najczystsze rozwiązanie – jednym z miusów jest to, że po updacie Symfony może się okazać, że będziemy musieli przekopiować ten folder ręcznie do wszystkich swoich projektów i pojawią się zapewne problemy ze ścieżkami – przy korzystaniu z zasobów pluginów lub przy bezwględnym adresowaniu zasobów (choć jeśli zawsze będziemy korzystać z helperów symfony do generowania ścieżek nie powinno to być żadnym problemem).

Zakładam, że naszym domyślnym środowiskiem jest Windows XP lub Windows Vista i zaczynamy od zera, tzn. nie mamy jeszcze postawionego i skonfigurowanego żadnego serwera WWW.

Co nam będzie potrzebne?

• WAMP (2.0 w chwili pisania)
• i… to wszystko

Z WAMPa już zainstalujemy PEARa a potem dzięki niemu Symfony, ale po kolei:

Część 1 – Instalacja WAMPa

WAMP to samoinstalująca się paczka zawierająca Apacha, MySQLa i PHP 5 (5.2.8+) – czyli dokładnie to co potrzebujemy (i dodatkowo miły dodatek w postaci PhpMyAdmina oraz SQLitemanagera). Oczywiście nie jest to jedyna taka dostępna dystrybucja, podobnie działa np. XAMPP – wybór należy do Ciebie. Można też instalować wszystkie komponenty ręcznie… tylko po co?

WAMP powinien automatycznie wypakować swoje pliki (załóżmy że np. pod C:\wamp) i uruchomić się bezproblemowo. Voila! – działający serwer z domyślną konfiguracją już jest . To nie zajęło za dużo czasu, prawda?

Większość elementów można skonfigurować przez menu skrótów dostępnego po kliknięciu na ikonkę WAMPA. WAMP “mówi” także po polsku – klikając na ikonę w trayu prawym przyciskiem myszy możemy wybrać rodzimy język z listy language.

Jeśli Twój WAMP nie chce poprawnie wystartować twierdząc, np. że port 80 jest już wykorzystywany (a nie masz uruchomionego innego serwera WWW) – przyczyną może być uruchomiony Skype. Domyślnie w opcjach Skype (Zaawansowane >> Połączenie) zaznaczone jest “Użyj portów 80 oraz 443 jako alternatywnych dla połączeń przychodzących” – wystarczy odznaczyć tą pozycję.

Aby Symfony poprawnie działał musimy także uruchomić obsługę PHP-XSL oraz Apache URL Rewrite Module (które domyślnie są wyłączone). Najpierw włączymy moduł Rewrite – klikamy na ikonkę WAMPa i z menu wybieramy Apache >> Moduły Apache i klikamy na rewrite_module (serwer automatycznie się zrestartuje). Teraz czas na XSL – postępując analogicznie PHP >> Rozszerzenia PHP i wybieramy php_xsl. Jednak istnieje jeszcze jeden plik php.ini, którego WAMP czasem nie zmienia (nie wiedzieć czemu) – zatem musimy ręcznie otworzyć C:\wamp\bin\php\php5.2.8\php.ini i usunąć średnik z poniższej linii:

;extension=php_xsl.dll

Teraz powinniśmy dodać zmienne środowiskowe by mięć dostęp do PHP i MySQL pod konsolą. Klikamy prawym przyciskiem myszy na Mój komputer i wybieramy Właściwości, następnie w zakładce Zaawansowane klikamy przycisk Zmienne środowiskowe. W zmiennych systemowych do zmiennej PATH dodajemy na końcu ;C:\wamp\bin\php\php5.2.8;C:\wamp\bin\mysql\mysql5.0.45\bin (ścieżki do naszych plików MySQLa i PHP rozdzielone średnikami).

Część 2 – Instalacja PEARa

PEAR (PHP Extension and Application Repository) to system dystrybucji rozszerzeń do języka PHP. Instalator dołączony jest domyślnie, więc i ten etap nie zajmuje dużo czasu.

Wchodzimy do katalogu PHP w WAMPie (np. C:\wamp\bin\php\php5.2.8\) i odpalamy plik go-pear.bat. Odpowiadamy na pytania instalatora by przygotować konfigurację – domyślna powinna być ok.

W katalogu PHP został dla nas utworzony plik PEAR_ENV.reg, który dla wygody doda nam automatycznie odpowiednie zmienne środowiskowe PEARa – należy go kliknąć dwukrotnie by wstawić odpowiednie dane do rejestru.

Część 3 – Instalacja Symfony

Otwieramy konsolę i wpisujemy:

> pear channel-discover pear.symfony-project.com

Jeśli wszystko się powiedzie ujrzymy:

Adding Channel “pear.symfony-project.com” succeeded
Discovery of channel “pear.symfony-project.com” succeeded

Przyszedł wreszcie ten upragniony czas by zainstalować Symfony:

> pear install symfony/symfony

Ściągnięcie paczki nie powinno trwać długo (~2 MB), a PEAR w pełni automatyzuje cały proces.

Aby zweryfikować czy Symfony zostało zainstalowane poprawnie wpiszmy:

symfony -V

Powinniśmy ujrzeć na ekranie informację zawierającą wersję zainstalowanego przed chwilą frameworka.

Część 4 – Pierwszy projekt w Symfony

Zakładając, że wszystko do tej pory poszło gładko możemy przejść do rzeczy najprzyjemniejszych – zainicjować nasz pierwszy projekt:

> cd C:\wamp\www
> mkdir mojprojekt
> cd mojprojekt
> symfony init-project mojprojekt
> symfony init-app testapp

Dla Symfony 1.2 poprawnym sposobem zainicjowania projektu jest:

> symfony generate:project mojprojekt
> symfony generate:app —escaping-strategy=on —csrf-secret=Unique$ecret testapp

Przy wywolaniu generate:app użyliśmy także dwóch (opcjonalnych) parametrów związanych z bezpieczeństwem:

• –escaping-strategy – Włącza output escaping chroniąc nasz projekt przed atakami XSS
• –csrf-secret – Generuje tokeny chroniąc nas przed atakami CSRF

Tak, Symfony 1.2 chroni nasze projekty przed dwoma najbardziej rozpowszechnionymi atakami w sieci!

Gratulacje!

Efekt swojej pracy możesz zobaczyć pod http://127.0.0.1/mojprojekt/web/

I to byłoby na tyle. Życzę wielu udanych projektów z Symfony w przyszłości

Co dalej?

• Zapraszam do przeczytania mojego poradnika na temat poprawnej konfiguracji Apacha dla projektów Symfony.
• Odwiedzenia oficjalnej strony Symfony i dalszego odkrywania tego frameworka dzięki licznym poradnikom i dobrze napisanej dokumentacji (niestety wciąż bez polskiego tłumaczenia).