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).