diff --git a/docs/guide-pl/caching-fragment.md b/docs/guide-pl/caching-fragment.md new file mode 100644 index 0000000..b55fc17 --- /dev/null +++ b/docs/guide-pl/caching-fragment.md @@ -0,0 +1,165 @@ +Pamięć podręczna fragmentów +=========================== + +Pamięć podręczna fragmentów dotyczy zapisywania w pamięci podręcznej części strony Web. Dla przykładu, jeśli strona wyświetla podsumowanie danych rocznej sprzedaży w postaci tabeli, +można tę tabelę zapisać w pamięci podręcznej, aby wyeliminować konieczność generowania jej za każdym razem od nowa. Mechanizm pamięci podręcznej fragmentów zbudowany jest w oparciu +o [pamięć podręczną danych](caching-data.md). + +Aby wykorzystać pamięć podręczną fragmentów, należy użyć następującego kodu w [widoku](structure-views.md): + +```php +if ($this->beginCache($id)) { + + // ... generowanie zawartości w tym miejscu ... + + $this->endCache(); +} +``` + +Jak widać, chodzi tu o zamknięcie bloku generatora zawartości pomiędzy wywołaniem metod [[yii\base\View::beginCache()|beginCache()]] i [[yii\base\View::endCache()|endCache()]]. +Jeśli wskazana zawartość zostanie odnaleziona w pamięci podręcznej, [[yii\base\View::beginCache()|beginCache()]] wyrenderuje zapisaną zawartość i zwróci false, przez co pominie +blok jej generowania. W przeciwnym wypadku generowanie zostanie uruchomione, a w momencie wywołania [[yii\base\View::endCache()|endCache()]] wygenerowana zawartość zostanie zapisana +w pamięci podręcznej. + +Tak, jak w przypadku [pamięci podręcznej danych](caching-data.md), unikalne `$id` jest wymagane do identyfikacji zawartości. + + +## Opcje zapisu w pamięci podręcznej + +Możesz określić dodatkowe opcje zapisu pamięci podręcznej fragmentów, przekazując tablicę opcji jako drugi parametr w metodzie [[yii\base\View::beginCache()|beginCache()]]. +Opcje te będą użyte do skonfigurowania widżetu [[yii\widgets\FragmentCache|FragmentCache]], który implementuje właściwą funkcjonalność zapisu pamięci podręcznej. + +### Czas życia + +Prawdopodobnie najczęściej używaną opcją zapisu fragmentów jest [[yii\widgets\FragmentCache::duration|duration]]. +Parametr ten określa, przez ile sekund zawartość może być przechowywana w pamięci podręcznej, zanim konieczne będzie wygenerowanie jej ponownie. Poniższy kod zapisuje fragment +zawartości w pamięci podręcznej na maksymalnie godzinę: + +```php +if ($this->beginCache($id, ['duration' => 3600])) { + + // ... generowanie zawartości w tym miejscu ... + + $this->endCache(); +} +``` + +Jeśli ta opcja nie jest określona, przyjmuje domyślną wartość 60, co oznacza, że ważność zapisanej zawartości wygaśnie po upływie 60 sekund. + + +### Zależności + +Tak, jak w przypadku [pamięci podręcznej danych](caching-data.md#cache-dependencies), zapis fragmentów może opierać się na zależnościach. +Dla przykładu, zawartość wyświetlanego posta zależy od tego, czy został on zmodyfikowany, bądź nie. + +Aby określić zależność, należy ustawić opcję [[yii\widgets\FragmentCache::dependency|dependency]], która może przyjąć postać zarówno obiektu klasy [[yii\caching\Dependency|Dependency]], +jak i tablicy konfiguracyjnej, służacej do utworzenia obiektu zależności. Poniższy kod określa pamięć podręczną fragmentu jako zależną od zmiany wartości kolumny `updated_at`: + +```php +$dependency = [ + 'class' => 'yii\caching\DbDependency', + 'sql' => 'SELECT MAX(updated_at) FROM post', +]; + +if ($this->beginCache($id, ['dependency' => $dependency])) { + + // ... generowanie zawartości w tym miejscu ... + + $this->endCache(); +} +``` + + +### Wariacje + +Zapisana zawartość może mieć kilka wersji, zależnych od niektórych parametrów. Przykładowo, w aplikacji Web wspierającej kilka języków, ten sam fragment kodu w widoku może generować +zawartość w różnych językach. Z tego powodu wymagana może być konieczność zapisu zawartości w wariacji zależnej od aktualnie wybranego języka aplikacji. + +Aby określić wariacje pamięci podręcznej, ustaw opcję [[yii\widgets\FragmentCache::variations|variations]], która powinna mieć postać tablicy wartości skalarnych, z których każda +będzie reprezentować odpowiedni czynnik modyfikujący wersję. Dla prykładu, aby zapisać zawartość w zależności od języka, możesz użyć następującego kodu: + +```php +if ($this->beginCache($id, ['variations' => [Yii::$app->language]])) { + + // ... generowanie zawartości w tym miejscu ... + + $this->endCache(); +} +``` + + +### Warunkowe uruchamianie pamięci podręcznej + +Czasem konieczne może być uruchamianie pamięci podręcznej fragmentów tylko w przypadku, gdy spełnione są określone warunki. Przykładowo, dla strony zawierającej formularz, +pożądane może być zapisanie i wyświetlenie go z pamięci podręcznej tylko w momencie pierwszego pobrania jego treści (poprzez żądanie GET). Każde kolejne żądanie wyświetlenia formularza +(już za pomocą metody POST) nie powinno być zapisane w pamięci, ponieważ może zawierać dane podane przez użytkownika. +Aby użyć takiego mechanizmu, należy ustawić opcję [[yii\widgets\FragmentCache::enabled|enabled]], jak w przykładzie poniżej: + +```php +if ($this->beginCache($id, ['enabled' => Yii::$app->request->isGet])) { + + // ... generowanie zawartości w tym miejscu ... + + $this->endCache(); +} +``` + + +## Zagnieżdżony zapis w pamięci + +Fragmenty zapisane w pamięci podręcznej mogą być zagnieżdżane. Oznacza to, że zapisany fragment może być częścią innego, również zapisanego w pamięci podręcznej. +Przykładowo, komentarze mogą być zapisane jako fragmenty w pamięci podręcznej, które z kolei w całości również są zapisane jako większy fragment w pamięci. +Poniższy kod pokazuje, w jaki sposób można zagnieździć dwa fragmenty w pamięci podręcznej: + +```php +if ($this->beginCache($id1)) { + + // ... generowanie zawartości ... + + if ($this->beginCache($id2, $options2)) { + + // ... generowanie zawartości ... + + $this->endCache(); + } + + // ... generowanie zawartości ... + + $this->endCache(); +} +``` + +Zagnieżdżone fragmenty mogą mieć różne opcje zapisu. Dla przykładu, wewnętrzny i zewnętrzy fragment może mieć inną wartość czasu życia. Nawet w przypadku, gdy zawartość zapisana +w zewnętrznym fragmencie straci ważność, wewnętrzny fragment wciąż będzie pobierany z pamięci. Nie zadziała to jednak w przeciwnym przypadku - dopóki zewnętrzny fragment będzie ważny, +będzie zwracał tą samą zawartość za każdym razem, niezależnie od tego, czy zawartość wewnętrznego fragmentu już wygasła, czy nie. Z tego powodu należy zwrócić szczególną ostrożność +przy ustalaniu czasu życia lub zależności zagnieżdżonych fragmentów, ponieważ "stara" zawartość może być wciąż niezamierzenie przechowywana w zewnętrznym fragmencie. + + +## Dynamiczna zawartość + +Używając pamięci podręcznej fragmentów, można napotkać na sytuację, kiedy duża część zawartości strony jest względnie statyczna z wyjątkiem kilku nielicznych miejsc. +Przykładowo, nagłówek strony może wyświetlać pasek głównego menu razem z imieniem aktualnie zalogowanego użytkownika. Innym kłopotem może być to, że zapisywana w pamięci zawartość +może zawierać kod PHP, który musi być wykonany dla każdego żądania (np. kod rejestrujący paczkę assetów). W obu tych przypadkach pomoże nam skorzystanie z funkcjonalności tzw. +*dynamicznej zawartości*. + +Dynamiczna zawartość oznacza fragment zwrotki, który nie powinien zostać zapisany w pamięci podręcznej, nawet jeśli znajduje się w bloku objętym zapisem. Aby określić zawartość jako +dynamiczną, musi być ona generowana poprzez wykonanie jakiegoś kodu PHP dla każdego zapytania, nawet jeśli całość fragmentu serwowana jest z pamięci podręcznej. + +Możesz wywołać metodę [[yii\base\View::renderDynamic()|renderDynamic()]] wewnątrz zapisywanego fragmentu, aby wstawić w danym miejscu zawartość dynamiczną, jak w przykładzie poniżej: + +```php +if ($this->beginCache($id1)) { + + // ... generowanie zawartości ... + + echo $this->renderDynamic('return Yii::$app->user->identity->name;'); + + // ... generowanie zawartości ... + + $this->endCache(); +} +``` + +Metoda [[yii\base\View::renderDynamic()|renderDynamic()]] przyjmuje jako parametr kod PHP. +Wartość zwracana przez ten kod jest traktowana jako zawartość dynamiczna. Ten sam kod PHP będzie wykonany dla każdego zapytania, niezależnie od tego, czy obejmujący go fragment będzie +pobierany z pamięci podręcznej czy też nie. diff --git a/docs/guide-pl/db-active-record.md b/docs/guide-pl/db-active-record.md index 9de9ef0..550a1c8 100644 --- a/docs/guide-pl/db-active-record.md +++ b/docs/guide-pl/db-active-record.md @@ -1035,9 +1035,30 @@ Zwróć uwagę na to, że ten przykład różni się od poprzedniego, gdzie pobi > Info: Jeśli [[yii\db\ActiveQuery|ActiveQuery]] zawiera warunek podany za pomocą [[yii\db\ActiveQuery::onCondition()|onCondition()]], > będzie on umieszczony w części instrukcji `ON` tylko jeśli kwerenda zawiera JOIN. W przeciwnym wypadku warunek ten będzie automatycznie -> dodany do części `WHERE`. +> dodany do części `WHERE`. Może zatem składać się z warunków opierających się tylko na kolumnach powiązanej tabeli. +#### Aliasy dołączanych tabeli + +Jak już wspomniano wcześniej, używając JOIN w kwerendzie, musimy ujednoznacznić nazwy kolumn. Z tego powodu często stosuje się aliasy dla tabel. +Alias dla kwerendy relacyjnej można ustawić, modyfikując ją w następujący sposób: + +```php +$query->joinWith([ + 'orders' => function ($q) { + $q->from(['o' => Order::tableName()]); + }, +]) +``` + +Powyższy sposób wygląda jednak na bardzo skomplikowany i wymaga ręcznej modyfikacji w kodzie nazwy tabeli obiektu relacji lub wywołania `Order::tableName()`. +Od wersji 2.0.7, Yii udostępnia do tego celu skróconą metodę. Możliwe jest zdefiniowanie i używanie aliasu dla tabeli relacji w poniższy sposób: + +```php +// dołącz relację 'orders' i posortuj wyniki po 'orders.id' +$query->joinWith(['orders o'])->orderBy('o.id'); +``` + ### Odwrócone relacje Deklaracje relacji są zazwyczaj obustronne dla dwóch klas Active Record. Przykładowo `Customer` jest powiązany z `Order` poprzez relację `orders`, diff --git a/docs/guide-pl/input-file-upload.md b/docs/guide-pl/input-file-upload.md index 14b9b83..b50046f 100644 --- a/docs/guide-pl/input-file-upload.md +++ b/docs/guide-pl/input-file-upload.md @@ -74,6 +74,8 @@ use yii\widgets\ActiveForm; Należy pamiętać, aby dodać opcję `enctype` do formularza, przez co plik będzie mógł być prawidłowo przesłany. Wywołanie `fileInput()` spowoduje wyrenderowanie tagu ``, który pozwala użytkownikowi na wybranie oraz przesłanie pliku. +> Tip: od wersji 2.0.8, [[yii\web\widgets\ActiveField::fileInput|fileInput]] dodaje automatycznie opcję `enctype` do formularza, kiedy pole typu 'file input' jest używane. + ## Implementacja kontrolera W akcji kontrolera musimy połączyć model oraz widok aby zaimplementować przesyłanie plików: diff --git a/docs/guide-pl/input-forms.md b/docs/guide-pl/input-forms.md index aa67440..d2bedbd 100644 --- a/docs/guide-pl/input-forms.md +++ b/docs/guide-pl/input-forms.md @@ -117,7 +117,6 @@ Możemy użyć metody klasy ActiveForm [yii\widgets\ActiveForm::dropDownList()|d ```php use app\models\ProductCategory; -use yii\helpers\ArrayHelper; /* @var $this yii\web\View */ /* @var $form yii\widgets\ActiveForm */ diff --git a/docs/guide-pl/input-validation.md b/docs/guide-pl/input-validation.md index e348011..52ef455 100644 --- a/docs/guide-pl/input-validation.md +++ b/docs/guide-pl/input-validation.md @@ -648,3 +648,6 @@ Powyższy kod sprawdzi, czy zapytanie zostało wysłane przy użyciu AJAXa. Jeś > Info: Możesz również użyć [walidacji kolejkowej](#deferred-validation) do wykonania walidacji AJAX, jednakże walidacja AJAXowa opisana w tej sekcji jest bardziej systematyczna i > wymaga mniej wysiłku przy kodowaniu. + +Kiedy zarówno `enableClientValidation`, jak i `enableAjaxValidation` ustawione są na true, walidacja za pomocą AJAX zostanie uruchomiona dopiero po udanej +walidacji po stronie klienta. diff --git a/docs/guide-pl/output-pagination.md b/docs/guide-pl/output-pagination.md index 80b5bbb..345faeb 100644 --- a/docs/guide-pl/output-pagination.md +++ b/docs/guide-pl/output-pagination.md @@ -57,10 +57,10 @@ Metoda ta wymaga podania parametru page i zwraca poprawnie sformatowany adres UR // Jeśli nie będzie podana, użyta zostanie aktualna trasa $pagination->route = 'article/index'; -// wyświetla: /index.php?r=article/index&page=100 +// wyświetla: /index.php?r=article%2Findex&page=100 echo $pagination->createUrl(100); -// wyświetla: /index.php?r=article/index&page=101 +// wyświetla: /index.php?r=article%2Findex&page=101 echo $pagination->createUrl(101); ``` diff --git a/docs/guide-pl/start-databases.md b/docs/guide-pl/start-databases.md index c1166a2..1299b31 100644 --- a/docs/guide-pl/start-databases.md +++ b/docs/guide-pl/start-databases.md @@ -210,7 +210,7 @@ Sprawdź jak to działa Aby zobaczyć jak działa powyższy kod, użyj przeglądarki i przejdź pod podany adres URL: ``` -http://hostname/index.php?r=country/index +http://hostname/index.php?r=country%2Findex ``` ![Lista krajów](../guide/images/start-country-list.png) @@ -220,7 +220,7 @@ Jeśli klikniesz przycisk "2", zobaczysz stronę wyświetlającą pięć innych Zauważ, że adres URL w przeglądarce również się zmienił na ``` -http://hostname/index.php?r=country/index&page=2 +http://hostname/index.php?r=country%2Findex&page=2 ``` Za kulisami, [[yii\data\Pagination|Pagination]] dostarcza wszystkich niezbędnych funkcjonalności do stronicowania zbioru danych: diff --git a/docs/guide-pl/start-forms.md b/docs/guide-pl/start-forms.md index bdb2368..ec79263 100644 --- a/docs/guide-pl/start-forms.md +++ b/docs/guide-pl/start-forms.md @@ -178,7 +178,7 @@ Próba Aby zobaczyć jak to działa, użyj przeglądarki i przejdź pod dany adres: ``` -http://hostname/index.php?r=site/entry +http://hostname/index.php?r=site%2Fentry ``` Zobaczysz stronę wyświetlającą formularz z dwoma polami. Przed każdym polem znajduje się etykieta opisująca to pole. Jeśli klikniesz przycisk "Wyślij" nie wpisując żadnych danych, lub diff --git a/docs/guide-pl/start-gii.md b/docs/guide-pl/start-gii.md index 03f9ee8..960e62e 100644 --- a/docs/guide-pl/start-gii.md +++ b/docs/guide-pl/start-gii.md @@ -108,7 +108,7 @@ Sprawdzenie w działaniu Aby zobaczyć, jak działa nowo wygenerowany kod, użyj przeglądarki, aby uzyskać dostęp do podanego adresu URL: ``` -http://hostname/index.php?r=country/index +http://hostname/index.php?r=country%2Findex ``` Zobaczysz tabelę prezentującą kraje z bazy danych. Możesz sortować tabelę, lub filtrować ją przez wpisanie odpowiednich warunków w nagłówkach kolumn. diff --git a/docs/guide-pl/start-hello.md b/docs/guide-pl/start-hello.md index 29b92f9..c8b364a 100644 --- a/docs/guide-pl/start-hello.md +++ b/docs/guide-pl/start-hello.md @@ -88,7 +88,7 @@ Próba Po utworzeniu akcji oraz widoku możesz uzyskać dostęp do nowej strony przez przejście pod podany adres URL: ``` -http://hostname/index.php?r=site/say&message=Hello+World +http://hostname/index.php?r=site%2Fsay&message=Hello+World ``` ![Witaj świecie](../guide/images/start-hello-world.png) diff --git a/docs/guide-pl/start-installation.md b/docs/guide-pl/start-installation.md index 400dc47..ab4fb44 100644 --- a/docs/guide-pl/start-installation.md +++ b/docs/guide-pl/start-installation.md @@ -21,8 +21,10 @@ Instalacja przez Composer Jeśli nie posiadasz jeszcze zainstalowanego Composera to możesz to zrobić podążając według zamieszczonych na [getcomposer.org](https://getcomposer.org/download/) instrukcji. W systemach operacyjnych Linux i Mac OS X należy wywołać następujące komendy: - curl -sS https://getcomposer.org/installer | php - mv composer.phar /usr/local/bin/composer +```bash +curl -sS https://getcomposer.org/installer | php +mv composer.phar /usr/local/bin/composer +``` W systemie Windows należy pobrać i uruchomić [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe). @@ -33,8 +35,10 @@ Jeśli posiadałeś już wcześniej zainstalowanego Composera, upewnij się, że Z zainstalowanym Composerem możesz przejść do instalacji Yii wywołując poniższe komendy w katalogu dostępnym z poziomu sieci web: - composer global require "fxp/composer-asset-plugin:~1.1.1" - composer create-project --prefer-dist yiisoft/yii2-app-basic basic +```bash +composer global require "fxp/composer-asset-plugin:~1.1.1" +composer create-project --prefer-dist yiisoft/yii2-app-basic basic +``` Pierwsza komenda instaluje [wtyczkę zasobów](https://github.com/francoispluchino/composer-asset-plugin/), która pozwala na zarządzanie zasobami [Bowera](http://bower.io) oraz [paczkami zależności NPM](https://www.npmjs.com/) przez Composer. @@ -47,14 +51,16 @@ Druga komenda instaluje Yii w katalogu `basic`. Jeśli chcesz, możesz wybrać k > Tip: Jeśli chcesz zainstalować najnowszą wersję deweloperską Yii, użyj poniższej komendy, która dodaje [opcję stabilności](https://getcomposer.org/doc/04-schema.md#minimum-stability): > -> composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic +> ```bash +> composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic +> ``` > > Pamiętaj, że wersja deweloperska Yii nie powinna być używana w wersjach produkcyjnych aplikacji, ponieważ mogą wystąpić niespodziewane błędy. Instalacja z pliku archiwum ------------------------------- -Instalacja Yii z pliku archiwum dotyczy trzech kroków: +Instalacja Yii z pliku archiwum składa się z trzech kroków: 1. Pobranie pliku archiwum z [yiiframework.com](http://www.yiiframework.com/download/). 2. Rozpakowanie pliku archiwum do katalogu dostępnego z poziomu sieci web. @@ -82,33 +88,43 @@ Dostępne są również inne opcje instalacji: Sprawdzenie instalacji -------------------------- -Po instalacji możesz użyć swojej przeglądarki, aby uzyskać dostęp do swojej aplikacji Yii przechodząc pod adres: - +Po zakończeniu instalacji, skonfiguruj swój serwer (zobacz następną sekcję) lub użyj +[wbudowanego serwera PHP](https://secure.php.net/manual/en/features.commandline.webserver.php), uruchamiając poniższą komendę w konsoli z poziomu folderu +`web` projektu: + +```bash +php yii serve ``` -http://localhost/basic/web/index.php + +> Note: Domyślnym portem, na którym serwer HTTP nasłuchuje, jest 8080. Jeśli jednak ten port jest już w użyciu lub też chcesz obsłużyć wiele aplikacji w ten sposób, +możesz podać inny numer portu, dodając argument --port: + +```bash +php yii serve --port=8888 ``` -Powyższy wpis zakłada, że zainstalowałeś Yii w katalogu o nazwie `basic`, bezpośrednio jako katalog głównego katalogu serwera, oraz że serwer jest uruchomiony na Twojej lokalnej -maszynie ('localhost'). -Być może będziesz musiał dostosować go do Twojego środowiska instalacyjnego. +Możesz teraz użyć swojej przeglądarki, aby uzyskać dostęp do zainstalowanej aplikacji Yii przechodząc pod adres: -![Pomyślna instalacja Yii](../guide/images/start-app-installed.png) +``` +http://localhost:8080/ +``` +![Poprawna instalacja Yii](../guide/images/start-app-installed.png) -Na stronie w przeglądarce powinienieś zobaczyć napis "Congratulations!". Jeśli nie, sprawdź czy zainstalowana wersja PHP jest wystarczająca do wymagań Yii. +Powinienieś zobaczyć stronę z napisem "Congratulations!" (Gratulacje!). Jeśli nie, sprawdź czy zainstalowane elementy środowiska spełniają wymagania Yii. Możesz sprawdzić minimalne wymagania na dwa sposoby: -* Używając przeglądarki przejdź pod adres `http://localhost/basic/requirements.php` -* Wywołaj poniższą komendę: +* Skopiuj plik `/requirements.php` do `/web/requirements.php`, a następnie przejdź do przeglądarki i uruchom go przechodząc pod adres `http://localhost/requirements.php` +* Lub też uruchom następujące komendy: - ``` - cd basic - php requirements.php - ``` + ```bash + cd basic + php requirements.php + ``` -Powinienieś skonfigurować swoją instalację PHP tak, aby spełniała minimalne wymogi Yii. Najważniejszym z nich jest posiadanie PHP w wersji 5.4 lub wyższej. Powinienieś również -zainstalować [rozszerzenie PDO](http://www.php.net/manual/en/pdo.installation.php) oraz odpowiedni sterownik bazy danych (np. `pdo_mysql` dla bazy danych MySQL), jeśli Twoja aplikacja -potrzebuje bazy danych. +Powinienieś skonfigurować swoją instalację PHP tak, aby spełniała minimalne wymogi Yii. Najważniejszym z nich jest posiadanie PHP w wersji 5.4 lub wyższej. +Powinienieś również zainstalować [rozszerzenie PDO](http://www.php.net/manual/en/pdo.installation.php) oraz odpowiedni sterownik bazy danych (np. `pdo_mysql` dla bazy danych +MySQL), jeśli Twoja aplikacja potrzebuje bazy danych. Konfigurowanie serwerów WWW @@ -140,7 +156,7 @@ Blokowanie dostępu do tych folderów jest dużą poprawą bezpieczeństwa. Użyj następującej konfiguracji serwera Apache w pliku `httpd.conf` lub w konfiguracji wirtualnego hosta. Pamiętaj, że musisz zamienić ścieżkę `path/to/basic/web` na aktualną ścieżkę do `basic/web` Twojej aplikacji. -``` +```apache # Ustaw główny katalog na "basic/web" DocumentRoot "path/to/basic/web" @@ -160,16 +176,16 @@ DocumentRoot "path/to/basic/web" ### Zalecane ustawienia Nginx Aby użyć [Nginx](http://wiki.nginx.org/) powinienieś zainstalować PHP jako [FPM SAPI](http://php.net/install.fpm). -Możesz użyć przedstawionej poniżej konfiguracji Nginx, zastępując jedynie ścieżkę `path/to/basic/web` aktualną ścieżką do `basic/web` Twojej aplikacji oraz `mysite.local` aktualną -nazwą hosta. +Możesz użyć przedstawionej poniżej konfiguracji Nginx, zastępując jedynie ścieżkę `path/to/basic/web` aktualną ścieżką do `basic/web` Twojej aplikacji oraz +`mysite.local` aktualną nazwą hosta. -``` +```nginx server { charset utf-8; client_max_body_size 128M; listen 80; ## nasłuchuj ipv4 - #listen [::]:80 default_server ipv6only=on; ## listen for ipv6 + #listen [::]:80 default_server ipv6only=on; ## nasłuchuj ipv6 server_name mysite.local; root /path/to/basic/web; @@ -183,7 +199,7 @@ server { try_files $uri $uri/ /index.php?$args; } - # odkomentuj aby uniknąć przetwarzania żądań do nieistniejących plików przez Yii + # dkomentuj aby uniknąć przetwarzania żądań do nieistniejących plików przez Yii #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ { # try_files $uri =404; #} diff --git a/docs/guide-pl/tutorial-shared-hosting.md b/docs/guide-pl/tutorial-shared-hosting.md new file mode 100644 index 0000000..56dd9dc --- /dev/null +++ b/docs/guide-pl/tutorial-shared-hosting.md @@ -0,0 +1,116 @@ +Współdzielone środowisko hostujące +================================== + +Współdzielone środowiska hostujące są często ograniczone, jeśli chodzi o możliwości ich konfiguracji i struktury folderów. Pomimo to, wciąż, w większości przypadków, +możesz w takim środowisku uruchomić Yii 2.0 po kilku drobnych modyfikacjach. + +Wdrożenie podstawowej aplikacji +------------------------------- + +W standardowym współdzielonym środowisku hostującym jest zwykle tylko jeden główny folder publiczny (webroot), zatem wygodniej jest stosować podstawowy szablon projektu. +Korzystając z instrukcji w sekcji [Instalowanie Yii](start-installation.md), zainstaluj taki szablon lokalnie. Po udanej instalacji, dokonamy kilku modyfikacji, aby aplikacji +mogła działać na współdzielonym środowisku. + +### Zmiana nazwy webroota + +Połącz się ze swoim współdzielonym hostem za pomocą np. klienta FTP. Prawdopodobnie zobaczysz listę folderów podobną do poniższej. + +``` +config +logs +www +``` + +W tym przykładzie, `www` jest folderem webroot. Folder ten może mieć różne nazwy, zwykle stosowane są: `www`, `htdocs` i `public_html`. + +Webroot w naszym podstawowym szablonie projektu nazywa się `web`. Przed skopiowaniem aplikacji na serwer, zmień nazwę lokalnego folderu webroot, aby odpowiadała folderowi +na serwerze, czyli z `web` na `www`, `public_html` lub na inną nazwę, która używana jest na serwerze. + +### Folder root FTP jest zapisywalny + +Jeśli masz prawa zapisu w folderze poziomu root, czyli tam, gdzie znajdują się foldery `config`, `logs` i `www`, skopiuj foldery `assets`, `commands` itd. bezpośrednio w to +miejsce. + +### Dodatkowe opcje serwera + +Jeśli Twój serwer to Apache, będziesz musiał dodać plik `.htaccess` z poniższą zawartością do folderu `web` (czy też `public_html`, bądź jakakolwiek jest jego nazwa), +gdzie znajduje się plik `index.php`: + +``` +Options +FollowSymLinks +IndexIgnore */* + +RewriteEngine on + +# jeśli katalog lub plik istnieje, użyj go bezpośrednio +RewriteCond %{REQUEST_FILENAME} !-f +RewriteCond %{REQUEST_FILENAME} !-d + +# w innym przypadku przekieruj żądanie na index.php +RewriteRule . index.php +``` + +W przypadku serwera nginx nie powinieneś potrzebować dodatkowego pliku konfiguracyjnego. + +### Sprawdzenie wymagań + +Aby uruchomić Yii, Twój serwer musi spełniać jego wymagania. Minimalnym wymaganiem jest PHP w wersji 5.4. Możesz sprawdzić wszystkie wymagania, kopiując plik +`requirements.php` z folderu root do folderu webroot i uruchamiając go w przeglądarce pod adresem `http://example.com/requirements.php`. +Nie zapomnij o skasowaniu tego pliku po sprawdzeniu wymagań. + + +Wdrożenie zaawansowanej aplikacji +--------------------------------- + +Wdrażanie zaawansowanej aplikacji na współdzielonym środowisku jest odrobinę bardziej problematyczne, niż w przypadku podstawowej aplikacji, ponieważ wymaga ona dwóch folderów +webroot, czego zwykle nie wspierają serwery środowisk współdzielonych. Będziemy musieli odpowiednio dostosować strukturę folderów. + +### Przeniesienie skryptów wejściowych do jednego folderu webroot + +Na początek potrzebujemy folderu webroot. Stwórz nowy folder i nazwij go tak, jak webroot docelowego serwera, jak opisane zostało to w +[Zmiana nazwy webroota](#renaming-webroot) powyżej, np. `www` czy też `public_html`. Następnie utwórz poniższą strukturę, gdzie `www` jest folderem webroot, +który właśnie stworzyłeś: + +``` +www + admin +backend +common +console +environments +frontend +... +``` + +`www` będzie naszym folderem frontend, zatem przenieś tam zawartość `frontend/web`. Do folderu `www/admin` przenieś zawartość `backend/web`. +W każdym przypadku będziesz musiał zmodyfikować ścieżki w plikach `index.php` i `index-test.php`. + +### Rozdzielone sesje i ciasteczka + +Backend i frontend zostały stworzone z myślą o uruchamianiu ich z poziomu oddzielnych domen. Jeśli uruchamiamy je z poziomu jednej domeny, frontend i backend będą dzielić +te same ciasteczka, co może wywołać konflikty. Aby temu zapobiec, zmodyfikuj backendową konfigurację aplikacji `backend/config/main.php` jak poniżej: + +```php +'components' => [ + 'request' => [ + 'csrfParam' => '_backendCSRF', + 'csrfCookie' => [ + 'httpOnly' => true, + 'path' => '/admin', + ], + ], + 'user' => [ + 'identityCookie' => [ + 'name' => '_backendIdentity', + 'path' => '/admin', + 'httpOnly' => true, + ], + ], + 'session' => [ + 'name' => 'BACKENDSESSID', + 'cookieParams' => [ + 'path' => '/admin', + ], + ], +], +```