めもらんだむ

デリゲートでBBCodeの拡張を Part2

nobunobu — Thu, 30 Nov 2006 21:38:26 +0000

このブログで、PHPのソースを紹介する時、以前は、WordPressのプラグインをつかって、色分けされたソースを表示していました。
しかしながら、同様のことはXOOPSのDelegateを使用しても実現出来ます。少し前の投稿からこのDelegateによって拡張したBBCodeの［phpsrc］タグを使用するように変更しました。
以下のソースをCustomSanitizer.class.phpというファイル名で/preloadディレクトリに置くことによって、３つの新しいタグが使用出来るようになります。
・［siteimg]［/siteimg]：［url]タグに対する［siteurl] タグと同様の働きをするものを
　　　　　　　［img]タグに適用したものです。
・［phpsrc]［/phpsrc]： PHPのソースファイルの内容をそのまま表示するときに使用します。
・［phpcode]［/phpcode]： PHPのソースの断片を表示するときに使用します。



class CustomSanitizer extends XCube_ActionFilter
{
    function preBlockFilter() {
        $this->mController->mRoot->mDelegateManager->add("MyTextSanitizer.XoopsCodePre",array(&$this,"BBCodePre"));
    }
    
    function BBCodePre(&$patterns, &$replacements, $allowimage) {
        // Replacement rules for [siteimg] tag
        $patterns[] = "/\[siteimg align=(['\"]?)(left|center|right)\\1]([^\"\(\)\?\&'<>]*)\[\/siteimg\]/sU";
        $patterns[] = "/\[siteimg]([^\"\(\)\?\&'<>]*)\[\/siteimg\]/sU";
        if( $allowimage ) {
            $replacements[] = '.XOOPS_URL.'/\\3" align="\\2" alt="" />';
    
            $replacements[] = '.XOOPS_URL.'/\\1" alt="" />';
        } else {
            $replacements[] = '.XOOPS_URL.'/\\3" target="_blank">'.XOOPS_URL.'/\\3';
            $replacements[] = '.XOOPS_URL.'/\\1" target="_blank">'.XOOPS_URL.'/\\1';
        }
        $patterns[] = '/\[phpcode\](.*?)\[\/phpcode\]/es';
        $replacements[] = "CustomSanitizer::phpSource('\\1',true);";
        $patterns[] = '/\[phpsrc\](.*?)\[\/phpsrc\]/es';
        $replacements[] = "CustomSanitizer::phpSource('\\1',false);";
    }
    
