PagesNames::uniqueRandomPageName() method

Get a random, globally unique page name

Usage

// basic usage
$string = $pagesNames->uniqueRandomPageName();

// usage with all arguments
$string = $pagesNames->uniqueRandomPageName(array $options = []);

Arguments

NameType(s)Description
options (optional)array
  • page (Page): If name is or should be assigned to a Page, specify it here. (default=null)
  • length (int): Required/fixed length, or omit for random length (default=0).
  • min (int): Minimum required length, if fixed length not specified (default=6).
  • max (int): Maximum allowed length, if fixed length not specified (default=min*2).
  • alpha (bool): Include alpha a-z letters? (default=true)
  • numeric (bool): Include numeric digits 0-9? (default=true)
  • confirm (bool): Confirm that name is globally unique? (default=true)
  • parent (Page|int): If specified, name must only be unique for this parent Page or ID (default=0).
  • prefix (string): Prepend this prefix to page name (default='').
  • suffix (string): Append this suffix to page name (default='').

Return value

string


PagesNames methods and properties

API reference based on ProcessWire core version 3.0.248

Latest news

  • ProcessWire Weekly #581
    The 581st issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 28 June 2025
  • New ProcessWire admin redesign
    When you upgrade to ProcessWire 3.0.248 or newer (currently the dev branch), you’ll immediately notice something new and beautiful…
    Blog / 9 May 2025
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull