JsonDocument

MMO\core\documents · 1 symbol · generated 30 Sep 2026

class

JsonDocument

A JSON Document. Unless isRaw, the rendered JSON wraps the body under a 'data' key alongside 'meta'/'links'/'logs' (jsonSerialize); when raw, only the bare body is rendered.

class MMO\core\documents\JsonDocument extends MMO\core\documents\Document

Namespace: MMO\core\documents
Extends: Document

$doc = new JsonDocument(['hello' => 'world']); echo $doc->render(); // {"meta":[],"links":[],"data":{"hello":"world"},"logs":[]} echo JsonDocument::Raw(['hello' => 'world'])->render(); // {"hello":"world"}

Index

	render($opts)
	renderValue($value, $opts)

Methods2

render($opts)

JsonDocument.php:31

function render(array $opts = []): string

$opts = []	array
returns	string	the document as JSON: just the body when `isRaw`, otherwise the full structure (see `jsonSerialize`).

renderValue($value, $opts)

JsonDocument.php:22

function renderValue(mixed $value, MMO\core\interfaces\iOptions|array $opts = []): string

$value	mixed
$opts = []	iOptions \| array
returns	string	$value JSON-encoded, or the encoding exception's own text if encoding fails.

Inherited members (50)

Properties	Declared by	Description
`body`	Document
`importPaths`	Document
`links`	Document
`logs`	Document
`meta`	Document	Free-form metadata about this document (e.g.
`opts`	Document
`readOnly`	Document	If true, the document's body/links/meta can no longer be modified (setters throw `eRuntime`).

Methods	Declared by	Description
`addContent($data)`	Document	Recursively merge $data into the current body (see `merge`).
`addImportPath($path, $first)`	Document	Add one base directory to the import search paths.
`addLink($link)`	Document	Append a link to this document.
`addMeta($data)`	Document	Recursively merge $data into `$meta` (existing keys are overwritten, not combined -- see `merge`'s `$combine` argument).
`addOptions($opts, $appendList)`	Document	Merge $opts into the existing options (through `merge`), rather than replacing them wholesale like `setOptions`.
`addVars($vars)`	Document	Merge extra variables into the set made available to `import()-ed` files.
`clearLogs()`	Document	Discard all recorded logs.
`clearOptions()`	Document	Empty the options bag.
`createStream()`	Document
`findImportPath($filename)`	Document	Resolve a relative filename against `getImportPaths` (first match wins).
`getBody()`	Document
`getImportPaths()`	Document
`getLinkByRel($rel)`	Document
`getLinks()`	Document	Returns an iterable of LinkInterface objects.
`getLinksByRel($rel)`	Document	Returns an iterable of LinkInterface objects that have a specific relationship.
`getLogs()`	Document
`getOption($key, $default)`	Document
`getOptions()`	Document
`getPrinter()`	Document
`getVars()`	Document	Get the variables available for import
`hasLogs($flag)`	Document
`import($_FILENAME, $_VARS, $_KEY)`	Document	Import (require) a PHP/phtml file as a sub-template, capturing its output.
`isImportValid($filename)`	Document
`isRaw()`	Document
`jsonSerialize()`	Document
`logEvent($event)`	Document	Record a log/event on this document, e.g.
`offsetExists($offset)`	Document	ArrayAccess: `isset($document[$offset])` -- true for a body entry with a non-null value, or, when the body is a plain array, for any existing key (including one whose value is null).
`offsetGet($offset)`	Document	ArrayAccess: `$document[$offset]` -- returns null for a missing entry, same as `$document[$offset] ??
`offsetSet($offset, $value)`	Document	ArrayAccess: `$document[$offset] = $value` sets a body entry (`$document[] = $value` appends).
`offsetUnset($offset)`	Document	ArrayAccess: `unset($document[$offset])` removes a body entry.
`Raw($body, $opts)`	Document	Build a document whose `isRaw` is true from the start (see `setRaw` for what "raw" means).
`removeLink($link)`	Document	Remove a link (by identity).
`setBody($body)`	Document	Replace the document's content, then dispatch `DocumentInit`.
`setImportPaths($paths)`	Document	Replace the base directories searched by `findImportPath`/`import` for a relative filename.
`setLogs($logs)`	Document
`setOption($key, $value)`	Document	Set (or, with a null $value, remove) a single option.
`setOptions($opts)`	Document	Replace the whole options bag.
`setPrinter($printer)`	Document
`setRaw($raw)`	Document	Tells a document should be left as `raw` as possible.
`setVars($vars)`	Document	Replace the variables made available to `import()-ed` files (a 'document' => $this var is always added at construction, see `__construct`).
`startCapture($key)`	Document	Start output capture.
`__construct($body, $opts)`	Document	Constructor
`__toString()`	Document