1). 多言語対応を試してみる

Akelosはデフォで多言語に対応するための仕組みがあるようです。インストール時にen,jaなどを入力したのはこのためだったようですね。app/locales/blog/jp.phpを開いて、$dictionary['The Akelos Blog'] に格納されている値を日本語の任意の文字列に変更してください。一覧ページのタイトルが変更されていることを確認できると思います。

ここで、「http://localhost/en/blog/listing/」を開いてみましょう。タイトルは元の「The Akelos Blog」であることが確認できると思います。en.phpもjp.phpと同じフォルダ内に存在します。この機能と.htaccessを使えば、多言語対応のサービスが簡単に作れそうですね。

2). ログをとる

config/config.phpを編集して、ログファイルを出力するように設定を変更します。、boot.phpのインクルード処理の前にAK_LOG_EVENTSを定義します。

define('AK_LOG_EVENTS', true);
include_once(dirname(__FILE__).DIRECTORY_SEPARATOR.'boot.php');

登録や更新処理を行うとlog/development.logが生成され、ログ出力されていることを確認できると思います。

3). ユニットテスト

ユニットテストを試してみます。test/unit/app/modelsに生成したモデルに合わせて、ユニットテスト用のファイルが格納されているので、testコマンドで実行してみます。

php test ./unit/app/models/post.php

コマンドが実行された後、1件の失敗があることを確認できると思います。

では、テストが通るパターンを試してみましょう。test/unit/app/models/post.phpを開き、test_should_be_added()関数を下記のように書き直します。

function test_should_be_added()
{
$Post = new Post(array('title'=>'First test post', 'body'=>'Say hello'));
$Post->comment->create(array('body'=>'hello!'));
$Post->save();
$Post->reload();

$this->assertEqual(1, $Post->comment->count());
}

また、test/unit/app/models/comment.phpのtest_should_be_added()関数の中身は全てコメントアウトし、app/installers/comment_installer.phpの初期コメント生成の処理もコメントアウトします。

//$Post = new Post(1);
//$Post->comment->create(array('body'=>"コメントをどうぞ。"));
//$Post->save();

再度、コマンドを実行します。

php test ./unit/app/models/post.php

今度はテストが通ったことを確認できると思います。

解説動画では、Akelosコンソールで更に何かをしているようですが、あまり重要そうではないので省きます。

まとめ

解説動画を元に実際にAkelosをインストールして、簡単なBlogの作成、ユニットテストまで行いましたが、バージョンの違いのせいか、ところどころ異なる点がありました。ただ、触っていて感じたことは、「噂どおりCakePHPより良さそうだ」ということです。2つのフレームワークの比較について、時間があればまた記事にしてみたいと思います。

1). 部品の共有化

エントリー内容を表示する部分を共有化します。新しくapp/views/blog/_post.tplファイルを作成し、app/views/blog/show.tplの下記のソースをコピー&ペーストしてください。

・_post.tpl

    <hr />
    <h2><?php echo $url_helper->link_to($post->title, array('action'=>'show', 'id'=>$post->id)); ?></h2>
    <p><?php echo $text_helper->textilize($post->body); ?></p>
    <p><small>{post.posted_at}<?php echo $blog_helper->link_to_edit($post); ?></small></p>

次にこの部品化された_post.tplをshow.tplとlisting.tplから呼び出します。app/views/blog/show.tplとapp/views/blog/liting.tplを下記のように書き直してください。

・show.tplのshowブロックを下記のように書き換え

  <div class="show">
    <?php echo $controller->render(array('partial'=>'post')); ?>
  </div>

・liting.tplのcontentブロックを下記のように書き換え

<div id="content">
  <h1>_{The Akelos Blog}</h1>
  {?posts}
     <?php echo $controller->render(array('partial'=>'post', 'collection'=>$posts)); ?>
  {end}
</div>

ソースを書き直したら、ブラウザで今まで通り問題なく処理されていることを確認してください。

2). コメントテーブルを作成

コメント機能を実装するためにCommentモデルを作成します。下記のコマンドを実行してください。上手くいかない場合は最後に–forceを付けて実行してください。

php generate model Comment

次はapp/models/comment.phpとapp/models/post.phpにお互いの依存関係をソースに追加します。

