blob: 6650c4cc97dea0444a07ec8986bb3fb0a7b54485 [file] [log] [blame]
Andrey Andreevc5536aa2012-11-01 17:33:58 +02001<?php
Derek Allard2067d1a2008-11-13 22:59:24 +00002/**
3 * CodeIgniter
4 *
Phil Sturgeon07c1ac82012-03-09 17:03:37 +00005 * An open source application development framework for PHP 5.2.4 or newer
Derek Allard2067d1a2008-11-13 22:59:24 +00006 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05007 * NOTICE OF LICENSE
Andrey Andreevccabcfd2012-01-07 19:30:47 +02008 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05009 * Licensed under the Open Software License version 3.0
Andrey Andreevccabcfd2012-01-07 19:30:47 +020010 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -050011 * This source file is subject to the Open Software License (OSL 3.0) that is
12 * bundled with this package in the files license.txt / license.rst. It is
13 * also available through the world wide web at this URL:
14 * http://opensource.org/licenses/OSL-3.0
15 * If you did not receive a copy of the license and are unable to obtain it
16 * through the world wide web, please send an email to
17 * licensing@ellislab.com so we can send you a copy immediately.
18 *
Derek Allard2067d1a2008-11-13 22:59:24 +000019 * @package CodeIgniter
Derek Jonesf4a4bd82011-10-20 12:18:42 -050020 * @author EllisLab Dev Team
darwinel871754a2014-02-11 17:34:57 +010021 * @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (http://ellislab.com/)
Derek Jonesf4a4bd82011-10-20 12:18:42 -050022 * @license http://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
Derek Allard2067d1a2008-11-13 22:59:24 +000023 * @link http://codeigniter.com
24 * @since Version 1.0
25 * @filesource
26 */
Andrey Andreevc5536aa2012-11-01 17:33:58 +020027defined('BASEPATH') OR exit('No direct script access allowed');
Derek Allard2067d1a2008-11-13 22:59:24 +000028
Derek Allard2067d1a2008-11-13 22:59:24 +000029/**
Andrey Andreev5232ba02012-10-27 15:25:05 +030030 * Config Class
Derek Allard2067d1a2008-11-13 22:59:24 +000031 *
32 * This class contains functions that enable config files to be managed
33 *
34 * @package CodeIgniter
35 * @subpackage Libraries
36 * @category Libraries
Derek Jonesf4a4bd82011-10-20 12:18:42 -050037 * @author EllisLab Dev Team
Derek Allard2067d1a2008-11-13 22:59:24 +000038 * @link http://codeigniter.com/user_guide/libraries/config.html
39 */
40class CI_Config {
41
David Behler2d2c9c62011-08-14 20:03:08 +020042 /**
43 * List of all loaded config values
44 *
Andrey Andreev5232ba02012-10-27 15:25:05 +030045 * @var array
David Behler2d2c9c62011-08-14 20:03:08 +020046 */
Eric Robertsaa141a52012-07-04 02:13:56 -050047 public $config = array();
Andrey Andreev92ebfb62012-05-17 12:49:24 +030048
David Behler2d2c9c62011-08-14 20:03:08 +020049 /**
50 * List of all loaded config files
51 *
Andrey Andreev5232ba02012-10-27 15:25:05 +030052 * @var array
David Behler2d2c9c62011-08-14 20:03:08 +020053 */
Timothy Warren48a7fbb2012-04-23 11:58:16 -040054 public $is_loaded = array();
Andrey Andreev92ebfb62012-05-17 12:49:24 +030055
David Behler2d2c9c62011-08-14 20:03:08 +020056 /**
Andrey Andreevccabcfd2012-01-07 19:30:47 +020057 * List of paths to search when trying to load a config file.
David Behler2d2c9c62011-08-14 20:03:08 +020058 *
Andrey Andreev1887ec62012-10-27 16:22:07 +030059 * @used-by CI_Loader
Andrey Andreev5232ba02012-10-27 15:25:05 +030060 * @var array
David Behler2d2c9c62011-08-14 20:03:08 +020061 */
Timothy Warren48a7fbb2012-04-23 11:58:16 -040062 public $_config_paths = array(APPPATH);
Derek Allard2067d1a2008-11-13 22:59:24 +000063
64 /**
Andrey Andreev5232ba02012-10-27 15:25:05 +030065 * Class constructor
Derek Allard2067d1a2008-11-13 22:59:24 +000066 *
Andrey Andreev5232ba02012-10-27 15:25:05 +030067 * Sets the $config data from the primary config.php file as a class variable.
68 *
69 * @return void
Derek Allard2067d1a2008-11-13 22:59:24 +000070 */
Andrey Andreevccabcfd2012-01-07 19:30:47 +020071 public function __construct()
Derek Allard2067d1a2008-11-13 22:59:24 +000072 {
Barry Mienydd671972010-10-04 16:33:58 +020073 $this->config =& get_config();
Andrey Andreevd52b2422012-01-07 21:28:32 +020074 log_message('debug', 'Config Class Initialized');
Phil Sturgeon4df8b222010-12-15 14:23:14 +000075
76 // Set the base_url automatically if none was provided
Taufan Aditya8749bc72012-03-11 05:43:45 +070077 if (empty($this->config['base_url']))
Phil Sturgeon4df8b222010-12-15 14:23:14 +000078 {
vlakoff7ead65b2014-04-01 02:09:25 +020079 if (isset($_SERVER['HTTP_HOST']))
80 {
81 $base_url = (is_https() ? 'https' : 'http')
82 .'://'.$_SERVER['HTTP_HOST']
83 .substr($_SERVER['SCRIPT_NAME'], 0, -strlen(basename($_SERVER['SCRIPT_NAME'])));
84 }
85 else
86 {
87 $base_url = 'http://localhost/';
88 }
Phil Sturgeon4df8b222010-12-15 14:23:14 +000089
90 $this->set_item('base_url', $base_url);
91 }
Derek Allard2067d1a2008-11-13 22:59:24 +000092 }
Barry Mienydd671972010-10-04 16:33:58 +020093
Derek Allard2067d1a2008-11-13 22:59:24 +000094 // --------------------------------------------------------------------
95
96 /**
97 * Load Config File
98 *
Andrey Andreev5232ba02012-10-27 15:25:05 +030099 * @param string $file Configuration file name
100 * @param bool $use_sections Whether configuration values should be loaded into their own section
101 * @param bool $fail_gracefully Whether to just return FALSE or display an error message
102 * @return bool TRUE if the file was loaded correctly or FALSE on failure
Barry Mienydd671972010-10-04 16:33:58 +0200103 */
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200104 public function load($file = '', $use_sections = FALSE, $fail_gracefully = FALSE)
Derek Allard2067d1a2008-11-13 22:59:24 +0000105 {
Alex Bilbieed944a32012-06-02 11:07:47 +0100106 $file = ($file === '') ? 'config' : str_replace('.php', '', $file);
Fu Xub3355192014-06-12 16:45:00 +0800107 $loaded = FALSE;
Andrey Andreev9438e262012-10-05 13:16:27 +0300108
Pascal Kriete5d5895f2011-02-14 13:27:07 -0500109 foreach ($this->_config_paths as $path)
Phil Sturgeon05fa6112011-04-06 22:57:43 +0100110 {
Fu Xub3355192014-06-12 16:45:00 +0800111 $found = FALSE;
Andrey Andreevdb529ca2013-01-28 11:00:02 +0200112 foreach (array(ENVIRONMENT.'/'.$file, $file) as $location)
Derek Jones6d743e22010-03-02 13:22:03 -0600113 {
Andrey Andreevd52b2422012-01-07 21:28:32 +0200114 $file_path = $path.'config/'.$location.'.php';
Phil Sturgeon05fa6112011-04-06 22:57:43 +0100115
116 if (in_array($file_path, $this->is_loaded, TRUE))
117 {
118 $loaded = TRUE;
119 continue 2;
120 }
121
122 if (file_exists($file_path))
123 {
124 $found = TRUE;
125 break;
126 }
127 }
128
129 if ($found === FALSE)
130 {
Derek Jones6d743e22010-03-02 13:22:03 -0600131 continue;
132 }
Derek Allard2067d1a2008-11-13 22:59:24 +0000133
Derek Jones6d743e22010-03-02 13:22:03 -0600134 include($file_path);
135
136 if ( ! isset($config) OR ! is_array($config))
137 {
138 if ($fail_gracefully === TRUE)
139 {
140 return FALSE;
141 }
142 show_error('Your '.$file_path.' file does not appear to contain a valid configuration array.');
143 }
Barry Mienydd671972010-10-04 16:33:58 +0200144
Derek Jones6d743e22010-03-02 13:22:03 -0600145 if ($use_sections === TRUE)
146 {
147 if (isset($this->config[$file]))
148 {
149 $this->config[$file] = array_merge($this->config[$file], $config);
150 }
151 else
152 {
153 $this->config[$file] = $config;
154 }
155 }
156 else
157 {
158 $this->config = array_merge($this->config, $config);
159 }
Barry Mienydd671972010-10-04 16:33:58 +0200160
Derek Jones6d743e22010-03-02 13:22:03 -0600161 $this->is_loaded[] = $file_path;
162 unset($config);
Barry Mienydd671972010-10-04 16:33:58 +0200163
Derek Jones6d743e22010-03-02 13:22:03 -0600164 $loaded = TRUE;
165 log_message('debug', 'Config file loaded: '.$file_path);
katzgraud127e612011-04-22 10:59:25 -0400166 break;
Derek Jones6d743e22010-03-02 13:22:03 -0600167 }
Barry Mienydd671972010-10-04 16:33:58 +0200168
Derek Jones6d743e22010-03-02 13:22:03 -0600169 if ($loaded === FALSE)
Derek Allard2067d1a2008-11-13 22:59:24 +0000170 {
171 if ($fail_gracefully === TRUE)
172 {
173 return FALSE;
174 }
Eric Robertsaa141a52012-07-04 02:13:56 -0500175 show_error('The configuration file '.$file.'.php does not exist.');
Derek Allard2067d1a2008-11-13 22:59:24 +0000176 }
Phil Sturgeon05fa6112011-04-06 22:57:43 +0100177
Derek Allard2067d1a2008-11-13 22:59:24 +0000178 return TRUE;
179 }
Barry Mienydd671972010-10-04 16:33:58 +0200180
Derek Allard2067d1a2008-11-13 22:59:24 +0000181 // --------------------------------------------------------------------
182
183 /**
184 * Fetch a config file item
185 *
Andrey Andreev5232ba02012-10-27 15:25:05 +0300186 * @param string $item Config item name
187 * @param string $index Index name
vlakoff90f316a2013-07-25 04:33:56 +0200188 * @return string|null The configuration item or NULL if the item doesn't exist
Derek Allard2067d1a2008-11-13 22:59:24 +0000189 */
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200190 public function item($item, $index = '')
Barry Mienydd671972010-10-04 16:33:58 +0200191 {
Andrey Andreev9ba661b2012-06-04 14:44:34 +0300192 if ($index == '')
Barry Mienydd671972010-10-04 16:33:58 +0200193 {
vlakoff184cf1b2013-07-24 03:43:39 +0200194 return isset($this->config[$item]) ? $this->config[$item] : NULL;
Derek Allard2067d1a2008-11-13 22:59:24 +0000195 }
196
vlakoff184cf1b2013-07-24 03:43:39 +0200197 return isset($this->config[$index], $this->config[$index][$item]) ? $this->config[$index][$item] : NULL;
Derek Allard2067d1a2008-11-13 22:59:24 +0000198 }
Barry Mienydd671972010-10-04 16:33:58 +0200199
200 // --------------------------------------------------------------------
Derek Allard2067d1a2008-11-13 22:59:24 +0000201
202 /**
Andrey Andreev5232ba02012-10-27 15:25:05 +0300203 * Fetch a config file item with slash appended (if not empty)
Derek Allard2067d1a2008-11-13 22:59:24 +0000204 *
Andrey Andreev5232ba02012-10-27 15:25:05 +0300205 * @param string $item Config item name
vlakoffc1044cb2013-07-25 12:18:43 +0200206 * @return string|null The configuration item or NULL if the item doesn't exist
Derek Allard2067d1a2008-11-13 22:59:24 +0000207 */
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200208 public function slash_item($item)
Derek Allard2067d1a2008-11-13 22:59:24 +0000209 {
210 if ( ! isset($this->config[$item]))
211 {
vlakoffc1044cb2013-07-25 12:18:43 +0200212 return NULL;
Derek Allard2067d1a2008-11-13 22:59:24 +0000213 }
Alex Bilbieed944a32012-06-02 11:07:47 +0100214 elseif (trim($this->config[$item]) === '')
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800215 {
216 return '';
217 }
Derek Allard2067d1a2008-11-13 22:59:24 +0000218
Phil Sturgeon4df8b222010-12-15 14:23:14 +0000219 return rtrim($this->config[$item], '/').'/';
Derek Allard2067d1a2008-11-13 22:59:24 +0000220 }
Barry Mienydd671972010-10-04 16:33:58 +0200221
Derek Allard2067d1a2008-11-13 22:59:24 +0000222 // --------------------------------------------------------------------
223
224 /**
225 * Site URL
Andrey Andreev5232ba02012-10-27 15:25:05 +0300226 *
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800227 * Returns base_url . index_page [. uri_string]
Derek Allard2067d1a2008-11-13 22:59:24 +0000228 *
Andrey Andreev5232ba02012-10-27 15:25:05 +0300229 * @uses CI_Config::_uri_string()
230 *
231 * @param string|string[] $uri URI string or an array of segments
vlakoff4c07fce2013-10-25 01:20:32 +0200232 * @param string $protocol
Derek Allard2067d1a2008-11-13 22:59:24 +0000233 * @return string
234 */
vlakoff4c07fce2013-10-25 01:20:32 +0200235 public function site_url($uri = '', $protocol = NULL)
Derek Allard2067d1a2008-11-13 22:59:24 +0000236 {
vlakoff4c07fce2013-10-25 01:20:32 +0200237 $base_url = $this->slash_item('base_url');
238
239 if (isset($protocol))
240 {
241 $base_url = $protocol.substr($base_url, strpos($base_url, '://'));
242 }
243
Andrey Andreev1764dd72012-06-16 18:48:19 +0300244 if (empty($uri))
Derek Allard2067d1a2008-11-13 22:59:24 +0000245 {
vlakoff4c07fce2013-10-25 01:20:32 +0200246 return $base_url.$this->item('index_page');
Derek Jones6d743e22010-03-02 13:22:03 -0600247 }
248
Andrey Andreev95d78cf2012-06-16 19:54:33 +0300249 $uri = $this->_uri_string($uri);
250
Alex Bilbieed944a32012-06-02 11:07:47 +0100251 if ($this->item('enable_query_strings') === FALSE)
Derek Jones6d743e22010-03-02 13:22:03 -0600252 {
vlakoff4d9fd192012-12-03 11:31:00 +0100253 $suffix = isset($this->config['url_suffix']) ? $this->config['url_suffix'] : '';
Andrey Andreev95d78cf2012-06-16 19:54:33 +0300254
vlakoff66cb4132012-12-03 10:43:44 +0100255 if ($suffix !== '')
Andrey Andreev95d78cf2012-06-16 19:54:33 +0300256 {
vlakoff66cb4132012-12-03 10:43:44 +0100257 if (($offset = strpos($uri, '?')) !== FALSE)
258 {
259 $uri = substr($uri, 0, $offset).$suffix.substr($uri, $offset);
260 }
261 else
262 {
263 $uri .= $suffix;
264 }
Andrey Andreev95d78cf2012-06-16 19:54:33 +0300265 }
266
vlakoff4c07fce2013-10-25 01:20:32 +0200267 return $base_url.$this->slash_item('index_page').$uri;
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800268 }
Andrey Andreev95d78cf2012-06-16 19:54:33 +0300269 elseif (strpos($uri, '?') === FALSE)
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800270 {
Andrey Andreev95d78cf2012-06-16 19:54:33 +0300271 $uri = '?'.$uri;
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800272 }
Andrey Andreev1764dd72012-06-16 18:48:19 +0300273
vlakoff4c07fce2013-10-25 01:20:32 +0200274 return $base_url.$this->item('index_page').$uri;
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800275 }
David Behler2d2c9c62011-08-14 20:03:08 +0200276
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800277 // -------------------------------------------------------------
David Behler2d2c9c62011-08-14 20:03:08 +0200278
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800279 /**
280 * Base URL
Andrey Andreev5232ba02012-10-27 15:25:05 +0300281 *
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800282 * Returns base_url [. uri_string]
David Behler2d2c9c62011-08-14 20:03:08 +0200283 *
Andrey Andreev5232ba02012-10-27 15:25:05 +0300284 * @uses CI_Config::_uri_string()
285 *
286 * @param string|string[] $uri URI string or an array of segments
vlakoff4c07fce2013-10-25 01:20:32 +0200287 * @param string $protocol
Andrey Andreev92ebfb62012-05-17 12:49:24 +0300288 * @return string
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800289 */
vlakoff4c07fce2013-10-25 01:20:32 +0200290 public function base_url($uri = '', $protocol = NULL)
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800291 {
vlakoff4c07fce2013-10-25 01:20:32 +0200292 $base_url = $this->slash_item('base_url');
293
294 if (isset($protocol))
295 {
296 $base_url = $protocol.substr($base_url, strpos($base_url, '://'));
297 }
298
299 return $base_url.ltrim($this->_uri_string($uri), '/');
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800300 }
David Behler2d2c9c62011-08-14 20:03:08 +0200301
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800302 // -------------------------------------------------------------
David Behler2d2c9c62011-08-14 20:03:08 +0200303
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800304 /**
Andrey Andreev5232ba02012-10-27 15:25:05 +0300305 * Build URI string
David Behler2d2c9c62011-08-14 20:03:08 +0200306 *
Andrey Andreev5232ba02012-10-27 15:25:05 +0300307 * @used-by CI_Config::site_url()
308 * @used-by CI_Config::base_url()
309 *
310 * @param string|string[] $uri URI string or an array of segments
Andrey Andreev92ebfb62012-05-17 12:49:24 +0300311 * @return string
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800312 */
313 protected function _uri_string($uri)
314 {
Alex Bilbieed944a32012-06-02 11:07:47 +0100315 if ($this->item('enable_query_strings') === FALSE)
anaxamaxan@blackdog.locald09c51a2011-02-02 23:00:16 -0800316 {
Derek Jones6d743e22010-03-02 13:22:03 -0600317 if (is_array($uri))
318 {
319 $uri = implode('/', $uri);
320 }
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200321 return trim($uri, '/');
Derek Allard2067d1a2008-11-13 22:59:24 +0000322 }
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200323 elseif (is_array($uri))
Derek Allard2067d1a2008-11-13 22:59:24 +0000324 {
Andrey Andreev1764dd72012-06-16 18:48:19 +0300325 return http_build_query($uri);
Derek Allard2067d1a2008-11-13 22:59:24 +0000326 }
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200327
Greg Aker03abee32011-12-25 00:31:29 -0600328 return $uri;
Derek Allard2067d1a2008-11-13 22:59:24 +0000329 }
Barry Mienydd671972010-10-04 16:33:58 +0200330
Derek Allard2067d1a2008-11-13 22:59:24 +0000331 // --------------------------------------------------------------------
David Behler2d2c9c62011-08-14 20:03:08 +0200332
Derek Allard2067d1a2008-11-13 22:59:24 +0000333 /**
334 * System URL
335 *
Andrey Andreeve4e10912014-02-08 19:58:48 +0200336 * @deprecated 3.0.0 Encourages insecure practices
Derek Allard2067d1a2008-11-13 22:59:24 +0000337 * @return string
338 */
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200339 public function system_url()
Derek Allard2067d1a2008-11-13 22:59:24 +0000340 {
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200341 $x = explode('/', preg_replace('|/*(.+?)/*$|', '\\1', BASEPATH));
Derek Allard2067d1a2008-11-13 22:59:24 +0000342 return $this->slash_item('base_url').end($x).'/';
343 }
Barry Mienydd671972010-10-04 16:33:58 +0200344
Derek Allard2067d1a2008-11-13 22:59:24 +0000345 // --------------------------------------------------------------------
346
347 /**
348 * Set a config file item
349 *
Andrey Andreev5232ba02012-10-27 15:25:05 +0300350 * @param string $item Config item key
351 * @param string $value Config item value
Derek Allard2067d1a2008-11-13 22:59:24 +0000352 * @return void
353 */
Andrey Andreevccabcfd2012-01-07 19:30:47 +0200354 public function set_item($item, $value)
Derek Allard2067d1a2008-11-13 22:59:24 +0000355 {
356 $this->config[$item] = $value;
357 }
Barry Mienydd671972010-10-04 16:33:58 +0200358
Derek Allard2067d1a2008-11-13 22:59:24 +0000359}
360
Derek Allard2067d1a2008-11-13 22:59:24 +0000361/* End of file Config.php */
Fu Xub3355192014-06-12 16:45:00 +0800362/* Location: ./system/core/Config.php */