Pagefile::filedata() method

Get or set filedata

Filedata is any additional data that you want to store with the file’s database record.

  • To get a value, specify just the $key argument. Null is returned if request value is not present.
  • To get all values, omit all arguments. An associative array will be returned.
  • To set a value, specify the $key and the $value to set.
  • To set all values at once, specify an associative array for the $key argument.
  • To unset, specify boolean false (or null) for $key, and the name of the property to unset as $value.
  • To unset, you can also get all values, unset it from the retuned array, and set the array back.

Usage

// basic usage
$mixed = $pagefile->filedata();

// usage with all arguments
$mixed = $pagefile->filedata($key = '', $value = null);

Arguments

NameType(s)Description
key (optional)string, array, false, null

Specify array to set all file data, or key (string) to set or get a property, Or specify boolean false to remove key specified by $value argument.

value (optional)null, string, array, int, float

Specify a value to set for given property

Return value

mixed


Pagefile methods and properties

API reference based on ProcessWire core version 3.0.244

Latest news

  • ProcessWire Weekly #560
    In the 560th issue of ProcessWire Weekly we'll check out the latest core updates, cover newly released ProcessWire modules, and more. Read on!
    Weekly.pw / 1 February 2025
  • ProcessWire 3.0.244 new main/master version
    ProcessWire 3.0.244 is our newest main/master/stable version. It's been more than a year in the making and is packed with tons of new features, issue fixes, optimizations and more. This post covers all the details.
    Blog / 18 January 2025
  • Subscribe to weekly ProcessWire news

“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer