1: <?php
2: /**
3: * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
4: * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
5: *
6: * Licensed under The MIT License
7: * For full copyright and license information, please see the LICENSE.txt
8: * Redistributions of files must retain the above copyright notice.
9: *
10: * @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
11: * @link https://cakephp.org CakePHP(tm) Project
12: * @since 1.0.0
13: * @license https://opensource.org/licenses/mit-license.php MIT License
14: */
15: namespace Cake\Core\Configure;
16:
17: /**
18: * An interface for creating objects compatible with Configure::load()
19: */
20: interface ConfigEngineInterface
21: {
22: /**
23: * Read a configuration file/storage key
24: *
25: * This method is used for reading configuration information from sources.
26: * These sources can either be static resources like files, or dynamic ones like
27: * a database, or other datasource.
28: *
29: * @param string $key Key to read.
30: * @return array An array of data to merge into the runtime configuration
31: */
32: public function read($key);
33:
34: /**
35: * Dumps the configure data into the storage key/file of the given `$key`.
36: *
37: * @param string $key The identifier to write to.
38: * @param array $data The data to dump.
39: * @return bool True on success or false on failure.
40: */
41: public function dump($key, array $data);
42: }
43: