Migracja z Zend Framework w wersji 0.8.0 do 1.0.0 RC1


Wczoraj przeprowadziłem migrację biblioteki Zend Framework z wersji 0.8.0 do 1.0.0RC1 w mojej aplikacji. Zamieszczam spis najważniejszych zadań jakie trzeba było wykonać, myślę, że może to trochę ułatwić przejście przez proces migracji.

  1. Ładowanie plików oraz klas
  2. Korzystanie z rejestru
  3. Informacje o wersji
  4. Nazwy tabel w modelach
  5. Aliasy dla tabel w zapytaniach
  6. Wyświetlanie informacji o zmiennych
  7. Metoda find() w modelach
  8. Przekierowania
  9. Filtrowanie danych przychodzących
  10. Klasa ViewRenderer

1. Ładowanie plików oraz klas

W związku z rezygnacją z głównej klasy Zend metody służące do ładowania plików oraz klas zostały przeniesione do komponentu Zend_Loader. Trzeba zmienić wywołania ładujące moduł:

PLAIN TEXT
PHP:
  1. <?php
  2. require_once('Zend.php');
  3. // zmienić na
  4. require_once('Zend/Loader.php');
  5. ?>

Zamienić wywołania metody ładującej plik:

PLAIN TEXT
PHP:
  1. <?php
  2. Zend::loadFile();
  3. // zmienić na
  4. Zend_Loader::loadFile();
  5. ?>

Zmienić wywołania metody ładującej klasę:

PLAIN TEXT
PHP:
  1. <?php
  2. Zend::loadClass();
  3. // zmienić na
  4. Zend_Loader::loadClass();
  5. ?>

2. Korzystanie z rejestru

Funkcjonalność rejestru także została przeniesiona do osobnego modułu. Trzeba zmienić wywołania metody dodającej zmienną do rejestru:

PLAIN TEXT
PHP:
  1. <?php
  2. Zend::register('foo', $foo);
  3. // zmienić na
  4. Zend_Registry::set('foo', $foo);
  5. ?>

a także zmienić wywołania metody odbierającej zmienną:

PLAIN TEXT
PHP:
  1. <?php
  2. Zend::registry('foo');
  3. // zmienić na
  4. Zend_Registry::get('foo');
  5. ?>

3. Informacje o wersji

Stała przechowująca informacje o wersji została przeniesiona z klasy Zend do osobnego komponentu. Trzeba zmienić odwołania do tej stałej:

PLAIN TEXT
PHP:
  1. <?php
  2. Zend::VERSION;
  3. // zmienić na
  4. Zend_Version::VERSION;
  5. ?>

4. Nazwy tabel w modelach

Obecnie nazwy klas modeli, czyli klas rozszerzających Zend_Db_Table, nie są już konwertowane z postaci NazwaKlasy na nazwa_tabeli, więc trzeba o to zadbać samemu. Można to zrobić ustawiając w każdym modelu na sztywno nazwę tabeli, za którą model jest odpowiedzialny:

PLAIN TEXT
PHP:
  1. <?php
  2. class FooBar
  3. {
  4.   protected $_name = 'foo_bar';
  5. }
  6. ?>

Jeśli nie ustawimy nazwy tabeli, to jako nazwa tabeli zostanie bezpośrednio użyta nazwa klasy. Ustawienie nazwy tabeli można zrobić też automatycznie dla wszystkich tabel za pomocą klasy transformującej nazwę klasy na nazwę tabeli

5. Aliasy dla tabel w zapytaniach

Jeśli używamy klasy Zend_Db_Select do tworzenia zapytań i w tych zapytaniach stosujemy aliasy dla tabel to trzeba zmienić sposób ich definiowania. Wystarczy zamienić klucz tablicy z jej wartością, czyli:

PLAIN TEXT
PHP:
  1. <?
  2. $select->from(array('foo' => 'f'), $bar);
  3. // zamienić na
  4. $select->from(array('f' => 'foo'), $bar);
  5. ?>

6. Wyświetlanie informacji o zmiennych

Metoda wyświetlająca informacje o zmiennej została przeniesiona z klasy Zend do komponentu Zend_Debug. W związku z tym należy:

PLAIN TEXT
PHP:
  1. <?php
  2. Zend::dump($foo);
  3. // zmienić na
  4. Zend_Debug::dump($foo);
  5. ?>

7. Metoda find() w modelach

Zmienił się typ danych zwracanych przez metodę find(), teraz zawsze zwracany jest obiekt klasy Zend_Db_Table_Rowset, niezależnie od ilości wyników. Trzeba w związku z tym zmienić obsługę danych odebranych za pomocą tej metody, najłatwiej można to zrobić dodająć wywołanie metody current():

