Tuesday, September 28, 2010

Könyvajánló: Agile Web Application Development with Yii 1.1 and PHP5

A következő könyvajánló a Weblabor hasábjain jelent meg pár nappal ezelőtt, Orionstar klaviatúrájából:



A könyv azon haladó PHP fejlesztők számára készült, akik otthonosan mozognak az objektumorientált programozás világában, és felgyorsítanák munkájukat egy keretrendszer használatával. A könyv e fejlesztőket vezeti be a Yii keretrendszer alapszintű használatába pár egyszerű és egy komplex példán keresztül, agilis fejlesztési módszertant alkalmazva. Habár a tudásanyag nagy része könnyedén elérhető a keretrendszer weblapján illetve fórumában kutakodva, ezt a keresést helyettesíti részben a könyv kibővítve az agilis szempontból történő fejlesztéssel.
A könyv egy rövid összefoglalóval indít, hogy miért a Yii keretrendszert válasszuk. Röviden bemutatja a Yii által alkalmazott tervezési mintát, az MVC-t. Ez tényleg csak egy rövid összefoglaló, aki nincs tisztában ezzel, annak először ajánlott utána járni, majd ezt követően jönnek az egyszerű példák. A későbbi fejezetek során szoftverfejlesztési életciklus követésre képes alkalmazás lépésenkénti fejlesztését mutatja be a szerző a főbb funkciók megvalósításon keresztül, a témakezelésen át az RSS hírlevél és cachelésig. Maga a példa rendkívül hasonló a keretredszer oldalán megtalálható blog példához.
Miért érdemes hát elolvasni a könyvet, ha szinte minden elérhető az interneten is? Azért, mert a kezdéshez szükséges több helyen felhalmozott tudást a szerző összefoglalja, és mindezt olyan módszertan segítségével teszi, amiből az olvasók profitálhatnak. Engem személy szerint arra ösztökélt, hogy jobban utánajárjak az agilis módszertannak, amit noha korábban elvetettem a vízesés modellre esküdve. Továbbá nagy hangsúlyt fektet a(z) (egység)tesztelés részletes bemutatására is, amiről hajlamosak vagyunk olykor elfeledkezni.
Hogyan tovább, mi hiányzik? A könyv csak bevezető a Yii világába, ezért nem találhatók meg benne jQuery-vel, Ajaxszal, web service-okkal kapcsolatos példák, amik viszont a Yii igazi erejét adják, de az interneten sok példakód, tutorial elérhető melyek segítenek továbbfejleszteni tudásunk.

Az eredeti cikk itt található: http://weblabor.hu/konyvek/agile-yii-11-and-php5

Tuesday, September 21, 2010

Yii Radiio - 31. adás

MZ/x MZ/x,

Itt a Yii Radiio 31. adása, nézzük mik a legújabb hírek a Yii háza táján:

- Hosszas fontolgatás után úgy döntöttünk, hogy a Facebook 'csoport' helyett egy 'oldal'-t készítünk amivel talán egyszerűbben tudunk kapcsolatot teremteni az érdeklődőkkel. Csupán LIKE-olni kell és kész is :) http://facebook.com/yiiradiio.

- Frank Kleine még 2008-ban írt egy cikket az 'annotations' és a PHP kapcsolatáról, és most újraelemzi a helyzetet, és egy megoldásra is rámutat a Yii segítségével.
http://www.stubbles.org/archives/79-State-of-annotations-in-the-PHP-world,-revisited.html

- A HAML and SASS kiterjesztésnek jelent meg  egy újabb változata. Aki nem ismerné, a Ruby környezetben már régóta használt HTML és CSS "csonka kód" megoldásról van szó, aminek segítségével sokkal gyorsabban tudunk program kódot írni, hiszen nem kell annyit gépelnünk ...
http://www.yiiframework.com/extension/haml-and-sass/

- Végre a Yii-hez is elért a már rengeteg helyen használt OAuth. Köszönet CGeorge-nak.
http://www.yiiframework.com/extension/eoauth/

- Megjelent a Yii 1.1.4-es változata, közel 60 hibajavítással és újításokkal. A teljes listáért ide klikkoljatok:
http://www.yiiframework.com/files/CHANGELOG-1.1.4.txt

- Az MVC (Modell - Nézet - Vezérlő) elterjedésével egyre többen próbálják újraértelmezni a már jól bevált technológiát, de még mindig MVC-nek álcázva. A "Nézet az nem Template" -
http://r.je/views-are-not-templates.html

