$pages→uncacheAll()

Remove all pages from the cache (to clear memory)

This method clears all pages that ProcessWire has cached in memory, making room for more pages to be loaded. Use of this method (along with pagination) may be necessary when modifying or calculating from thousand of pages.

  • 3.0.259 Deprecated 2nd argument (previously $options) and moved to 1st argument but still backwards compatible.

Example

// calculate total dollar value of all 50000+ products in inventory
$total = 0;
$start = 0;
$limit = 500;

do {
  $products = $pages->find("template=product, start=$start, limit=$limit");
  if(!$products->count()) break;
  foreach($products as $product) {
    $total += ($product->qty * $product->price);
  }
  unset($products);
  $start += $limit;
  // clear cache to make room for another 500 products
  $pages->uncacheAll();
} while(true);

echo "Total value of all products: $" . number_format($total);

Usage

// basic usage
$int = $pages->uncacheAll();

// usage with all arguments
$int = $pages->uncacheAll($options = [], $deprecated = null);

Arguments

NameType(s)Description
$options (optional)array Page

Options to modify default behavior or Page object for 'page option:

  • shallow (bool): By default, this method also calls $page->uncache(). To prevent that call, set this to true.
  • page (Page): Optionally specify Page instance that initiated the call (for debugging purposes only).
$deprecated (optional)array null

Old location of $options, now deprecated, but still supported for backwards compatibility.

Return value

int

Number of pages uncached

$pages methods and properties

API reference based on ProcessWire core version 3.0.259