DocPage

MMO\doc\models · 1 symbol · generated 30 Sep 2026

class

DocPage

One generated documentation page: the unit both renderers work on. The generator writes it twice, side by side -- Foo.md (MarkdownPrinter, for reading the repository itself) and Foo.json (this model, verbatim), which DocPageController reloads to render the html page without needing reflection, a parser, or even the documented source to still exist.

class MMO\doc\models\DocPage extends MMO\doc\models\DocNode

Namespace: MMO\doc\models
Extends: DocNode

Index

	EXTENSION
	defaults()
	Filename($markdownFilename) static
	Load($filename) static	Reload a page model from the `.json` file the generator wrote.
	symbols()

Constants1

EXTENSION

const EXTENSION = '.doc.json'

Methods4

defaults()

DocPage.php:18

protected function defaults(): array

returns

array

Filename($markdownFilename)

staticDocPage.php:54

static function Filename(string $markdownFilename): string

$markdownFilename	string
returns	string	the model filename matching a generated markdown page.

Load($filename)

staticDocPage.php:46

Reload a page model from the .json file the generator wrote.

static function Load(string $filename): ?static

$filename	string
returns	null \| static	null when the file does not exist or does not hold a page

symbols()

DocPage.php:37

function symbols(): array

returns

array

Inherited members (21)

	Properties	Declared by	Description
	`content`	DocNode
	`nodeCache`	DocNode

Methods	Declared by	Description
`add($key, $node)`	DocNode	Append a child node under $key.
`clear()`	DocNode	Empty the underlying content, keeping the object itself.
`compact()`	DocNode	Drop every key whose value is null, '' or [] -- keeps the generated json readable and small.
`count()`	DocNode	\Countable::count
`Flatten($value)`	DocNode
`get($key, $default)`	DocNode	Read a key, without the "undefined array key" notice `$node['missing']` would raise (`tArray::offsetGet` returns by reference, so it cannot null-coalesce on its own).
`getIterator()`	DocNode	\IteratorAggregate::getIterator
`isEmpty()`	DocNode
`jsonSerialize()`	DocNode
`keys()`	DocNode
`loadArray($data)`	DocNode	Load every entry of a plain array into the content, through `offsetSet` (so any offsetSet() override defined by the class using this trait, e.g.
`nodes($key, $class)`	DocNode	Read a key as a list of child nodes, rebuilding each one into $class if it is still a plain array (which is what it is right after `json_decode`).
`offsetExists($key)`	DocNode	\ArrayAccess::offsetExists
`offsetGet($key)`	DocNode	\ArrayAccess::offsetGet
`offsetSet($key, $value)`	DocNode	Store a value, dropping whatever `nodes` had already rebuilt for that key.
`offsetUnset($key)`	DocNode	\ArrayAccess::offsetUnset -- on a list (sequential integer keys, as produced by `$bag[] = ...`), the element is spliced out (closing the gap and reindexing), matching \unset() semantics on a plain …
`storeValue($key, $value)`	DocNode	\ArrayAccess::offsetSet -- a null $key appends (`$bag[] = $value`), like a plain PHP array.
`toArray()`	DocNode	Recursively convert to plain arrays.
`__construct($data)`	DocNode