Django for PHP

Pluf
出ました。
いや、出てました。
すばらしい。

テンプレートエンジン以外はPure PHPと言うところがウリの一つです。

まずURL設定。

view plainprint?

1. $ctl = array();  
2. $base = Pluf::f('idf_base');  
3.   
4. $ctl[] = array('regex' => '#^/p/([\-\w]+)/review/$#',  
5.                'base' => $base,  
6.                'priority' => 4,  
7.                'model' => 'IDF_Views_Review',  
8.                'method' => 'index');  
9.   
10. $ctl[] = array('regex' => '#^/p/([\-\w]+)/review/(\d+)/$#',  
11.                'base' => $base,  
12.                'priority' => 4,  
13.                'model' => 'IDF_Views_Review',  
14.                'method' => 'view');  
15.   
16. $ctl[] = array('regex' => '#^/p/([\-\w]+)/review/create/$#',  
17.                'base' => $base,  
18.                'priority' => 4,  
19.                'model' => 'IDF_Views_Review',  
20.                'method' => 'create');  
21. return $ctl;  

$ctl = array();
$base = Pluf::f('idf_base');

$ctl[] = array('regex' => '#^/p/([\-\w]+)/review/$#',
               'base' => $base,
               'priority' => 4,
               'model' => 'IDF_Views_Review',
               'method' => 'index');

$ctl[] = array('regex' => '#^/p/([\-\w]+)/review/(\d+)/$#',
               'base' => $base,
               'priority' => 4,
               'model' => 'IDF_Views_Review',
               'method' => 'view');

$ctl[] = array('regex' => '#^/p/([\-\w]+)/review/create/$#',
               'base' => $base,
               'priority' => 4,
               'model' => 'IDF_Views_Review',
               'method' => 'create');
return $ctl;

うん、まあこんな感じだろうね。
重複も多いし、modelとmethodで分かれているから、少し長い。
あと、分割も標準の方法が見つからないのでもう一工夫ほしいところ。


viewは見慣れたコード。
名前付き引数がないので$match[1]になることと、
名前空間がないので、名前が長くなることがおしい。

view plainprint?

1. public function updateItem($request, $match)  
2. {  
3.     $item = Pluf_Shortcuts_GetObjectOr404('Todo_Item', $match[1]);  
4.     $new_data = $item->getData();  
5.     if ($request->method == 'POST') {  
6.         $form = Pluf_Shortcuts_GetFormForModel($item, $request->POST);  
7.         if ($form->isValid()) {  
8.             $item = $form->save();  
9.             $url = Pluf_HTTP_URL_urlForView('Todo_Views::viewList',  
10.                                             array($item->list));  
11.             return new Pluf_HTTP_Response_Redirect($url);  
12.         }  
13.     } else {  
14.         $form = Pluf_Shortcuts_GetFormForModel($item, $item->getData());  
15.     }  
16.     return Pluf_Shortcuts_RenderToResponse('todo/item/update.html',  
17.                              array('page_title' => 'Update a Todo Item',  
18.                                    'item' => $item,  
19.                                    'form' => $form));  
20. }  

    public function updateItem($request, $match)
    {
        $item = Pluf_Shortcuts_GetObjectOr404('Todo_Item', $match[1]);
        $new_data = $item->getData();
        if ($request->method == 'POST') {
            $form = Pluf_Shortcuts_GetFormForModel($item, $request->POST);
            if ($form->isValid()) {
                $item = $form->save();
                $url = Pluf_HTTP_URL_urlForView('Todo_Views::viewList',
                                                array($item->list));
                return new Pluf_HTTP_Response_Redirect($url);
            }
        } else {
            $form = Pluf_Shortcuts_GetFormForModel($item, $item->getData());
        }
        return Pluf_Shortcuts_RenderToResponse('todo/item/update.html',
                                 array('page_title' => 'Update a Todo Item',
                                       'item' => $item,
                                       'form' => $form));
    }

テンプレート

view plainprint?

1. {extends 'todo/base.html'}  
2.   
3. {block body}  
4. <h2>{$list.name}</h2>  
5.   
6. {if $items}  
7. <ol>  
8. {foreach $items as $item}  
9. <li><a href="{url 'Todo_Views::viewItem', array($item.id)}">{$item.item}</a></li>  
10. {/foreach}  
11. </ol>  
12. {/if}  
13.   
14. <p><a href="{url 'Todo_Views::addItem', array($list.id)}">Create a new item</a> | <a href="{url 'Todo_Views::updateList', array($list.id)}">Update the list</a></p>  
15. {/block}  

{extends 'todo/base.html'}

{block body}
<h2>{$list.name}</h2>

{if $items}
<ol>
{foreach $items as $item}
<li><a href="{url 'Todo_Views::viewItem', array($item.id)}">{$item.item}</a></li>
{/foreach}
</ol>
{/if}

<p><a href="{url 'Todo_Views::addItem', array($list.id)}">Create a new item</a> | <a href="{url 'Todo_Views::updateList', array($list.id)}">Update the list</a></p>
{/block}

