add to hatena hatena.comment (22) add to del.icio.us (0) add to livedoor.clip (0) add to Yahoo!Bookmark (0) Total: 22

PHP5 配列をメソッドチェインで再帰処理するクラス

CakePHPを使っていると、データ構造が多階層の配列で管理されていることが多く、一括で処理をしたい場合などに度々再帰処理を実装することがあります。
通常であれば、array_map系の関数を使って再帰的に処理を記述することになりますが、

  • 毎回array_mapを使うのは面倒だし、もっと簡潔に記述したい
  • 個別のグローバル関数・各メソッドを連続して簡単に利用したい

という理由で、以下のように記述できるクラスを作成しました。
(クラスのソースコードは最後に記述しています)

PHP:
  1. // $arrの全ての要素にtrimと半角カナ変換を実施
  2. ArrayMap::create($arr)->trim()->mb_convert_kana('KV');
  3.  
  4. // $arrの全ての要素に「先頭:」という文字を追加
  5. ArrayMap::create($arr)->sprintf('先頭:%s');

※PHP5のマジックメソッドを使って実現していますので、PHP4系では使えません
※通常の手続き型で実装する場合は「array_walk_recursive」「array_map recursive」などで検索するといろいろ参考情報があります。

利用メリット

あくまで個人的な意見ですが、、 

  • PHPの標準関数をそのまま利用できる
  • 自作関数やメソッドを作成する際に再帰処理の考慮が不要になり、単純な処理だけを作成→利用時に合成とすることができる(より再利用できる)
  • ソース可読性の向上

利用書式

1.グローバル関数を実行する場合

ArrayMap::create(配列変数)->グローバル関数([引数1],[引数2],・・・)
->次の関数・メソッド

例:配列$arrの全ての要素にtrimと半角カナ変換を実施

PHP:
  1. ArrayMap::create($arr)->trim()->mb_convert_kana('KV');

2.静的クラスメソッドを実行する場合

ArrayMap::create(配列変数)->call(array(静的クラス名,メソッド名),[引数1],[引数2],・・・)
->次の関数・メソッド

例:配列$arrの全ての要素にInflectorクラスのcamelizeメソッドを実施(引数無し)

PHP:
  1. ArrayMap::create($arr)->call(array('Inflector', 'camelize'));

3.オブジェクトメソッドを実行する場合

ArrayMap::create(配列変数)->call(array(オブジェクト変数,メソッド名),[引数1],[引数2],・・・)
->次の関数・メソッド

例:配列$arrの全ての要素に$thisオブジェクトのconvメソッドを実施(引数1:'a'、引数2:'b')

PHP:
  1. ArrayMap::create($arr)->call(array($this, 'conv'), 'a', 'b');

※呼び出される関数・メソッドは第1引数に処理をする値、第2引数以降に必要であれば引数を設定します。
※ArrayMapクラスから呼び出す際は各要素が自動的に第1引数に設定されるので、第2引数以降を呼び出し時に指定します
※標準関数のstr_replace()やsprintf()などは処理を行う値が最後の引数になっています。
これらはArrayMapクラス内で定義しておけば自動的に最後の引数として設定します。
呼び出し時に動的に最後の引数として要素を渡したい場合は、実行前にp()メソッドを実行する必要があります。

PHP:
  1. ArrayMap::create($arr)->trim()->p()->要素を最後の引数とする関数();

CakePHPでの利用

前半にも記述しましたが、CakePHPでは各データが配列で管理されている為、
以下のような部分で適用できるかと思います。(すいません、未検証です)

  • コントローラーのbeforeFilterで入力値($this->dataや$this->params)の変換(trimや改行・文字コード統一など)
  • モデルのbeforeValidateなどで値の変換(trimや最大長による切り捨て)
  • ビュー内やコントローラーのbeforeRenderなどで値のエスケープ処理

ソースコード

ダウンロード

