yafapplication(3) [php man page]

YAFAPPLICATION(3)							 1							 YAFAPPLICATION(3)

The YafApplication class

INTRODUCTION

       Yaf_Application	provides  a  bootstrapping facility for applications which provides reusable resources, common- and module-based bootstrap
       classes and dependency checking.

       Note

	      Yaf_Application implements the singleton pattern, and Yaf_Application can not be serialized or unserialized which will cause problem
	      when you try to use PHPUnit to write some test case for Yaf.

	       You  may use @backupGlobals annotation of PHPUnit to control the backup and restore operations for global variables. thus can solve
	      this problem.

CLASS SYNOPSIS

       Yaf_Application

       final
       Yaf_Application

       Properties

       o protected$config

       o protected$dispatcher

       o protectedstatic$_app

       o protected$_modules

       o protected$_running

       o protected$_environ

       Methods

       o publicstatic void Yaf_Application::app (void  )

       o public void Yaf_Application::bootstrap ([Yaf_Bootstrap_Abstract  $bootstrap])

       o public Yaf_Application Yaf_Application::clearLastError (void  )

       o private void Yaf_Application::__clone (void  )

       o public Yaf_Application::__construct (mixed  $config, [string  $envrion])

       o public void Yaf_Application::__destruct (void	)

       o public void Yaf_Application::environ (void  )

       o public void Yaf_Application::execute (callable  $entry, string  $...)

       o public Yaf_Application Yaf_Application::getAppDirectory (void	)

       o public Yaf_Config_Abstract Yaf_Application::getConfig (void  )

       o public Yaf_Dispatcher Yaf_Application::getDispatcher (void  )

       o public string Yaf_Application::getLastErrorMsg (void  )

       o public int Yaf_Application::getLastErrorNo (void  )

       o public array Yaf_Application::getModules (void  )

       o public void Yaf_Application::run (void  )

       o public Yaf_Application Yaf_Application::setAppDirectory (string  $directory)

       o private void Yaf_Application::__sleep (void  )

       o private void Yaf_Application::__wakeup (void  )

PROPERTIES

	      o $config
		-

	      o $dispatcher
		-

	      o $_app
		-

	      o $_modules
		-

	      o $_running
		-

	      o $_environ
		-

PHP Documentation Group 													 YAFAPPLICATION(3)

YAF_PLUGIN_ABSTRACT(3)							 1						    YAF_PLUGIN_ABSTRACT(3)

The Yaf_Plugin_Abstract class

INTRODUCTION

	Plugins allow for easy extensibility and customization of the framework.

	Plugins  are  classes.	The  actual class definition will vary based on the component -- you may need to implement this interface, but the
       fact remains that the plugin is itself a class.

	A plugin could be loaded into Yaf by using Yaf_Dispatcher::registerPlugin, after registerd, All the methods which the  plugin  implemented
       according to this interface, will be called at the proper time.

EXAMPLES

       Example #1

	      Plugin example

	      <?php
		 /* bootstrap class should be defined under ./application/Bootstrap.php */
		 class Bootstrap extends Yaf_Bootstrap_Abstract {
		      public function _initPlugin(Yaf_Dispatcher $dispatcher) {
			  /* register a plugin */
			  $dispatcher->registerPlugin(new TestPlugin());
		      }
		 }

		 /* plugin class should be placed under ./application/plugins/ */
		 class TestPlugin extends Yaf_Plugin_Abstract {
		      public function routerStartup(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {
			  /* before router
			     in this hook,  user can do some url rewrite */
			  var_dump("routerStartup");
		      }
		      public function routerShutdown(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {
			  /* router complete
			     in this hook, user can do login check */
			  var_dump("routerShutdown");
		      }
		      public function dispatchLoopStartup(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {
			  var_dump("dispatchLoopStartup");
		      }
		      public function preDispatch(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {
			  var_dump("preDispatch");
		      }
		      public function postDispatch(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {
			  var_dump("postDispatch");
		      }
		      public function dispatchLoopShutdown(Yaf_Request_Abstract $request, Yaf_Response_Abstract $response) {
			  /* final hoook
			     in this hook user can do loging or implement layout */
			  var_dump("dispatchLoopShutdown");
		      }
		 }

		 Class IndexController extends Yaf_Controller_Abstract {
		      public function indexAction() {
			  return FALSE; //prevent rendering
		      }
		 }

		 $config = array(
		     "application" => array(
			 "directory" => dirname(__FILE__) . "/application/",
		     ),
		 );

		 $app = new Yaf_Application($config);
		 $app->bootstrap()->run();
	      ?>

	      The above example will output something similar to:

	      string(13) "routerStartup"
	      string(14) "routerShutdown"
	      string(19) "dispatchLoopStartup"
	      string(11) "preDispatch"
	      string(12) "postDispatch"
	      string(20) "dispatchLoopShutdown"

CLASS SYNOPSIS

       Yaf_Plugin_Abstract

       Yaf_Plugin_Abstract

       Methods

       o public void Yaf_Plugin_Abstract::dispatchLoopShutdown (Yaf_Request_Abstract  $request, Yaf_Response_Abstract  $response)

       o public void Yaf_Plugin_Abstract::dispatchLoopStartup (Yaf_Request_Abstract  $request, Yaf_Response_Abstract  $response)

       o public void Yaf_Plugin_Abstract::postDispatch (Yaf_Request_Abstract  $request, Yaf_Response_Abstract  $response)

       o public void Yaf_Plugin_Abstract::preDispatch (Yaf_Request_Abstract  $request, Yaf_Response_Abstract  $response)

       o public void Yaf_Plugin_Abstract::preResponse (Yaf_Request_Abstract  $request, Yaf_Response_Abstract  $response)

       o public void Yaf_Plugin_Abstract::routerShutdown (Yaf_Request_Abstract	$request, Yaf_Response_Abstract  $response)

       o public void Yaf_Plugin_Abstract::routerStartup (Yaf_Request_Abstract  $request, Yaf_Response_Abstract	$response)

PHP Documentation Group 												    YAF_PLUGIN_ABSTRACT(3)