Introduction
In the centre, or should I say core, of HydePHP is the HydeKernel. The kernel encapsulates a HydePHP project and provides helpful methods for interacting with it. You can think of it as the heart of HydePHP, if you're a romantic.
The HydeKernel is so important that you have probably used it already. The main entry point for the HydePHP API is the Hyde facade, which calls methods on the kernel.
use Hyde\Hyde;
use Hyde\Foundation\HydeKernel;
Hyde::version(); // calls $HydeKernel->version()
The kernel is created very early on in the application lifecycle, in the bootstrap.php
file, where it is also bound
as a singleton into the application service container.
Accessing the Kernel
The HydeKernel is stored as a singleton in a static property in its own class and can be accessed in a few ways.
Commonly, you'll use the Hyde
facade which forwards calls to the singleton instance.
You can also use the hyde()
function to get the Kernel, and call methods on it.
Since the instance is also bound into the Laravel Application Service Container you can also use Dependency Injection by type-hinting the HydeKernel::class
.
Here are some examples of how you can call methods on the Kernel. All methods call the same method on the same instance, so it's just a matter of preference.
use Hyde\Hyde;
use Hyde\Foundation\HydeKernel;
Hyde::version();
Hyde::kernel()->version();
HydeKernel::getInstance()->version();
app(HydeKernel::class)->version();
hyde()->version();
The Kernel instance is constructed and bound in the app/bootstrap.php
file.
The Kernel Lifecycle
Whenever we talk about the kernel being "booted" we are talking about the kernel's role in the autodiscovery process.
You can read all about it in the Autodiscovery Documentation.
API Reference
Since the most common way to interact with the kernel is through the Hyde facade, we will use that for the examples. But you could just as well chain the methods on the accessed kernel singleton instance if you wanted.
version()
No description provided.
Hyde::version(): string
__construct()
No description provided.
$hyde = new HydeKernel(string $basePath): void
features()
No description provided.
Hyde::features(): Hyde\Facades\Features
hasFeature()
No description provided.
Hyde::hasFeature(Hyde\Enums\Feature|string $feature): bool
toArray()
Get the instance as an array.
Hyde::toArray(): array<TKey, TValue>
files()
No description provided.
Hyde::files(): Hyde\Foundation\Kernel\FileCollection
pages()
No description provided.
Hyde::pages(): Hyde\Foundation\Kernel\PageCollection
routes()
No description provided.
Hyde::routes(): Hyde\Foundation\Kernel\RouteCollection
makeTitle()
No description provided.
Hyde::makeTitle(string $value): string
normalizeNewlines()
No description provided.
Hyde::normalizeNewlines(string $string): string
stripNewlines()
No description provided.
Hyde::stripNewlines(string $string): string
trimSlashes()
No description provided.
Hyde::trimSlashes(string $string): string
markdown()
No description provided.
Hyde::markdown(string $text, bool $normalizeIndentation): Illuminate\Support\HtmlString
formatLink()
No description provided.
Hyde::formatLink(string $destination): string
relativeLink()
No description provided.
Hyde::relativeLink(string $destination): string
mediaLink()
No description provided.
Hyde::mediaLink(string $destination, bool $validate): string
asset()
No description provided.
Hyde::asset(string $name, bool $preferQualifiedUrl): string
url()
No description provided.
Hyde::url(string $path): string
route()
No description provided.
Hyde::route(string $key): Hyde\Support\Models\Route
hasSiteUrl()
No description provided.
Hyde::hasSiteUrl(): bool
filesystem()
No description provided.
Hyde::filesystem(): Hyde\Foundation\Kernel\Filesystem
path()
No description provided.
Hyde::path(string $path): string
vendorPath()
No description provided.
Hyde::vendorPath(string $path, string $package): string
mediaPath()
No description provided.
Hyde::mediaPath(string $path): string
sitePath()
No description provided.
Hyde::sitePath(string $path): string
siteMediaPath()
No description provided.
Hyde::siteMediaPath(string $path): string
pathToAbsolute()
No description provided.
Hyde::pathToAbsolute(array|string $path): array|string
pathToRelative()
No description provided.
Hyde::pathToRelative(string $path): string
getInstance()
No description provided.
Hyde::getInstance(): Hyde\Foundation\HydeKernel
setInstance()
No description provided.
Hyde::setInstance(Hyde\Foundation\HydeKernel $instance): void
getBasePath()
No description provided.
Hyde::getBasePath(): string
setBasePath()
No description provided.
Hyde::setBasePath(string $basePath): void
getSourceRoot()
No description provided.
Hyde::getSourceRoot(): string
setSourceRoot()
No description provided.
Hyde::setSourceRoot(string $sourceRoot): void
getOutputDirectory()
No description provided.
Hyde::getOutputDirectory(): string
setOutputDirectory()
No description provided.
Hyde::setOutputDirectory(string $outputDirectory): void
getMediaDirectory()
No description provided.
Hyde::getMediaDirectory(): string
setMediaDirectory()
No description provided.
Hyde::setMediaDirectory(string $mediaDirectory): void
getMediaOutputDirectory()
No description provided.
Hyde::getMediaOutputDirectory(): string
registerExtension()
Register a HydePHP extension within the HydeKernel.
Typically, you would call this method in the register method of a service provider. If your package uses the standard Laravel (Composer) package discovery feature, the extension will automatically be enabled when the package is installed.
Hyde::registerExtension(class-string<\Hyde\Foundation\Concerns\HydeExtension> $extension): void
getExtension()
Get the singleton instance of the specified extension.
Hyde::getExtension(class-string<T> $extension): T
hasExtension()
Determine if the specified extension is registered.
Hyde::hasExtension(class-string<\Hyde\Foundation\Concerns\HydeExtension> $extension): bool
getExtensions()
No description provided.
Hyde::getExtensions(): array<\Hyde\Foundation\Concerns\HydeExtension>
getRegisteredExtensions()
No description provided.
Hyde::getRegisteredExtensions(): array<class-string<\Hyde\Foundation\Concerns\HydeExtension>>
getRegisteredPageClasses()
No description provided.
Hyde::getRegisteredPageClasses(): array<class-string<\Hyde\Pages\Concerns\HydePage>>
shareViewData()
Share data for the page being rendered.
Hyde::shareViewData(Hyde\Pages\Concerns\HydePage $page): void
currentRouteKey()
Get the route key for the page being rendered.
Hyde::currentRouteKey(): string
currentRoute()
Get the route for the page being rendered.
Hyde::currentRoute(): Hyde\Support\Models\Route
currentPage()
Get the page being rendered.
Hyde::currentPage(): Hyde\Pages\Concerns\HydePage
isBooted()
Determine if the Kernel has booted.
Hyde::isBooted(): bool
boot()
Boot the Hyde Kernel and run the Auto-Discovery Process.
Hyde::boot(): void
booting()
Register a new boot listener.
Your callback will be called before the kernel is booted. You can use this to register your own routes, pages, etc. The kernel instance will be passed to your callback.
/** @param callable(\Hyde\Foundation\HydeKernel): void $callback */
Hyde::booting(callable(\Hyde\Foundation\HydeKernel): void): void
booted()
Register a new "booted" listener.
Your callback will be called after the kernel is booted. You can use this to run any logic after discovery has completed. The kernel instance will be passed to your callback.
/** @param callable(\Hyde\Foundation\HydeKernel): void $callback */
Hyde::booted(callable(\Hyde\Foundation\HydeKernel): void): void