- Ha már nem lenne elég, itt egy újabb NoSQL szerű adatbázis motor, de azt mondják jobb minden eddiginél. Majd meglátjuk: Pomegranate.

- A hét oldala: PicLyf képmegosztó szolgáltatás és közösségi oldal a Twidl Inc.-től.

Wednesday, September 15, 2010

Temesvári Imre: Online informatikai tudásbázis Yii alapokon

Az interneten böngészgetve akadtam erre a remek kis szakdolgozatra, amit Temesvári Imre publikált:

"Szakdolgozatom célja és témája egy olyan informatikai tudásbázis elkészítése, amely az informatika minden területéről összegyűjti a szakszavakat, fogalmakat, kifejezéseket – abból a célból, hogy az érdeklődőnek pontos információt adhasson. Jellege tudásbázis – ami annyival több, mint egy adatbázis vagy informatikai szótár, hogy nem egy valaki, vagy egy zárt csoport fejleszti - bővíti, hanem mindenki, aki az oldalt felkeresi, és érdemben tud rajta javítani, hozzá tenni. A cél egy minél bővebb tudásbázis létrehozása, ahol az érdeklődő gyorsan megtalálhatja a magyarázatot az általa nem ismert szóra, fogalomra.

A tudásbázis Yii alapokon fog működni, ami egy nem túl régi és még nem annyira elterjedt PHP keretrendszer. A keretrendszer jelentősen meggyorsíthatja a fejlesztés menetét, és az előre elkészített osztályok, kódok felhasználásával segíti a fejlesztő munkáját. Így a szakdolgozat másik célja a Yii bemutatása, megismertetése."
A szakdolgozat (PDF)

