Poetry of Programming

Jak szybko i przyjemnie zainstalować Symfony Framework pod Windowsem? 15 minutowy poradnik, aby błyskawicznie rozpocząć zabawę.

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 - czyli dokładnie to co potrzebujemy (i dodatkowo miły dodatek w postaci Phpmyadmina oraz SQLitemanager). 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 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 nie zmienia (nie wiedzieć czemu) - zatem musimy ręcznie otworzyć C:\wamp\bin\php\php5.2.5\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.5;C:\wamp\bin\mysql\mysql5.0.45\bin (ścieżki do 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.5\) i odpalamy plik go-pear.bat. Odpowiadamy na pytania instalatora by przygotować konfigurację - domyślna powinna być ok, zatem możemy postępować tak:

• [Enter] (wartość domyślna) - jeśli chcemy zainstalować PEARa w całym systemie.
• [Enter] - jeśli nie chcemy zmieniać układu katalogów.
• Y - wyrażamy zgodę na modyfikację php.ini (dodaje PEARa do include_path).
• I [Enter] dwa razy zakończyć instalację.

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.

Warto również skopiować plik pear.bat z katalogu PHP do C:\Windows\System32\ dzięki czemu będziemy mieli do niego dostęp z konsoli w każdym miejscu (przy czym należy pamiętać, że po uaktualnieniu PEARa należy go ponownie skopiować ręcznie).

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.

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

Gratulacje! Efekt pracy Symfony 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