Get multiple Page property/field values in an array
This method works exactly the same as the get()
method except that it accepts an
array (or CSV string) of properties/fields to get, and likewise returns an array
of those property/field values. By default it returns a regular (non-indexed) PHP
array in the same order given. To instead get an associative array indexed by the
property/field names given, specify true
for the $assoc
argument.
Available since version 3.0.201.
Example
// returns regular array i.e. [ 'foo val', 'bar val' ]
$a = $page->getMultiple([ 'foo', 'bar' ]);
list($foo, $bar) = $a;
// returns associative array i.e. [ 'foo' => 'foo val', 'bar' => 'bar val' ]
$a = $page->getMultiple([ 'foo', 'bar' ], true);
$foo = $a['foo'];
$bar = $a['bar'];
// CSV string can also be used instead of array
$a = $page->getMultiple('foo,bar');
Usage
// basic usage
$array = $page->getMultiple($keys);
// usage with all arguments
$array = $page->getMultiple($keys, bool $assoc = false);
Arguments
Name | Type(s) | Description |
---|---|---|
keys | array, string | Array or CSV string of properties to get. |
assoc (optional) | bool | Get associative array indexed by given properties? (default=false) |
Return value
array
API reference based on ProcessWire core version 3.0.236