CakePHP
  • Documentation
    • Book
    • API
    • Videos
    • Reporting Security Issues
    • Privacy Policy
    • Logos & Trademarks
  • Business Solutions
  • Swag
  • Road Trip
  • Team
  • Community
    • Community
    • Get Involved
    • Issues (GitHub)
    • Bakery
    • Featured Resources
    • Training
    • Meetups
    • My CakePHP
    • CakeFest
    • Newsletter
    • Linkedin
    • YouTube
    • Facebook
    • Twitter
    • Mastodon
    • Help & Support
    • Forum
    • Stack Overflow
    • Slack
    • Paid Support
CakePHP

C CakePHP 2.6 API

  • Overview
  • Tree
  • Deprecated
  • Version:
    • 2.6
      • 4.2
      • 4.1
      • 4.0
      • 3.9
      • 3.8
      • 3.7
      • 3.6
      • 3.5
      • 3.4
      • 3.3
      • 3.2
      • 3.1
      • 3.0
      • 2.10
      • 2.9
      • 2.8
      • 2.7
      • 2.6
      • 2.5
      • 2.4
      • 2.3
      • 2.2
      • 2.1
      • 2.0
      • 1.3
      • 1.2

Packages

  • Cake
    • Cache
      • Engine
    • Configure
    • Console
      • Command
        • Task
    • Controller
      • Component
        • Acl
        • Auth
    • Core
    • Error
    • Event
    • I18n
    • Log
      • Engine
    • Model
      • Behavior
      • Datasource
        • Database
        • Session
      • Validator
    • Network
      • Email
      • Http
    • Routing
      • Filter
      • Route
    • TestSuite
      • Coverage
      • Fixture
      • Reporter
    • Utility
    • View
      • Helper

