[](https://shepherd.dev/github/yiisoft/view)

This library provides templates rendering abstraction supporting layout-view-subview hierarchy, custom renderers with

The package provides two use cases for managing view templates:

- [Basic functionality](docs/basic-functionality.md) for use in any environment.

- JS/CSS strings,

- JS/CSS files.

using `with*()`, both new and old instances are sharing the same set of stateful mutable data. It allows, for example,

to get `WebView` via type-hinting in a controller and change context path:

}

final class LastPosts extends Widget

- [yiisoft/view-twig](https://github.com/yiisoft/view-twig) - an extension that provides a view renderer that will

allow you to use the [Twig](https://twig.symfony.com) view template engine, instead of the default PHP renderer.

Please see [`LICENSE`](./LICENSE.md) for more information.

Maintained by [Yii Software](https://www.yiiframework.com/).

declare(strict_types=1);

use Yiisoft\Aliases\Aliases;

use Yiisoft\Definitions\DynamicReference;

use Yiisoft\View\Theme;

use Yiisoft\View\WebView;

static fn (Aliases $aliases) => $aliases->get($params['yiisoft/view']['basePath'])

),

],

/** @var WebView $this */

$this->clear();

},

],

];

declare(strict_types=1);

use Yiisoft\Aliases\Aliases;

use Yiisoft\Definitions\DynamicReference;

use Yiisoft\View\View;

static fn (Aliases $aliases) => $aliases->get($params['yiisoft/view']['basePath'])

),

],

/** @var View $this */

$this->clear();

},

],

];

'basePath' => '',

'baseUrl' => '',

],

],

];

The package provides a `Yiisoft\View\View` class with basic functionality for managing views, and

classes, but examples will be provided using the `Yiisoft\View\View`. For advanced examples with

To create a `Yiisoft\View\View` class, you must specify two mandatory parameters:

Within a view, you can access `$this` which refers to the `Yiisoft\View\View` managing and rendering current view template.

Besides `$this`, there may be other variables in a view, such as `$posts` in the above example.

The `renderFile()` method accepts a full absolute path of the view file to be rendered,

and an array of parameters (name-value pairs) that will be available in the view template:

- A name of a view starting with a slash (for example, `/blog/posts`). It will be prepended with

the base path that was passed to `Yiisoft\View\View` constructor. For example, `/blog/posts`

will be resolved into `/path/to/views/blog/posts.php`.

in the context (instance of `Yiisoft\View\ViewContextInterface`) set via `$view->withContext()`. If the

rendered.

The view name may omit a file extension. In this case, `.php` will be used as the extension.

$view = $view->withRenderers([

'tpl' => new MyCustomViewRenderer(),

]);

the corresponding renderer will be applied.

$view->setLocale('fr');

of the view. For example, if there is a view `/path/to/views/blog/posts.php` and we translate it into Russian, create

a subdirectory `ru-RU` or `ru`. In this subdirectory, create a file for the Russian locale:

`/path/to/views/blog/ru/posts.php`.

File choice is based on the specified locale code. A file with the same name will be looked

for under the subdirectory whose name is the same as the locale code. For example, given the file

`/path/to/views/blog/posts.php` and the locale code `ru-RU`, the localized file will be looked

$this->setBlock('block-id-2', '...content of block2...');

<?php

You can not call the `hasParameter()` method, but pass the default value to the `getParameter()` method.

an `InvalidArgumentException` exception will be thrown.

if a page displays a summary of yearly sales in a table, you can store this table in a cache to eliminate

the time needed to generate this table for each request.

// Trying to get content from the cache

$content = $cachedContent->get();

if ($content === null) {

// Generating content

$content = $view->render('view/name');

In addition to the content, the `Yiisoft\View\Cache\CachedContent::cache()` method

- `$ttl (int)` - The TTL of the cached content. Default is `60`.

- `$dependency (Yiisoft\Cache\Dependency\Dependency|null)` - The dependency of the cached content. Default is `null`.

For more information about caching and cache options, see the documentation of the

[yiisoft/cache package](https://github.com/yiisoft/cache).

static except one or a few places. For example, a page header may display a main menu bar together with

a name of the current user. Another problem is that the content being cached may contain PHP code that must

/**

// Trying to get content from the cache

$content = $cachedContent->get();

if ($content === null) {

// Generating content

// In the view, we call `$dynamicContent->placeholder()`

echo $content;

You may call `$dynamicContent->placeholder()` within a cached fragment to insert dynamic content at the desired place

of the view, like the following:

`Yiisoft\Yii\Widgets\FragmentCache` widget from the

[yiisoft/yii-widgets](https://github.com/yiisoft/yii-widgets) package:

multiple locales, the same piece of view code may generate the content in different locales. Therefore, you

may want to make the cached content varied according to the current application locale.