(az eredeti cikk itt található: http://nagygusztav.hu/temesvari-imre-online-informatikai-tudasbazis-yii-alapokon)

Saturday, September 11, 2010

Környezetbarát Egységtesztelés Meztelencsigákkal


avagy, hogyan gyártsunk Egységtesztelős programot a Yii-vel.

Mi ez?

Ha netán a címből nem lenne eléggé egyértelmű, a következőkben Egységteszetkről (Unit Test) lesz szó PHP-s környezetben. Ha a nyájas olvasó még nem olvasta a korábban megjelent Yiiki al'a Yii cikket, és semmilyen tapasztalata nincs a Yii keretrendszerrel, mindenképp érdemes rajta átfutni ugyanis itt nem fogunk belemenni az alapvető, -Na most akkor, hogy is kezdjem? kérdésekbe.

Mi lesz ez?

Egy nagyon egyszerű URL rövidítőt fogunk késziteni, mint pl a http://tinyurl.com vagy a http://vurl.me. Ha valaki nem ismerné, a lényeg az, hogy marha hosszú URL-eket lekicsinyítünk, és ha valahol egy felhasználó az általunk lekicsinyített linkre (slug) kattint, azt továbbítjuk a megfelelő oldalra.

Bevezetés

Környezet:

  • PHP 5.2.x
  • Apache (a PHP futtatásához)
  • SQLite (az egyszerűség kedvéért használjuk ezt, lehetne MySQL is)
  • Yii 1.1.3 (de elvileg működik az 1.1-es ág bármelyik csomagjával)
  • PHPUnit (tesztelést végrehajtó program: http://www.phpunit.de )

Fogalmak:

Test Driven Development (TDD) - Tesztelésen alapuló fejlesztés.
Ezt talán úgy lehetne a legegyszerűbben bemutatni, hogy képzeljünk el egy adott problémát és próbáljuk meg visszafelé megoldani. Oké, lehet, hogy ez így elsőre hülyén hangzik, de talán ez az ábra segíthet.
  1. Írjunk tesztet
  2. Ellenőrizzük, hogy a tesztünk hibázik (FAIL)
  3. Írjuk meg (a legegyszerűbben!) a kívánt kódot úgy, hogy a tesztünk sikeres legyen.
  4. Ellenőrizzük, hogy a tesztünk sikeres e (PASS)
  5. Módosítsuk a kódunkat (úgy, hogy a teszt még mindig sikeres maradjon!)
  6. Kezdjük előlről az egészet.
Unit Test - Egységteszt.
Az egységek, komponensek tesztelése, hogy megbizonyosodjunk a működésének helyességéről. Cél, hogy feltárja nincsenek-e tévműködések, feltáratlan hibák a belső algoritmusban, adatkezelésben. A komponensek más rendszer komponensektől függetlenül vannak tesztelve. (http://www.dcs.vein.hu/)
Ez így elsőre, másodikra de talán még harmadikra is érdekesen hangozhat, de reméljük a cikk végén minden világos lesz.
(ja, itt ajánlanám Erenon írását.)

Adatbázis

Mint korábban említettük, SQLite3-at fogunk használni, de gyakorlatilag bármilyen adatbázis motorral is műküdik a dolog.

Táblák

protected/data/rovidke.db
++++++++++++++++++++++++++
+ urls                   +
++++++++++++++++++++++++++
+ id INT (auto_increment)+
+ url TEXT               +
+ slug VARCHAR(50)       +
+ created INT            +
++++++++++++++++++++++++++
SQLite3
CREATE TABLE urls (created INTEGER, id INTEGER PRIMARY KEY AUTOINCREMENT, slug varchar(50), url TEXT);
Na, ennyi pepecselés után ugorjunk is bele a programozásba. Miután sikeresen létrehoztuk az alap alkalmazásunkat (pl: yiic webapp rovidke). Állítsuk is be egyből az adatbázis kapcsolatot.
protected/config/main.php
...
  'connectionString' => 'sqlite:'.dirname(__FILE__).'/../data/rovidke.db',
...
Itt szeretném megjegyezni, hogy többször is belefutottam a következő hibaüzenetbe (SQLite esetén, Linux-szal, lehet, hogy ez MS környezetben nem gond)
CDbCommand failed to execute the SQL statement: SQLSTATE[HY000]: General error: 8 attempt to write a readonly database
Ez annyit jelent, hogy az adatbázis file-t a program nem tudta írásra megnyitni, tehát át kell állítanunk a jogokat (ha csak a saját gépemen programozok, és nem foglalkozok a biztonsággal, egyszerűen 777-et adok neki :) )

Itt a MVC

Modell

Első lépésként hozzuk is létre a Url modellünket. Ha valaki nagyon bátor, az használhatja az új csodafegyvert: Gii, amit a yiic utódjának szán a Yii fejlsztői csapat. Tulajdonképpen egy grafikus, bongészőbarát kódgeneráló eszköz. (a cikkben a yiic-et fogjuk használni)
./protected/yiic shellYii Interactive Tool v1.1 (based on Yii v1.1.3)
Please type 'help' for help. Type 'exit' to quit.
>> _
>> model Url urls
   generate models/Url.php
   generate fixtures/urls.php
   generate unit/UrlTest.php
The following model classes are successfully generated:
    Url
If you have a 'db' database connection, you can test these models now with:
    $model=Url::model()->find();
    print_r($model);
>>
Akiknek jobb a szeme, azok nyilván észrevették a teszt csomagot, amit a Yii alapból elkészít minden modellhez a protected/tests/unit mappa alatt. Gyakorlás képpen Futtassuk is le "tesztjeinket" (protected/tests/) ...
$phpunit unit...
There was 1 error:
1) testCreate(UrlTest)
CDbException: The table "urls" for active record class "Url" cannot be found in the database.
...
Hoppá, hát az meg mi? Mi az, hogy nincs ilyen tábla az adatbázisban?
Azt fontos megjegyezni, hogy tesztelés közben nem egy, csak és kizárólag, a teszthez írt funkciót futtatunk, hanem az éles alkalmazás kódját. Ami azt jelenti, hogy a funkció az mindig ugyanaz marad és mindig ugyanúgy fut le. Hova is akarok ezzel kilyukadni? A lényeg, hogy amikor a teszteket futtatjuk, a program egy előre legyártott adat-tömbből (fixtures) veszi az adatokat, ezeket egy adatbázisba teszi, lefutattja a tesztet, és törli a DB táblákban tárolt bejegyzéseket. Tehát fontos, hogy az éles adatbázis és a teszt adatbázis különböző legyen!
Innen jött a hibaüzenet, ugyanis a teszt adatbázisunk még nem létezik. Csináljunk is egyet ...
protected/data/rovidke_test.db
++++++++++++++++++++++++++
+ urls                   +
++++++++++++++++++++++++++
+ id INT (auto_increment)+
+ url TEXT               +
+ slug VARCHAR(50)       +
+ created INT            +
++++++++++++++++++++++++++
SQLite3
CREATE TABLE urls (created INTEGER, id INTEGER PRIMARY KEY AUTOINCREMENT, slug varchar(50), url TEXT);
... és módosítsuk a teszt(!) konfigurációs file-t az alábbiak szerint
protected/config/test.php
...
 'connectionString'=>'sqlite:' . dirname(__FILE__).'/../rovidke_test.db',
...
ha, most lefuttatjuk a tesztünket ... protected/tests/
$phpunit unitPHPUnit 3.3.16 by Sebastian Bergmann.
.
Time: 0 seconds

OK (1 test, 0 assertions)
minden OK! Birkabőr (Juhéjj)!
Kedvenc szövegszerkesztőnkkel nyissuk meg a UrlTest? a protected/tests/unit/ könyvtárból (aki VIM-et hasznal +1 piros pontot kap). Ez elvileg üres, illetve, az osztályt a Yii már létrehozta, és talán akad is egy példa teszt. Ha van, ha nincs, a lényeg, hogy minden teszt funkciónak a testcimkével kell kezdődnie. Nem történik semmi baj, ha nem kezdjük ezzel a tesztünket, de nem fog lefutni. A gyakorlás kedvéért csináljunk is két tesztet ...
protected/tests/unit/UrlTest?.php
...
    public function testTrue()
    {
        $this->assertTrue( false );
    }

    public function testTrue2()
    {
        $this->assertTrue( true );
    }
...
Ez talán elég világos, de ha nem, akkor röviden annyi történik, hogy elsőben megvizsgáljuk, hogy az IGAZ az HAMIS e, a másodikban pedig, hogy az IGAZ az IGAZ e. Futtasuk is le ...
protected/tests/
$phpunit unit
PHPUnit 3.3.16 by Sebastian Bergmann.

F.
Time: 0 seconds
There was 1 failure:
1) testTrue(UrlTest)
Failed asserting that <boolean:false> is true.
/var/www/rovidke/protected/tests/unit/UrlTest.php:18