Classes

  • IniReader
  • PhpReader
  1: <?php
  2: /**
  3:  * IniReader
  4:  *
  5:  * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
  6:  * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
  7:  *
  8:  * Licensed under The MIT License
  9:  * For full copyright and license information, please see the LICENSE.txt
 10:  * Redistributions of files must retain the above copyright notice.
 11:  *
 12:  * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 13:  * @link          http://cakephp.org CakePHP(tm) Project
 14:  * @package       Cake.Configure
 15:  * @since         CakePHP(tm) v 2.0
 16:  * @license       http://www.opensource.org/licenses/mit-license.php MIT License
 17:  */
 18: 
 19: App::uses('Hash', 'Utility');
 20: App::uses('CakePlugin', 'Core');
 21: 
 22: /**
 23:  * Ini file configuration engine.
 24:  *
 25:  * Since IniReader uses parse_ini_file underneath, you should be aware that this
 26:  * class shares the same behavior, especially with regards to boolean and null values.
 27:  *
 28:  * In addition to the native `parse_ini_file` features, IniReader also allows you
 29:  * to create nested array structures through usage of `.` delimited names. This allows
 30:  * you to create nested arrays structures in an ini config file. For example:
 31:  *
 32:  * `db.password = secret` would turn into `array('db' => array('password' => 'secret'))`
 33:  *
 34:  * You can nest properties as deeply as needed using `.`'s. In addition to using `.` you
 35:  * can use standard ini section notation to create nested structures:
 36:  *
 37:  * ```
 38:  * [section]
 39:  * key = value
 40:  * ```
 41:  *
 42:  * Once loaded into Configure, the above would be accessed using:
 43:  *
 44:  * `Configure::read('section.key');
 45:  *
 46:  * You can combine `.` separated values with sections to create more deeply
 47:  * nested structures.
 48:  *
 49:  * IniReader also manipulates how the special ini values of
 50:  * 'yes', 'no', 'on', 'off', 'null' are handled. These values will be
 51:  * converted to their boolean equivalents.
 52:  *
 53:  * @package       Cake.Configure
 54:  * @see http://php.net/parse_ini_file
 55:  */
 56: class IniReader implements ConfigReaderInterface {
 57: 
 58: /**
 59:  * The path to read ini files from.
 60:  *
 61:  * @var array
 62:  */
 63:     protected $_path;
 64: 
 65: /**
 66:  * The section to read, if null all sections will be read.
 67:  *
 68:  * @var string
 69:  */
 70:     protected $_section;
 71: 
 72: /**
 73:  * Build and construct a new ini file parser. The parser can be used to read
 74:  * ini files that are on the filesystem.
 75:  *
 76:  * @param string $path Path to load ini config files from. Defaults to APP . 'Config' . DS
 77:  * @param string $section Only get one section, leave null to parse and fetch
 78:  *     all sections in the ini file.
 79:  */
 80:     public function __construct($path = null, $section = null) {
 81:         if (!$path) {
 82:             $path = APP . 'Config' . DS;
 83:         }
 84:         $this->_path = $path;
 85:         $this->_section = $section;
 86:     }
 87: 
 88: /**
 89:  * Read an ini file and return the results as an array.
 90:  *
 91:  * For backwards compatibility, acl.ini.php will be treated specially until 3.0.
 92:  *
 93:  * @param string $key The identifier to read from. If the key has a . it will be treated
 94:  *  as a plugin prefix. The chosen file must be on the reader's path.
 95:  * @return array Parsed configuration values.
 96:  * @throws ConfigureException when files don't exist.
 97:  *  Or when files contain '..' as this could lead to abusive reads.
 98:  */
 99:     public function read($key) {
100:         if (strpos($key, '..') !== false) {
101:             throw new ConfigureException(__d('cake_dev', 'Cannot load configuration files with ../ in them.'));
102:         }
103: 
104:         $file = $this->_getFilePath($key);
105:         if (!is_file($file)) {
106:             throw new ConfigureException(__d('cake_dev', 'Could not load configuration file: %s', $file));
107:         }
108: 
109:         $contents = parse_ini_file($file, true);
110:         if (!empty($this->_section) && isset($contents[$this->_section])) {
111:             $values = $this->_parseNestedValues($contents[$this->_section]);
112:         } else {
113:             $values = array();
114:             foreach ($contents as $section => $attribs) {
115:                 if (is_array($attribs)) {
116:                     $values[$section] = $this->_parseNestedValues($attribs);
117:                 } else {
118:                     $parse = $this->_parseNestedValues(array($attribs));
119:                     $values[$section] = array_shift($parse);
120:                 }
121:             }
122:         }
123:         return $values;
124:     }
125: 
126: /**
127:  * parses nested values out of keys.
128:  *
129:  * @param array $values Values to be exploded.
130:  * @return array Array of values exploded
131:  */
132:     protected function _parseNestedValues($values) {
133:         foreach ($values as $key => $value) {
134:             if ($value === '1') {
135:                 $value = true;
136:             }
137:             if ($value === '') {
138:                 $value = false;
139:             }
140:             unset($values[$key]);
141:             if (strpos($key, '.') !== false) {
142:                 $values = Hash::insert($values, $key, $value);
143:             } else {
144:                 $values[$key] = $value;
145:             }
146:         }
147:         return $values;
148:     }
149: 
150: /**
151:  * Dumps the state of Configure data into an ini formatted string.
152:  *
153:  * @param string $key The identifier to write to. If the key has a . it will be treated
154:  *  as a plugin prefix.
155:  * @param array $data The data to convert to ini file.
156:  * @return int Bytes saved.
157:  */
158:     public function dump($key, $data) {
159:         $result = array();
160:         foreach ($data as $k => $value) {
161:             $isSection = false;
162:             if ($k[0] !== '[') {
163:                 $result[] = "[$k]";
164:                 $isSection = true;
165:             }
166:             if (is_array($value)) {
167:                 $kValues = Hash::flatten($value, '.');
168:                 foreach ($kValues as $k2 => $v) {
169:                     $result[] = "$k2 = " . $this->_value($v);
170:                 }
171:             }
172:             if ($isSection) {
173:                 $result[] = '';
174:             }
175:         }
176:         $contents = trim(implode("\n", $result));
177: 
178:         $filename = $this->_getFilePath($key);
179:         return file_put_contents($filename, $contents);
180:     }
181: 
182: /**
183:  * Converts a value into the ini equivalent
184:  *
185:  * @param mixed $val Value to export.
186:  * @return string String value for ini file.
187:  */
188:     protected function _value($val) {
189:         if ($val === null) {
190:             return 'null';
191:         }
192:         if ($val === true) {
193:             return 'true';
194:         }
195:         if ($val === false) {
196:             return 'false';
197:         }
198:         return (string)$val;
199:     }
200: 
201: /**
202:  * Get file path
203:  *
204:  * @param string $key The identifier to write to. If the key has a . it will be treated
205:  *  as a plugin prefix.
206:  * @return string Full file path
207:  */
208:     protected function _getFilePath($key) {
209:         if (substr($key, -8) === '.ini.php') {
210:             $key = substr($key, 0, -8);
211:             list($plugin, $key) = pluginSplit($key);
212:             $key .= '.ini.php';
213:         } else {
214:             if (substr($key, -4) === '.ini') {
215:                 $key = substr($key, 0, -4);
216:             }
217:             list($plugin, $key) = pluginSplit($key);
218:             $key .= '.ini';
219:         }
220: 
221:         if ($plugin) {
222:             $file = CakePlugin::path($plugin) . 'Config' . DS . $key;
223:         } else {
224:             $file = $this->_path . $key;
225:         }
226: 
227:         return $file;
228:     }
229: 
230: }
231: 
OpenHub
Rackspace
Rackspace
  • Business Solutions
  • Showcase
  • Documentation
  • Book
  • API
  • Videos
  • Reporting Security Issues
  • Privacy Policy
  • Logos & Trademarks
  • Community
  • Get Involved
  • Issues (GitHub)
  • Bakery
  • Featured Resources
  • Training
  • Meetups
  • My CakePHP
  • CakeFest
  • Newsletter
  • Linkedin
  • YouTube
  • Facebook
  • Twitter
  • Mastodon
  • Help & Support
  • Forum
  • Stack Overflow
  • Slack
  • Paid Support

Generated using CakePHP API Docs