$smarty->assign( 'options', array(1,2,3) );[テンプレート側]
{html_options name=test options=$options}
これで選択肢が「1,2,3」というセレクトボックスを出力できます。
しかし、決まりきった選択肢に対して、いちいちPHP側でコードを書くのは面倒です。
しかもこのhtml_options、id属性を指定できません。
そこで、その辺を改善する関数（zb_html_select_options）を作ってみました。
[テンプレート側]
{zb_html_select_options id=test123 name=test options=1,2,3}
とするだけで、選択肢が「1,2,3」というセレクトボックスを出力できます。
id属性も出力できます。
また年月日など、数値を選択するセレクトボックスで選択肢を範囲指定できるようにしました。
[テンプレート側]
{zb_html_select_options name=date_d id=selD options_from=1 options_to=31}
これで「１〜３１」までの日を選択できるリストボックスを生成できます。
更にevalを使って今日を選択できます。
[テンプレート側]
{zb_html_select_options name=date_d id=selD options_from=1 options_to=31 selected=eval:date('j')}
パラメータの値が「eval:」で始まる文字列であった場合、それ以降の文字列をPHPの式としてevalした結果を設定します。
「selected=eval:date('j')」は今日を選択することになります。
「eval:」の記述は、options、options_from、options_to、options_step、selectedパラメータで指定可能です。
■書式
{zb_html_select_options パラメータ=値}
パラメータ 値
----------------------------------------------------------
id selectタグのid属性を指定する。
name selectタグのname属性を指定する。
class selectタグのclass属性を指定する。
style selectタグのstyle属性を指定する。
options OPTIONタグの配列。配列のkeyがvalueに、配列のvalue
が表示名になります。
options_from 数値を選択するセレクトボックスの場合に、下限値を指定する。optionsが指定された場合は無視される。
options_to 数値を選択するセレクトボックスの場合に、上限値を指定する。optionsが指定された場合は無視される。
options_step 数値を選択するセレクトボックスの場合に、選択肢の間隔を指定する。optionsが指定された場合は無視される。
selected 初期状態で選択される値を指定する。
■サンプル
年：現在の年−２〜＋２年の範囲 初期状態で現在の年を選択
月：１〜１２の範囲 初期状態で現在の月を選択
日：１〜３１の範囲 初期状態で現在の日を選択
({zb_html_select_options name=reserve_date_y id=selY options_from=eval:date('Y')-2 options_to=eval:date('Y')+2 selected=eval:date('Y')})年
({zb_html_select_options name=reserve_date_m id=selM options=1,2,3,4,5,6,7,8,9,10,11,12 selected=eval:date('n')})月
({zb_html_select_options name=reserve_date_d id=selD options_from=1 options_to=31 selected=eval:date('j')})日
■ダウンロード
zb_html_select_options.txt
ダウンロード後、Smartyのpluginsフォルダに「function.zb_html_select_options.php」という名前で保存してください。
]]>
{$hoge->bar}
と書くのが面倒に感じたり、Smartyに怒られてから「あれ、これオブジェクトだったっけ、それとも配列だったっけ？」とソースコードを読み返したりしたことはありませんか？
そんなものぐさなPHPerの方のために、配列のようにも、オブジェクトのようにもアクセスできるクラスを作ってみました。
<?php
class DualObject implements Iterator, ArrayAccess
{
private $__data;
private $__field_list;
/*
* コンストラクタ
*/
public function __construct()
{
$this->__data = array();
// __で始まるフィールドは除外
$this->__field_list = array();
$vars = get_object_vars($this);
foreach( $vars as $key => $value ){
if ( strpos($key,'__')===FALSE ){
$this->__field_list[] = $key;
}
}
}
/*
* ArrayAccessインタフェース:offsetGetの実装
*/
public function offsetGet($offset)
{
if ( $offset instanceof Object ){
$offset = $offset->s();
}
if ( property_exists($this, $offset) ) {
return $this->$offset;
}
return isset($this->__data[$offset]) ? $this->__data[$offset] : NULL;
}
/*
* ArrayAccessインタフェース:offsetSetの実装
*/
public function offsetSet($offset, $value)
{
if ( $offset instanceof Object ){
$offset = $offset->s();
}
if ( property_exists( $this, $offset ) ){
$this->$offset = $value;
}
else {
$this->__data[$offset] = $value;
if ( FALSE === array_search( $offset, $this->__field_list ) ){
$this->__field_list[] = $offset;
}
}
}
/*
* ArrayAccessインタフェース:offsetExistsの実装
*/
public function offsetExists($offset)
{
if ( $offset instanceof String ){
$offset = $offset->s();
}
return FALSE !== array_search( $offset, $this->__field_list );
}
/*
* ArrayAccessインタフェース:offsetUnsetの実装
*/
public function offsetUnset($offset)
{
if ( $offset instanceof Object ){
$offset = $offset->s();
}
if ( property_exists( $this, $offset ) ){
unset($this->$offset);
}
if ( isset($this->__data[$offset]) ){
unset($this->__data[$offset]);
}
$pos = array_search( $offset, $this->__field_list );
if ( FALSE !== $pos ){
unset($this->__field_list[$pos]);
}
}
/*
* Iteratorインタフェース:rewidの実装
*/
public function rewind()
{
reset($this->__field_list);
}
/*
* Iteratorインタフェース:currentの実装
*/
public function current()
{
$offset = current($this->__field_list);
return $this->offsetGet($offset);
}
/*
* Iteratorインタフェース:keyの実装
*/
public function key()
{
return current($this->__field_list);
}
/*
* Iteratorインタフェース:nextの実装
*/
public function next()
{
return next($this->__field_list);
}
/*
* Iteratorインタフェース:validの実装
*/
public function valid()
{
$offset = current($this->__field_list);
return $this->offsetExists($offset);
}
/*
* プロパティアクセス（取得）
*/
public function __get( $name )
{
return $this->offsetGet($name);
}
/*
* プロパティアクセス（設定）
*/
public function __set( $name, $value )
{
$this->offsetSet($name, $value);
}
/*
* dump
*/
public function dump()
{
print "--------------[ dump start ]--------------" . nl2br(PHP_EOL);
foreach( $this as $key => $value ){
print "[$key]$value" . nl2br(PHP_EOL);
}
print "--------------[ dump end ]--------------" . nl2br(PHP_EOL);
}
}
使い方はこんな感じ。
<?php
require_once 'dual_object.php';
class MyObject extends DualObject
{
public $foo;
}
$o = new MyObject();
$o->dump();
// 通常のpublicフィールドアクセス
$o->foo = 'Boo!';
// 配列でもアクセスできる
$o['foo'] = 'Bazz!';
// 定義していなくてもアクセスできる
$o['bar'] = 'Woot!';
$o->dump();
$o->bar = 'Mzzzz';
$o->dump();
// 読み取りもできる
echo 'o:foo=' . $o['foo'] . nl2br(PHP_EOL);
echo 'o:foo=' . $o->foo . nl2br(PHP_EOL);
echo 'o:bar=' . $o['bar'] . nl2br(PHP_EOL);
echo 'o:bar=' . $o->bar . nl2br(PHP_EOL);
$o->dump();
出力結果。
--------------[ dump start ]-------------- [foo] --------------[ dump end ]-------------- --------------[ dump start ]-------------- [foo]Bazz! [bar]Woot! --------------[ dump end ]-------------- --------------[ dump start ]-------------- [foo]Bazz! [bar]Mzzzz --------------[ dump end ]-------------- o:foo=Bazz! o:foo=Bazz! o:bar=Mzzzz o:bar=Mzzzz --------------[ dump start ]-------------- [foo]Bazz! [bar]Mzzzz --------------[ dump end ]--------------
DualObjectを継承して使うとPHP側でプロパティアクセスし、Smarty側では配列としてアクセスするといった使い方ができます。
ちなみにIteratorも実装しているので、Dual#dump()を見ても分かるように、
$obj = new MyObject();
$obj->foo = 'bar';
...
foreach( $obj as $key => $value ){
...
}
のように記述してオブジェクトのプロパティと値を列挙することができます。
]]>
OpenPNEである日突然招待メール送信時の画像認証（キャプチャ画像による認証）ができなくなってしまい、ハマってしまったので、メモ。
エラー内容は、「確認キーワードが誤っています」。
登録時のエラー箇所で_SESSIONの中を見てみると、確かに空。
っていうか、何も入ってない。
なんだこりゃ、ってことで、キャプチャ画像を生成している部分を確認。
public_html/cap.phpからkcapctha.phpを呼び出している。こいつか？
と思うが、特にセッションがらみのロジックは無い。
そこで、Kcaptchaのロジックを外し、session_start()したあとのヘッダ情報を確認してみるが、PHPSESSIDが正しく吐かれている。
がしかし、ブラウザが受け取るクッキーは
Cookie: ENC_PHPSESSID=%2becFX2FNcQbB61OuymsUNxFW6NVBmuTaOW/sfxrJuahEguweCV3eRLQoQhDiD2L5
みたいになっている。
なんでやーと１日悩みました・・・が、サーバのコントロールパネルを見ていてハタと気づきました。
-------------------------------------------------------
本機能を有効にすることにより、ソフトウェアの動作やインストールに影響が出る場合があります。 ご利用の前に必ずこちらをご一読ください。
-------------------------------------------------------
これか！（笑
てことで、サーバのWAF設定を外してみると、ビンゴ、見事にセッションを復元できました。
多分、
ブラウザ ←→ WAF ←→ Webサーバ
って構成になってて、WAFでENC_PHPSESSIDとPHPSESSIDの変換をしているんだろうなと。
んー、しかしこんな簡単な簡単なロジックで復元できないとなると、WAFってあんまり意味ないようなｗ
（パソコンで言うと、ウィルスも駆除する代わりにExcelが起動できなくなるウィルス対策ソフトみたいなｗ）
]]>
今考えているのは、
・ディレクトリ構成をプログラム動作に反映させる（配置するだけで使えるようになるとか）
・開発モードを実装し、クラスが見つからない場合、配置先を自動でパースしてautoloadコードを自動生成する（リロードするとエラーが出なくなるイメージです）
・プログラムの分割単位として、ディレクトリ単位といった小さなファイルセットで動作するモジュールのようなものの導入
・自前でクラス定義をするケースを極力なくすための、フレームワーク提供イベントクラス、タスククラスを充実させる
といったことで、地味ですが、設定ファイルを無くしたり小さな単位で再利用可能とすることでかなり生産性を向上できるのではないかと思っています。 ]]>
・複数のリクエストに渡ってデータを保持できるタスクであるステートフルタスクを実装しました。
ステートフルタスクの実装は簡単です。通常のタスクの実装に加えて、IStatefulインタフェースを実装するだけです。ステートフルタスクの保持するデータはフレームワークにより自動的に保存／復元されます。保存データはセッションハンドラ経由でファイル等に書き出されます。
CharcoalPHP 0.10.0は下記のページからダウンロードできます。
http://sourceforge.jp/projects/charcoalphp/files/
]]>
CharcoalPHP 0.10.0は下記のページからダウンロードできます。
以前はタスクの処理順序はプロシージャのtask_orderで指定していましたが、より柔軟な処理フローができるように下記の様に変更しました。
・プロシージャ定義ファイルのtasksで定義されたタスクがタスクマネージャに登録される
・タスクマネージャは受け取ったリクエストを元にhttp_requestシステムイベントを生成、各登録タスクに送信
・タスクは定義ファイルのevent_filtersで受け入れ可能なイベントを定義する。受け入れ可能なイベントはIEventインタフェースを実装するユーザイベントまたはシステムイベント。
・event_filtersで指定されているイベントなら、タスクマネージャはそのタスクのprocessEvent()メソッドを呼び出す。
・タスクのprocessEventメソッド内ではイベントを実際に処理したかのフラグ（Boolean値）または、ユーザイベントを戻り値として返す。
・タスクマネージャはタスクの処理結果を受け取り、ユーザイベントのイベントキューへの追加や現在のイベントの消去などを行う。
・新たにイベントキューに追加されたイベントは、次回以降のイベント実行ループで処理される。
・タスクの処理条件はguard_conditionsで指定可能。例えば「ログインタスクのプロパティloginedがTRUEの時のみこのタスクを実行する」などの条件指定が可能。
・イベントキューにイベントが無いか、タスク実行リストにタスクが無くなったらイベント処理を終了する。
processEvent()でユーザイベントを返却できるようになったことで、祖結合のままタスク間の連携が取れるようになりました。
たとえば、Aタスクがhttp_requestを処理し、その結果をXイベントにセットしてタスクマネージャ経由でBタスクに渡すことが出来ます。
AタスクはBタスクの存在を知らずに実装でき、またBタスクもAタスクの存在に依存しないため、仕様変更の影響範囲を限定しやすくできます。
CharcoalPHP 0.9.0は下記のページからダウンロードできます。
・タスク処理機構の改善
・TypeHintingの追加
前者はタスクのprocessEventメソッドからイベントを返却することで、別のタスクとの連携が可能になりました。
後者は引数に指定するデータ型をコンパイル時にチェックすることで、よりタイプセーフなプログラミングが可能になりました。
CharcoalPHP 0.8.0は下記のページからダウンロードできます。
音楽用語で「小刻みに演奏する方法」を指す言葉らしいのですが、私自身は全く音楽に疎いのですが、語感が気に入ったので決めました。
また、頭文字が「Task」の「T」にしたかったというのもあります。
とりあえずTremolo1.0からは以下のことができます。
・タスク＋イベントによる擬似並列Webプログラミング。
・CSMLによるウィジェットマークアップ。
その他、1.1以降では以下の機能の実装も予定しています。
・コマンドラインからのタスク制御
・Scaffolding
・コンポーネント共有サイトの開設
・汎用インストーラ
・Tremolo上に構築されるCMS
・自動テストツール
]]>
・レイアウトマネージャを廃止
・ページセレクタを導入
ページセレクタにより、タスクとビューの橋渡しと分離が明確になりました。
CharcoalPHP 0.7.0は下記のページからダウンロードできます。
マニュアルによるとinclude/require系のステートメントは読み込んだ先のソースファイルでreturnした値を戻り値として返します。
なら読み込むべきソースの最後でそのソースファイルのパスを返してやれば実際に（エラーなく読み込まれた場合は、ですが）読み込まれたパスをコールした側で取得できるはず。
ソースはこんな感じで。
[/var/htdocs/hoge.php :読み込まれる方]
<?php
class Hoge
{
....
}
return __FILE__; ....<--これを追加
?>
[/var/htdocs/main.php :読み込む方]
<?php $ret = include( 'hoge.php' ); print $ret; // --> /var/htdocs/hoge.php ?>結果をログファイルなどに吐き出すようにすれば、幸せになれる？
XDebugとか入ってたらプロファイラで確認できるのでしょうが、ちょっとしたデバッグとかには有効かもしれません。
]]>
・速度が遅い
・テンプレートが汚くなり（ロジックが書けてしまう）、デザイナーとの協業がしにくい
・再利用性が低い
などがありますが、２番目の「テンプレート汚染」についてはPHPTALやKwartzを使うことである程度解決できます。
しかし３番目の「再利用性」について考えられているテンプレートシステムはあまりなく、考えられていたとしてもそれはテンプレートファイルの再利用であり、ビジュアルコードの再利用についてまで考えられたテンプレートシステムはPHPでは私の知る範囲では皆無です。
そこで、下記のようなテンプレートシステムを考案しました。
・テンプレートファイルはプレーンなHTML
・ビジュアルコードは「ウィジェット」と呼ばれるクラスにまとめられる
・ウィジェットのテンプレートHTML内の要素へのバインドはXMLを使う
こうすることで、テンプレートとロジックの分離とともにビジュアルコードの再利用性も高められるわけです。このXMLを冒頭で紹介した「CSML（Chacoal Screen Markup Language）と名づけました。
下記はCSMLとテンプレート（HTML）のサンプルです。
[CSML]
<?xml version="1.0" encoding="utf-8"?> <csml:page xmlns:csml="http://charcoal.net/csml/ns/"> <csml:widget id="header_panel" class="HeaderPanelWidget"> <csml:widget id="menu" class="MenuWidget"> <csml:widget id="main_panel" class="MainPanelWidget"> <csml:widget id="footer_panel" class="FooterPanelWidget"> </csml:page>
[HTMLテンプレート]
<html> <body> <div id="header_panel"></div> <div id="menu"></div> <div id="main_panel"></div> <div id="footer_panel"></div> </body> </html>
実際、レンダリングを行う時はCSMLとHTMLを関連付けする必要がありますが、それはレイアウトマネージャの方で行います。ですので同じCSMLを異なるHTMLテンプレートに関連付けることも出来ます。タスクの実行結果によって見栄えを大きく変更する場合などに便利な機能です。
HTMLテンプレートの要素とCSML要素の対応はid属性で行います。同じidのHTML要素の位置に、CSMLに記述されたウィジェットクラスのコードが展開されます。コードは描画時に評価されますが、Smartyなどと同じように、展開後のコードはキャッシュされるため、展開にかかるコストは最初の１回だけになります。
ビューコードを記述するウィジェットクラスでは直接HTMLを出力できるほか、更にCSMLを適用すると言った使い方ができます。この方法を使うと、ウィジェットを「塊」で管理することができるようになり、部品の再利用性が高まります。
まだ構想段階ではありますが、CharcoalPHPの次期バージョン（0.7.0）では基本的な機能を実装できればと思っています。
]]>
≪設定ファイル関係≫
・デフォルトをSpycからJavaプロパティファイル形式に変更
・Configクラスのインタフェースを変更
・システム設定ファイルをアプリケーション設定ファイルでオーバロードできるようにした
≪デバッグ関係≫
・例外スタック（ExceptionStack）クラスの実装
・スクリーンロガー（ScreenLogger）クラスの修正とポップアップするスクリーンロガー（PopupScreenLogger）クラスの実装
≪プロファイル関係≫
・デフォルトで外部ライブラリパスを無効にし、プロファイルに有効にするフラグ（USE_EXTLIB）とパス変数（EXTLIB_DIR）を追加した
≪その他≫
・TypeSafeのためのプリミティブクラス（Boolean、Integer、String）を追加
パフォーマンスについてですが、abコマンドでの測定では以下のようになりました。
CodeIgniter 68.07 #/sec 14.69 ms/# CharcoalPHP 42.94 #/sec 23.28 ms/#
0.5.0では30#/secほどでしたから、50%近い速度の向上を実現しました。
これはデフォルトの設定ファイル形式をSpycからiniファイル（実際はJavaプロパティファイル形式）に変更したことが大きいです。やはりparse_ini_fileは高速ですね。
]]>
parse_ini_fileとSpycのベンチはもちろんparse_ini_fileの圧勝でしたが、その結果は標準の設定ファイル形式としてYAMLとPHPを捨てさせるのに十分なものでした。というわけで、次期リリースではparse_ini_fileを使い、Javaのプロパティファイルっぽいフォーマットにしようかと画策中。
ところで最近Scalaというプログラミング言語に興味を持っているのですが、Scalaは「アクター」
（Actor）というものが使えるらしいと知り、調べて見ました。
アクター（Actor）とは、もともと並列処理のための計算モデルである「Actor Model」
からきています。Scalaのそれは並列処理指向言語であるErlangから拝借したものらしい
です。
Actor自体はメッセージを受け付けるスレッドのようなもので、内部で何らかのトリガーが発生するか、外部からのメッセージを受け取って
処理を行う処理体のことをいいます。
この考え方自体は並列コンピューティングの世界で古くからあるものですが、昨今スケー
リングやらCPUのマルチコア化などで再度注目を浴びています。
調べていくうち、この考え方ってCharcoalPHPの方向性（タスク）とそっくりだなーと
感じるようになりました。実際には細かいところで考え方や実装の
異なる点があるようには感じています。
大まかに「プログラムに並列性を導入することでロジックを簡略化する」という点は
一致しますが、アクターモデルでは「それにより並列性を上げる」のが目的であるの
に対し、CharcoalPHPでは「それにより再利用性を高める」のが目的である点が違いと
言えるでしょう。
というわけで、CharcoalPHPでは「アクターモデル」を中心概念として採用します。
DI+AOPも採用する可能性がありますが、型付けの弱い言語であるPHPでは費用対効果が少ないという
見通しをしているので、採用されたとしてもあくまで補助的な扱いになるでしょう。
]]>
http://www.kuwata-lab.com/kwartz/
Ruby版、PHP版、Java版がありあますので、PHP版をダウンロードします。ダウンロードしたファイルを解凍後、Kwartzディレクトリ以下をPHPのinclude_path以下にコピーすればインストール完了です。
次に以下のファイルを作成してHTTPサーバのhtdocsに配置します。
[index.php]
require_once('Kwartz/Main.php');
$argv = array('kwartz-php', '-l', 'php', '-p', 'my.plogic', 'my.html' );
ob_start();
KwartzMain::main($argv);
$out = ob_get_clean();
/*
// こういう書き方もできるようです
$kwartz = new KwartzMain($argv);
$out = $kwartz->execute();
*/
file_put_contents('cache.php', $out);
$members = array( 'member1', 'member2', 'member3', );
include('cache.php');
[my.plogic]
/* The element which is marked by 'id="list1"' */
#list1 {
logic: {
foreach( $members as $member ){
_stag() // start tag
_cont() // content
_etag() // end tag
}
}
}
/* The element which is marked by 'id="mark:item1"' */
#item1 {
/* replace the content with value of a variable 'member' */
value: $member;
}
[my.html]
<table>
<tr id="list1">
<td id="mark:item1">foo</td>
</tr>
</table>
仕組みとしては、index.phpにアクセスするとまずKwartzによりmy.plogic（ロジック記述用ファイル）とmy.html（HTMLテンプレート）がコンパイルされ、PHPファイルが出力されます（cache.php）。次にテンプレート出力用の変数を用意して、cache.phpをincludeします。includeによりテンプレートPHPファイルが解釈され、変数の内容が出力されます。
このようにロジックファイルとテンプレートファイルが分離しているため、非常にメンテナンスはしやすいです。
なお、Kwartzにはコマンドラインツールも用意されていますので、テンプレートPHPファイルは事前にコンパイルしてもいいのですが、上記のようにすることでSmartyのように実行時にテンプレートファイルを更新することができます。
]]>