    function phpSource($text,$tag=false) {
        $maxlines = 30;
        $maxwidth = "85%";
        
        $text =str_replace(array('\"'),array('"'),$text);
        if (!preg_match('/[<>"\']+/',$text)) {
            $text =str_replace(array('>','<','"','''),array('>','<','"',"'"),$text);
        }
        $text = trim($text);
        $linecount = count(explode("\n",$text))+1;
        $text = preg_replace("/\r\n/","\n",$text);
        if ($linecount > $maxlines) {
            $linecount = $maxlines + 0.5;
        }
        if ($tag) {
            $text = highlight_string(".$text."\n?>", true);
            $text = preg_replace('/()<\?php/','$1',$text);
            $text = str_replace("?>\n",'',$text);
        } else {
            $text = highlight_string($text, true);
        }
        $text = str_replace("\n",'',$text);
        return '.$linecount*1.2.'em;width:'.$maxwidth.';max-width:'.$maxwidth.';overflow:auto;">'.$text.'

';
    }
}
?>




	どうぞ、お試しあれ！
	実は、同様の拡張を、xoopscube.orgにてwanikooさんが公開されています。

が・・・一部のソースがhtmlspecialcharsがかかって正しい状態にはになっていない

ようですね。


	-Code Highlight2 Preload Hack ( XCCodeHighlight Version, for XC )

-Code Highlight3 Preload Hack ( New xcode version, for XC )



$xoopsOption[’nocommon’]
nobunobu — Sun, 12 Nov 2006 12:07:27 +0000
	XOOPS Cube Legacy2.1では、モジュール開発者向けにモジュールの実行モードを2つ追加しました。

従来のXOOPS 2.0.xでは、モジュール開発者がXOOPSの実行環境を読み込む事によるオーバーヘッドを回避するために、
	


$xoopsOption['nocommon']=1;
include '../../mainfile.php';
?>




	というように書くと、XOOPS_ROOT_PATH等のmainfile.phpに定義された定数だけを読み込むだけで、include/common.phpのinclude実行を行わない様にすることができます。
	XOOPS2.0.xでは、この状態でXOOPSが提供しているfunctions.php等を独自に参照することが可能だったのですが、XOOPS Cube Legacy2.1ではfunctions.php内の関数が、XCube_Root等の XOOPS Cubeクラス群を参照するようになったため、定数を読み込んだだけの状態では、functions.phpのincludeに失敗してしまいます。
	そこで、XOOPS Cube Legacy2.1 Beta3-d の時点で、$xoopsOption['nocommon']が設定されていても、必要最低限のXOOPS Cubeクラス群の初期化を行うように変更しました。

これによってXOOPS2.0.x用のモジュールで$xoopsOption['nocommon']を指定しているプログラムの大半が稼動可能になったはずです。
	しかしながら、$xoopsOption['nocommon']を指定する目的の大半が、特定処理のオーバーヘッド軽減による高速化であったことから、この「必要最低限のXOOPS Cubeクラス群の初期化」でさえも重く感じる場合があるようです。

何人かのメンバーとの討議の結果、新たに2つのPHP定数を用意して、これらのモジュール開発者の要望の期待に答えることにしました。 既存の$xoopsOptionでは無くPHP定数にしたのは、新たなグローバル変数の定義をコアチームとしては避けたかったからです。



モジュールプログラム内で、この2つのPHP定数を使用する方法は以下のとおりです。

1. 単純にmainfile.phpで定義されている定数を参照したい場合
	


define('_LEGACY_PREVENT_LOAD_CORE_', 1);
include '../../mainfile.php';
?>




	上記指定によってmainfile.phpを読み込むことによって、XOOPS_URLなどの定数参照が可能になります。但しこの状態では、XOOPS Cube Legacyが提供しているファイルをincludeすることはたいていの場合エラーとなります。もし、データベースにアクセスする場合には、XOOPS_DB_HOST、XOOPS_DB_USERなどの定数を元にして直接PHPのmysql関数群を呼び出す必要があります。
	2. XOOPSのクラスや関数群をある程度のコントロールしの元に読み込んで、オーバーヘッドを減らしたい。
	


define('_LEGACY_PREVENT_EXEC_COMMON_', 1);
include '../../mainfile.php';
?>




	この記述は、XOOPS Cube Legacy2.1 Beta3-d の時点での、
	


$xoopsOption['nocommon'])=1;
include '../../mainfile.php';
?>




	と等価で、この記述方法もまだ対応していますが、$xoopsOption['nocommon']はXOOPS Cube Legacy2.1では非推奨とします。

上記指定の場合には、mainfile.php内での定数定義に加えて、include/cubecore_init.phpが読み込まれます。

cubecore_init.phpでは、XCube_Rootシングルトンインスタンスの生成及び、settings下のiniファイルに基づいてコントローラの初期化（通常はLegacy_Controllerの初期化）を行います。これによって、include/functions.phpの中ででDBアクセスを伴わない関数を中心とした幾つかが使用可能となります。

さらに、
	


define('_LEGACY_PREVENT_EXEC_COMMON_', 1);
include '../../mainfile.php';
$root=&XCube_Root::getSingleton();
$root->mController->executeCommonSubset();
?>




	というように、Legacy_Contorollerに新たに追加したexecuteCommonSubsetを呼び出すことによって、

DBアクセスをはじめとして、Legacyのかなりの範囲のクラスメソッドを含めて利用することができます。

executeCommonSubset()は、executeCommon()内の処理のうちで、preloadフォルダ内のActionFilter呼び出しとか、ユーザー認証及びセッション管理、xoopsConfigの読み込み、モジュール情報の初期化などを省いたサブセットとなっています。これらを省くことによって、処理の内容によってはかなりの高速化が見込めることとなります。

executeCommonSubset(false)と関数パラメータにfalseを設定することによってさらにDB接続処理のスキップも可能です。

legacyモジュールでもadmin/css.phpという管理画面のスタイルシートのフォールバック対応処理について、

このモードで稼動するように変更したことによって、処理時間を半分以下に短縮することが可能になりました。

これらの新しい動作モード定数の仕様については、現在はCVSに投入されており、XOOPS Cube Legacy 2.1 Beta CVS Snapshotより取得可能ですが、すでにXOOPS Cube legacyを使用している方は、mainfile.phpの修正が必要です。
	2.1 Beta3-c以前
	


if (!isset($xoopsOption['nocommon']) && XOOPS_ROOT_PATH != '') {
        include XOOPS_ROOT_PATH.'/include/common.php';
    }
?>




	または、

2.1 Beta3-d以降
	


@include_once XOOPS_ROOT_PATH.'/include/cubecore_init.php';
    if (!isset($xoopsOption['nocommon']) && XOOPS_ROOT_PATH != '') {
        include XOOPS_ROOT_PATH.'/include/common.php';
    }
?>




	を
	


if (!defined('_LEGACY_PREVENT_LOAD_CORE_') && XOOPS_ROOT_PATH != '') {
        @include_once XOOPS_ROOT_PATH.'/include/cubecore_init.php';
        if (!isset($xoopsOption['nocommon']) && !defined('_LEGACY_PREVENT_EXEC_COMMON_')) {
            include XOOPS_ROOT_PATH.'/include/common.php';
        }
    }
?>




	に変更していただく必要があります。




XOOPS Cube Legacy2.1 BetaのXoopsErrorHandler
nobunobu — Sat, 04 Nov 2006 17:35:32 +0000
	少し時間がたちますけど、GIJOEさんの記事、「Cube2.1betaをデバッグする前に」で、XoopsErrorHandlerの復活について書かれていましたが・・・・
	引用：



このあたり、エラーハンドラの有効無効を選択式にする、という話をminahitoさんから聞いていたような気もするのですが、ぱっと見で一般設定には見つからないので・・・・・



	この部分、minaitoさんの意図はXOOPS Cube Legacy2.1から、デバッグマネージャの初期化がDelegateによって実装されたこともあって、preloadで換装できますという意味だと思います。


ということでpreloadの実装サンプルです。

/preload/DisableErrorHandler.class.phpというファイル名で、
	



class DisableErrorHandler extends XCube_ActionFilter
{
    function preFilter() {
        $this->mController->mSetupDebugger->reset();
        $this->mController->mSetupDebugger->add('My_DebuggerManager::createInstance');
    }
}
    
class My_DebuggerManager extends Legacy_DebuggerManager
{
    function createInstance(&$instance, $debug_mode)
    {
        if (is_object($instance)) {
            return;
        }
    
        switch($debug_mode) {
            case XOOPS_DEBUG_PHP:
                $instance = new My_PHPDebugger();
                break;
    
            case XOOPS_DEBUG_MYSQL:
                $instance = new My_MysqlDebugger();
                break;
    
            case XOOPS_DEBUG_SMARTY:
                $instance = new My_SmartyDebugger();
                break;
    
            case XOOPS_DEBUG_OFF:
            default:
                $instance = new Legacy_NonDebugger();
                break;
        }
    }
}
    
class My_PHPDebugger extends Legacy_PHPDebugger
{
    function prepare()
    {
        error_reporting(E_ALL);
        $GLOBALS['xoopsErrorHandler'] = null;
    }
}
    
class My_MysqlDebugger extends Legacy_MysqlDebugger
{
    function prepare()
    {
        $GLOBALS['xoopsErrorHandler'] = null;
    }
}
class My_SmartyDebugger extends Legacy_SmartyDebugger
{
    function prepare()
    {
        $GLOBALS['xoopsErrorHandler'] = null;
    }
}
?>





	という内容でpreloadを作成すると、xoopsErrorHandlerをすべて無効にすることができます。




Eclipse PHP IDE 0.7
nobunobu — Wed, 01 Nov 2006 23:45:17 +0000
	Eclipse環境下のPHP IDEが、ZendやIBM支援の下でEclipse Project下で開発途上ですが、10月末に一挙にバージョンが0.7にあがって、stable buildとして、S20061026-M3がリリースされてました。

今までのリリースも何度となくダウンロードしてはテストをしていましたが、デバッグ環境が最近のバージョンではかなりの進歩を見せています。

従来のバージョンでは、ある決まったURLに対してのリクエストに対してのみのデバッグしかできず、単体テストレベルのデバッグしか行えなかったのですが、今回ダウンロードしたバージョンでは、ブラウザーでの対話中もデバッグが有効なままなので、任意箇所にブレークポイントを設定して、通常の対話シーケンスの中でのデバッグかかなり楽にできるようになりました。
	簡単に言うと、今までは単純なGETリクエストのページのデバッグしかできなかったのが、POSTリクエストによるデータ更新なども簡単にトレースを取ることができるようになったということです。
	WEBサーバと連携してのデバッグには、別途ZendFrameworkをダウンロードしてその中のZendDebugger.soをWEBサーバのPHP Extentionとして登録し、さらにEclipseを稼動させるPCのIPアドレスをphp.ini内にデバッグ許可端末として追加してあげる必要があります。

つまり、php.iniに
	

zend_extension="/usr/lib/php4/20050606/ZendDebugger.so"
zend_debugger.allow_hosts=192.168.252.254



	のような行追加が必要となります。
	Eclipse PHP IDE では、minahito氏が絶賛しているVS.PHPに比べると使い勝手は少し落ちますが、VS.PHPと同様にphpdoc形式のコメントを元にしたソース編集時の入力補助機能もありますので、無償ということを考えると、今までのEclipse環境下のTruStudioやphpeclipseに比べても、

かなりお勧めだと思います。
	いずれにせよ、このようなデバッグ可能な開発ツールでXOOPS Cubeをステップ実行させると、どのようにしてXOOPS Cubeが動作しているかを目に見える形で理解するための良いツールとなるでしょう。




OSC 2006 Tokyo/Fall
nobunobu — Tue, 31 Oct 2006 00:40:06 +0000
	10月28日に日本電子専門学校にて開催されました、オープンソースカンファレンス2006 Tokyo/Fall（OSC2006 Tokyo/Fall) のセミナーでの発表に使用させていただいた資料を公開させていただきました。

準備不足もあって、十分な内容の資料とはなっておりませんが、ご参考まで。
	- 資 料 -




XOOPS Cube Legacy 2.1 Beta2に入れ替えました
nobunobu — Mon, 30 Oct 2006 21:28:18 +0000
	当サイトをXOOPS Cube Legacy2.1 Beta2に入れ替えました。

cubeUtilsモジュールをはじめ、いくつかのカスタムプリロードもBeta2で正常動作するように修正しました。




cubeUtils Version 0.5
nobunobu — Sun, 22 Oct 2006 00:23:02 +0000
	XOOPS Cube2.1 Betaに対応したcubeUtils Ver0.5をリリースしました。




cubeUtils Version 0.3
nobunobu — Mon, 04 Sep 2006 22:04:26 +0000
	plusangelさんからxoopscube.orgのフォーラムでレポート頂いた不具合に対応した、cubeUtils Ver0.3をリリースしました。
	
Loginブロック内で取得しているパラメータの参照先を修正

	




cubeUtils Version 0.2
nobunobu — Sun, 03 Sep 2006 01:23:38 +0000
	GIJOEさんからコメント頂いた不具合に対応した、cubeUtils Ver0.2をリリースしました。
	
xoops_version.phpのTYPO修正
	Auto Login直後リロードしないと、ゲストユーザと同等画面しか表示されなかった。

	




cubeUtils Module 放流
nobunobu — Mon, 21 Aug 2006 23:35:06 +0000
	XOOPS Cube2.1のカストマイズ柔軟性実証モジュールとして、cubeUtilsモジュールを公開します。

詳しくは、資料室をご覧下さい。