PLAIN TEXT
PHP:
  1. <?php
  2. $model->find($foo);
  3. // zmienić na
  4. $model->find($foo)->current();
  5. ?>

W związku z tą zmianą trzeba też zmienić typ danych zwracanych przez nadpisaną w modelu metodę find(). Jeśli w klasie modelu nie nadpisujemy tej metody, to można to pominąć.

8. Przekierowania

W wersji 1.0.0 RC1 pojawił się problem z działającymi do tej pory przekierowaniami, mianowicie przestała działać opcja PrependBase. W moim przypadku udało się rozwiązać ten błąd zmieniając jedną linijkę w klasie Zend_Controller_Action_Helper_Redirector:

PLAIN TEXT
PHP:
  1. <?php
  2. // linia 179
  3. if (!empty($base) && ('/' != $base)) {
  4. // zmieniona na
  5. if (empty($base) && ('/' != $base)) {
  6. ?>

Wydaje mi się, że jest to wina błędu w tym pliku, z tego co czytałem do obsługa przekierowań ma być poprawiona w wersji RC2.

9. Filtrowanie danych przychodzących

Tymczasowo przygotowałem klasę Foo_Filter_Input, aby przyspieszyć migrację przez opóźnienie wdrożenia w aplikacji komponentu Zend_Filter_Input:

PLAIN TEXT
PHP:
  1. <?php
  2. class Foo_Filter_Input extends Zend_Filter_Input
  3. {
  4.     protected $_source = NULL;
  5.  
  6.     public function __construct(&$source = NULL, $strict = TRUE)
  7.     {
  8.         $this->_source = $source;
  9.  
  10.         if ($strict) {
  11.             $source = NULL;
  12.         }
  13.     }
  14.  
  15.     public function __call($method, $args)
  16.     {
  17.         if (!$this->keyExists($key)) {
  18.             return false;
  19.         }
  20.  
  21.         $method = substr($method, 3);
  22.  
  23.         return Zend_Filter::get($this->_source[$args[0]], $method);
  24.     }
  25.  
  26.     public function keyExists($key)
  27.     {
  28.         return array_key_exists($key, $this->_source);
  29.     }
  30.  
  31. }
  32. ?>

Dodatkowo trzeba zmienić wywołania filtra noTags:

PLAIN TEXT
PHP:
  1. <?php
  2. $input->noTags('foo');
  3. // zmienić na
  4. $input->getStripTags('foo');
  5. ?>

Jesto jednak rozwiązanie tymczasowe, docelowo warto wdrożyć komponent Zend_Filter_Input.

10. Klasa ViewRenderer

Domyślnie włączoną klasę pomocniczą ViewRenderer tymczasowo wyłączyłem w pliku ładującym za pomocą:

PLAIN TEXT
PHP:
  1. <?php
  2. $front->setParam('noViewRenderer', true);
  3. ?>

Docelowo warto będzie ją jednak włączyć, aby cały proces generowania widoków odbywał się automatycznie, jednak na razie brak jest obsługi layoutów, czegoś w stylu Master Pages w ASP.NET, więc nie jest to jeszcze zbyt wygodne.

W nowej wersji pojawia się też plugin ErrorHandler, do tej pory używałem podobnego własnego plugina, więc po prostu go zastąpiłem.

Oczywiście mogą być konieczne jeszcze inne zmiany, których tu nie opisałem, z tego względu, że w mojej aplikacji nie używam wszystkich komponentów, a w nich także mogły pojawić się zmiany.

Więcej szczegółów na temat migracji dla klas MVC można znaleźć w dokumentacji w rozdziale na temat migracji z wersji 0.9.3 do 1.0.0RC1

Informacje oraz linki

Informacje
czerwiec 8th, 2007
Jeden komentarz
Kanały oraz odnośniki
Kanał komentarzy
Artykuły tego autora
Del.icio.us
Digg
Technorati
Categories and Tags
PHP
Zend Framework

Inne artykuły
Zend Framework 1.0.0 już jest!
Zend Framework 1.0.0 RC1
Polecane
Zend Studio - The premiere PHP IDE

Dodaj komentarz

Poświęć chwilę i wyraź swoją opinię. Możesz użyć niektórych znaczników HTML.

Komentarze czytelników

Gravatar:
Dodał:
Kubek Bartosz
Data:
16 czerwiec 2007 at 2:03

Dobry tekst. Gratuluję. Ja przechodziłem z wersji 0.6 do 0.9 i także musiałem zastosować pewne obejścia. Jak chociżby wyłączenie inicjalizacji widoku, ponieważ miałem napisaną już własną obsługę widoków od wersji 0.2. Czas jednak byłoby zabrać sie za napisanie aplikacji niemalże od początku w stylu 1.0 :) Pozdrawiam!