3.7 KiB
Komponenty
Komponenty są głównym budulcem aplikacji Yii. Komponenty to instancje klasy yii\base\Component lub jej potomnych. Trzy główne funkcjonalności, które zapewniają komponenty innym klasom to:
Wszystkie razem i każda z tych funkcjonalności osobno zapewnia klasom Yii o wiele większą elastyczność i łatwość użycia. Dla przykładu, dołączony yii\jui\DatePicker, komponent interfejsu użytkownika, może być użyty w widoku, aby wygenerować interaktywny kalendarz:
use yii\jui\DatePicker;
echo DatePicker::widget([
'language' => 'pl',
'name' => 'country',
'clientOptions' => [
'dateFormat' => 'yy-mm-dd',
],
]);
Właściwości widżetu są w łatwy sposób konfigurowalne ponieważ jego klasa rozszerza yii\base\Component.
Komponenty zapewniają duże możliwości, ale przez to są też bardziej zasobożerne od standardowych obiektów, ponieważ wymagają dodatkowej pamięci i czasu CPU dla wsparcia eventów i behaviorów w szczególności. Jeśli komponent nie wymaga tych dwóch funkcjonalności, należy rozważyć rozszerzenie jego klasy z yii\base\Object zamiast yii\base\Component. Dzięki temu komponent będzie tak samo wydajny jak standardowy obiekt PHP, ale z dodatkowym wsparciem właściwości.
Rozszerzając klasę yii\base\Component lub yii\base\Object, zalecane jest aby przestrzegać następującej konwencji:
- Przeciążając konstruktor, dodaj parametr
$config
jako ostatni na liście jego argumentów i przekaż go do konstruktora rodzica. - Zawsze wywoływuj konstruktor rodzica na końcu przeciążanego konstruktora.
- Przeciążając metodę yii\base\Object::init(), upewnij się, że wywołujesz metodę
init
rodzica na początku własnej implementacji metodyinit
.
Przykład:
<?php
namespace yii\components\MyClass;
use yii\base\Object;
class MyClass extends Object
{
public $prop1;
public $prop2;
public function __construct($param1, $param2, $config = [])
{
// ... inicjalizacja przed zaaplikowaniem konfiguracji
parent::__construct($config);
}
public function init()
{
parent::init();
// ... inicjalizacja po zaaplikowaniu konfiguracji
}
}
Postępowanie zgodnie z tymi zasadami zapewni konfigurowalność Twojego komponentu, kiedy już zostanie utworzony. Dla przykładu:
$component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]);
// lub alternatywnie
$component = \Yii::createObject([
'class' => MyClass::className(),
'prop1' => 3,
'prop2' => 4,
], [1, 2]);
Info: Wersja z wywołaniem Yii::createObject() wygląda na bardziej skomplikowaną, ale jest o wiele wydajniejsza, ponieważ jej implementację zapewnia kontener wstrzykiwania zależności.
Klasa yii\base\Object wymusza następujący cykl życia obiektu:
- Preinicjalizacja w konstruktorze. W tym miejscu można ustawić domyślne wartości właściwości.
- Konfiguracja obiektu poprzez
$config
. Konfiguracja może nadpisać domyślne wartości ustawione w konstruktorze. - Postinicjalizacja w metodzie yii\base\Object::init(). Metoda może być przeciążona w celu normalizacji i sanityzacji właściwości.
- Wywołanie metody obiektu.
Pierwsze trzy kroki są w całości wykonywane w konstruktorze obiektu, co oznacza, że uzyskana instancja klasy jest już poprawnie zainicjowana i stabilna.