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 #552
    In the 552nd issue of ProcessWire Weekly we'll check out the latest weekly update from Ryan, take a quick look at a new e-commerce solution for ProcessWire, and more. Read on!
    Weekly.pw / 7 December 2024
  • Custom Fields Module
    This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
    Blog / 30 August 2024
  • Subscribe to weekly ProcessWire news

“We were really happy to build our new portfolio website on ProcessWire! We wanted something that gave us plenty of control on the back-end, without any bloat on the front end - just a nice, easy to access API for all our content that left us free to design and build however we liked.” —Castus, web design agency in Sheffield, UK