・comment.php

<?php
class Comment extends ActiveRecord
{
  var $belongs_to = 'post';
}
?>

・post.phpのfunction validate()の上に追加

<?php
class Post extends ActiveRecord
{
	var $has_many = 'comments';

	function validate()
	{
		$this->validatesPresenceOf('title');
	}
}
?>

次にapp/installers/comment_installer.phpを下記のように書き換えます。

<?php
class CommentInstaller extends AkInstaller
{
    function up_1()
    {
        $this->createTable('comments', "
          id,
          body,
          post_id
        ");

        AK::import('post,comment');

        $Post = new Post(1);
        $Post->comment->create(array('body'=>"コメントをどうぞ。"));
        $Post->save();
    }

    function down_1()
    {
        $this->dropTable('comments');
    }
}
?>

installerファイルを作ったら、コマンドを入力してテーブルを作成します。

php migrate comment install

commentテーブルが作成され、レコードが1つ作成されていることが確認できると思います。このコメントをshowページに表示させるため、app/controllers/blog_controller.phpとapp/views/app/views/blog/show.tplにソースを追記します。

・blog_controller.phpのshowアクションのfind関数の引数にコメント情報を追加します。

function show()
{
    $this->post =& $this->Post->find(@$this->params['id'], array('include'=>'comments'));
}

・show.tplのcontentブロックの最後に追加します。

<h2>_{Comments}</h2>
{loop post.comments}
  <hr />
  <p>{comment.body}</p>
{end}

showページをリロードしてコメントが表示されていることを確認してください。

3). コメント欄を実装

app/views/blog/show.tplにコメント欄のソースを追加します。先ほどのコメントを表示するソースの後に追加します。

  <h3>_{Add a comment}</h3>
  <?php echo $form_tag_helper->form_tag(array('action'=>'comment', 'id'=>$post->id)); ?>
    <?php echo $form_helper->text_area('comment','body'); ?><br />
    <?php echo $form_tag_helper->submit_tag("Comment!"); ?>
  </fom>

app/controllers/blog_controller.phpに、commentアクションを追加します。

  function comment()
  {
    $Post = $this->Post->find($this->params['id']);
    $Post->comment->create($this->params['comment']);
    $Post->save();

    $this->flash['notice'] = $this->t('Your comment was successfully added');
	$this->redirectTo(array('action'=>'show', 'id'=>$Post->id));
  }

showページに入力欄が表示されます。コメントを入力して、正しく動作しているか確認してください。

次回に続きます。

1).エラー判定を実装

scaffoldを作って一通りのCRUDを確認しましたが、もう少し実用的にするためにTitle項目に必須エラー判定を実装します。app/models/post/post.phpにvalidate関数を実装します。

<?php
class Post extends ActiveRecord
{
	function validate()
	{
    	$this->validatesPresenceOf('title');
	}
}
?>

画面を開き、Titleを空にして登録、または更新をしてみましょう。次のようにエラーメッセージが表示され、処理が中断されます。

2).ViewファイルのRails形式とPHP形式について

AkelosではViewファイルをRails形式に書くこともできるようです。次のコマンドをscriptフォルダからコマンドプロンプトで実行してください。

php generate scaffold Post Blog --force --sintags

Viewファイルが書き換えられます。例として変更前と後のソースを下記に載せておきます。

書換前

<td class="operation"><?php  echo  $blog_helper->link_to_show($post)?></td>
<td class="operation"><?php  echo  $blog_helper->link_to_edit($post)?></td>
<td class="operation"><?php  echo  $blog_helper->link_to_destroy($post)?></td>

書換後

<td class="operation"><%= link_to_show post %></td>
<td class="operation"><%= link_to_edit post %></td>
<td class="operation"><%= link_to_destroy post %></td>

公式の解説動画ではRails形式で解説を続けていますが、このブログではphp形式で解説を進めてみます。
もう一度次のコマンドを実行して、Viewファイルをphp形式に直します。

php generate scaffold Post Blog --force

3). viewファイルをブログ風に書き直していく

app/views/blog/listing.tplをブログ風になるように次のように書き換えます。

