-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathideas-plugin_preloader.html
147 lines (139 loc) · 6.38 KB
/
ideas-plugin_preloader.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="utf-8">
<title>Ethnamドキュメント</title>
<link href="css/style.css" media="all" rel="stylesheet" />
<link href="css/github.css" media="all" rel="stylesheet" />
</head>
<body>
<p><a href=".">目次</a></p>
<div class="blob instapaper_body">
<article class="markdown-body entry-content">
<h1>プラグインの先読み機能</h1>
<ul>
<li>概要 </li>
<li>新しいプラグインの読み込ませ方・使い方 </li>
<li>別名の付け方 </li>
<li>読み込まれるタイミング </li>
<li>その他 </li>
<li>その他2（ViewClassで使いたい場合） </li>
<li>その他3 （PHP 5ベースになると） </li>
<li>コード </li>
</ul>
<p>書いた人：sotarok</p>
<h2>プラグインの先読み機能</h2>
<h3>概要</h3>
<p>Ethna のプラグインは，これまで getPlugin を2回呼ばないとインスタンスがとれないだとか *1，決して使いやすいものではありませんでした．</p>
<p>そもそも，「プラグイン」といいつつも，Validator や Filter など，Ethna の中で，「呼ばれるタイミングの決まっているプラグイン」が主であり，任意の機能追加をして再利用しやすいものを作ったり配布したり，があまりされてきませんでした．実際，getPlugin して利用するものは，現状の Ethna の組み込みですと， Cachemanager くらいでしょう．</p>
<p>しかし，2.5.0 以降では，他人の作成したプラグインを取り込みやすい仕組み，自分の作ったプラグインを配布しやすい仕組みが導入される予定です．それに伴い，利用のしやすさ，も重要な要素になってきます．</p>
<h3>新しいプラグインの読み込ませ方・使い方</h3>
<p>ActionClass に $plugins というプロパティを作成し，配列で読み込みたいプラグインを記述すると，その名前でプラグインのオブジェクトをあらかじめ取得しておいてくれるようになります．</p>
<p>Example: app/action/Index.php</p>
<pre><code><?php
...
class App_Action_Index extends App_ActionClass
{
// type_name のように，アンダースコア区切りで指定する
var $plugins = array(
'Cachemanager_Localfile',
'Cachemanager_Memcache',
);
function prepare()
{
...
return null;
}
function perform()
{
...
// $plugins で指定したプラグインが，その名前で使える
$this->plugin->Cachemanager_Localfile->get('hoge');
$this->plugin->Cachemanager_Memcache->get('hoge');
...
return 'index';
}
}</code></pre>
<p>このように，あらかじめ $plugins プロパティ変数に配列で定義することで，そのプラグインのインスタンスを $this->plugin に読み込んでおいてくれるようになります．</p>
<h3>別名の付け方</h3>
<p>これで，キャッシュプラグインなどが幾分使いやすくなりました．とはいえ，Cachemanager_Localfile と毎回打つのもなかなか骨が折れます*2</p>
<p>ですので，別名でアクセスする方法も提供しています． 連想配列のキーに別名を指定すると，その名前で使えるようになります．</p>
<p>Example: app/action/Index.php</p>
<pre><code><?php
...
class App_Action_Index extends App_ActionClass
{
// type_name のように，アンダースコア区切りで指定する
var $plugins = array(
'cm' => 'Cachemanager_Localfile',
);
function prepare()
{
...
return null;
}
function perform()
{
...
// $plugins の連想配列のキーで別名を指定
$this->plugin->cm->get('hoge');
...
return 'index';
}
}</code></pre>
<h3>読み込まれるタイミング</h3>
<ul>
<li>ActionClass のコンストラクタで読み込まれます．従って，prepare でも preform でも使えます．</li>
</ul>
<h3>その他</h3>
<ul>
<li>別名づけと，プラグインファイル名でアクセスする方法は混同して利用できます．*3</li>
</ul>
<p>Example: app/action/Index.php</p>
<pre><code><?php
...
class App_Action_Index extends App_ActionClass
{
// 混同してもOK
var $plugins = array(
'Cachemanager_Localfile',
'cm' => 'Cachemanager_Localfile',
);
...
function perform()
{
...
// どっちも同じオブジェクト
$this->plugin->cm->get('hoge');
$this->plugin->Cachemanager_Localfile->get('hoge');
...
}
}</code></pre>
<h3>その他2（ViewClassで使いたい場合）</h3>
<ul>
<li>こうして読み込ませた Plugin は，Plugin オブジェクトに読み込まれるので，このActionClassからforwardしたViewClassでも当然利用できます．</li>
<li>逆にいうと，ViewClass で使いたいプラグインは，そのViewClassにフローのながれるActionClassにpluginの記述をしておくといいでしょう．</li>
</ul>
<h3>その他3 （PHP 5ベースになると）</h3>
<ul>
<li>PHP 5 ベースのコードになると，別名をつけない場合は，$plugins の記述すら必要なくなる予定です</li>
</ul>
<h3>コード</h3>
<p>この変更は git の plugin_preloader ブランチで適用されています．</p>
<ul>
<li><a href="http://git.sourceforge.jp/view?p=ethna/ethna.git;a=shortlog;h=refs/heads/plugin_preload"><a href="http://git.sourceforge.jp/view?p=ethna/ethna.git;a=shortlog;h=refs/heads/plugin_preload">http://git.sourceforge.jp/view?p=ethna/ethna.git;a=shortlog;h=refs/heads/plugin_preload</a></a></li>
</ul>
<p>チェックアウト例：</p>
<pre><code>% git clone git://git.sourceforge.jp/gitroot/ethna/ethna.git
% cd ethna
% git checkout -b plugin_preloader origin/plugin_preloader</code></pre>
<hr />
<p>*1 <a href="plugin.html#j3c3ba62">plugin.html#j3c3ba62</a><br />
*2当然みなさんは補完機能付きのエディタを使っているとは思いますが，それでも面倒っちゃ面倒です<br />
*3が，実際にコードを書くときはどちらかのポリシーに統一したほうがチーム開発の面ではよろしいでしょう </p> </article>
</div>
<div class="site-footer">
@2015 <a href="https://twitter.com/DQNEO">DQNEO</a>
</div>
</body>
</html>