mirror of
https://github.com/yiisoft/yii2.git
synced 2026-02-20 00:32:19 +01:00
PL Guide updates (#18787)
This commit is contained in:
Bizley
@@ -18,6 +18,7 @@ Wstęp
|
||||
Pierwsze kroki
|
||||
--------------
|
||||
|
||||
* [Co musisz wiedzieć](start-prerequisites.md)
|
||||
* [Instalacja Yii](start-installation.md)
|
||||
* [Uruchamianie aplikacji](start-workflow.md)
|
||||
* [Witaj świecie](start-hello.md)
|
||||
@@ -40,7 +41,7 @@ Struktura aplikacji
|
||||
* [Moduły](structure-modules.md)
|
||||
* [Filtry](structure-filters.md)
|
||||
* [Widżety](structure-widgets.md)
|
||||
* [Assety (Assets)](structure-assets.md)
|
||||
* [Zasoby (Assets)](structure-assets.md)
|
||||
* [Rozszerzenia](structure-extensions.md)
|
||||
|
||||
|
||||
@@ -62,12 +63,12 @@ Kluczowe koncepcje
|
||||
|
||||
* [Komponenty](concept-components.md)
|
||||
* [Właściwości](concept-properties.md)
|
||||
* [Eventy](concept-events.md)
|
||||
* [Behaviory](concept-behaviors.md)
|
||||
* [Zdarzenia (Events)](concept-events.md)
|
||||
* [Zachowania (Behaviors)](concept-behaviors.md)
|
||||
* [Konfiguracje](concept-configurations.md)
|
||||
* [Aliasy](concept-aliases.md)
|
||||
* [Autoładowanie klas](concept-autoloading.md)
|
||||
* [Lokator usług](concept-service-locator.md)
|
||||
* [Lokator usług (Service Locator)](concept-service-locator.md)
|
||||
* [Kontener wstrzykiwania zależności (DI Container)](concept-di-container.md)
|
||||
|
||||
|
||||
@@ -78,10 +79,10 @@ Praca z bazami danych
|
||||
* [Konstruktor kwerend](db-query-builder.md): Zapytania do bazy danych z użyciem warstwy abstrakcyjnej.
|
||||
* [Active Record](db-active-record.md): Active Record ORM, otrzymywanie i manipulacja rekordami oraz definiowanie relacji.
|
||||
* [Migracje](db-migrations.md): Użycie systemu kontroli wersji bazy danych do pracy z wieloma środowiskami.
|
||||
* [Sphinx](https://github.com/yiisoft/yii2-sphinx/blob/master/docs/guide/README.md)
|
||||
* [Redis](https://github.com/yiisoft/yii2-redis/blob/master/docs/guide/README.md)
|
||||
* [MongoDB](https://github.com/yiisoft/yii2-mongodb/blob/master/docs/guide/README.md)
|
||||
* [ElasticSearch](https://github.com/yiisoft/yii2-elasticsearch/blob/master/docs/guide/README.md)
|
||||
* [Sphinx](https://www.yiiframework.com/extension/yiisoft/yii2-sphinx/doc/guide)
|
||||
* [Redis](https://www.yiiframework.com/extension/yiisoft/yii2-redis/doc/guide)
|
||||
* [MongoDB](https://www.yiiframework.com/extension/yiisoft/yii2-mongodb/doc/guide)
|
||||
* [ElasticSearch](https://www.yiiframework.com/extension/yiisoft/yii2-elasticsearch/doc/guide)
|
||||
|
||||
|
||||
Odbieranie danych od użytkowników
|
||||
@@ -115,7 +116,7 @@ Bezpieczeństwo
|
||||
* [Autoryzacja](security-authorization.md)
|
||||
* [Praca z hasłami](security-passwords.md)
|
||||
* [Kryptografia](security-cryptography.md)
|
||||
* [Klienty autoryzacji](security-auth-clients.md)
|
||||
* [Klienty autoryzacji](https://www.yiiframework.com/extension/yiisoft/yii2-authclient/doc/guide)
|
||||
* [Bezpieczeństwo w praktyce](security-best-practices.md)
|
||||
|
||||
|
||||
@@ -146,9 +147,9 @@ Webserwisy z wykorzystaniem REST
|
||||
Narzędzia wspomagające tworzenie aplikacji
|
||||
------------------------------------------
|
||||
|
||||
* [Pasek debugowania i debuger](https://github.com/yiisoft/yii2-debug/blob/master/docs/guide/README.md)
|
||||
* [Generowanie kodu przy użyciu Gii](https://github.com/yiisoft/yii2-gii/blob/master/docs/guide/README.md)
|
||||
* [Generowanie dokumentacji API](https://github.com/yiisoft/yii2-apidoc)
|
||||
* [Pasek debugowania i debuger](https://www.yiiframework.com/extension/yiisoft/yii2-debug/doc/guide)
|
||||
* [Generowanie kodu przy użyciu Gii](https://www.yiiframework.com/extension/yiisoft/yii2-gii/doc/guide)
|
||||
* [Generowanie dokumentacji API](https://www.yiiframework.com/extension/yiisoft/yii2-apidoc)
|
||||
|
||||
|
||||
Testowanie
|
||||
@@ -165,10 +166,11 @@ Testowanie
|
||||
Tematy specjalne
|
||||
----------------
|
||||
|
||||
* [Szablon zaawansowanej aplikacji](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md)
|
||||
* [Szablon zaawansowanej aplikacji](https://www.yiiframework.com/extension/yiisoft/yii2-app-advanced/doc/guide)
|
||||
* [Tworzenie aplikacji od podstaw](tutorial-start-from-scratch.md)
|
||||
* [Komendy konsolowe](tutorial-console.md)
|
||||
* [Podstawowe walidatory](tutorial-core-validators.md)
|
||||
* [Wbudowane walidatory](tutorial-core-validators.md)
|
||||
* [Docker](tutorial-docker.md)
|
||||
* [Internacjonalizacja](tutorial-i18n.md)
|
||||
* [Wysyłanie poczty](tutorial-mailing.md)
|
||||
* [Poprawianie wydajności](tutorial-performance-tuning.md)
|
||||
@@ -189,8 +191,8 @@ Widżety
|
||||
* [Menu](https://www.yiiframework.com/doc-2.0/yii-widgets-menu.html)
|
||||
* [LinkPager](https://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html)
|
||||
* [LinkSorter](https://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html)
|
||||
* [Widżety Bootstrapowe](https://github.com/yiisoft/yii2-bootstrap/blob/master/docs/guide/README.md)
|
||||
* [Widżety jQuery UI](https://github.com/yiisoft/yii2-jui/blob/master/docs/guide/README.md)
|
||||
* [Widżety Bootstrapowe](https://www.yiiframework.com/extension/yiisoft/yii2-bootstrap/doc/guide)
|
||||
* [Widżety jQuery UI](https://www.yiiframework.com/extension/yiisoft/yii2-jui/doc/guide)
|
||||
|
||||
|
||||
Klasy pomocnicze
|
||||
@@ -199,6 +201,7 @@ Klasy pomocnicze
|
||||
* [Przegląd](helper-overview.md)
|
||||
* [ArrayHelper](helper-array.md)
|
||||
* [Html](helper-html.md)
|
||||
* [Json](helper-json.md)
|
||||
* [Url](helper-url.md)
|
||||
|
||||
|
||||
|
||||
@@ -107,8 +107,8 @@ Więcej szczegółów na temat konfiguracji znajdziesz w sekcji [Konfiguracje](c
|
||||
Zdarzenia (Events)
|
||||
------------------
|
||||
|
||||
W Yii 1 zdarzenia były tworzone poprzez definiowanie `on`-metody (np., `onBeforeSave`). W Yii 2 możesz użyć dowolnej nazwy. Uruchomienie zdarzenia następuje
|
||||
poprzez wywołanie metody [[yii\base\Component::trigger()|trigger()]]:
|
||||
W Yii 1 zdarzenia były tworzone poprzez definiowanie `on`-metody (np., `onBeforeSave`). W Yii 2 możesz użyć dowolnej nazwy.
|
||||
Uruchomienie zdarzenia następuje poprzez wywołanie metody [[yii\base\Component::trigger()|trigger()]]:
|
||||
|
||||
```php
|
||||
$event = new \yii\base\Event;
|
||||
|
||||
@@ -21,25 +21,31 @@ Jak wygląda porównanie Yii z innymi frameworkami?
|
||||
|
||||
Jeśli korzystałeś już z innych frameworków, na pewno docenisz, jak Yii wypada na ich tle:
|
||||
|
||||
* Jak większość frameworków, Yii wykorzystuje architekturę MVC (Model-Widok-Kontroler) i wspiera organizację kodu zgodną z tym wzorcem.
|
||||
* Yii opiera się na filozofii, która mówi, że kod powinien być napisany w prosty, ale jednocześnie elegancki sposób. Yii nigdy nie będzie upierać się przy przeprojektowaniu
|
||||
kodu jedynie w celu dokładnego trzymania się zasad wzorca projektowego.
|
||||
* Yii jest w pełni rozwiniętym frameworkiem dostarczającym sprawdzonych i gotowych do użycia funkcjonalności: konstruktorów zapytań
|
||||
oraz ActiveRecord dla baz danych relacyjnych i NoSQL, wsparcia dla tworzenia RESTful API oraz wielopoziomowych mechanizmów pamięci podręcznej i wielu, wielu innych.
|
||||
* Jak większość frameworków, Yii wykorzystuje architekturę MVC (Model-Widok-Kontroler) i wspiera organizację kodu zgodną
|
||||
z tym wzorcem.
|
||||
* Yii opiera się na filozofii, która mówi, że kod powinien być napisany w prosty, ale jednocześnie elegancki sposób.
|
||||
Yii nigdy nie będzie upierać się przy przeprojektowaniu kodu jedynie w celu dokładnego trzymania się zasad wzorca projektowego.
|
||||
* Yii jest w pełni rozwiniętym frameworkiem dostarczającym sprawdzonych i gotowych do użycia funkcjonalności: konstruktorów
|
||||
zapytań oraz ActiveRecord dla baz danych relacyjnych i NoSQL, wsparcia dla tworzenia RESTful API oraz wielopoziomowych
|
||||
mechanizmów pamięci podręcznej i wielu, wielu innych.
|
||||
* Yii jest ekstremalnie rozszerzalny. Możesz dostosować lub wymienić praktycznie każdy fragment podstawowego kodu.
|
||||
Dodatkowo Yii wykorzystuje architekturę rozszerzeń, dzięki czemu możesz w prosty sposób stworzyć i opublikować swoje własne moduły i widżety.
|
||||
Dodatkowo Yii wykorzystuje architekturę rozszerzeń, dzięki czemu możesz w prosty sposób stworzyć i opublikować swoje
|
||||
własne moduły i widżety.
|
||||
* Podstawowym celem, do którego Yii zawsze dąży, jest wysoka wydajność.
|
||||
|
||||
Yii nie jest efektem pracy pojedynczego programisty - projekt wspiera zarówno [grupa doświadczonych deweloperów](https://www.yiiframework.com/team/), jak i ogromna społeczność programistyczna, nieustannie
|
||||
przyczyniając się do jego rozwoju. Deweloperzy trzymają rękę na pulsie najnowszych trendów Internetu, za pomocą prostych i eleganckich interfejsów wzbogacając Yii w najlepsze sprawdzone
|
||||
rozwiązania i funkcjonalności, dostępne w innych frameworkach i projektach.
|
||||
Yii nie jest efektem pracy pojedynczego programisty - projekt wspiera zarówno
|
||||
[grupa doświadczonych deweloperów](https://www.yiiframework.com/team/), jak i ogromna społeczność programistyczna,
|
||||
nieustannie przyczyniając się do jego rozwoju. Deweloperzy trzymają rękę na pulsie najnowszych trendów Internetu,
|
||||
za pomocą prostych i eleganckich interfejsów wzbogacając Yii w najlepsze sprawdzone rozwiązania i funkcjonalności,
|
||||
dostępne w innych frameworkach i projektach.
|
||||
|
||||
Wersje Yii
|
||||
----------
|
||||
|
||||
Yii aktualnie dostępny jest w dwóch głównych wersjach: 1.1 i 2.0. Wersja 1.1 jest kodem starszej generacji, obecnie w fazie utrzymaniowej.
|
||||
Wersja 2.0 jest całkowicie przepisaną wersją Yii z uwzględnieniem najnowszych protokołów i technologii, takich jak Composer, PSR, przestrzenie nazw, traity i wiele innych.
|
||||
2.0 reprezentuje aktualną generację frameworka i na niej skupi się głównie praca programistów w ciągu najbliższych lat.
|
||||
Yii aktualnie dostępny jest w dwóch głównych wersjach: 1.1 i 2.0. Wersja 1.1 jest kodem starszej generacji, obecnie
|
||||
w fazie utrzymaniowej. Wersja 2.0 jest całkowicie przepisaną wersją Yii z uwzględnieniem najnowszych protokołów i technologii,
|
||||
takich jak Composer, PSR, przestrzenie nazw, traity i wiele innych. 2.0 reprezentuje aktualną generację frameworka i na
|
||||
niej skupi się głównie praca programistów w ciągu najbliższych lat.
|
||||
Ten przewodnik opisuje wersję 2.0.
|
||||
|
||||
|
||||
@@ -53,4 +59,3 @@ Używanie Yii wymaga podstawowej wiedzy o programowaniu obiektowym w PHP (OOP),
|
||||
jest frameworkiem czysto obiektowym. Yii 2.0 wykorzystuje ostatnie udoskonalenia w PHP, jak
|
||||
[przestrzenie nazw](https://secure.php.net/manual/pl/language.namespaces.php) i [traity](https://secure.php.net/manual/pl/language.oop5.traits.php).
|
||||
Zrozumienie tych konstrukcji pomoże Ci szybciej i łatwiej rozpocząć pracę z Yii 2.0.
|
||||
|
||||
|
||||
@@ -2,28 +2,30 @@ Instalacja Yii
|
||||
==============
|
||||
|
||||
Yii możesz zainstalować na dwa sposoby, korzystając z [Composera](https://getcomposer.org/) lub pobierając plik archiwum.
|
||||
Preferowanym sposobem jest ten pierwszy, ponieważ pozwala na instalację i aktualizację dodatkowych [rozszerzeń](structure-extensions.md) oraz samego Yii przy użyciu
|
||||
zaledwie jednej komendy.
|
||||
Preferowanym sposobem jest ten pierwszy, ponieważ pozwala na instalację i aktualizację dodatkowych
|
||||
[rozszerzeń](structure-extensions.md) oraz samego Yii przy użyciu zaledwie jednej komendy.
|
||||
|
||||
Standardowa instalacja Yii skutkuje pobraniem i wstępnym skonfigurowaniem frameworka wraz z szablonem projektu.
|
||||
Szablon projektu jest aplikacją Yii zawierającą podstawowe funkcjonalności, takie jak logowanie, formularz kontaktowy itp.
|
||||
Struktura jego kodu została stworzona w oparciu o zalecany sposób pisania aplikacji opartych na Yii, dlatego może służyć jako dobry punkt wyjściowy dla stworzenia
|
||||
Twojego bardziej zaawansowanego projektu.
|
||||
Struktura jego kodu została stworzona w oparciu o zalecany sposób pisania aplikacji opartych na Yii, dlatego może służyć
|
||||
jako dobry punkt wyjściowy dla stworzenia Twojego bardziej zaawansowanego projektu.
|
||||
|
||||
W tej oraz kilku kolejnych sekcjach opiszemy jak zainstalować Yii z tak zwanym "podstawowym szablonem projektu" oraz jak zaimplementować w nim nowe funkcjonalności.
|
||||
Oprócz podstawowego, Yii dostarcza również drugi, [zaawansowany szablon projektu](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md),
|
||||
W tej oraz kilku kolejnych sekcjach opiszemy jak zainstalować Yii z tak zwanym "podstawowym szablonem projektu" oraz jak
|
||||
zaimplementować w nim nowe funkcjonalności. Oprócz podstawowego, Yii dostarcza również drugi,
|
||||
[zaawansowany szablon projektu](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md),
|
||||
przystosowany dla programistów tworzących wielowarstwowe aplikacje.
|
||||
|
||||
> Info: Podstawowy szablon projektu jest odpowiedni dla 90% aplikacji webowych. Główną różnicą, w porównaniu do zaawansowanego szablonu projektu, jest organizacja kodu.
|
||||
> Jeśli dopiero zaczynasz swoją przygodę z Yii, zalecamy zapoznać się z podstawowym szablonem, ze względu na jego prostotę oraz funkcjonalność.
|
||||
> Info: Podstawowy szablon projektu jest odpowiedni dla 90% aplikacji webowych. Główną różnicą, w porównaniu do
|
||||
zaawansowanego szablonu projektu, jest organizacja kodu. Jeśli dopiero zaczynasz swoją przygodę z Yii, zalecamy
|
||||
zapoznać się z podstawowym szablonem, ze względu na jego prostotę oraz funkcjonalność.
|
||||
|
||||
Instalacja z użyciem Composera <span id="installing-via-composer"></span>
|
||||
------------------------------
|
||||
|
||||
### Instalacja Composera
|
||||
|
||||
Jeśli nie posiadasz jeszcze Composera, to możesz go zainstalować korzystając z instrukcji zamieszczonej na stronie [getcomposer.org](https://getcomposer.org/download/).
|
||||
W systemach operacyjnych Linux i Mac OS X należy wywołać następujące komendy:
|
||||
Jeśli nie posiadasz jeszcze Composera, to możesz go zainstalować korzystając z instrukcji zamieszczonej na stronie
|
||||
[getcomposer.org](https://getcomposer.org/download/). W systemach operacyjnych Linux i Mac OS X należy wywołać następujące komendy:
|
||||
|
||||
```bash
|
||||
curl -sS https://getcomposer.org/installer | php
|
||||
@@ -44,32 +46,27 @@ pamiętaj, żeby odpowiednio zmodyfikować podane tu przykładowe komendy.
|
||||
Jeśli jesteś już posiadaczem Composera, upewnij się, że jest on zaktualizowany do najnowszej wersji (komenda `composer self-update`).
|
||||
|
||||
> Note: Podczas instalacji Yii, Composer będzie potrzebował pobrać sporo informacji z API serwisu Github.
|
||||
> Ilość zapytań zależy od liczby powiązanych wtyczek, rozszerzeń i modułów, których wymaga Twoja aplikacja, i może być większa niż
|
||||
> **limit zapytań API GitHuba**. Jeśli faktycznie tak będzie, Composer może poprosić o Twoje dane logowania w serwisie Github, aby uzyskać
|
||||
> token dostępowy API Githuba. Przy szybkim łączu napotkanie limitu może nastąpić szybciej niż Composer jest w stanie obsłużyć zapytania,
|
||||
> zatem zalecane jest skonfigurowanie tokenu dostępowego przed instalacją Yii.
|
||||
> Instrukcja opisująca jak tego dokonać znajduje się w
|
||||
> [dokumentacji Composera dotyczącej tokenów API Githuba](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens).
|
||||
Ilość zapytań zależy od liczby powiązanych wtyczek, rozszerzeń i modułów, których wymaga Twoja aplikacja, i może być
|
||||
większa niż **limit zapytań API GitHuba**. Jeśli faktycznie tak będzie, Composer może poprosić o Twoje dane logowania
|
||||
w serwisie Github, aby uzyskać token dostępowy API Githuba. Przy szybkim łączu napotkanie limitu może nastąpić szybciej
|
||||
niż Composer jest w stanie obsłużyć zapytania, zatem zalecane jest skonfigurowanie tokenu dostępowego przed instalacją Yii.
|
||||
Instrukcja opisująca jak tego dokonać znajduje się w
|
||||
[dokumentacji Composera dotyczącej tokenów API Githuba](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens).
|
||||
|
||||
### Installing Yii
|
||||
|
||||
Teraz możesz przejść już do instalacji samego Yii, wywołując poniższe komendy w katalogu dostępnym z poziomu sieci web:
|
||||
|
||||
```bash
|
||||
composer global require "fxp/composer-asset-plugin:^1.4.1"
|
||||
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
|
||||
```
|
||||
|
||||
Pierwsza komenda instaluje [wtyczkę Composer Asset Plugin](https://github.com/francoispluchino/composer-asset-plugin), która pozwala na zarządzanie zasobami
|
||||
[Bowera](http://bower.io) oraz [NPM](https://www.npmjs.com) z użyciem samego Composera.
|
||||
Komendę tę wystarczy wywołać raz i od tej pory wtyczka będzie zainstalowana globalnie i dostępna dla każdej kolejnej instalacji Yii.
|
||||
Druga komenda instaluje Yii w katalogu `basic`. Jeśli chcesz, możesz podać katalog o innej nazwie.
|
||||
Komenda ta zainstaluje najnowszą stabilną wersję szablonu aplikacji Yii w katalogu `basic`. Możesz oczywiście wybrać
|
||||
inną nazwę.
|
||||
|
||||
> Info: Jeśli komenda `composer create-project` zwróci błąd, upewnij się, czy Composer Asset Plugin jest poprawnie zainstalowany.
|
||||
> Możesz to zrobić wywołując komendę `composer global show`, która powinna wyświetlić wpis (pośród innych możliwych) `fxp/composer-asset-plugin`.
|
||||
> Aby sprawdzić, czy przypadkiem nie napotkałeś na jeden z częstych błędów, zerknij również do
|
||||
> [dokumentacji Composera w sekcji Rozwiązywania problemów](https://getcomposer.org/doc/articles/troubleshooting.md).
|
||||
> Kiedy uporasz się już z błędem, możesz wznowić przerwaną instalację uruchamiając komendę `composer update` w folderze `basic`.
|
||||
> Info: Jeśli komenda `composer create-project` zwróci błąd, sprawdź, czy przypadkiem nie jest on już opisany
|
||||
w [dokumentacji Composera w sekcji Rozwiązywania problemów](https://getcomposer.org/doc/articles/troubleshooting.md).
|
||||
Kiedy uporasz się już z błędem, możesz wznowić przerwaną instalację uruchamiając komendę `composer update` w folderze `basic`.
|
||||
|
||||
> 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):
|
||||
@@ -78,7 +75,8 @@ Druga komenda instaluje Yii w katalogu `basic`. Jeśli chcesz, możesz podać ka
|
||||
> 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 Twojej aplikacji, ponieważ mogą wystąpić w niej niespodziewane błędy.
|
||||
> Pamiętaj, że wersja deweloperska Yii nie powinna być używana w wersjach produkcyjnych Twojej aplikacji, ponieważ mogą
|
||||
> wystąpić w niej niespodziewane błędy.
|
||||
|
||||
Instalacja z pliku archiwum <span id="installing-from-archive-file"></span>
|
||||
---------------------------
|
||||
@@ -99,14 +97,44 @@ Inne opcje instalacji <span id="other-installation-options"></span>
|
||||
---------------------
|
||||
|
||||
Powyższe instrukcje pokazują, jak zainstalować Yii oraz utworzyć podstawową, gotową do uruchomienia aplikację web.
|
||||
To podejście jest dobrym punktem startowym dla większości projektów, zarówno małych jak i dużych. Jest to szczególnie korzystne, gdy zaczynasz naukę Yii.
|
||||
To podejście jest dobrym punktem startowym dla większości projektów, zarówno małych jak i dużych. Jest to szczególnie
|
||||
korzystne, gdy zaczynasz naukę Yii.
|
||||
|
||||
Dostępne są również inne opcje instalacji:
|
||||
|
||||
* Jeśli chcesz zainstalować wyłącznie framework i samemu zbudować aplikację, zapoznaj się z rozdziałem
|
||||
[Tworzenie aplikacji od podstaw](tutorial-start-from-scratch.md).
|
||||
* Jeśli chcesz utworzyć bardziej zaawansowaną aplikację, przystosowaną do programowania dla wielu środowisk,
|
||||
powinienieś rozważyć instalację [zaawansowanego szablonu aplikacji](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md).
|
||||
powinienieś rozważyć instalację
|
||||
[zaawansowanego szablonu aplikacji](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md).
|
||||
|
||||
|
||||
Instalowanie zasobów <span id="installing-assets"></span>
|
||||
--------------------
|
||||
|
||||
Yii używa menadżerów pakietów [Bower](http://bower.io/) i/lub [NPM](https://www.npmjs.com/) do instalacji bibliotek
|
||||
zasobów (CSS i JavaScript). Proces pobierania tych bibliotek korzysta z Composera, pozwalając na rozwiązywanie zależności
|
||||
pakietów PHP i CSS/JavaScript w tym samym czasie, za pomocą serwisu [asset-packagist.org](https://asset-packagist.org)
|
||||
lub wtyczki [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/).
|
||||
Po więcej informacji sięgnij do sekcji [dokumentacji Zasobów](structure-assets.md).
|
||||
|
||||
Możesz, rzecz jasna, również zarządzać swoimi zasobami za pomocą natywnego klienta Bower/NPM, korzystać z CDN, albo też
|
||||
całkowicie zrezygnować z instalacji zasobów. Aby zablokować automatyczne pobieranie zasobów podczas używania Composera,
|
||||
dodaj poniższe linie w pliku 'composer.json':
|
||||
|
||||
```json
|
||||
"replace": {
|
||||
"bower-asset/jquery": ">=1.11.0",
|
||||
"bower-asset/inputmask": ">=3.2.0",
|
||||
"bower-asset/punycode": ">=1.3.0",
|
||||
"bower-asset/yii2-pjax": ">=2.0.0"
|
||||
},
|
||||
```
|
||||
|
||||
> Note: w przypadku zablokowania instalacji zasobów przez Composera, odpowiedzialność za ich instalację i rozwiązywanie
|
||||
zależności spada na Ciebie. Przygotuj się na potencjalne niezgodności w plikach zasobów pochodzących z różnych rozszerzeń.
|
||||
|
||||
|
||||
|
||||
Weryfikacja instalacji <span id="verifying-installation"></span>
|
||||
----------------------
|
||||
@@ -119,8 +147,8 @@ uruchamiając poniższą komendę w konsoli z poziomu folderu `web` w projekcie:
|
||||
php yii serve
|
||||
```
|
||||
|
||||
> 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:
|
||||
> 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
|
||||
@@ -134,10 +162,11 @@ http://localhost:8080/
|
||||
|
||||
|
||||
|
||||
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:
|
||||
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:
|
||||
|
||||
* 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`
|
||||
* 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:
|
||||
|
||||
```bash
|
||||
@@ -145,9 +174,10 @@ Możesz sprawdzić minimalne wymagania na dwa sposoby:
|
||||
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](https://secure.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](https://secure.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 <span id="configuring-web-servers"></span>
|
||||
@@ -157,25 +187,23 @@ Konfigurowanie serwerów WWW <span id="configuring-web-servers"></span>
|
||||
|
||||
Aplikacja zainstalowana według powyższych instrukcji powinna działać bezproblemowo zarówno na
|
||||
[serwerze HTTP Apache](http://httpd.apache.org) jak i [serwerze HTTP Nginx](http://nginx.org), na systemie
|
||||
operacyjnym Windows, Mac OS X oraz Linux, posiadającym zainstalowane PHP 5.4 lub wyższe.
|
||||
Yii 2.0 jest również kompatybilne z [facebookowym HHVM](http://hhvm.com).
|
||||
Są jednak przypadki, gdzie Yii zachowuje się inaczej w HHVM niż w natywnym PHP, dlatego powinieneś zachować
|
||||
szczególną ostrożność używając HHVM.
|
||||
operacyjnym Windows, Mac OS X oraz Linux, posiadającym zainstalowane PHP 5.4 lub nowsze. Yii 2.0 jest również kompatybilne
|
||||
z [facebookowym HHVM](http://hhvm.com), są jednak przypadki, gdzie Yii zachowuje się inaczej w HHVM niż w natywnym PHP,
|
||||
dlatego powinieneś zachować szczególną ostrożność używając HHVM.
|
||||
|
||||
Na serwerze produkcyjnym możesz skonfigurować swój host tak, aby aplikacja była dostępna pod adresem `http://www.example.com/index.php` zamiast
|
||||
`http://www.example.com/basic/web/index.php`.
|
||||
Taka konfiguracja wymaga wskazania głównego katalogu serwera jako katalogu `basic/web`.
|
||||
Jeśli chcesz ukryć `index.php` w adresie URL, skorzystaj z informacji opisanych w dziale
|
||||
[routing i tworzenie adresów URL](runtime-routing.md).
|
||||
Na serwerze produkcyjnym możesz skonfigurować swój host tak, aby aplikacja była dostępna pod adresem
|
||||
`http://www.example.com/index.php` zamiast `http://www.example.com/basic/web/index.php`. Taka konfiguracja wymaga wskazania
|
||||
głównego katalogu serwera jako katalogu `basic/web`. Jeśli chcesz ukryć `index.php` w adresie URL, skorzystaj z informacji
|
||||
opisanych w dziale [routing i tworzenie adresów URL](runtime-routing.md).
|
||||
W tej sekcji dowiesz się, jak skonfigurować Twój serwer Apache lub Nginx, aby osiągnąć te cele.
|
||||
|
||||
> Info: Ustawiając `basic/web` jako główny katalog serwera unikasz niechcianego dostępu użytkowników końcowych do prywatnego kodu oraz wrażliwych plików aplikacji, które są
|
||||
> przechowywane w katalogu `basic`.
|
||||
> Zablokowanie dostępu do tych folderów jest jednym z wymogów bezpieczeństwa aplikacji.
|
||||
> Info: Ustawiając `basic/web` jako główny katalog serwera, unikasz niechcianego dostępu użytkowników końcowych do
|
||||
prywatnego kodu oraz wrażliwych plików aplikacji, które są przechowywane w katalogu `basic`. Zablokowanie dostępu do
|
||||
tych folderów jest jednym z wymogów bezpieczeństwa aplikacji.
|
||||
|
||||
> Info: W przypadku, gdy Twoja aplikacja działa na wspólnym środowisku hostingowym, gdzie nie masz dostępu do modyfikowania konfiguracji serwera, nadal możesz zmienić strukturę
|
||||
> aplikacji dla lepszej ochrony.
|
||||
> Po więcej informacji zajrzyj do działu [Współdzielone środowisko hostingowe](tutorial-shared-hosting.md).
|
||||
> Info: W przypadku, gdy Twoja aplikacja działa na wspólnym środowisku hostingowym, gdzie nie masz dostępu do modyfikowania
|
||||
konfiguracji serwera, nadal możesz zmienić strukturę aplikacji dla lepszej ochrony. Po więcej informacji zajrzyj do
|
||||
działu [Współdzielone środowisko hostingowe](tutorial-shared-hosting.md).
|
||||
|
||||
### Zalecane ustawienia Apache <span id="recommended-apache-configuration"></span>
|
||||
|
||||
@@ -189,9 +217,14 @@ DocumentRoot "path/to/basic/web"
|
||||
<Directory "path/to/basic/web">
|
||||
# użyj mod_rewrite do wsparcia "ładnych URLi"
|
||||
RewriteEngine on
|
||||
|
||||
# jeśli $showScriptName jest ustawione na false w UrlManager, nie pozwalaj na dostęp do URLi za pomocą nazwy skryptu
|
||||
RewriteRule ^index.php/ - [L,R=404]
|
||||
|
||||
# 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
|
||||
|
||||
@@ -202,8 +235,8 @@ DocumentRoot "path/to/basic/web"
|
||||
### Zalecane ustawienia Nginx <span id="recommended-nginx-configuration"></span>
|
||||
|
||||
Aby użyć [Nginx](http://wiki.nginx.org/) powinienieś zainstalować PHP jako [FPM SAPI](https://secure.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.test` 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.test` aktualną nazwą hosta.
|
||||
|
||||
```nginx
|
||||
server {
|
||||
@@ -231,7 +264,7 @@ server {
|
||||
#}
|
||||
#error_page 404 /404.html;
|
||||
|
||||
# deny accessing php files for the /assets directory
|
||||
# zablokuj dostęp do plików php w folderze /assets
|
||||
location ~ ^/assets/.*\.php$ {
|
||||
deny all;
|
||||
}
|
||||
@@ -255,3 +288,96 @@ aby zapobiec wielu zbędnym wywołaniom `stat()`.
|
||||
|
||||
Należy również pamiętać, że podczas pracy na serwerze HTTPS musisz dodać `fastcgi_param HTTPS on;`,
|
||||
aby Yii prawidłowo wykrywało, że połączenie jest bezpieczne.
|
||||
|
||||
### Zalecane ustawienia NGINX Unit <span id="recommended-nginx-unit-configuration"></span>
|
||||
|
||||
Możesz uruchomić aplikacje oparte na Yii korzystając z [NGINX Unit](https://unit.nginx.org/) z modułem języka PHP. Poniżej
|
||||
znajdziesz przykładową konfigurację.
|
||||
|
||||
```json
|
||||
{
|
||||
"listeners": {
|
||||
"*:80": {
|
||||
"pass": "routes/yii"
|
||||
}
|
||||
},
|
||||
|
||||
"routes": {
|
||||
"yii": [
|
||||
{
|
||||
"match": {
|
||||
"uri": [
|
||||
"!/assets/*",
|
||||
"*.php",
|
||||
"*.php/*"
|
||||
]
|
||||
},
|
||||
|
||||
"action": {
|
||||
"pass": "applications/yii/direct"
|
||||
}
|
||||
},
|
||||
{
|
||||
"action": {
|
||||
"share": "/path/to/app/web/",
|
||||
"fallback": {
|
||||
"pass": "applications/yii/index"
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"applications": {
|
||||
"yii": {
|
||||
"type": "php",
|
||||
"user": "www-data",
|
||||
"targets": {
|
||||
"direct": {
|
||||
"root": "/path/to/app/web/"
|
||||
},
|
||||
|
||||
"index": {
|
||||
"root": "/path/to/app/web/",
|
||||
"script": "index.php"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Możesz również [skonfigurować](https://unit.nginx.org/configuration/#php) swoje środowisko PHP lub przygotować
|
||||
spersonalizowany plik `php.ini` w tej samej konfiguracji.
|
||||
|
||||
### Konfiguracja IIS <span id="iis-configuration"></span>
|
||||
|
||||
Zalecane jest hostowanie aplikacji na wirtualnym hoście (strona Web), gdzie podstawowa ścieżka dokumentów wskazuje na folder
|
||||
`path/to/app/web` i strona Web jest skonfigurowana do uruchamiania PHP. W folderze `web` musisz umieścić plik `web.config`
|
||||
(`path/to/app/web/web.config`). Zawartość tego pliku powinna wyglądać jak poniżej:
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<configuration>
|
||||
<system.webServer>
|
||||
<directoryBrowse enabled="false" />
|
||||
<rewrite>
|
||||
<rules>
|
||||
<rule name="Hide Yii Index" stopProcessing="true">
|
||||
<match url="." ignoreCase="false" />
|
||||
<conditions>
|
||||
<add input="{REQUEST_FILENAME}" matchType="IsFile"
|
||||
ignoreCase="false" negate="true" />
|
||||
<add input="{REQUEST_FILENAME}" matchType="IsDirectory"
|
||||
ignoreCase="false" negate="true" />
|
||||
</conditions>
|
||||
<action type="Rewrite" url="index.php" appendQueryString="true" />
|
||||
</rule>
|
||||
</rules>
|
||||
</rewrite>
|
||||
</system.webServer>
|
||||
</configuration>
|
||||
```
|
||||
Sprawdź również poniższe oficjalne poradniki firmy Microsoft, opisujące jak poprawnie skonfigurować PHP dla IIS:
|
||||
1. [Jak uruchomić swoją pierwszą stronę Web na IIS](https://docs.microsoft.com/en-us/iis/manage/creating-websites/scenario-build-a-static-website-on-iis)
|
||||
2. [Konfiguracja strony Web PHP dla IIS](https://docs.microsoft.com/en-us/iis/application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis)
|
||||
|
||||
Reference in New Issue
Block a user