FAILURES!
Tests: 2, Assertions: 2, Failures: 1.
Jajj de remek, láthatjuk is, hogy egy darab (F) betűt kaptunk, ami a tévhitekkel ellentétben, az jelenti, hogy FAIL (ja, a pont . meg azt, hogy a teszt PASS(ED), azaz sikeresen lefutott.) Ha jobban megvizsgáljuk az üzenetet, akkor még az is kiderül, hogy Failed asserting that <boolean:false> is true, ami a Google fordító szerint annyit jelent, hogy Elmulasztotta azt állítja, hogy hamis igaz. Remélem lejön a lényeg :)
Rengeteg ilyen "a teszt azt állítja, hogy" funkció létezik, ebben a példában mi csak néhányat fogunk bemutatni/használni. A teljes listáért ide klikkoljatok.

Fixtures - Minta Adat

Mint már korábban említettem, a "teszt csomag" egy úgynevezett adat-tömbből veszi a teszthez szükséges adatokat, most itt erről lesz szó (egy kicsit). Szerencsénkre Yii már létrehozta az alap könyvtárrendszert és a file-okat, sőt még néhány példa tömbböt is készített aprotected/tests/fixtures/urls.php file-ban. Pompás.
Módosítsuk is az értékeket, valahogy így:
return array(
        'sample1'=>array(
                'created' => '1234567890',
                'slug' => 'AA',
                'url' => 'http://weblabor.hu',
        ),
        'sample2'=>array(
                'created' => '1234567890',
                'slug' => 'AB',
                'url' => 'http://google.com',
        ),
);
Ugyan ezek az adat-tömbök elhanyagolhatóak, a gyakorlatban szinte mindig hasznaljuk őket.

Megint Tesztelünk

Nyissuk meg a URL teszt file-unkat és írjunk gyorsan egy számláló tesztet, ami megszámolja az összes linket a táblában:
protected/tests/unit/UrlTest?.php
...
    public function testCountAll()
    {
        $urls_count = sizeof(Url::model()->findAll());
        $this->assertEquals( 2, $urls_count );
    }
...
A példa kedvéért itt az assertEquals()-t mutatom be, ami azt "Feltételezi", hogy a két megadott érték megegyezik. Ezzel lehet játszadozni, ha valami nem stimmel a tesztünk úgyis elbukik. PL:
protected/tests
$phpunit unit/
...
  Failed asserting that <integer:2> matches expected value <integer:1>.
