File indexing completed on 2024-12-22 05:36:32

 <?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_Config
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @version    $Id$
  */
 
 
 /**
  * @see Zend_Config
  */
 // require_once 'Zend/Config.php';
 
 
 /**
  * @category   Zend
  * @package    Zend_Config
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  */
 class Zend_Config_Ini extends Zend_Config
 {
     /**
      * String that separates nesting levels of configuration data identifiers
      *
      * @var string
      */
     protected $_nestSeparator = '.';
 
     /**
      * String that separates the parent section name
      *
      * @var string
      */
     protected $_sectionSeparator = ':';
 
     /**
      * Whether to skip extends or not
      *
      * @var boolean
      */
     protected $_skipExtends = false;
 
     /**
      * Loads the section $section from the config file $filename for
      * access facilitated by nested object properties.
      *
      * If the section name contains a ":" then the section name to the right
      * is loaded and included into the properties. Note that the keys in
      * this $section will override any keys of the same
      * name in the sections that have been included via ":".
      *
      * If the $section is null, then all sections in the ini file are loaded.
      *
      * If any key includes a ".", then this will act as a separator to
      * create a sub-property.
      *
      * example ini file:
      *      [all]
      *      db.connection = database
      *      hostname = live
      *
      *      [staging : all]
      *      hostname = staging
      *
      * after calling $data = new Zend_Config_Ini($file, 'staging'); then
      *      $data->hostname === "staging"
      *      $data->db->connection === "database"
      *
      * The $options parameter may be provided as either a boolean or an array.
      * If provided as a boolean, this sets the $allowModifications option of
      * Zend_Config. If provided as an array, there are three configuration
      * directives that may be set. For example:
      *
      * $options = array(
      *     'allowModifications' => false,
      *     'nestSeparator'      => ':',
      *     'skipExtends'        => false,
      *      );
      *
      * @param  string        $filename
      * @param  mixed         $section
      * @param  boolean|array $options
      * @throws Zend_Config_Exception
      * @return void
      */
     public function __construct($filename, $section = null, $options = false)
     {
         if (empty($filename)) {
             /**
              * @see Zend_Config_Exception
              */
             // require_once 'Zend/Config/Exception.php';
             throw new Zend_Config_Exception('Filename is not set');
         }
 
         $allowModifications = false;
         if (is_bool($options)) {
             $allowModifications = $options;
         } elseif (is_array($options)) {
             if (isset($options['allowModifications'])) {
                 $allowModifications = (bool) $options['allowModifications'];
             }
             if (isset($options['nestSeparator'])) {
                 $this->_nestSeparator = (string) $options['nestSeparator'];
             }
             if (isset($options['skipExtends'])) {
                 $this->_skipExtends = (bool) $options['skipExtends'];
             }
         }
 
         $iniArray = $this->_loadIniFile($filename);
 
         if (null === $section) {
             // Load entire file
             $dataArray = array();
             foreach ($iniArray as $sectionName => $sectionData) {
                 if(!is_array($sectionData)) {
                     $dataArray = $this->_arrayMergeRecursive($dataArray, $this->_processKey(array(), $sectionName, $sectionData));
                 } else {
                     $dataArray[$sectionName] = $this->_processSection($iniArray, $sectionName);
                 }
             }
             parent::__construct($dataArray, $allowModifications);
         } else {
             // Load one or more sections
             if (!is_array($section)) {
                 $section = array($section);
             }
             $dataArray = array();
             foreach ($section as $sectionName) {
                 if (!isset($iniArray[$sectionName])) {
                     /**
                      * @see Zend_Config_Exception
                      */
                     // require_once 'Zend/Config/Exception.php';
                     throw new Zend_Config_Exception("Section '$sectionName' cannot be found in $filename");
                 }
                 $dataArray = $this->_arrayMergeRecursive($this->_processSection($iniArray, $sectionName), $dataArray);
 
             }
             parent::__construct($dataArray, $allowModifications);
         }
 
         $this->_loadedSection = $section;
     }
 
     /**
      * Load the INI file from disk using parse_ini_file(). Use a private error
      * handler to convert any loading errors into a Zend_Config_Exception
      *
      * @param string $filename
      * @throws Zend_Config_Exception
      * @return array
      */
     protected function _parseIniFile($filename)
     {
         set_error_handler(array($this, '_loadFileErrorHandler'));
         $iniArray = parse_ini_file($filename, true); // Warnings and errors are suppressed
         restore_error_handler();
 
         // Check if there was a error while loading file
         if ($this->_loadFileErrorStr !== null) {
             /**
              * @see Zend_Config_Exception
              */
             // require_once 'Zend/Config/Exception.php';
             throw new Zend_Config_Exception($this->_loadFileErrorStr);
         }
 
         return $iniArray;
     }
 
     /**
      * Load the ini file and preprocess the section separator (':' in the
      * section name (that is used for section extension) so that the resultant
      * array has the correct section names and the extension information is
      * stored in a sub-key called ';extends'. We use ';extends' as this can
      * never be a valid key name in an INI file that has been loaded using
      * parse_ini_file().
      *
      * @param string $filename
      * @throws Zend_Config_Exception
      * @return array
      */
     protected function _loadIniFile($filename)
     {
         $loaded = $this->_parseIniFile($filename);
         $iniArray = array();
         foreach ($loaded as $key => $data)
         {
             $pieces = explode($this->_sectionSeparator, $key);
             $thisSection = trim($pieces[0]);
             switch (count($pieces)) {
                 case 1:
                     $iniArray[$thisSection] = $data;
                     break;
 
                 case 2:
                     $extendedSection = trim($pieces[1]);
                     $iniArray[$thisSection] = array_merge(array(';extends'=>$extendedSection), $data);
                     break;
 
                 default:
                     /**
                      * @see Zend_Config_Exception
                      */
                     // require_once 'Zend/Config/Exception.php';
                     throw new Zend_Config_Exception("Section '$thisSection' may not extend multiple sections in $filename");
             }
         }
 
         return $iniArray;
     }
 
     /**
      * Process each element in the section and handle the ";extends" inheritance
      * key. Passes control to _processKey() to handle the nest separator
      * sub-property syntax that may be used within the key name.
      *
      * @param  array  $iniArray
      * @param  string $section
      * @param  array  $config
      * @throws Zend_Config_Exception
      * @return array
      */
     protected function _processSection($iniArray, $section, $config = array())
     {
         $thisSection = $iniArray[$section];
 
         foreach ($thisSection as $key => $value) {
             if (strtolower($key) == ';extends') {
                 if (isset($iniArray[$value])) {
                     $this->_assertValidExtend($section, $value);
 
                     if (!$this->_skipExtends) {
                         $config = $this->_processSection($iniArray, $value, $config);
                     }
                 } else {
                     /**
                      * @see Zend_Config_Exception
                      */
                     // require_once 'Zend/Config/Exception.php';
                     throw new Zend_Config_Exception("Parent section '$section' cannot be found");
                 }
             } else {
                 $config = $this->_processKey($config, $key, $value);
             }
         }
         return $config;
     }
 
     /**
      * Assign the key's value to the property list. Handles the
      * nest separator for sub-properties.
      *
      * @param  array  $config
      * @param  string $key
      * @param  string $value
      * @throws Zend_Config_Exception
      * @return array
      */
     protected function _processKey($config, $key, $value)
     {
         if (strpos($key, $this->_nestSeparator) !== false) {
             $pieces = explode($this->_nestSeparator, $key, 2);
             if (strlen($pieces[0]) && strlen($pieces[1])) {
                 if (!isset($config[$pieces[0]])) {
                     if ($pieces[0] === '0' && !empty($config)) {
                         // convert the current values in $config into an array
                         $config = array($pieces[0] => $config);
                     } else {
                         $config[$pieces[0]] = array();
                     }
                 } elseif (!is_array($config[$pieces[0]])) {
                     /**
                      * @see Zend_Config_Exception
                      */
                     // require_once 'Zend/Config/Exception.php';
                     throw new Zend_Config_Exception("Cannot create sub-key for '{$pieces[0]}' as key already exists");
                 }
                 $config[$pieces[0]] = $this->_processKey($config[$pieces[0]], $pieces[1], $value);
             } else {
                 /**
                  * @see Zend_Config_Exception
                  */
                 // require_once 'Zend/Config/Exception.php';
                 throw new Zend_Config_Exception("Invalid key '$key'");
             }
         } else {
             $config[$key] = $value;
         }
         return $config;
     }
 }