<div id="sidebar">
	<h1>_{Tasks}:</h1>
	<ul>
		<li><?php  echo  $url_helper->link_to($text_helper->translate('Create new Post'), array('action' => 'add'))?></li>
	</ul>
</div>

<div id="content">
	<h1>_{The Akelos Blog}</h1>
	{?posts}
		{loop posts}
		<hr />
		<h2><?php echo $url_helper->link_to($post->title, array('action'=>'show', 'id'=>$post->id)); ?></h2>
		<p>{post.body}</p>
		<p><small></small>{post.posted_at}<?php echo $blog_helper->link_to_edit($post); ?></p>
		{end}
	{end}
</div>

ページを開くと次のように変更されているのが、確認できると思います。

更にapp/views/blog/show.tplを次のように書き換えてみます。

<div id="sidebar">
<h1>_{Tasks}:</h1>
<ul>
	<li><?php  echo  $url_helper->link_to($text_helper->translate('Edit this Post'), array('action' => 'edit', 'id'=>$post->getId()))?></li>
	<li><?php  echo  $url_helper->link_to($text_helper->translate('Back to overview'), array('action' => 'listing'))?></li>
</ul>
</div>

<div id="content">
	<h1>_{Posts}</h1>
	<div class="show">
	<hr />
	<h2><?php echo $url_helper->link_to($post->title, array('action'=>'show', 'id'=>$post->id)); ?></h2>
	<p><?php echo $text_helper->textilize($post->body); ?></p>
	<p><small>{post.posted_at}<?php echo $blog_helper->link_to_edit($post); ?></small></p>
</div>

text_helperのtextilizeを使うことで、Wikiのように強調や斜体で文字を飾りつけることができるようになります。下記の例のように入力を行い、show画面で確認してみてください。（ただし、日本語には対応できていないようです。）

次回に続きます。

1). モデルを自動生成

前回、コントローラーを生成したのと同じようにscriptフォルダから下記のコマンドを実行してModelを生成します。(上手くいかない場合は、最後に–forceを付けて実行してください。)

php generate model Post

下記のようにファイルが作成されます。

2). インストーラーを実行して、テーブルを作成

先ほどの作業で生成されたpost_installer.phpを使ってテーブルを作成します。
/app/installers/post_installer.phpを下記のように書き換えてください。

<?php
class PostInstaller extends AkInstaller
{
    function up_1()
    {
        $this->createTable('posts', "
            id,
            title
        ");
    }

    function down_1()
    {
        $this->dropTable('posts');
    }
}
?>

次に下記のコマンドを実行します。

php migrate post install

SQLが実行され、postsテーブルが作成されます。

3). scaffoldを実行

ここでようやくscaffoldの出番です。下記のコマンドを実行してください。

php generate scaffold Post Blog --force

ここでも自動的にファイルが生成され、scaffoldが構築されます。早速、ブラウザで確認してみましょう。
URLに「http://localhost/blog/」と打ち込んでアクセスすると、下記のような画面が表示されると思います。

「Create new Post」のリンクをクリックすると編集画面が表示されます。

また、「Back to overview」で戻れば、登録した情報が一覧表示され、参照／編集／削除も自由に行うことができます。

3). カラムを追加する

postsテーブルにカラムを追加します。/app/installers/post_installer.phpを開いて、up_1ファンクションの下に下記のup_2ファンクションを追加してください。

    function up_2()
    {
        $this->addColumn('posts', 'body text');
        $this->addColumn('posts', 'posted_at');
    }

先ほどと同じようにinstallコマンドを実行します。

php migrate post install

テーブルに新たにbodyカラムとposted_atカラムが追加されたことを確認してください。ちなみにカラム名に_atをつけるとDate型扱いになるようです。

続いて、scaffoldも再度実行します。

php generate scaffold Post Blog --force

「http://localhost/blog/」をリロードすると、新しい項目が増えていることが確認できると思います。

公式サイトの解説動画では、Mysqlのツールを使ってpostsテーブルのposted_atカラムをbodyカラムの前に移動することで、画面に表示される順番も変更されることが説明されています。phpmyadminで、同じことが出来ないか調べてみましたが、どうやらそのような機能は無いようです。

