README

一个基本的从JSON文件加载并返回单个运行时实例的应用程序配置类。该实例是可写的。

• 可以从JSON文件创建一个对象。
• 可以从JSON文件的某一节创建一个对象，深度为一级。
• 可以在运行时构建一个对象。
• 只返回一个对象实例。
• 返回的对象是可写的。

许可证

MIT - MIT许可证文件: LICENSE

安装

Composer

composer require somephp/appconfig

使用示例

以下两个示例展示了如何加载JSON配置文件及其部分，它们使用config.json。最后一个示例展示了如何在运行时构建配置。

示例 #1 从JSON文件创建对象

<?php
require_once 'AppConfig.php';

try {
  // Specify the path of a JSON file to load.
  $config = AppConfig::load('config.json');
} catch (Exception $e) {
  var_dump($e->getMessage());
  exit;
}

echo "API: {$config->dev->api->example->url} \n";
echo "User: {$config->dev->db->mysql->user} \n";
echo "Passowrd: {$config->dev->db->mysql->pass} \n";

示例 #1 输出

API: https://example.com/dev/api 
User: admin 
Passowrd: love 

示例 #2 从JSON文件的子部分创建对象

<?php
class ServerConfig {
  public static $env = 'prod';
}

require_once 'AppConfig.php';

try {
  // Create an object from the "prod" section of a JSON file.
  $config = AppConfig::load('config.json', ServerConfig::$env);
} catch (Exception $e) {
  var_dump($e->getMessage());
  exit;
}

// Display a copy the entire runtime object.
echo print_r($config->get(), true);

示例 #2 输出

stdClass Object
(
    [db] => stdClass Object
        (
            [mysql] => stdClass Object
                (
                    [server] => https://example.com
                    [user] => admin
                    [pass] => secret
                    [db] => currency_prod
                )

            [mongo] => stdClass Object
                (
                    [collection] => currency_prod
                    [doc] => 
                    [server] => mongodb://127.0.0.1:27017
                )

        )

    [api] => stdClass Object
        (
            [example] => stdClass Object
                (
                    [url] => https://example.com/api
                    [secret] => 74c42a009d7c0fcdb1aa4a853b37977f
                    [key] => 85bb2e1519dbb2c2421b5cad6039bfcd
                    [pass] => realsecret5realkey
                )

        )

)

示例 #3 在运行时构建对象

<?php
require_once 'AppConfig.php';

try {
  // Create an empty config object.
  $config = AppConfig::load();
} catch (Exception $e) {
  var_dump($e->getMessage());
  exit;
}
echo 'config->api: '. print_r($config->api, true). PHP_EOL;
echo 'config->db: '. print_r($config->db, true). PHP_EOL;
echo PHP_EOL;

// Add a property.
@$config->api->example->url = 'http://example.com/api';

// Add an object.
$config->db = (object) [
  'mysql' => (object) [
    'server' => 'localhost',
    'user' => 'admin',
    'pass' => 'love',
    'db' => 'currency_dev'
  ]
];

// load() will return the same instance of the config object.
$configTwo = AppConfig::load();

echo 'configTwo->api: '. print_r($configTwo->api, true). PHP_EOL;
echo 'configTwo->db: '. print_r($configTwo->db, true). PHP_EOL;

示例 #3 输出

config->api: 
config->db: 
configTwo->api: stdClass Object
(
    [example] => stdClass Object
        (
            [url] => http://example.com/api
        )

)

configTwo->db: stdClass Object
(
    [mysql] => stdClass Object
        (
            [server] => localhost
            [user] => admin
            [pass] => love
            [db] => currency_dev
        )

)

内容

贡献

欢迎提出建议和代码修改。创建一个合并请求，并告诉我你的想法。