Commit84b9148

committed

updated PropertyAccess docs for PR 30536

1 parent67cc8ed commit84b9148Copy full SHA for 84b9148

File tree

+32

-0

lines changed

+32

-0

lines changed

Lines changed: 23 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -168,6 +168,29 @@ getters, this means that you can do something like this::`
`168`	`168`
`169`	`169`	This will produce: ``He is an author``
`170`	`170`
	`171`	`+Accessing a non existing property path`
	`172`	`+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~`
	`173`	+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>`
	`174`	`+does not exist.`
	`175`	+You can change this behaviour using the:method:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::disableExceptionOnInvalidPropertyPath`
	`176`	`+method::`
	`177`	`+`
	`178`	`+ // ...`
	`179`	`+ $propertyAccessor = PropertyAccess::createPropertyAccessorBuilder()`
	`180`	`+ ->disableExceptionOnInvalidPropertyPath()`
	`181`	`+ ->getPropertyAccessor();`
	`182`	`+`
	`183`	`+ class Person`
	`184`	`+ {`
	`185`	`+ public $name;`
	`186`	`+ }`
	`187`	`+`
	`188`	`+ $person = new Person();`
	`189`	`+`
	`190`	`+ // instead of throwing an exception the following code returns a null value`
	`191`	`+ $value = $propertyAccessor->getValue($person, 'birthday');`
	`192`	`+`
	`193`	`+`
`171`	`194`	Magic ``__get()`` Method
`172`	`195`	`~~~~~~~~~~~~~~~~~~~~~~~~`
`173`	`196`

Lines changed: 9 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -107,6 +107,7 @@ Configuration`
`107`	`107`
`108`	`108`	* `magic_call`_
`109`	`109`	* `throw_exception_on_invalid_index`_
	`110`	+ * `throw_exception_on_invalid_property_path`_
`110`	`111`
`111`	`112`	* `property_info`_
`112`	`113`
`@@ -1726,6 +1727,14 @@ throw_exception_on_invalid_index`
`1726`	`1727`	When enabled, the ``property_accessor`` service throws an exception when you
`1727`	`1728`	`try to access an invalid index of an array.`
`1728`	`1729`
	`1730`	`+throw_exception_on_invalid_property_path`
	`1731`	`+........................................`
	`1732`	`+`
	`1733`	+type: ``boolean`` default: ``true``
	`1734`	`+`
	`1735`	+When enabled, the ``property_accessor`` service throws an exception when you
	`1736`	`+try to access an invalid property path of an object.`
	`1737`	`+`
`1729`	`1738`	`property_info`
`1730`	`1739`	`~~~~~~~~~~~~~`
`1731`	`1740`

Comments

(0)