Table of Contents
ThemeResolutionException
Layer: Core · Source: lib/core/ThemeResolutionException.php:25 (lines 25–78)
class ThemeResolutionException extends \RuntimeException
Exception thrown when a theme or template cannot be resolved.
This is a framework-level exception that signals a theme configuration or filesystem problem. Callers at the controller / dispatcher layer should catch it and fall back gracefully (e.g. to the default theme) rather than letting the request fail hard.
Factory methods are provided for the most common resolution failures:
\
throw ThemeResolutionException::notFound('custom-theme');
throw ThemeResolutionException::missingTemplate('header.php');
\
Inheritance
| Relation | Type | Meaning |
|---|---|---|
| extends | \RuntimeException | parent class/interface |
Constants (0)
None.
Properties (0)
None declared.
Methods (3)
| Visibility | Method | Summary | Line |
|---|---|---|---|
| public static | notFound() | Create an exception for a theme that could not be resolved. | 36 |
| public static | missingTemplate() | Create an exception for a required template file that does not exist. | 54 |
| public static | invalidTemplateName() | Create an exception for an invalid or malicious template name. | 71 |
notFound()
public static function notFound(string $themeName, ?string $fallback = null): self
lines 36–43 (8)
Create an exception for a theme that could not be resolved.
| Parameter | Type | Default | Description |
|---|---|---|---|
$themeName | string | required | The unresolvable theme directory name. |
$fallback | ?string | null | The fallback theme that will be used instead. |
Returns: self — self
missingTemplate()
public static function missingTemplate(string $template, string $themeDir = ''): self
lines 54–61 (8)
Create an exception for a required template file that does not exist.
| Parameter | Type | Default | Description |
|---|---|---|---|
$template | string | required | Template filename (e.g. “header.php”). |
$themeDir | string | '''''' | The theme directory that was searched. |
Returns: self — self
invalidTemplateName()
public static function invalidTemplateName(string $template): self
lines 71–77 (7)
Create an exception for an invalid or malicious template name.
| Parameter | Type | Default | Description |
|---|---|---|---|
$template | string | required | The rejected template name. |
Returns: self — self
This page is generated from source by 'tools/gendoc'. Edits will be overwritten.