updated PropertyAccess docs for PR 30536

wuestkamp · wuestkamp · commit 84b9148b0e86 · 2019-03-14T13:04:45.000+01:00
diff --git a/components/property_access.rst b/components/property_access.rst
@@ -168,6 +168,29 @@ getters, this means that you can do something like this::
 
 This will produce: ``He is an author``
 
+Accessing a non existing property path
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+By default a :class:`Symfony\\Component\\PropertyAccess\\Exception\\NoSuchPropertyException` is thrown if the property path passed to :method:`PropertyAccessor::getValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue>`
+does not exist.
+You can change this behaviour using the :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::disableExceptionOnInvalidPropertyPath`
+method::
+
+    // ...
+    $propertyAccessor = PropertyAccess::createPropertyAccessorBuilder()
+        ->disableExceptionOnInvalidPropertyPath()
+        ->getPropertyAccessor();
+
+    class Person
+    {
+        public $name;
+    }
+
+    $person = new Person();
+
+    // instead of throwing an exception the following code returns a null value
+    $value = $propertyAccessor->getValue($person, 'birthday');
+
+
 Magic ``__get()`` Method
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
@@ -107,6 +107,7 @@ Configuration
 
   * `magic_call`_
   * `throw_exception_on_invalid_index`_
+  * `throw_exception_on_invalid_property_path`_
 
 * `property_info`_
 
@@ -1726,6 +1727,14 @@ throw_exception_on_invalid_index
 When enabled, the ``property_accessor`` service throws an exception when you
 try to access an invalid index of an array.
 
+throw_exception_on_invalid_property_path
+........................................
+
+**type**: ``boolean`` **default**: ``true``
+
+When enabled, the ``property_accessor`` service throws an exception when you
+try to access an invalid property path of an object.
+
 property_info
 ~~~~~~~~~~~~~
 