...
Ugye milyen egyszerű? Az assertEquals()-ba nem csak szám értéket passzolhatunk ám, hanem akár szöveges változót is:
protected/tests/unit/UrlTest?.php
...
    public function testActionView()
    {
        $url = Url::model()->findByAttributes( array( 'id' => 1 ) );

        $this->assertTrue( $url instanceof Url );
        $this->assertEquals( $url->url, 'http://altavizsla.hu' );
    }
...
ez nyilván elbubik, de ...:
protected/tests/
$phpunit unit...
There was 1 failure:

expected string <http://weblabor.hu>
difference      <       xxxxxxxxxxx??>
got string      <http://altavizsla.hu>
...
Itt a PHPUnit ügyesen megmutatja nekünk, hogy pontosan hol is tértek el a szöveges változók. jajj, de jó :)
Na most nézzünk egy kicsit komolyabb tesztet. A urls táblába csak olyan rekordot szertnénk elmenteni, aminek mind a url, mind a slug értéke be van állítva, tehát nem lehet üres. Írjuk meg a tesztet:
protected/tests/unit/UrlTest?.php
...
    public function testUrlRequired()
    {
        $this->assertTrue( Url::model()->isAttributeRequired( 'url' ) );
    }
...
Ha most lefuttatnánk a tesztünket, akkor nyilvánvalóan elbukna. Szerencsénkre a Yii modell osztálynak van egy ún. rules() (szabályok) funkciója, amivel többek között azt is beállíthatjuk, hogy mely értékek nem lehetnek üresek. Ezt a required-del határozhatjuk meg.
protected/models/Url.php
...
  public function rules()
  {
    return array(
       ...
       array( 'url', 'required' ),
       ...
    );
  }
...
A tesztünk már majdnem sikeres ;) Hasonlóan az előző példához, most állítsuk be a slug-ot is ...
protected/tests/unit/UrlTest?.php
...
    public function testSlugRequired()
    {
        $this->assertTrue( Url::model()->isAttributeRequired( 'slug' ) );
    }
...
TESZT: FAIL!
protected/models/Url.php
...
    return array(
       ...
       array( 'url,slug', 'required' ),
       ...
    );
...
Itt még azt is észrevehetjük, hogy milyen szépen lehet több értéket is megadni a Yii rules()-ban.
TESZT: PASS!
Most nézzünk egy olyan példát, ahol a tesztelésre szánt funkció még nem létezik. Például mi történik akkor, ha egy új URL-t (inkább slug-ot) szeretnénk készíteni. Ha most próbálnánk ki a programot, akkor kézzel kéne beállítanunk a lerövidített URL-t. Na ne má ... Tehát ha az adatbázisunk üres (nincs 1 darab URL sem) akkor az első slug legyen: AA. Na hogy is néz ez ki pontosan?
protected/tests/unit/UrlTest?.php
...
    public function testCreateUrl()
    {
        $url = new Url();
        $url->setAttribute( 'url', 'http://altavizsla.hu' );
        $this->assertTrue( $url->save(), 'URL tarolas tesztelese' );
        $this->assertEquals( $url->slug, 'AA' );
    }
...
A tesztünk az feltételezi, hogy egy új URL esetén az új URL slug-ja az AA értékkel fog visszatérni. A teszt itt nyilván elbukik. (azt érdemes megjegyezni, hogy több feltételezést is meg lehet adni 1 teszten belül).
Itt jön segítségünkre, a beforeValidate() beépített függvény, ami arra szolgál, hogy még a mezők ellenőrzése előtt(!) futtassunk le valamit ...
protected/models/Url.php
    public function beforeValidate()
    {
        $this->slug = $this->createSlug();
        return parent::beforeValidate();
    }

    public function createSlug()
    {
       return 'AA'; 
    }
Azért nem tudtuk itt a beforeSave()-et használni, mert az ellenőrző szabályunk (rule) elbukna, ugyanis a slug nem lehet üres. Most csak azt akarjuk elérni, hogy a tesztünk sikeresen lefusson, ugyanis a createSlug() nem adhat mindig AA értéket, pl. ha több URL-t is szeretnénk tárolni az adatbázisunkban ;). Ha most lefuttatjuk a tesztünket akkor sikeresen lefut. Jajj, de jó. Na most módosítsuk a kódunkat úgy, hogy az tényleg azt csinálja amit akarunk ...
    public function createSlug()
    {
        $slug = Url::model()->find( array( 'order' => 'slug DESC' ) )->slug;

        if( ! $slug )
        {
            $slug = 'AA';
        }
        else
        {
            ++$slug;
        }

        return $slug; 
    }
