Konstruktor drzewa Symfony2 - do czego służy metoda canBeUnset()?

Question

$rootNode 
    ->children() 
     ->arrayNode('form') 
      ->info('form configuration') 
      ->canBeUnset() 
      ->treatNullLike(array('enabled' => true)) 
      ->treatTrueLike(array('enabled' => true)) 
      ->children() 
       ->booleanNode('enabled')->defaultTrue()->end() 
      ->end() 
     ->end() 

Wiersz 5 powyższego urywka z Symfony\Bundle\FrameworkBundle\DependencyInjection\Configuration używa metody canBeUnset(). Nie wiem, co to robi, ponieważ wydaje się, że nic nie robię, jeśli go usunę. Pracuję nad zrozumieniem konfiguracji semantycznej dla własnych pakietów.

Answer 1

Po kodzie można znaleźć definicję tej metody w klasie Symfony/Component/Config/Definition/Builder/ArrayNodeDefinition.

/** 
* Sets whether the node can be unset. 
* 
* @param Boolean $allow 
* 
* @return ArrayNodeDefinition 
*/ 
public function canBeUnset($allow = true) 
{ 
    $this->merge()->allowUnset($allow); 

    return $this; 
} 

ta jest przekazywana do MergeBuilder (Symfony/Component/Config/Definition/Builder/MergeBuilder), który obsługuje konfiguracyjny połączeniu.

/** 
* Sets whether the node can be unset. 
* 
* @param Boolean $allow 
* 
* @return MergeBuilder 
*/ 
public function allowUnset($allow = true) 
{ 
    $this->allowFalse = $allow; 

    return $this; 
} 

Więc moje zrozumienie jest, że metoda ta definiuje, jeśli wartość config może być wyłączony podczas scalania konfiguracje, w przypadku nadrzędnym config nie obsługuje wartości. Musiałbym jednak przetestować, aby dowiedzieć się, czy zachowanie nie jest dozwolone, ale myślę, że wtedy wyrzuciłoby wyjątek dotyczący brakującej wartości konfiguracyjnej, podobnie jak isRequired.