yiiapi/docs/guide/pl/topics.gii.txt

这里只显示每个文件的开头 60 行。登录后可以解锁完整代码。

微信扫码关注公众号，代码整理好后第一时间通知你。

Automatyczne generowanie kodu
=========================

Poczynając od wersji 1.1.2, Yii wyposażone jest w przeglądarkowe narzędzie do generowania kodu *Gii*. Zastępuje ona poprzednie narzędzie do generacji `yiic shell`, które uruchamiane jest z linii poleceń. W tej części opiszemy jak używać Gii i jak rozszerzać Gii by zwiększyć produktywność dewelopmentu.

Używanie Gii
---------

Gii zaimplementowane zostało w postaci modułu i musi być używane wewnątrz istniejącej aplikacji Yii. Aby używać Gii, najpierw modyfikujemy konfigurację aplikacji w następujący sposób:

~~~
[php]
return array(
	......
	'modules'=>array(
		'gii'=>array(
			'class'=>'system.gii.GiiModule',
			'password'=>'wprowadź tutaj hasło',
			// 'ipFilters'=>array(...lista adresów IP...),
			// 'newFileMode'=>0666,
			// 'newDirMode'=>0777,
		),
	),
);
~~~

W powyższym kodzie deklarujemy moduł nazwany `gii` którego klasą jest [GiiModule]. Określamy również hasło dla modułu, które będzie rządane podczas uzyskiwania dostępu do Gii. 

Domyślnie, z powodu bezpieczeństwa, Gii skonfigurowane jest jako dostępne na lokalnym komputerze. Jeśli chcemy udostępnić go dla innych zaufanych komputerów, możemy skonfigurować właściwość [GiiModule::ipFilters] w sposób pokazany w powyższym kodzie.

Ponieważ Gii może generować i zapisywać nowe pliki z kodem w istniejącej aplikacji, musimy się upewnić, że proces serwera ma odpowiednie uprawnienia do tego. Powyższe właściwości [GiiModule::newFileMode] oraz [GiiModule::newDirMode] kontrolują jak nowe pliki i katalogi powinny być wygenerowane.

> Note|Uwaga: Gii jest przewidziane jako narzędzie deweloperskie. Dlatego też, powinno być zainstalowane jedynie na maszynie deweloperskiej. Ponieważ może ono generować nowe skrypty PHP w aplikacji, powinniśmy zwracać dostateczną uwagę na środki bezpieczeństwa (np. hasła, filtry IP).

Możemy uzyskać dostęp do Gii poprzez adres URL `http://hostname/sciezka/do/index.php?r=gii`. Zakładamy, że `http://hostname/sciezka/do/index.php` to URL dostępu do istniejącej aplikacji Yii.

Jeśli istniejąca aplikacjia Yii używa formatu URL `ścieżek` (zobacz [zarządzanie URL-ami](/doc/guide/topics.url)), możemy uzyskać dostęp do Gii poprzez adres URL `http://hostname/sciezka/do/index.php/gii`. Możemy dodać następujący reguły URL na początej istniejących reguł URL:

~~~
[php]
'components'=>array(
	......
	'urlManager'=>array(
		'urlFormat'=>'path',
		'rules'=>array(
			'gii'=>'gii',
			'gii/<controller:\w+>'=>'gii/<controller>',
			'gii/<controller:\w+>/<action:\w+>'=>'gii/<controller>/<action>',
			...dotychczasowe reguły...
		),
	),
)
~~~

Gii dostarczane jest z kilkoma domyślnymi generatorami kodu. Każdy generator kodu jest odpowiedzialny za generowanie określonego typu kodu. Na przykład, generator kontrolera generuje klasę kontrolera wraz z kilkoma skryptami widoków akcji; generator modelu generuje klasę rekordu aktywnego dla określonej tabeli bazy danych.

Kolejne kroki używane podczas generowania wyglądają następująco:

1. Wejdź na stronę generatora;
2. Uzupełnij pola, które określają parametry generacji kodu. Na przykład, aby używać generatora modułu do utworzenia nowego modułu, należy podać ID modułu.