PageValues::getMultiple() method

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.

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 = $pageValues->getMultiple(page $page, $keys);

// usage with all arguments
$array = $pageValues->getMultiple(page $page, $keys, bool $assoc = false);

Arguments

NameType(s)Description
pagepage
keysarray, string

Array or CSV string of properties to get.

assoc (optional)bool

Get associative array indexed by given properties? (default=false)

Return value

array


PageValues methods and properties

API reference based on ProcessWire core version 3.0.236

Latest news

  • ProcessWire Weekly #518
    The 518th issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 13 April 2024
  • ProFields Table Field with Actions support
    This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
    Blog / 12 April 2024
  • Subscribe to weekly ProcessWire news

I just love the easy and intuitive ProcessWire API. ProcessWire rocks!” —Jens Martsch, Web developer