Poetry of Programming

Radość z uruchomienia pierwszego projektu w Symfony bardzo często rozwiewana jest następującym komunikatem wyświetlanym na stronie:

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