--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/web/Zend/Application.php Mon Dec 13 18:29:26 2010 +0100
@@ -0,0 +1,413 @@
+<?php
+/**
+ * Zend Framework
+ *
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@zend.com so we can send you a copy immediately.
+ *
+ * @category Zend
+ * @package Zend_Application
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ * @version $Id: Application.php 23163 2010-10-19 16:30:26Z matthew $
+ */
+
+/**
+ * @category Zend
+ * @package Zend_Application
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ */
+class Zend_Application
+{
+ /**
+ * Autoloader to use
+ *
+ * @var Zend_Loader_Autoloader
+ */
+ protected $_autoloader;
+
+ /**
+ * Bootstrap
+ *
+ * @var Zend_Application_Bootstrap_BootstrapAbstract
+ */
+ protected $_bootstrap;
+
+ /**
+ * Application environment
+ *
+ * @var string
+ */
+ protected $_environment;
+
+ /**
+ * Flattened (lowercase) option keys
+ *
+ * @var array
+ */
+ protected $_optionKeys = array();
+
+ /**
+ * Options for Zend_Application
+ *
+ * @var array
+ */
+ protected $_options = array();
+
+ /**
+ * Constructor
+ *
+ * Initialize application. Potentially initializes include_paths, PHP
+ * settings, and bootstrap class.
+ *
+ * @param string $environment
+ * @param string|array|Zend_Config $options String path to configuration file, or array/Zend_Config of configuration options
+ * @throws Zend_Application_Exception When invalid options are provided
+ * @return void
+ */
+ public function __construct($environment, $options = null)
+ {
+ $this->_environment = (string) $environment;
+
+ require_once 'Zend/Loader/Autoloader.php';
+ $this->_autoloader = Zend_Loader_Autoloader::getInstance();
+
+ if (null !== $options) {
+ if (is_string($options)) {
+ $options = $this->_loadConfig($options);
+ } elseif ($options instanceof Zend_Config) {
+ $options = $options->toArray();
+ } elseif (!is_array($options)) {
+ throw new Zend_Application_Exception('Invalid options provided; must be location of config file, a config object, or an array');
+ }
+
+ $this->setOptions($options);
+ }
+ }
+
+ /**
+ * Retrieve current environment
+ *
+ * @return string
+ */
+ public function getEnvironment()
+ {
+ return $this->_environment;
+ }
+
+ /**
+ * Retrieve autoloader instance
+ *
+ * @return Zend_Loader_Autoloader
+ */
+ public function getAutoloader()
+ {
+ return $this->_autoloader;
+ }
+
+ /**
+ * Set application options
+ *
+ * @param array $options
+ * @throws Zend_Application_Exception When no bootstrap path is provided
+ * @throws Zend_Application_Exception When invalid bootstrap information are provided
+ * @return Zend_Application
+ */
+ public function setOptions(array $options)
+ {
+ if (!empty($options['config'])) {
+ if (is_array($options['config'])) {
+ $_options = array();
+ foreach ($options['config'] as $tmp) {
+ $_options = $this->mergeOptions($_options, $this->_loadConfig($tmp));
+ }
+ $options = $this->mergeOptions($_options, $options);
+ } else {
+ $options = $this->mergeOptions($this->_loadConfig($options['config']), $options);
+ }
+ }
+
+ $this->_options = $options;
+
+ $options = array_change_key_case($options, CASE_LOWER);
+
+ $this->_optionKeys = array_keys($options);
+
+ if (!empty($options['phpsettings'])) {
+ $this->setPhpSettings($options['phpsettings']);
+ }
+
+ if (!empty($options['includepaths'])) {
+ $this->setIncludePaths($options['includepaths']);
+ }
+
+ if (!empty($options['autoloadernamespaces'])) {
+ $this->setAutoloaderNamespaces($options['autoloadernamespaces']);
+ }
+
+ if (!empty($options['autoloaderzfpath'])) {
+ $autoloader = $this->getAutoloader();
+ if (method_exists($autoloader, 'setZfPath')) {
+ $zfPath = $options['autoloaderzfpath'];
+ $zfVersion = !empty($options['autoloaderzfversion'])
+ ? $options['autoloaderzfversion']
+ : 'latest';
+ $autoloader->setZfPath($zfPath, $zfVersion);
+ }
+ }
+
+ if (!empty($options['bootstrap'])) {
+ $bootstrap = $options['bootstrap'];
+
+ if (is_string($bootstrap)) {
+ $this->setBootstrap($bootstrap);
+ } elseif (is_array($bootstrap)) {
+ if (empty($bootstrap['path'])) {
+ throw new Zend_Application_Exception('No bootstrap path provided');
+ }
+
+ $path = $bootstrap['path'];
+ $class = null;
+
+ if (!empty($bootstrap['class'])) {
+ $class = $bootstrap['class'];
+ }
+
+ $this->setBootstrap($path, $class);
+ } else {
+ throw new Zend_Application_Exception('Invalid bootstrap information provided');
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Retrieve application options (for caching)
+ *
+ * @return array
+ */
+ public function getOptions()
+ {
+ return $this->_options;
+ }
+
+ /**
+ * Is an option present?
+ *
+ * @param string $key
+ * @return bool
+ */
+ public function hasOption($key)
+ {
+ return in_array(strtolower($key), $this->_optionKeys);
+ }
+
+ /**
+ * Retrieve a single option
+ *
+ * @param string $key
+ * @return mixed
+ */
+ public function getOption($key)
+ {
+ if ($this->hasOption($key)) {
+ $options = $this->getOptions();
+ $options = array_change_key_case($options, CASE_LOWER);
+ return $options[strtolower($key)];
+ }
+ return null;
+ }
+
+ /**
+ * Merge options recursively
+ *
+ * @param array $array1
+ * @param mixed $array2
+ * @return array
+ */
+ public function mergeOptions(array $array1, $array2 = null)
+ {
+ if (is_array($array2)) {
+ foreach ($array2 as $key => $val) {
+ if (is_array($array2[$key])) {
+ $array1[$key] = (array_key_exists($key, $array1) && is_array($array1[$key]))
+ ? $this->mergeOptions($array1[$key], $array2[$key])
+ : $array2[$key];
+ } else {
+ $array1[$key] = $val;
+ }
+ }
+ }
+ return $array1;
+ }
+
+ /**
+ * Set PHP configuration settings
+ *
+ * @param array $settings
+ * @param string $prefix Key prefix to prepend to array values (used to map . separated INI values)
+ * @return Zend_Application
+ */
+ public function setPhpSettings(array $settings, $prefix = '')
+ {
+ foreach ($settings as $key => $value) {
+ $key = empty($prefix) ? $key : $prefix . $key;
+ if (is_scalar($value)) {
+ ini_set($key, $value);
+ } elseif (is_array($value)) {
+ $this->setPhpSettings($value, $key . '.');
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set include path
+ *
+ * @param array $paths
+ * @return Zend_Application
+ */
+ public function setIncludePaths(array $paths)
+ {
+ $path = implode(PATH_SEPARATOR, $paths);
+ set_include_path($path . PATH_SEPARATOR . get_include_path());
+ return $this;
+ }
+
+ /**
+ * Set autoloader namespaces
+ *
+ * @param array $namespaces
+ * @return Zend_Application
+ */
+ public function setAutoloaderNamespaces(array $namespaces)
+ {
+ $autoloader = $this->getAutoloader();
+
+ foreach ($namespaces as $namespace) {
+ $autoloader->registerNamespace($namespace);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set bootstrap path/class
+ *
+ * @param string $path
+ * @param string $class
+ * @return Zend_Application
+ */
+ public function setBootstrap($path, $class = null)
+ {
+ // setOptions() can potentially send a null value; specify default
+ // here
+ if (null === $class) {
+ $class = 'Bootstrap';
+ }
+
+ if (!class_exists($class, false)) {
+ require_once $path;
+ if (!class_exists($class, false)) {
+ throw new Zend_Application_Exception('Bootstrap class not found');
+ }
+ }
+ $this->_bootstrap = new $class($this);
+
+ if (!$this->_bootstrap instanceof Zend_Application_Bootstrap_Bootstrapper) {
+ throw new Zend_Application_Exception('Bootstrap class does not implement Zend_Application_Bootstrap_Bootstrapper');
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get bootstrap object
+ *
+ * @return Zend_Application_Bootstrap_BootstrapAbstract
+ */
+ public function getBootstrap()
+ {
+ if (null === $this->_bootstrap) {
+ $this->_bootstrap = new Zend_Application_Bootstrap_Bootstrap($this);
+ }
+ return $this->_bootstrap;
+ }
+
+ /**
+ * Bootstrap application
+ *
+ * @param null|string|array $resource
+ * @return Zend_Application
+ */
+ public function bootstrap($resource = null)
+ {
+ $this->getBootstrap()->bootstrap($resource);
+ return $this;
+ }
+
+ /**
+ * Run the application
+ *
+ * @return void
+ */
+ public function run()
+ {
+ $this->getBootstrap()->run();
+ }
+
+ /**
+ * Load configuration file of options
+ *
+ * @param string $file
+ * @throws Zend_Application_Exception When invalid configuration file is provided
+ * @return array
+ */
+ protected function _loadConfig($file)
+ {
+ $environment = $this->getEnvironment();
+ $suffix = strtolower(pathinfo($file, PATHINFO_EXTENSION));
+
+ switch ($suffix) {
+ case 'ini':
+ $config = new Zend_Config_Ini($file, $environment);
+ break;
+
+ case 'xml':
+ $config = new Zend_Config_Xml($file, $environment);
+ break;
+
+ case 'json':
+ $config = new Zend_Config_Json($file, $environment);
+ break;
+
+ case 'yaml':
+ $config = new Zend_Config_Yaml($file, $environment);
+ break;
+
+ case 'php':
+ case 'inc':
+ $config = include $file;
+ if (!is_array($config)) {
+ throw new Zend_Application_Exception('Invalid configuration file provided; PHP file does not return array value');
+ }
+ return $config;
+ break;
+
+ default:
+ throw new Zend_Application_Exception('Invalid configuration file provided; unknown config type');
+ }
+
+ return $config->toArray();
+ }
+}