PageFiles

Records a URL a template has asked for, keyed by its public request path: a lazily-rendered image variant, or - with empty $options - the file itself.

Returns ['original' => string, 'options' => array, 'pageUuid' => string] for a variant's public request path, or null.

Returns every recorded image variant, keyed by public request path - used by PageFiles::rebuild() to validate the public mirror against live source files instead of trusting whatever's on disk.

Absolute path to the original file in its page directory, or null if the page is unresolvable.

Makes a virtual page the owner of its files for the rest of this request, so a file can be stored, listed and served by its uuid like any page's.

Returns the thumbnail cache directory for a page UUID.

Returns the public-mirror path for a file, or null if the owner is unresolvable.

The URL folder (trimmed, '' for the root page) an owner's public files nest under, or null if the owner is unresolvable.

Resolves the admin users page's current URL (trimmed), or null if the admin addon isn't mounted - the fixed "parent" every user-owned file nests under.

Returns the PageFile/PageImage for a page UUID + filename, or null if its metadata does not exist

A file's metadata sits beside it as `_{name}.json`; a leading `_` is never a name an author can give, so it can't be a file.

A file's metadata from its `_{filename}.json`, with `created` filled in from the file when missing.

Builds the PageFile, PageImage or PageSvg the file's mime calls for.

Builds a PageImage, rejecting anything that isn't a resizable image.

Stores a file on disk in its page directory and writes metadata.

Stores file upload in page directory and writes metadata.

Merges $changes into a file's metadata and returns the file.

Deletes the file, its metadata, and any cached variants.

True when a template has exposed the file, or any variant of it.

Withdraws a file: forgets every URL it was exposed at and wipes its mirrored and cached variants.

Returns all PageFiles for a page by scanning its page directory for files with a `_{name}.json` beside them.

Generates a registry-recorded image variant and serves it.

Deletes the public mirrors under a page URL ('' for the whole site) but keeps their rows, so each is served through PHP, behind the page's gate, until the page is public again.

Serves whatever the request's trailing path points at as one of $page's own files, exiting if it does and returning otherwise.

Serves what the request path was recorded as for one owner - a rendered image variant, or the stored file itself when the row has no options - and returns if nothing was.

Serves a public generic (non-image) file - Cache-Control depends on size, so one oversized file can't crowd out a client's cache with something huge.

Shared streaming primitive - variant(), serve(), and the admin preview route all send through this.

Wipes the variant cache for a specific file, forcing fresh generation on next request.

Forgets every image variant under a page URL ("blog/post" and everything below it): their recorded rows and their public mirrors.

Forgets every URL an owner's files were exposed at and wipes their public mirrors - for an owner that is going away.

Deletes the public mirror file and any mirrored variants for a file.

Writes an index file for any real file missing one, across every page directory - $subtree scopes the scan to one page and its descendants.

Sweeps the public mirror, deleting anything that isn't a still-current image variant - the only kind of file PageFiles ever writes into public/ (see PageImage::transform()/PageFiles::variant()); a plain PageFile/PageImage url() has no physical mirror at all and is always served live through PHP. public/ is exclusively CMS-managed territory - the build pipeline writes into real page folders (site/pages/assets/, phlat/addons/admin/pages/assets/), not here - so index.php aside, anything found in public/ that isn't a validated, current variant is deleted outright, regardless of where it lives.