Merge ViewHelper `<f:merge>`

Note

This reference is part of the documentation of Fluid Standalone. If you are working with Fluid in TYPO3 CMS, please refer to TYPO3's ViewHelper reference instead.

The MergeViewHelper merges two arrays into one, optionally recursively.

It works similar to the PHP functions array_merge() and array_merge_recursive(), depending on the value of the "recursive" argument.

Example

Simple merge

<f:merge array="{0: 'a', 1: 'b'}" with="{1: 'x', 2: 'c'}" />

Result:

{0: 'a', 1: 'x', 2: 'c'}

Recursive merge

<f:merge array="{foo: {bar: 'baz'}}" with="{foo: {qux: 'value'}}" recursive="true" />

Result:

{foo: {bar: 'baz', qux: 'value'}}

Inline notation

{f:variable(name: 'myArray', value: {foo: 1})}
{myArray -> f:merge(with: {bar: 2})}

Result:

{foo: 1, bar: 2}

Go to the source code of this ViewHelper: MergeViewHelper.php (GitHub).

Arguments

The following arguments are available for the merge ViewHelper:

array

Type: array

The array to merge into

recursive

Type: boolean
Default: false

Whether to merge arrays recursively

with

Type: array

Array to be merged

Merge ViewHelper <f:merge>

Example

Simple merge

Recursive merge

Inline notation

Arguments

array

recursive

with

Merge ViewHelper `<f:merge>`