Futtassuk a tesztet ...
protected/tests/
$phpunit unit/
...
Failed asserting that two strings are equal.
expected string <AC>
difference      < x>
got string      <AA>
...
Ez meg hogy lehet, az előbb még minden jó volt ;) Persze a fentiekből egyből kiderül, hogy a teszt az AA értéket várta és AC-t kapott. Tehát módosítanunk kell a tesztünket. Itt jogosan merülhet fel a kérdés, hogy mi a ráknak ez a kerülőút? De ne feletjtsük el, tesztelünk.
protected/tests/unit/UrlTest?.php
...
    public function testCreateUrl()
    {
        $url = new Url();
        $url->setAttribute( 'url', 'http://altavizsla.hu' );
        $this->assertTrue( $url->save(), 'URL tarolas tesztelese' );
        $this->assertEquals( $url->slug, 'AC' );
    }
...
Még itt gyorsan, mielőtt elfelejtem, a createSlug()-ot rövidíthetjük így is.
protected/models/Url.php
...
    public function createSlug()
    {
        $slug = Url::model()->find( array( 'order' => 'slug DESC' ) )->slug;
        return $slug ? ++$slug : 'AA';
    }
...

Vezérlő és Nézet Cucc - CRUD - Létrehoz, Megjelenít, Frissít, Töröl

Az azért remélem feltűnt, hogy még egyszer sem ellenőriztük a programot a böngészőben. Mert nincs is rá szükség. Abban azonban biztosak lehetünk, hogy a URL modellre vonatkozó funkcióink majdnem 100%-osak. Azért nem mondom, hogy majdnem, mert több mindent lehetne, sőt, kellene(!) még tesztelnünk. Pl. mi van akkor, ha frissítünk, vagy törlünk egy linket az adatbázisból stb. Ezeket a fentiek alapján, remélem, kis gondolkodás után meg lehet csinálni. De még van néhány egyéb teendőnk is mielőtt a programunkat a felhasználók karmai közé eresztenénk.
Készítsük el az alap felhasználói interfészt (formok, nézetek és egyebek) a yiic segítségével.
protected/yiic shell
>> crud Url
   generate UrlController.php
   generate UrlTest.php
      mkdir /var/www/rovidke/protected/views/url
   generate create.php
   generate update.php
   generate index.php
   generate view.php
   generate admin.php
   generate _form.php
   generate _view.php
   generate _search.php
Ha egy új felhasználó érkezik az oldalra, azt szeretnénk, hogy minden klikkolgatás nélkül készíthessen egy rövidített linket (monnyuk ez nem csakúj felhasználókra vonatkozik). Módosítsuk az alap kontrollerünket:
protected/config/main.php
...
    'defaultController'    => 'url/create',
...
Amikor a Yii a hozzáférési szabályokat készíti, alapból a létrehozás funkció (create) csak belépés után lehetséges. Ami jelen esetben nem elfogadható, hiszen mi azt szeretnénk, hogy a felhasználóink a lehető leggyorsabban létrehozhassanak rövidített linkeket. Módosítsuk tehát a
protected/controllers/UrlController?.php
...
   public function accessRules()
... 
   array('allow',  // allow all users to perform 'index' and 'view' actions
        'actions'=>array('index','view', 'create'),
        'users'=>array('*'),
   ),
   array('allow', // allow authenticated user to perform 'create' and 'update' actions
        'actions'=>array('update'),
        'users'=>array('@'),
   ),
...
Ha most megnéznénk a kis programunkat, akkor mindenféle egyéb form mezőket látnánk, amit az okos (már tesztelt) Modell funkcióink szépen kitöltenek a URL mentése előtt. (pl. dátum mező, a rövidített URL azaz slug mező). Tulajdonképpen csak egyetlen mezőre van szükségünk, a URL-re:
protected/views/url/form.php
...
    <?php /*
        <div class="row">
                <?php echo $form->labelEx($model,'created'); ?>
                <?php echo $form->textField($model,'created'); ?>
                <?php echo $form->error($model,'created'); ?>
        </div>

        <div class="row">
                <?php echo $form->labelEx($model,'slug'); ?>
                <?php echo $form->textField($model,'slug',array('size'=>50,'maxlength'=>50)); ?>
                <?php echo $form->error($model,'slug'); ?>
        </div>
    */ 
    ?>

        <div class="row">
                <?php echo $form->labelEx($model,'url'); ?>
                <?php echo $form->textField($model,'url', array( 'size' => 50 )); ?>
                <?php echo $form->error($model,'url'); ?>
        </div>