PHP:
  1. <?php
  2. #########################################################################
  3. /**
  4. * 配列要素操作クラス
  5. */
  6. #########################################################################
  7. class ArrayMap {
  8.     protected $value;
  9.     protected $arg_push  = false;
  10.     protected $is_call   = false;
  11.    
  12.     // 値を最後の引数とする関数を追加する
  13.     public static $auto_push_method  = array( 'str_replace', 'preg_replace', 'sprintf', 'date');
  14.    
  15.     // コンストラクタ
  16.     public function __construct(&$array = array()){
  17.         $this->value =& $array;
  18.         return $this;
  19.     }
  20.     // セッター
  21.     public function set($value) {
  22.         $this->value = $value;
  23.         return $this;
  24.     }
  25.     public function setByRef(&$value) {
  26.         $this->value =& $value;
  27.         return $this;
  28.     }
  29.    
  30.     // 値を返す
  31.     public function v() {
  32.         return $this->value;
  33.     }
  34.     // 次に実行される関数は引数の最後に値を渡す
  35.     public function p() {
  36.         $this->arg_push = true;
  37.         return $this;
  38.     }
  39.     // 実行する関数・メソッドをグローバル以外から明示的に指定
  40.     // 引数を指定する場合は第二引数以降に指定
  41.     public function call($method){
  42.         $this->is_call = true;
  43.         $arguments = func_get_args();
  44.         array_shift($arguments);
  45.         return $this->__call($method, $arguments);
  46.     }
  47.    
  48.     // 関数実行メソッド
  49.     public function __call($method, $arguments){
  50.         // 自動的に引数位置を変更するメソッド
  51.         if(!$this->arg_push && in_array($method, self::$auto_push_method)){
  52.             $this->p();
  53.         }
  54.         // 値が空の場合
  55.         if(empty($this->value)){
  56.             return $this;
  57.         }
  58.        
  59.         // 値がスカラー値の場合でも動くように
  60.         if(is_scalar($this->value)){
  61.             $arg = $arguments;
  62.             if($this->arg_push){
  63.                 $arg[] = $this->value;
  64.             }else{
  65.                 array_unshift($arg, $this->value);
  66.             }
  67.             $this->value = call_user_func_array($method, $arg);
  68.             $this->arg_push = false;
  69.             $this->is_call  = false;
  70.             return $this;
  71.         }
  72.        
  73.         // 再帰を含めた要素処理
  74.         foreach($this->value as $k => $v){
  75.             $arg = $arguments;
  76.             if(is_array($v)){
  77.                 $arr = new ArrayMap($v);
  78.                 if($this->arg_push) $arr->p();
  79.                 if($this->is_call){
  80.                     array_unshift($arg, $method);
  81.                     call_user_func_array(array($arr, 'call'), $arg);
  82.                 }else{
  83.                     call_user_func_array(array($arr, $method), $arguments);
  84.                 }
  85.                 $this->value[$k] = $arr->v();
  86.                 continue;
  87.             }
  88.            
  89.             if($this->arg_push){
  90.                 $arg[] = $v;
  91.             }else{
  92.                 array_unshift($arg, $v);
  93.             }
  94.             $this->value[$k] = call_user_func_array($method, $arg);
  95.         }
  96.         $this->arg_push = false;
  97.         $this->is_call  = false;
  98.         return $this;
  99.     }
  100.    
  101.     #########################################################################
  102.     /**
  103.      * インスタンス生成用静的メソッド
  104.      */
  105.     #########################################################################
  106.     public static function create(&$array){
  107.         return new ArrayMap($array);
  108.     }
  109. }

関連するその他の記事

  • No Related Post

Comments

One Response to “PHP5 配列をメソッドチェインで再帰処理するクラス”

  1. PHP5 配列をメソッドチェインで再帰処理するクラス : エクスギア Blog « とっても! ちゅどん(雑記帳) on 10 月 2nd, 2009 6:31 AM

    [...] PHP5 配列をメソッドチェインで再帰処理するクラス : エクスギア Blog PHP5 配列をメソッドチェインで再帰処理するクラス : エクスギア Blog [...]

Leave a Reply