WebSVN - PHPX - Diff - Rev 29 and 30


<?php

require_once __DIR__ . '/Application.php';
require_once __DIR__ . '/View.php';

/* lcfirst() is unavailable before PHP 5.3 */
if (false === function_exists('lcfirst'))
{
  /**
   * Make a string's first character lowercase
   *
   * @param string $str The input string.
   * @return string The resulting string.
   * @link http://www.php.net/manual/en/function.lcfirst.php
   */
  function lcfirst($str)
  {
    return strtolower(substr($str, 0, 1)) . substr($str, 1);
  }
}

/**
 * A general controller that can handle views according to
 * the MVC pattern
 *
 * @author tlahn
 */
abstract class Controller
{
  /**
   * Default action of the controller
   * @var string
   */
  protected $_defaultAction = 'index';
 
  /**
   * If an array, maps an action name to an action method of the controller.
   *
   * Fallback for IE 7 where the content of a <code>button</code> element
   * is submitted as value.
   *
   * @var array
   */
  protected $_actionMap = null;
 
  /**
   * The {@link View} used by this controller
   * @var View
   */
  protected $_view = null;
 
  /**
   * Constructs a controller, initializes the related view,
   * and calls the controller's URI-indicated action method.
   *
   * @param string $viewClass
   *   View class.  The default is <code>'View'</code>.
   * @param string $template
   *   Resource path of the template for the view.  The default
   *   is the empty string.
   */
  protected function __construct($viewClass = 'View', $template = null)
 
  {
    $this->_view = new $viewClass($template);

    Application::getInstance()->setCurrentController($this);
   
    $action = Application::getParam('action', $_REQUEST);
   
    /* NOTE: No `==='; treat empty action like no specific action */
    if ($action == null)
    {
      $action = $this->_defaultAction;
    }

    $actionMethod = lcfirst($action) . 'Action';
   
    /* Fallback for IE 7 where the content of a `button' element is submitted as value */
    if (!method_exists($this, $actionMethod))
    {
      if (is_array($this->_actionMap) && array_key_exists($action, $this->_actionMap))
      {
        $actionMethod = $this->_actionMap[$action];
      }
    }
   
    $this->$actionMethod();
  }
   
  /**
   * Assigns a value to a template variable (after this,
   * <var>$value</var> is available through
   * <code>$this-><var>$name</var></code> in the view's template).
   * <code>Controller</code>s should call this method instead of
   * {@link View::assign()}.
   *
   * @param string $name
   *   Variable name
   * @param mixed $value
   *   Variable value
   * @param bool $encodeHTML
   *   If <code>true</code>, replace all potentially conflicting
   *   characters in <var>$value</var> with their HTML entity
   *   references.  The default is <code>false</code>.
   * @return mixed The assigned value (after possible HTML encoding)
   * @see View::encodeHTML()
   */
  protected function assign($name, $value, $encodeHTML = false)
  {
    return $this->_view->assign($name, $value, $encodeHTML);
  }
 
  /**
   * Renders the {@link View} associated with this controller
   * by including the <code>View</code>'s template.
   * <code>Controller</code>s should call this method instead of
   * <code>View::render()</code>.
   *
   * @param string $template
   *   Optional alternative template resource path.
   *   If not provided, the default template (the
   *   <code>View</code>'s <code>$template</code> property)
   *   will be used.
   */
  public function render($template = null, $content = null)
  {
    $this->_view->render($template, $content);
  }
}

?>