...
Miután programunk elmenti az új Url-t, Yii automatikusan betölti a megjelenítő kódot (viewAction()). Mi azt szeretnénk, ha a felhasználónk valami ilyesmit látnának: http://rovidke.hu/QWD, és erre klikkelve (vagy a böngészőbe másolva) jutnának el az igazi URL-hez.
Először módosítsuk a megjenítő nézetet:
protected/views/url/view.php
...
<?php 
    echo 
        CHtml::link( 
            $_SERVER['SERVER_NAME'] . '/' . $model->slug, 
            $this->createUrl( '/' . $model->slug ) 
        );
?>
...
<?php /*
$this->widget('zii.widgets.CDetailView', array(
        'data'=>$model,
        'attributes'=>array(
                'created',
                'id',
                'slug',
                'updated',
                'url',
        ),
)); 
*/
?>
No, és itt jön az alkalmazás egy másik érdekessége, az átirányítás vagy redirect. Alapértelmezésben a rendszer a kapott URL alapján megpróbál egy Vezérlőt (Controller) keresni és átpasszolni neki a kapott változókat. Nekünk viszont az kéne, hogy ha valami ilyesmit kapunk (/QWD) akkor a program ne keresse a QWD-t (nem találna!) hanem hívja meg a Url vezérlőt és adja át QWD-t mint egy változó értéket. (ugyebár a slugazonosítója.) Ezt az alap konfigurációs file-ban tehetjük meg, a következő képpen (a szabályok sorrendje fontos):
protected/config/main.php
...
        'urlManager'=>array(
             'urlFormat'=>'path',
             'showScriptName' => false,
             'rules'=>array(
                 '/<slug:[A-Z]+>' => 'url/redirect',
                 '<controller:\w+>/<id:\d+>'=>'<controller>/view',
                 '<controller:\w+>/<action:\w+>/<id:\d+>'=>'<controller>/<action>',
                 '<controller:\w+>/<action:\w+>'=>'<controller>/<action>',
             ),
         ),
...
Persze mindez nem jöhetne létre ha nics apache (.htaccess). Ha az alkalmazás ROOT könyvtárában valami oknál fogva nem lenne meg ez a file, akkor az alábbiak alapján kíszítsünk egyet.
.htaccess
Options +FollowSymLinks
IndexIgnore */*
RewriteEngine on

#Uncomment "RewriteBase /" when you upload this .htaccess to your web server, and comment it when on local web server

#NOTE: 

#If your application is in a folder, for example "application". Then, changing the "application" folder name, will require you to reset the RewriteBase /[your app folder]

#RewriteBase /[your app folder - optional]

# if a directory or a file exists, use it directly
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d

# otherwise forward it to index.php 
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]
Na, most már tényleg csak egy dolog van hátra, megírni magát az átirányító funkciót actionRedirect()
protected/controllers/UrlController?.php
...
    public function accessRules()
    {
       ...
          array('allow',  // allow all users to perform 'index' and 'view' actions
                  'actions'=>array('index','view','create','redirect'),
                  'users'=>array('*'),
                ),    
       ...
    }
...
    public function actionRedirect()
    {
        $slug = Yii::app()->request->getParam( 'slug', null );
        if( $slug )
        {
            $url = Url::model()->findByAttributes( array( 'slug' => $slug ) );
            if( $url )
            {
                $this->redirect( Url::model()->findByAttributes( array( 'slug' => $slug ) )->url );
            }
        }

        throw new CHttpException( '404', 'hmmm ... slug not found!' );
    }
...

Még nagyon sok mindent lehetne finomítani a programunkon, de szerintem kezdetnek ez is elég. Azt pedig nagyon remélem, hogy a PHP közösség (végre) felébred és használni fogja a Teszt Alapú (TDD) programozást.
Yii legyen veletek.

"Ismeret az nem cselekedet, csakis cselekedet a cselekedet" - tdc10