cakephp2-php8/cake/libs/controller/component.php

<?php
/* SVN FILE: $Id$ */
/**
 *
 * PHP versions 4 and 5
 *
 * CakePHP(tm) :  Rapid Development Framework <http://www.cakephp.org/>
 * Copyright 2005-2008, Cake Software Foundation, Inc.
 *								1785 E. Sahara Avenue, Suite 490-204
 *								Las Vegas, Nevada 89104
 *
 * Licensed under The MIT License
 * Redistributions of files must retain the above copyright notice.
 *
 * @filesource
 * @copyright		Copyright 2005-2008, Cake Software Foundation, Inc.
 * @link				http://www.cakefoundation.org/projects/info/cakephp CakePHP(tm) Project
 * @package			cake
 * @subpackage		cake.cake.libs.controller
 * @since			CakePHP(tm) v TBD
 * @version			$Revision$
 * @modifiedby		$LastChangedBy$
 * @lastmodified	$Date$
 * @license			http://www.opensource.org/licenses/mit-license.php The MIT License
 */
/**
 * Base class for all CakePHP Components.
 *
 * @package		cake
 * @subpackage	cake.cake.libs.controller
 */
class Component extends Object {
/**
 * Components used by this component.
 *
 * @var array
 * @access public
 */
	var $components = array();
/**
 * Controller to which this component is linked.
 *
 * @var object
 * @access public
 */
	var $controller = null;
/**
 * Used to initialize the components for current controller
 *
 * @param object $controller Controller using this component.
 * @access public
 */
	function init(&$controller) {
		$this->controller =& $controller;
		if ($this->controller->components !== false) {
			$loaded = array();
			if (!in_array('Session', $this->controller->components)) {
				$this->controller->components = array_merge(array('Session'), $this->controller->components);
			}
			$loaded = $this->_loadComponents($loaded, $this->controller->components);

			foreach (array_keys($loaded) as $component) {
				$tempComponent =& $loaded[$component];
				if (is_callable(array($tempComponent, 'initialize'))) {
					$tempComponent->initialize($controller);
				}
			}
		}
	}
/**
 * Load components used by this component.
 *
 * @param array $loaded Components already loaded (indexed by component name)
 * @param array $components Components to load
 * @return array Components loaded
 * @access protected
 */
	function &_loadComponents(&$loaded, $components, $parent = null) {
		foreach ($components as $component) {
			$parts = preg_split('/\/|\./', $component);

			if (count($parts) === 1) {
				$plugin = $this->controller->plugin;
			} else {
				$plugin = Inflector::underscore($parts['0']);
				$component = $parts[count($parts) - 1];
			}

			$componentCn = $component . 'Component';

			if (!class_exists($componentCn)) {
				if (is_null($plugin) || !App::import('Component', $plugin . '.' . $component)) {
					if (!App::import('Component', $component)) {
						$this->cakeError('missingComponentFile', array(array(
							'className' => $this->controller->name,
							'component' => $component,
							'file' => Inflector::underscore($component) . '.php',
							'base' => $this->controller->base,
							'code' => 500
						)));
						return false;
					}
				}

				if (!class_exists($componentCn)) {
					$this->cakeError('missingComponentClass', array(array(
						'className' => $this->controller->name,
						'component' => $component,
						'file' => Inflector::underscore($component) . '.php',
						'base' => $this->controller->base,
						'code' => 500
					)));
					return false;
				}
			}
			$base = null;

			if ($componentCn == 'SessionComponent') {
				$base = $this->controller->base;
			}

			if ($parent === null) {
				$this->controller->{$component} =& new $componentCn($base);
				$loaded[$component] =& $this->controller->{$component};
			} elseif ($parent !== null) {
				if (isset($loaded[$component])) {
					$this->controller->{$parent}->{$component} =& $loaded[$component];
				} else {
					$this->controller->{$parent}->{$component} =& new $componentCn($base);
					$loaded[$component] =& $this->controller->{$parent}->{$component};
				}
			}

			if (isset($this->controller->{$component}->components) && is_array($this->controller->{$component}->components)) {
				$loaded =& $this->_loadComponents($loaded, $this->controller->{$component}->components, $component);
			}

			if (isset($loaded[$parent])) {
				$loaded[$parent]->{$component} =& $loaded[$component];
			}
		}
		return $loaded;
	}
}
?>