|
|
@@ -12,10 +12,10 @@
|
|
|
<title>Instalacja Zend Framework</title>
|
|
|
|
|
|
<para>
|
|
|
- Najprostszym sposobem pobrania Zend Framework razem z całym środowiskiem PHP jest
|
|
|
+ Najprostszym sposobem pobrania Zend Framework razem z całym środowiskiem PHP jest
|
|
|
zainstalowanie
|
|
|
<ulink url="http://www.zend.com/en/products/server-ce/downloads">Zend Server</ulink>.
|
|
|
- Zend Server zawiera instalatory dla Mac OSX, Windows, Fedora Core oraz Ubuntu.
|
|
|
+ Zend Server zawiera instalatory dla Mac OSX, Windows, Fedora Core oraz Ubuntu.
|
|
|
Oprócz tego dostępna jest uniwersalna paczka instalacyjna kompatybilna z większością
|
|
|
dystrybucji Linux.
|
|
|
</para>
|
|
|
@@ -29,14 +29,14 @@
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Alternatywnie można <ulink url="http://framework.zend.com/download/latest">pobrać
|
|
|
+ Alternatywnie można <ulink url="http://framework.zend.com/download/latest">pobrać
|
|
|
najnowszą wersję Zend Framework</ulink> i rozpakować zawartość do dowolnego katalogu;
|
|
|
należy zapamiętać wybraną lokalizację instalacji.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Opcjonalnie w pliku <filename>php.ini</filename> można umieścić w
|
|
|
- zmiennej <constant>include_path</constant> ścieżkę do
|
|
|
+ Opcjonalnie w pliku <filename>php.ini</filename> można umieścić w
|
|
|
+ zmiennej <constant>include_path</constant> ścieżkę do
|
|
|
podkatalogu <filename>library/</filename> znajdującego się w pobranym archiwum.
|
|
|
</para>
|
|
|
|
|
|
@@ -54,7 +54,7 @@
|
|
|
<para>
|
|
|
W katalogu instalacji Zend Framework znajduje się podkatalog
|
|
|
<filename>bin/</filename>.
|
|
|
- Zawiera on skrypty <filename>zf.sh</filename> oraz <filename>zf.bat</filename>
|
|
|
+ Zawiera on skrypty <filename>zf.sh</filename> oraz <filename>zf.bat</filename>
|
|
|
odpowiednio dla użytkowników Unix oraz Windows. Należy zapamiętać ścieżkę dostępu
|
|
|
do tych skryptów.
|
|
|
</para>
|
|
|
@@ -73,8 +73,8 @@
|
|
|
</note>
|
|
|
|
|
|
<para>
|
|
|
- Aby utworzyć nowy projekt należy otworzyć terminal (dla Windows - wiersz polecenia
|
|
|
- <command>Start -> Run</command> i polecenie <command>cmd</command>). Należy przejść do
|
|
|
+ Aby utworzyć nowy projekt należy otworzyć terminal (dla Windows - wiersz polecenia
|
|
|
+ <command>Start -> Run</command> i polecenie <command>cmd</command>). Należy przejść do
|
|
|
katalogu nowego projektu. Następnie, używając ścieżki do odpowiedniego skryptu, należy
|
|
|
wywołać następujące polecenie:
|
|
|
</para>
|
|
|
@@ -119,7 +119,7 @@ quickstart
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- W tym momencie, jeśli Zend Framework nie jest umieszczony w zmiennej
|
|
|
+ W tym momencie, jeśli Zend Framework nie jest umieszczony w zmiennej
|
|
|
<constant>include_path</constant>, zaleca się przekopiowanie lub umieszczenie
|
|
|
linku symbolicznego do podkatalogu <filename>library/</filename> projektu.
|
|
|
Najistotniejszy jest aby zawartość katalogu <filename>library/Zend/</filename>
|
|
|
@@ -152,7 +152,7 @@ quickstart
|
|
|
Klasa <classname>Bootstrap</classname> definiuje zasoby i komponenty do inicjalizacji.
|
|
|
Domyślnie uruchamiany jest <link linkend="zend.controller.front">Front Controller</link>
|
|
|
ze standardowym katalogiem w którym szukane są kontrolery akcji (o których mowa później)
|
|
|
- ustawionym na <filename>application/controllers/</filename>. Klasa przedstawia się
|
|
|
+ ustawionym na <filename>application/controllers/</filename>. Klasa przedstawia się
|
|
|
następująco:
|
|
|
</para>
|
|
|
|
|
|
@@ -174,7 +174,7 @@ class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
|
|
|
|
|
|
<para>
|
|
|
Sam Zend Framework nie wymaga konfiguracji ale tworzona aplikacja - najczęściej tak.
|
|
|
- Standardowo plik konfiguracyjny umieszczony jest w
|
|
|
+ Standardowo plik konfiguracyjny umieszczony jest w
|
|
|
<filename>application/configs/application.ini</filename>. Zawiera on podstawowe
|
|
|
instrukcje ustawienia środowiska PHP (np. włączanie/wyłączanie raportowania błędów),
|
|
|
wskazanie ścieżki i klasy <classname>Bootstrap</classname> oraz ścieżkę do katalogu
|
|
|
@@ -210,7 +210,7 @@ phpSettings.display_errors = 1
|
|
|
w pliku INI, można bezpośrednio używać stałych; <constant>APPLICATION_PATH</constant>
|
|
|
to stała PHP (opisana później). Dodatkowo, zdefiniowane zostały oddzielne sekcje:
|
|
|
production, staging, testing oraz development. Ostatnie trzy dziedziczą ustawienia ze
|
|
|
- środowiska produkcyjnego (production). Podany sposób stanowi użyteczny przykład
|
|
|
+ środowiska produkcyjnego (production). Podany sposób stanowi użyteczny przykład
|
|
|
organizacji konfiguracji, dzięki której odpowiednie ustawienia są dostępne w
|
|
|
odpowiednim momencie cyklu rozwoju oprogramowania.
|
|
|
</para>
|
|
|
@@ -220,8 +220,8 @@ phpSettings.display_errors = 1
|
|
|
<title>Kontrolery akcji (action controllers)</title>
|
|
|
|
|
|
<para>
|
|
|
- Zawarte w aplikacji <emphasis>kontrolery akcji</emphasis> przechowują ścieżki
|
|
|
- działania programu i odwzorowują żądania na odpowiednie modele i widoki.
|
|
|
+ Zawarte w aplikacji <emphasis>kontrolery akcji</emphasis> przechowują ścieżki
|
|
|
+ działania programu i odwzorowują żądania na odpowiednie modele i widoki.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -311,9 +311,9 @@ class ErrorController extends Zend_Controller_Action
|
|
|
|
|
|
<para>
|
|
|
Widoki (view scripts) w Zend Framework są napisane w starym dobrym PHP. Domyślnie
|
|
|
- znajdują się w <filename>application/views/scripts/</filename>, gdzie są w dalszym
|
|
|
+ znajdują się w <filename>application/views/scripts/</filename>, gdzie są w dalszym
|
|
|
stopniu dzielone wg. kontrolerów do których należą. W obecnym przypadku istnieją
|
|
|
- dwa kontrolery: <classname>IndexController</classname> oraz
|
|
|
+ dwa kontrolery: <classname>IndexController</classname> oraz
|
|
|
<classname>ErrorController</classname>. Oznacza to, że w katalogu widoków powinny się
|
|
|
znaleźć dwa podkatalogi: <filename>index/</filename> oraz <filename>error/</filename>.
|
|
|
W nich należy umieścić skrypty widoków odpowiednie dla każdej z akcji danego kontrolera.
|
|
|
@@ -425,8 +425,8 @@ class ErrorController extends Zend_Controller_Action
|
|
|
|
|
|
<para>
|
|
|
Na potrzeby tego wprowadzenia, założono użycie <ulink url="http://httpd.apache.org/">
|
|
|
- web serwera Apache</ulink>. Zend Framework działa równie dobrze z innymi
|
|
|
- serwerami - włączając Microsoft Internet Information Services, lighttpd, nginx i
|
|
|
+ web serwera Apache</ulink>. Zend Framework działa równie dobrze z innymi
|
|
|
+ serwerami - włączając Microsoft Internet Information Services, lighttpd, nginx i
|
|
|
wiele innych. Większość deweloperów jednak jest najbardziej zaznajomiona z Apache, który
|
|
|
ułatwia zrozumienie struktury katalogów Zend Framework i posiada szerokie możliwości
|
|
|
przepisywania linków (mod_rewrite).
|
|
|
@@ -491,21 +491,21 @@ class ErrorController extends Zend_Controller_Action
|
|
|
<para>
|
|
|
Należy zwrócić uwagę na kilka szczegółów. Po pierwsze, <varname>DocumentRoot</varname>
|
|
|
wskazuje na podkatalog projektu o nazwie <filename>public</filename>. To oznacza, że
|
|
|
- jedynie pliki znajdujące się w tym podkatalogu mogą być zwracane przez serwer
|
|
|
- bezpośrednio. Po drugie, instrukcje <varname>AllowOverride</varname>,
|
|
|
+ jedynie pliki znajdujące się w tym podkatalogu mogą być zwracane przez serwer
|
|
|
+ bezpośrednio. Po drugie, instrukcje <varname>AllowOverride</varname>,
|
|
|
<varname>Order</varname> oraz <varname>Allow</varname> umożliwiają stosowanie plików
|
|
|
<filename>htacess</filename> w projekcie. W środowisku programistycznym (development)
|
|
|
jest to uznawane za dobrą praktykę ponieważ eliminuje potrzebę resetowania
|
|
|
serwera po każdej zmianie instrukcji konfiguracyjnych. Jednak w środowisku produkcyjnym
|
|
|
(production), zalecane jest przeniesienie zawartości pliku <filename>htaccess</filename>
|
|
|
- do głównego pliku konfiguracyjnego serwera oraz wyłączenie obsługi
|
|
|
+ do głównego pliku konfiguracyjnego serwera oraz wyłączenie obsługi
|
|
|
<filename>htaccess</filename>. Po trzecie, instrukcja
|
|
|
<varname>SetEnv</varname> pozwala zainicjować zmienną środowiskową oraz
|
|
|
przekazać ją do PHP i <filename>index.php</filename>.
|
|
|
Dzięki temu stanie się ona podstawą stałej
|
|
|
<constant>APPLICATION_ENV</constant> aplikacji Zend Framework.
|
|
|
- W środowisku produkcyjnym można ją ustawić na "production" lub zrezygnować
|
|
|
- z tej instrukcji ("production" jest domyślną wartością stałej
|
|
|
+ W środowisku produkcyjnym można ją ustawić na "production" lub zrezygnować
|
|
|
+ z tej instrukcji ("production" jest domyślną wartością stałej
|
|
|
<constant>APPLICATION_ENV</constant>).
|
|
|
</para>
|
|
|
|
tomeks