> For the complete documentation index, see [llms.txt](https://senselab.gitbook.io/senselab-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://senselab.gitbook.io/senselab-docs/vendor/symfony/options-resolver/changelog.md).

# CHANGELOG

## 8.0

* Remove support for nested options definition via `setDefault()`, use `setOptions()` instead

## 7.3

* Support union type in `OptionResolver::setAllowedTypes()` method
* Add `OptionsResolver::setOptions()` and `OptionConfigurator::options()` methods
* Deprecate defining nested options via `setDefault()`, use `setOptions()` instead

## 6.4

* Improve message with full path on invalid type in nested option

## 6.3

* Add `OptionsResolver::setIgnoreUndefined()` and `OptionConfigurator::ignoreUndefined()` to ignore not defined options while resolving

## 6.0

* Remove `OptionsResolverIntrospector::getDeprecationMessage()`

## 5.3

* Add prototype definition for nested options

## 5.1.0

* added fluent configuration of options using `OptionResolver::define()`
* added `setInfo()` and `getInfo()` methods
* updated the signature of method `OptionsResolver::setDeprecated()` to `OptionsResolver::setDeprecation(string $option, string $package, string $version, $message)`
* deprecated `OptionsResolverIntrospector::getDeprecationMessage()`, use `OptionsResolverIntrospector::getDeprecation()` instead

## 5.0.0

* added argument `$triggerDeprecation` to `OptionsResolver::offsetGet()`

## 4.3.0

* added `OptionsResolver::addNormalizer` method

## 4.2.0

* added support for nested options definition
* added `setDeprecated` and `isDeprecated` methods

## 3.4.0

* added `OptionsResolverIntrospector` to inspect options definitions inside an `OptionsResolver` instance
* added array of types support in allowed types (e.g int\[])

## 2.6.0

* deprecated OptionsResolverInterface
* \[BC BREAK] removed "array" type hint from OptionsResolverInterface methods setRequired(), setAllowedValues(), addAllowedValues(), setAllowedTypes() and addAllowedTypes()
* added OptionsResolver::setDefault()
* added OptionsResolver::hasDefault()
* added OptionsResolver::setNormalizer()
* added OptionsResolver::isRequired()
* added OptionsResolver::getRequiredOptions()
* added OptionsResolver::isMissing()
* added OptionsResolver::getMissingOptions()
* added OptionsResolver::setDefined()
* added OptionsResolver::isDefined()
* added OptionsResolver::getDefinedOptions()
* added OptionsResolver::remove()
* added OptionsResolver::clear()
* deprecated OptionsResolver::replaceDefaults()
* deprecated OptionsResolver::setOptional() in favor of setDefined()
* deprecated OptionsResolver::isKnown() in favor of isDefined()
* \[BC BREAK] OptionsResolver::isRequired() returns true now if a required option has a default value set
* \[BC BREAK] merged Options into OptionsResolver and turned Options into an interface
* deprecated Options::overload() (now in OptionsResolver)
* deprecated Options::set() (now in OptionsResolver)
* deprecated Options::get() (now in OptionsResolver)
* deprecated Options::has() (now in OptionsResolver)
* deprecated Options::replace() (now in OptionsResolver)
* \[BC BREAK] Options::get() (now in OptionsResolver) can only be used within lazy option/normalizer closures now
* \[BC BREAK] removed Traversable interface from Options since using within lazy option/normalizer closures resulted in exceptions
* \[BC BREAK] removed Options::all() since using within lazy option/normalizer closures resulted in exceptions
* \[BC BREAK] OptionDefinitionException now extends LogicException instead of RuntimeException
* \[BC BREAK] normalizers are not executed anymore for unset options
* normalizers are executed after validating the options now
* \[BC BREAK] an UndefinedOptionsException is now thrown instead of an InvalidOptionsException when non-existing options are passed


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://senselab.gitbook.io/senselab-docs/vendor/symfony/options-resolver/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.