404

[ Avaa Bypassed ]




Upload:

Command:

elspacio@18.191.189.164: ~ $
---
layout: default
title: Reading Validated Options
description: Reading the validated, processed options
---

# Reading Validated Options

Once the [schema has been defined](/1.1/schemas/) and the [user options have been set](/1.1/setting-values/) you are ready to read them elsewhere in your application! Thanks to [lazy processing](/1.1/lazy-processing/), this library will apply the schemas and validations only if/when you attempt to read a value.

The processed, validated configuration options can be read using the `get()` method. Simply pass in the name of the option you wish to fetch:

```php
use League\Config\Configuration;
use Nette\Schema\Expect;

$config = new Configuration([
    'debug_mode' => Expect::bool()->required(),
    'database' => Expect::structure([
        'driver' => Expect::anyOf('mysql', 'postgresql', 'sqlite')->required(),
        'host' => Expect::string()->default('localhost'),
        'port' => Expect::int()->min(1)->max(65535),
        'ssl' => Expect::bool(),
        'database' => Expect::string()->required(),
        'username' => Expect::string()->required(),
        'password' => Expect::string()->nullable(),
    ]),
    'logging' => Expect::structure([
        'enabled' => Expect::bool()->default($_ENV['DEBUG'] == true),
        'file' => Expect::string()->deprecated("use logging.path instead"),
        'path' => Expect::string()->assert(function ($path) { return \is_writeable($path); })->required(),
    ]),
]);

// TODO: Set the configuration values
$config->merge([/* ... */]);

var_dump($config->get('debug_mode')); // a string
var_dump($config->get('database'));   // an array
```

You can access nested options using "dot access" expressions like this:

```php
var_dump($config->get('database.driver')); // a string

// slashes can also be used instead of dots:
var_dump($config->get('database/driver')); // a string
```

## Undefined Options

If you attempt to `get()` an option that was not defined in the schema an exception will be thrown.  This is probably not an issue in cases where you wrote the schema and know it should always contain certain options.  But in some cases (perhaps you're conditionally adding certain schemas) you might want to first check whether an option is defined before attempting to read it - you can do that with the `exists()` method.  It takes the same arguments as `get()` but will return `true` or `false` based on whether that item exists.

Filemanager

Name Type Size Permission Actions
basic-usage.md File 2.09 KB 0644
changelog.md File 618 B 0644
index.md File 1.41 KB 0644
installation.md File 693 B 0644
lazy-processing.md File 2.14 KB 0644
mutability.md File 1.04 KB 0644
philosophy.md File 2.53 KB 0644
reading-values.md File 2.44 KB 0644
schemas.md File 4.17 KB 0644
setting-values.md File 2.19 KB 0644
upgrading.md File 383 B 0644