すばらしい。
文句のつけようがありません。
まあ、テンプレートエンジンだから当然か。
ところどころPHPの流儀を守っているところがさすがです。

しっかりテストクライアントが付いているところが粋です。

view plainprint?

1. $client->post('/login/', array('login' => 'toto',   
2.                                'password' => 'secret'));  
3. $client->get('/privatepage/');  
4. $reponse = $client->get($url, array('optional_get_param' => 'toto'));  
5. $this->assertEqual(200, $response->status_code);  
6. // print $response->content;  
7. // print_r($response->template);   

$client->post('/login/', array('login' => 'toto', 
                               'password' => 'secret'));
$client->get('/privatepage/');
$reponse = $client->get($url, array('optional_get_param' => 'toto'));
$this->assertEqual(200, $response->status_code);
// print $response->content;
// print_r($response->template); 

モデル

view plainprint?

1. class Todo_Item extends Pluf_Model  
2. {  
3.   public $_model = __CLASS__;  
4.   // ここに定義を書く  
5.   function init()  
6.   {  
7.     // テーブル名。設定ファイルでprefix設定可能  
8.     $this->_a['table'] = 'todo_items';  
9.   
10.     // クラス名を書く。PHPって自分のクラス名を取れなかったっけ？  
11.     $this->_a['model'] = 'Todo_Item';  
12.   
13.     // フィールド定義  
14.     $this->_a['cols'] = array(  
15.          // 残念ながらID定義は必要  
16.         'id' =>  
17.         array(  
18.               'type' => 'Pluf_DB_Field_Sequence',  
19.               'blank' => true,   
20.               ),  
21.         'item' =>   
22.         array(  
23.               'type' => 'Pluf_DB_Field_Varchar',  
24.               'blank' => false,  
25.               'size' => 250,  
26.               'verbose' => __('todo item'),  
27.                ),  
28.         'completed' =>   
29.         array(  
30.               'type' => 'Pluf_DB_Field_Boolean',  
31.               'default' => false,  
32.               'verbose' => __('completed'),  
33.               ),  
34.         'list' =>   
35.         array(  
36.               // おまちかね。関連設定。verboseがrelated_nameになる。  
37.               'type' => 'Pluf_DB_Field_Foreignkey',  
38.               'blank' => false,  
39.               'model' => 'Todo_List',  
40.               'verbose' => __('in list'),  
41.               'help_text' => __('To easily manage your todo items,'.  
42.                 'you are invited to organize your todo items in lists.'),  
43.               ),  
44.         );  
45. }  

class Todo_Item extends Pluf_Model
{
  public $_model = __CLASS__;
  // ここに定義を書く
  function init()
  {
    // テーブル名。設定ファイルでprefix設定可能
    $this->_a['table'] = 'todo_items';

    // クラス名を書く。PHPって自分のクラス名を取れなかったっけ？
    $this->_a['model'] = 'Todo_Item';

    // フィールド定義
    $this->_a['cols'] = array(
         // 残念ながらID定義は必要
        'id' =>
        array(
              'type' => 'Pluf_DB_Field_Sequence',
              'blank' => true, 
              ),
        'item' => 
        array(
              'type' => 'Pluf_DB_Field_Varchar',
              'blank' => false,
              'size' => 250,
              'verbose' => __('todo item'),
               ),
        'completed' => 
        array(
              'type' => 'Pluf_DB_Field_Boolean',
              'default' => false,
              'verbose' => __('completed'),
              ),
        'list' => 
        array(
              // おまちかね。関連設定。verboseがrelated_nameになる。
              'type' => 'Pluf_DB_Field_Foreignkey',
              'blank' => false,
              'model' => 'Todo_List',
              'verbose' => __('in list'),
              'help_text' => __('To easily manage your todo items,'.
                'you are invited to organize your todo items in lists.'),
              ),
        );
}

get_ + lower case name of the related model + _list
で関連リストが取れます。
でもどうでしょうね。
定義も単純だし、Selectも弱いので、こればっかりは様子見か。


FormはDjangoに忠実。
すばらしいです。
これは使いやすい。
ちゃんとFormForModelがあるので安心。
このFormと他ORMのアダプタをいくつか書いたほうがいいんじゃないのかな。
clean_nameなどのValidationも健在。


middlewareもあるし、
Dispatcherも「おっ！」と思うほどシンプル。
さらになんと、CodeIgniterよりも速い！
残念ながら、Djangoとディレクトリ構成が違うため、
規模が大きくなると散らかってしまうかも。
このあたりはLoaderを書き直してほしい。


面白いことに、このソースが配布されている
http://projects.ceondo.com/自体がPlufで書かれています。
git,svn,hgに対応したSourceBrowser,CodeReviewerにIssueTracker。
非常によいサンプルになり、なおかつ、読みやすいことがわかるのでとてもよい。
http://projects.ceondo.com/p/indefero/
この規模がこれだけ読みやすいなら個人的な用途は十分まかなえそうです。
PHPのソースで読みやすいと感じたのは久しぶりです。

これが広まれば、きっとPHPからDjangoへ流れる人が増えるはず。
PHP派もDjango派も目いっぱい布教しましょう。
オススメです。