Plugin クラス
Plugin は EventManager などに attach() させて処理を埋め込む感じで使うらしい．
下記のものは例．実験した限りだと attach() した順番で呼ばれるので，アクションが実行される前，あるいはされた後のフィルタとして使える？（javax.servlet.Filter や Play2 の play.mvc.api.Filter， Rails のフィルタ のような）
サンプルからこう使うんだろうなぁという推測でやったような感じ．
<?php
namespace Timeline\Frontend;
use Phalcon\Loader;
use Phalcon\Mvc\Dispatcher;
use Phalcon\Mvc\ModuleDefinitionInterface;
use Timeline\Frontend\Plugins\Header;
class Module implements ModuleDefinitionInterface
{
public function registerAutoloaders()
{
$loader = new Loader();
$loader->registerNamespaces(array(
'Timeline\Frontend\Plugins' => __DIR__.'/plugins/',
));
$loader->register();
}
public function registerServices($di)
$di['dispatcher'] = function() use ($di) {
$eventsManager = $di->getShared('eventsManager');
$eventsManager->attach('dispatch', new Header($di));
$dispatcher = new Dispatcher();
$dispatcher->setEventsManager($eventsManager);
return $dispatcher;
};
}
}
<?php
namespace Timeline\Frontend\Plugins;
use Phalcon\Events\Event;
use Phalcon\Mvc\Dispatcher;
use Phalcon\Mvc\User\Plugin;
class Header extends Plugin
{
public function beforeDispatch(Event $event, Dispatcher $dispatcher)
{
$this->response->setHeader('X-Frame-Options', 'SAMEORIGIN');
$this->response->setHeader('X-Content-Type-Options', 'nosniff');
}
}
Header がちゃんと付与されているかの確認．
$ curl -s -I http://localhost/ | egrep "X-Frame-Options|X-Content-Type-Options"
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
参考文献
Plugin と Component はどう違うの？
Plugin vs Component: what's the difference? - Discussion - Phalcon Framework
http://forum.phalconphp.com/discussion/383/plugin-vs-component-what-s-the-difference-
プラグインを使った例
チュートリアル 2: INVOについて説明します — Phalcon 1.3.1 documentation
http://docs.phalconphp.com/ja/latest/reference/tutorial-invo.html
プラグインとして実装する場合の例（ACL を使う）
PHP - Implementing an API ACL in Phalcon
http://www.rogerethomas.com/blog/php-implementing-an-api-acl-in-phalcon
紛らわしい記述だけど昔のドキュメントに "should not" と書かれていたらしい．今は気にしなくて良い様子．
WHY Plugins should not extend the class Phalcon\Mvc\User\Plugin? - Discussion - Phalcon Framework
上記の修正に対するコミットだと思う．
Re-adding 1.0.0 · 94eb834 · phalcon/docs
https://github.com/phalcon/docs/commit/94eb8342acfa895224754dc3f9d746a9fc36beb0#diff-13