Rev 29	Rev 30
1	<?php	1	<?php
2		2
3	require_once __DIR__ . '/Application.php';	3	require_once __DIR__ . '/Application.php';
4	require_once __DIR__ . '/View.php';	4	require_once __DIR__ . '/View.php';
5		5
6	/* lcfirst() is unavailable before PHP 5.3 */	6	/* lcfirst() is unavailable before PHP 5.3 */
7	if (false === function_exists('lcfirst'))	7	if (false === function_exists('lcfirst'))
8	{	8	{
9	/**	9	/**
10	* Make a string's first character lowercase	10	* Make a string's first character lowercase
11	*	11	*
12	* @param string $str The input string.	12	* @param string $str The input string.
13	* @return string The resulting string.	13	* @return string The resulting string.
14	* @link http://www.php.net/manual/en/function.lcfirst.php	14	* @link http://www.php.net/manual/en/function.lcfirst.php
15	*/	15	*/
16	function lcfirst($str)	16	function lcfirst($str)
17	{	17	{
18	return strtolower(substr($str, 0, 1)) . substr($str, 1);	18	return strtolower(substr($str, 0, 1)) . substr($str, 1);
19	}	19	}
20	}	20	}
21		21
22	/**	22	/**
23	* A general controller that can handle views according to	23	* A general controller that can handle views according to
24	* the MVC pattern	24	* the MVC pattern
25	*	25	*
26	* @author tlahn	26	* @author tlahn
27	*/	27	*/
28	abstract class Controller	28	abstract class Controller
29	{	29	{
30	/**	30	/**
31	* Default action of the controller	31	* Default action of the controller
32	* @var string	32	* @var string
33	*/	33	*/
34	protected $_defaultAction = 'index';	34	protected $_defaultAction = 'index';
35		35
36	/**	36	/**
37	* The {@link View} used by this controller	37	* If an array, maps an action name to an action method of the controller.
-		38	*
-		39	* Fallback for IE 7 where the content of a <code>button</code> element
-		40	* is submitted as value.
38	*	41	*
-		42	* @var array
-		43	*/
-		44	protected $_actionMap = null;
-		45
-		46	/**
-		47	* The {@link View} used by this controller
39	* @var View	48	* @var View
40	*/	49	*/
41	protected $_view = null;	50	protected $_view = null;
42		51
43	/**	52	/**
44	* Constructs a controller, initializes the related view,	53	* Constructs a controller, initializes the related view,
45	* and calls the controller's URI-indicated action method.	54	* and calls the controller's URI-indicated action method.
46	*	55	*
47	* @param string $viewClass	56	* @param string $viewClass
48	* View class. The default is <code>'View'</code>.	57	* View class. The default is <code>'View'</code>.
49	* @param string $template	58	* @param string $template
50	* Resource path of the template for the view. The default	59	* Resource path of the template for the view. The default
51	* is the empty string.	60	* is the empty string.
52	*/	61	*/
53	protected function __construct($viewClass = 'View',	62	protected function __construct($viewClass = 'View', $template = null)
54	$template = null)	-
55	{	63	{
56	$this->_view = new $viewClass($template);	64	$this->_view = new $viewClass($template);
57		65
58	Application::getInstance()->setCurrentController($this);	66	Application::getInstance()->setCurrentController($this);
59		67
60	$action = Application::getParam('action', $_REQUEST);	68	$action = Application::getParam('action', $_REQUEST);
61		69
62	/* NOTE: No `==='; treat empty action like no specific action */	70	/* NOTE: No `==='; treat empty action like no specific action */
63	if ($action == null)	71	if ($action == null)
64	{	72	{
65	$action = $this->_defaultAction;	73	$action = $this->_defaultAction;
66	}	74	}
67		75
68	$this->{lcfirst($action) . 'Action'}();	76	$actionMethod = lcfirst($action) . 'Action';
-		77
-		78	/* Fallback for IE 7 where the content of a `button' element is submitted as value */
-		79	if (!method_exists($this, $actionMethod))
-		80	{
-		81	if (is_array($this->_actionMap) && array_key_exists($action, $this->_actionMap))
-		82	{
-		83	$actionMethod = $this->_actionMap[$action];
-		84	}
-		85	}
-		86
-		87	$this->$actionMethod();
69	}	88	}
70		89
71	/**	90	/**
72	* Assigns a value to a template variable (after this,	91	* Assigns a value to a template variable (after this,
73	* <var>$value</var> is available through	92	* <var>$value</var> is available through
74	* <code>$this-><var>$name</var></code> in the view's template).	93	* <code>$this-><var>$name</var></code> in the view's template).
75	* <code>Controller</code>s should call this method instead of	94	* <code>Controller</code>s should call this method instead of
76	* {@link View::assign()}.	95	* {@link View::assign()}.
77	*	96	*
78	* @param string $name	97	* @param string $name
79	* Variable name	98	* Variable name
80	* @param mixed $value	99	* @param mixed $value
81	* Variable value	100	* Variable value
82	* @param bool $encodeHTML	101	* @param bool $encodeHTML
83	* If <code>true</code>, replace all potentially conflicting	102	* If <code>true</code>, replace all potentially conflicting
84	* characters in <var>$value</var> with their HTML entity	103	* characters in <var>$value</var> with their HTML entity
85	* references. The default is <code>false</code>.	104	* references. The default is <code>false</code>.
86	* @return mixed The assigned value (after possible HTML encoding)	105	* @return mixed The assigned value (after possible HTML encoding)
87	* @see View::encodeHTML()	106	* @see View::encodeHTML()
88	*/	107	*/
89	protected function assign($name, $value, $encodeHTML = false)	108	protected function assign($name, $value, $encodeHTML = false)
90	{	109	{
91	return $this->_view->assign($name, $value, $encodeHTML);	110	return $this->_view->assign($name, $value, $encodeHTML);
92	}	111	}
93		112
94	/**	113	/**
95	* Renders the {@link View} associated with this controller	114	* Renders the {@link View} associated with this controller
96	* by including the <code>View</code>'s template.	115	* by including the <code>View</code>'s template.
97	* <code>Controller</code>s should call this method instead of	116	* <code>Controller</code>s should call this method instead of
98	* <code>View::render()</code>.	117	* <code>View::render()</code>.
99	*	118	*
100	* @param string $template	119	* @param string $template
101	* Optional alternative template resource path.	120	* Optional alternative template resource path.
102	* If not provided, the default template (the	121	* If not provided, the default template (the
103	* <code>View</code>'s <code>$template</code> property)	122	* <code>View</code>'s <code>$template</code> property)
104	* will be used.	123	* will be used.
105	*/	124	*/
106	public function render($template = null, $content = null)	125	public function render($template = null, $content = null)
107	{	126	{
108	$this->_view->render($template, $content);	127	$this->_view->render($template, $content);
109	}	128	}
110	}	129	}
111		130
112	?>	131	?>

Subversion Repositories PHPX

(root)/trunk/Controller.php - Rev 29 → 30