また、テーブルのカラムの順序を変更する方法は、既存のテーブルを順序を変更した状態でコピーし、古いテーブルを削除、コピーしたテーブルを元の名前にリネームといった手順を踏まなければならないようです。（MySQL :: MySQL 4.1 リファレンスマニュアル :: A.7.2 テーブルのカラム順序を変更する方法を参照。）

このブログでのakelosのscaffoldの説明は以上ですが、解説動画では更にコメント機能をつけるなどしてブログを構築していきます。気が向いたら、続きを書こうと思います。

1). PHPコマンドを使用できるように環境を整える

scriptフォルダ内のファイルをコマンドプロンプトから実行して、ファイルやソースを自動生成することが出来ますが
この操作を快適に実行できるように、Windowsの環境設定を変更します。
（既にphpにパスを通している方はこの項目は飛ばしてください。）
まず、マイコンピュータを右クリックし、「プロパティ」→「詳細設定」→「環境変数」と進んでください。
下記のようなウインドウが表示されるので、「システム環境変数」の「Path」を選択して、「編集」ボタンをクリックします。

「変数値」の最後に「;C:\xampp\php\」と追記します。(xamppをCドライブの直下にインストールした場合)
先頭のセミコロンを忘れないように注意してください。

「OK」を押してコマンドの設定は完了です。コマンドプロンプトから「php -v」と打ち込んで、バージョン情報などが表示されるかテストしてみてください。また、コマンドプロンプトからわざわざAkelosのscriptフォルダまで移動するのは面倒ですので、こちらの「フォルダのショートカットメニューにコマンドプロンプトを表示させる」を参考に任意のフォルダからコマンドプロンプトを呼び出せるようにしておくと良いでしょう。

2). コントローラーを自動生成

generateを使用して、コントローラーを生成します。scriptフォルダから、下記のコマンドを実行します。

php generate controller Blog

実行後/app/controllersフォルダを確認すると、「blog_controller.php」が作成させていることが確認できると思います。

生成されたblog_controller.phpに下記のようにindexファンクションを付け加えて、動作確認をします。
ブラウザで「http;//localhost/blog」を開くと「こんにちは、世界！」と表示されることが確認できると思います。

<?php
class BlogController extends ApplicationController
{
	function index()
	{
		$this->renderText('こんにちは、世界！');
	}
}
?>

3). viewファイルを作成

次にviewファイルを作ってviewファイルからブラウザに文字を表示させてみます。
/app/views/blogフォルダに下記の内容で「index.tpl」というファイルを作成します。

<h1>テンプレートからこんにちは！</h1>

また、blog_controller.phpは下記のように変更してください。

<?php
class BlogController extends ApplicationController
{
	function index()
	{
	}
}
?>

先ほどと同じようにブラウザで「http://localhost/blog」を開くと、今度は「テンプレートからこんにちは！」と表示されることが確認できると思います。

次回に続きます。

Akelosにしました | ブログ.武田ソフト.jp

ということで、Akelosを試してみました。

1). Akelosをダウンロード

Akelos PHP Frameworkからソースをダウンロード。

ダウンロードしたソースを解凍して、Xamppで指定しているドキュメントルートに配置。
ブラウザから「http://localhost/」にアクセスすると、下記の画面が表示されました。

2). データベースを構築

設定ウィザードを開始する前に、データベースを作っておきます。製品、開発、テストの3つのデータベースが必要らしいので、下記のSQLを実行しました。テストは「test」ではなく、「tests」なので間違えないように。

create database project default character set utf8;
create database project_dev default character set utf8;
create database project_tests default character set utf8;

3). 設定ウィザードを開始

「設定ウィザードを開始します」のリンクをクリックするとMySQL／PostgreSQL／SQLiteを選択する画面が表示。
MySQLを選択して次に進み、下記画面にて先ほど作成したデータベースの情報を入力して「次へ」ボタンをクリック。

言語設定の画面が表示されました。デフォルトの設定で、「ja」が含まれているので、多分問題ないかと。そのまま「次へ」ボタンを押して先に進みました。

4). インストール完了

以上で、Akelosのインストールが完了しました。ウィザード形式だったので、とても簡単でした。次回はscaffoldを試してみます。