updated PropertyAccess docs for PR 30536

symfony · wouterj · Apr 6, 2019 · Mar 14, 2019 · Mar 15, 2019 · d53e11e3b29255ce379d9a50bf92d83b87e5c436
commit d53e11e3b29255ce379d9a50bf92d83b87e5c436
diff --git a/components/property_access.rst b/components/property_access.rst
@@ -168,6 +168,30 @@ 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 null
+    $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,18 @@ 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``
+
+.. versionadded:: 4.3
+
+    The ``throw_exception_on_invalid_property_path`` option was introduced in Symfony 4.3.
+
+When enabled, the ``property_accessor`` service throws an exception when you
+try to access an invalid property path of an object.
+
 property_info
 ~~~~~~~~~~~~~