server/lib/legacy/config.php
Thomas Müller e789e05675 on unit test use @expectedException
some phpdoc added
2013-07-02 00:15:42 +02:00

103 lines
2.5 KiB
PHP

<?php
/**
* ownCloud
*
* @author Frank Karlitschek
* @author Jakob Sack
* @copyright 2012 Frank Karlitschek frank@owncloud.org
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
* License as published by the Free Software Foundation; either
* version 3 of the License, or any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU AFFERO GENERAL PUBLIC LICENSE for more details.
*
* You should have received a copy of the GNU Affero General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*
*/
/*
*
* An example of config.php
*
* <?php
* $CONFIG = array(
* "database" => "mysql",
* "firstrun" => false,
* "pi" => 3.14
* );
* ?>
*
*/
/**
* This class is responsible for reading and writing config.php, the very basic
* configuration file of ownCloud.
*/
OC_Config::$object = new \OC\Config(OC::$SERVERROOT.'/config/');
class OC_Config {
/**
* @var \OC\Config
*/
public static $object;
/**
* @brief Lists all available config keys
* @return array with key names
*
* This function returns all keys saved in config.php. Please note that it
* does not return the values.
*/
public static function getKeys() {
return self::$object->getKeys();
}
/**
* @brief Gets a value from config.php
* @param string $key key
* @param string $default = null default value
* @return string the value or $default
*
* This function gets the value from config.php. If it does not exist,
* $default will be returned.
*/
public static function getValue($key, $default = null) {
return self::$object->getValue($key, $default);
}
/**
* @brief Sets a value
* @param string $key key
* @param string $value value
*
* This function sets the value and writes the config.php.
*
*/
public static function setValue($key, $value) {
try {
self::$object->setValue($key, $value);
} catch (\OC\HintException $e) {
\OC_Template::printErrorPage($e->getMessage(), $e->getHint());
}
}
/**
* @brief Removes a key from the config
* @param string $key key
*
* This function removes a key from the config.php.
*
*/
public static function deleteKey($key) {
try {
self::$object->deleteKey($key);
} catch (\OC\HintException $e) {
\OC_Template::printErrorPage($e->getMessage(), $e->getHint());
}
}
}