类 NegotiationRequiredView

一个响应任何内容类型的视图类，可以用于创建带有空主体和 406 状态码的响应。

这在使用控制器中的 viewClasses() 进行内容类型协商时最为有用。将此视图添加到可接受的视图类的末尾，以要求客户端选择可用的内容类型，并表明您没有默认类型。

命名空间： Cake\View

常量

字符串

NAME_TEMPLATE ¶
```
'templates'
```
用于 App::path() 的类型常量。
字符串

PLUGIN_TEMPLATE_FOLDER ¶
```
'plugin'
```
包含用于覆盖插件模板的文件的文件夹名称常量。
字符串

TYPE_ELEMENT ¶
```
'element'
```
视图文件类型 'element' 常量。
字符串

TYPE_LAYOUT ¶
```
'layout'
```
视图文件类型 'layout' 常量。
字符串

TYPE_MATCH_ALL ¶
```
'_match_all_'
```
视图可以使用的神奇的 'match-all' 内容类型，在内容类型协商期间充当备用。
字符串

TYPE_TEMPLATE ¶
```
'template'
```
视图文件类型 'template' 常量。

属性概览

$Blocks public @property

Cake\View\ViewBlock
$Breadcrumbs public @property

Cake\View\Helper\BreadcrumbsHelper
$Flash public @property

Cake\View\Helper\FlashHelper
$Form public @property

Cake\View\Helper\FormHelper
$Html public @property

Cake\View\Helper\HtmlHelper
$Number public @property

Cake\View\Helper\NumberHelper
$Paginator public @property

Cake\View\Helper\PaginatorHelper
$Text public @property

Cake\View\Helper\TextHelper
$Time public @property

Cake\View\Helper\TimeHelper
$Url public @property

Cake\View\Helper\UrlHelper
$_config protected

array<string, mixed>

运行时配置
$_configInitialized protected

bool

配置属性是否已使用默认值进行配置
$_current protected

字符串

当前正在渲染的视图文件。用于解析父文件。
$_currentType protected

字符串

当前正在渲染一个元素。用于查找元素的父片段。
$_defaultConfig protected

array<string, mixed>

默认自定义配置选项。
$_eventClass protected

字符串

新事件对象的默认类名。
$_eventManager protected

Cake\Event\EventManagerInterface|null

此对象用于分发内部事件的 Cake\Event\EventManager 实例。
$_ext protected

字符串

文件扩展名。默认为 ".php"。
$_helpers protected

Cake\View\HelperRegistry|null

助手集合
$_parents protected

array<string, string>

与 View::extend(); 一起使用的视图及其父级的名称。
$_passedVars protected

list<string>

要从关联控制器中收集的变量列表。
$_paths protected

list<string>

保存路径数组。
$_pathsForPlugin protected

array<string, list<string>>

保存插件路径数组。
$_stack protected

list<string>

内容堆栈，用于所有使用 View::extend(); 的嵌套模板。
$_viewBlockClass protected

字符串

ViewBlock 类。
$autoLayout protected

bool

打开或关闭 CakePHP 的应用布局文件的传统模式。默认情况下为打开。设置为关闭意味着布局不会自动应用于渲染的模板。
$elementCache protected

字符串

视图将用于存储缓存元素的缓存配置。更改此配置将更改元素存储的默认配置。您也可以为每个元素选择一个缓存配置。
$helpers protected

array<string, array<string, mixed>>

用于加载助手的配置数组。
$layout protected

字符串

要在其中渲染模板的布局文件名称。指定的名称是 templates/layout/ 中的布局文件名，不带 .php 扩展名。
$layoutPath protected

字符串

包含此视图布局的布局子文件夹的名称。
$name protected

字符串

创建视图的控制器的名称（如果有）。
$plugin protected

string|null

插件的名称。
$request protected

Cake\Http\ServerRequest

一个包含有关当前请求的信息的 \Cake\Http\ServerRequest 对象实例。此对象包含有关请求的所有信息，以及用于读取有关请求的更多信息的方法。
$response protected

Cake\Http\Response

对响应对象的引用
$subDir protected

字符串

此模板文件的子目录。这通常用于基于扩展名的路由。例如，对于 xml 扩展名，$subDir 将为 xml/
$template protected

字符串

要渲染的模板文件名称。指定的名称是 templates/<SubFolder>/ 中的文件名，不带 .php 扩展名。
$templatePath protected

字符串

包含此视图模板的子文件夹的名称。
$theme protected

string|null

要使用的视图主题。
$viewVars protected

array<string, mixed>

变量数组

方法概览

__construct() public

构造函数
__get() public

用于辅助函数的魔术访问器。
_checkFilePath() protected

检查视图文件路径是否超出定义的模板路径。
_configDelete() protected

删除单个配置键。
_configRead() protected

读取配置键。
_configWrite() protected

写入配置键。
_createCell() protected

创建并配置单元格实例。
_elementCache() protected

为元素生成缓存配置选项。
_evaluate() protected

沙盒方法，用于评估模板/视图脚本。
_getElementFileName() protected

查找元素文件名，如果失败则返回 false。
_getLayoutFileName() protected

返回此模板的布局文件名，作为字符串。
_getSubPaths() protected

查找所有子模板路径，基于 $basePath 如果当前请求中定义了前缀，此方法将 $basePath 前缀模板路径，如果前缀是嵌套的，则级联。这主要用于查找元素和布局的前缀模板路径。
_getTemplateFileName() protected

返回给定操作的模板文件名，作为字符串。默认情况下，骆驼式命名操作名称将被下划线分隔。这意味着您可以使用 LongActionNames 来引用 long_action_names.php 模板。您可以通过覆盖 _inflectTemplateFileName 来更改变位规则。
_inflectTemplateFileName() protected

将视图模板文件的名称更改为下划线分隔格式。
_paths() protected

按顺序返回查找视图文件的所有可能路径
_render() protected

渲染并返回给定模板文件及其数据数组的输出。处理父/扩展模板。
_renderElement() protected

渲染元素并触发其 before 和 afterRender 回调，并在使用缓存的情况下写入缓存
addHelper() protected

在 initialize() 方法中添加助手。
append() public

追加到现有或新的区块。
assign() public

设置区块的内容。这将覆盖任何现有内容。
blocks() public

获取所有现有区块的名称。
cache() public

创建缓存的视图逻辑区块。
cell() protected

渲染给定的单元格。
configShallow() public

将提供的配置与现有配置合并。与 config() 不同，config() 对嵌套键进行递归合并，此方法进行简单合并。
contentType() public static

获取内容类型
disableAutoLayout() public

关闭 CakePHP 的应用布局文件的传统模式。布局将不会自动应用于渲染的视图。
dispatchEvent() public

创建和分发事件的包装器。
element() public

渲染一段 PHP 代码，并提供参数，返回 HTML、XML 或任何其他字符串。
elementExists() public

检查元素是否存在
enableAutoLayout() public

启用或禁用 CakePHP 的应用布局文件的传统模式。默认情况下启用。设置为关闭意味着布局将不会自动应用于渲染的视图。
end() public

结束捕获区块。与 View::start() 相辅相成
exists() public

检查区块是否存在
extend() public

提供模板或元素扩展/继承。模板可以扩展父模板并在父模板中填充区块。
fetch() public

获取区块的内容。如果区块为空或未定义，则返回 ''。
get() public

返回给定视图变量的内容。
getConfig() public

返回配置。
getConfigOrFail() public

返回此特定键的配置。
getCurrentType() public

检索当前模板类型
getElementPaths() protected

获取元素路径的迭代器。
getEventManager() public

返回此对象的 Cake\Event\EventManager 管理器实例。
getLayout() public

获取布局文件的文件名，用于在其中渲染模板。指定的文件名是 templates/layout/ 中的布局文件名，不带 .php 扩展名。
getLayoutPath() public

获取布局文件的路径。
getLayoutPaths() protected

获取布局路径的迭代器。
getName() public

返回视图的控制器名称。
getPlugin() public

返回插件名称。
getRequest() public

获取请求实例。
getResponse() public

获取响应实例。
getSubDir() public

获取此模板文件的子目录。
getTemplate() public

获取要渲染的模板文件的文件名。指定的文件名是 templates/<SubFolder>/ 中的文件名，不带 .php 扩展名。
getTemplatePath() public

获取模板文件的路径。
getTheme() public

获取当前视图主题。
getVars() public

返回当前视图上下文中可用的变量列表
helpers() public

获取此视图类使用的助手注册表。
initialize() public

初始化钩子方法。
isAutoLayoutEnabled() public

返回是否启用 CakePHP 的应用布局文件的传统模式。禁用意味着布局将不会自动应用于渲染的视图。
loadHelper() public

加载助手。委托给 HelperRegistry::load() 加载助手。
loadHelpers() public

与 HelperRegistry 交互以加载所有助手。
log() public

将消息写入日志的便捷方法。有关写入日志的更多信息，请参阅 Log::write()。
pluginSplit() public

将点语法插件名称拆分为其插件和文件名。如果 $name 没有点，则索引 0 将为 null。它检查插件是否已加载，否则文件名将保持不变，用于包含点的文件名
prepend() public

预先追加到现有或新的区块。
render() public

渲染没有主体的视图，并使用 406 状态码。
renderLayout() public

渲染布局。返回 _render() 的输出。
reset() public

重置区块的内容。这将覆盖任何现有内容。
set() public

保存变量或关联变量数组，供模板内部使用。
setConfig() public

设置配置。
setContentType() protected

基于视图的 contentType() 设置响应内容类型
setElementCache() public

设置视图将用来存储缓存元素的缓存配置
setEventManager() public

返回此对象的 Cake\Event\EventManagerInterface 实例。
setLayout() public

设置要渲染模板的布局文件的文件名。指定的文件名是 templates/layout/ 中的布局文件名，不带 .php 扩展名。
setLayoutPath() public

设置布局文件的路径。
setPlugin() public

设置插件名称。
setRequest() public

设置请求对象，并根据请求内容配置一些控制器属性。将设置的属性有
setResponse() public

设置响应实例。
setSubDir() public

设置此模板文件的子目录。
setTemplate() public

设置要渲染的模板文件的文件名。指定的文件名是 templates/<SubFolder>/ 中的文件名，不带 .php 扩展名。
setTemplatePath() public

设置模板文件的路径。
setTheme() public

设置要使用的视图主题。
start() public

开始捕获“区块”的输出

方法详情

__construct() ¶ public

__construct(Cake\Http\ServerRequest|null $request = null, Cake\Http\Response|null $response = null, Cake\Event\EventManagerInterface|null $eventManager = null, array<string, mixed> $viewOptions = [])

构造函数

参数

Cake\Http\ServerRequest|null $request 可选: 请求实例。
Cake\Http\Response|null $response 可选: 响应实例。
Cake\Event\EventManagerInterface|null $eventManager 可选: 事件管理器实例。
array<string, mixed> $viewOptions 可选: 视图选项。有关设置为类属性的选项列表，请参阅 {@link View::$_passedVars}。

__get() ¶ public

__get(string $name): Cake\View\Helper|null

用于辅助函数的魔术访问器。

参数

string $name: 要获取的属性的名称。

返回值

Cake\View\Helper|null

_checkFilePath() ¶ protected

_checkFilePath(string $file, string $path): string

检查视图文件路径是否超出定义的模板路径。

仅检查包含.. 的路径，因为这些路径最有可能具有解析到模板路径之外的文件的能力。

参数

string $file: 模板文件的路径。
string $path: $file 应该位于其中的基本路径。

返回值

字符串

抛出

InvalidArgumentException

_configDelete() ¶ protected

_configDelete(string $key): void

删除单个配置键。

参数

string $key: 要删除的键。

返回值

void

抛出

Cake\Core\Exception\CakeException
如果尝试覆盖现有配置

_configRead() ¶ protected

_configRead(string|null $key): mixed

读取配置键。

参数

string|null $key: 要读取的键。

返回值

mixed

_configWrite() ¶ protected

_configWrite(array<string, mixed>|string $key, mixed $value, string|bool $merge = false): void

写入配置键。

参数

array<string, mixed>|string $key: 要写入的键。
mixed $value: 要写入的值。
string|bool $merge optional: True 表示递归合并，'shallow' 表示简单合并，false 表示覆盖，默认值为 false。

返回值

void

抛出

Cake\Core\Exception\CakeException
如果尝试覆盖现有配置

_createCell() ¶ protected

_createCell(string $className, string $action, string|null $plugin, array<string, mixed> $options): Cake\View\Cell

创建并配置单元格实例。

参数

string $className: 单元格类名。
string $action: 操作名称。
string|null $plugin: 插件名称。
array<string, mixed> $options: 单元格的构造函数选项。

返回值

Cake\View\Cell

_elementCache() ¶ protected

_elementCache(string $name, array $data, array<string, mixed> $options): array<string, mixed>

为元素生成缓存配置选项。

参数

string $name: 元素名称
array $data: 数据
array<string, mixed> $options: 元素选项

返回值

array<string, mixed>

_evaluate() ¶ protected

_evaluate(string $templateFile, array $dataForView): string

沙盒方法，用于评估模板/视图脚本。

参数

string $templateFile: 模板的文件名。
array $dataForView: 要包含在渲染视图中的数据。

返回值

字符串

_getElementFileName() ¶ protected

_getElementFileName(string $name, bool $pluginCheck = true): string|false

查找元素文件名，如果失败则返回 false。

参数

string $name

要查找的元素的名称。

bool $pluginCheck optional

如果为 false，则如果解析的插件未加载，将忽略请求的插件

返回值

string|false

_getLayoutFileName() ¶ protected

_getLayoutFileName(string|null $name = null): string

返回此模板的布局文件名，作为字符串。

参数

string|null $name optional: 要查找的布局的名称。

返回值

字符串

抛出

Cake\View\Exception\MissingLayoutException
当找不到布局时
Cake\Core\Exception\CakeException

_getSubPaths() ¶ protected

_getSubPaths(string $basePath): list<string>

查找所有子模板路径，基于 $basePath 如果当前请求中定义了前缀，此方法将 $basePath 前缀模板路径，如果前缀是嵌套的，则级联。这主要用于查找元素和布局的前缀模板路径。

参数

string $basePath: 用于获取带前缀路径的基本路径。

返回值

list<string>

_getTemplateFileName() ¶ protected

_getTemplateFileName(string|null $name = null): string

返回给定操作的模板文件名，作为字符串。默认情况下，骆驼式命名操作名称将被下划线分隔。这意味着您可以使用 LongActionNames 来引用 long_action_names.php 模板。您可以通过覆盖 _inflectTemplateFileName 来更改变位规则。

参数

string|null $name optional: 要查找模板文件名的控制器操作

返回值

字符串

抛出

Cake\View\Exception\MissingTemplateException
当找不到模板文件时。
Cake\Core\Exception\CakeException
当未提供模板名称时。

_inflectTemplateFileName() ¶ protected

_inflectTemplateFileName(string $name): string

将视图模板文件的名称更改为下划线分隔格式。

参数

string $name: 应该进行词形变化的文件的名称。

返回值

字符串

_paths() ¶ protected

_paths(string|null $plugin = null, bool $cached = true): list<string>

按顺序返回查找视图文件的所有可能路径

参数

string|null $plugin optional: 要扫描视图文件的可选插件名称。
bool $cached optional: 设置为 false 以强制刷新视图路径。默认值为 true。

返回值

list<string>

_render() ¶ protected

_render(string $templateFile, array $data = []): string

渲染并返回给定模板文件及其数据数组的输出。处理父/扩展模板。

参数

string $templateFile: 模板的文件名
array $data optional: 要包含在渲染视图中的数据。如果为空，将使用当前 View::$viewVars。

返回值

字符串

抛出

LogicException
当块保持打开状态时。

_renderElement() ¶ protected

_renderElement(string $file, array $data, array<string, mixed> $options): string

渲染元素并触发其 before 和 afterRender 回调，并在使用缓存的情况下写入缓存

参数

string $file: 元素文件路径
array $data: 要渲染的数据
array<string, mixed> $options: 元素选项

返回值

字符串

addHelper() ¶ protected

addHelper(string $helper, array<string, mixed> $config = []): void

在 initialize() 方法中添加助手。

参数

string $helper: 助手。
array<string, mixed> $config optional: 配置。

返回值

void

append() ¶ public

append(string $name, mixed $value = null): $this

追加到现有或新的区块。

追加到一个新的块将创建该块。

参数

string $name: 块的名称
mixed $value optional: 块的内容。值将被类型转换为字符串。

返回值

$this

另请参阅

\Cake\View\ViewBlock::concat()

assign() ¶ public

assign(string $name, mixed $value): $this

设置区块的内容。这将覆盖任何现有内容。

参数

string $name: 块的名称
mixed $value: 块的内容。值将被类型转换为字符串。

返回值

$this

另请参阅

\Cake\View\ViewBlock::set()

blocks() ¶ public

blocks(): list<string>

获取所有现有区块的名称。

返回值

list<string>

另请参阅

\Cake\View\ViewBlock::keys()

cache() ¶ public

cache(callable $block, array<string, mixed> $options = []): string

创建缓存的视图逻辑区块。

这允许您将一段视图输出缓存到elementCache 中定义的缓存中。

此方法将首先尝试读取缓存。如果缓存为空，则将运行 $block 并存储输出。

参数

callable $block: 您想要缓存其输出的代码块。
array<string, mixed> $options optional: 定义缓存键等的选项。

返回值

字符串

抛出

InvalidArgumentException
当 $options 缺少 'key' 选项时。

cell() ¶ protected

cell(string $cell, array $data = [], array<string, mixed> $options = []): Cake\View\Cell

渲染给定的单元格。

示例

// Taxonomy\View\Cell\TagCloudCell::smallList()
$cell = $this->cell('Taxonomy.TagCloud::smallList', ['limit' => 10]);

// App\View\Cell\TagCloudCell::smallList()
$cell = $this->cell('TagCloud::smallList', ['limit' => 10]);

当未提供操作时，将默认使用display 操作

// Taxonomy\View\Cell\TagCloudCell::display()
$cell = $this->cell('Taxonomy.TagCloud');

单元格在回显之前不会被渲染。

参数

string $cell: 您必须指定单元格名称，并可选择指定单元格操作。例如：TagCloud::smallList 将调用View\Cell\TagCloudCell::smallList()，当未提供时，将默认调用display 操作。
array $data optional: 单元格方法的附加参数。例如：cell('TagCloud::smallList', ['a1' => 'v1', 'a2' => 'v2']) 映射到 View\Cell\TagCloud::smallList(v1, v2)
array<string, mixed> $options optional: 单元格构造函数的选项

返回值

Cake\View\Cell

抛出

Cake\View\Exception\MissingCellException
如果未找到单元格类。

configShallow() ¶ public

configShallow(array<string, mixed>|string $key, mixed|null $value = null): $this

将提供的配置与现有配置合并。与 config() 不同，config() 对嵌套键进行递归合并，此方法进行简单合并。

设置特定值

$this->configShallow('key', $value);

设置嵌套值

$this->configShallow('some.nested.key', $value);

同时更新多个配置设置

$this->configShallow(['one' => 'value', 'another' => 'value']);

参数

array<string, mixed>|string $key: 要设置的键，或完整的配置数组。
mixed|null $value optional: 要设置的值。

返回值

$this

contentType() ¶ public static

contentType(): string

获取内容类型

返回值

字符串

disableAutoLayout() ¶ public

disableAutoLayout(): $this

关闭 CakePHP 的应用布局文件的传统模式。布局将不会自动应用于渲染的视图。

返回值

$this

dispatchEvent() ¶ public

dispatchEvent(string $name, array $data = [], TSubject|null $subject = null): Cake\Event\EventInterface<TSubject>

创建和分发事件的包装器。

返回已分派的事件。

参数

string $name: 事件的名称。
array $data optional: 您希望与该事件一起传输的任何值都可以由侦听器读取。
TSubject|null $subject 可选: 此事件所适用的对象（默认情况下为 $this）。

返回值

Cake\Event\EventInterface<TSubject>

element() ¶ public

element(string $name, array $data = [], array<string, mixed> $options = []): string

渲染一段 PHP 代码，并提供参数，返回 HTML、XML 或任何其他字符串。

这实现了元素（或“部分布局”）的概念，$params 数组用于发送要用于元素的数据。元素可以使用 cache 选项进行缓存，从而提高性能。

参数

string $name: templates/element/ 文件夹中的模板文件名称，或 MyPlugin.template 用于使用来自 MyPlugin 的模板元素。如果在插件中找不到该元素，则将搜索正常的视图路径级联。
array $data optional: 要提供给渲染视图（即元素）的数据数组。
array<string, mixed> $options optional: 选项数组。可能的键是

返回值

字符串

抛出

Cake\View\Exception\MissingElementException
当元素丢失且 `ignoreMissing` 为 false 时。

elementExists() ¶ public

elementExists(string $name): bool

检查元素是否存在

参数

string $name: templates/element/ 文件夹中的模板文件名称，或 MyPlugin.template 用于检查来自 MyPlugin 的模板元素。如果在插件中找不到该元素，则将搜索正常的视图路径级联。

返回值

bool

enableAutoLayout() ¶ public

enableAutoLayout(bool $enable = true): $this

启用或禁用 CakePHP 的应用布局文件的传统模式。默认情况下启用。设置为关闭意味着布局将不会自动应用于渲染的视图。

参数

bool $enable 可选: 用于打开/关闭的布尔值。

返回值

$this

end() ¶ public

end(): $this

结束捕获区块。与 View::start() 相辅相成

返回值

$this

另请参阅

\Cake\View\ViewBlock::end()

exists() ¶ public

exists(string $name): bool

检查区块是否存在

参数

string $name: 块的名称

返回值

bool

extend() ¶ public

extend(string $name): $this

提供模板或元素扩展/继承。模板可以扩展父模板并在父模板中填充区块。

参数

string $name: 要“扩展”当前模板或元素的模板或元素。

返回值

$this

抛出

LogicException
当使用模板扩展自身或进行扩展循环时。
LogicException
当扩展不存在的元素时。

fetch() ¶ public

fetch(string $name, string $default = ''): string

获取区块的内容。如果区块为空或未定义，则返回 ''。

参数

string $name: 块的名称
string $default 可选: 默认文本

返回值

字符串

另请参阅

\Cake\View\ViewBlock::get()

get() ¶ public

get(string $var, mixed $default = null): mixed

返回给定视图变量的内容。

参数

string $var: 要获取内容的视图变量。
mixed $default 可选: $var 的默认/回退内容。

返回值

mixed

getConfig() ¶ public

getConfig(string|null $key = null, mixed $default = null): mixed

返回配置。

用法

读取整个配置

$this->getConfig();

读取特定值

$this->getConfig('key');

读取嵌套值

$this->getConfig('some.nested.key');

读取默认值

$this->getConfig('some-key', 'default-value');

参数

string|null $key 可选: 要获取的键，或用于获取整个配置的 null。
mixed $default 可选: 键不存在时的返回值。

返回值

mixed

getConfigOrFail() ¶ public

getConfigOrFail(string $key): mixed

返回此特定键的配置。

此键的配置值必须存在，永远不能为 null。

参数

string $key: 要获取的键。

返回值

mixed

抛出

InvalidArgumentException

getCurrentType() ¶ public

getCurrentType(): string

检索当前模板类型

返回值

字符串

getElementPaths() ¶ protected

getElementPaths(string|null $plugin): Generator

获取元素路径的迭代器。

参数

string|null $plugin: 要获取路径的插件。

返回值

生成器

getEventManager() ¶ public

getEventManager(): Cake\Event\EventManagerInterface

返回此对象的 Cake\Event\EventManager 管理器实例。

可以使用此实例将任何新的监听器或回调注册到对象事件，或创建自己的事件并随意触发它们。

返回值

Cake\Event\EventManagerInterface

getLayout() ¶ public

getLayout(): string

获取布局文件的文件名，用于在其中渲染模板。指定的文件名是 templates/layout/ 中的布局文件名，不带 .php 扩展名。

返回值

字符串

getLayoutPath() ¶ public

getLayoutPath(): string

获取布局文件的路径。

返回值

字符串

getLayoutPaths() ¶ protected

getLayoutPaths(string|null $plugin): Generator

获取布局路径的迭代器。

参数

string|null $plugin: 要获取路径的插件。

返回值

生成器

getName() ¶ public

getName(): string

返回视图的控制器名称。

返回值

字符串

getPlugin() ¶ public

getPlugin(): string|null

返回插件名称。

返回值

string|null

getRequest() ¶ public

getRequest(): Cake\Http\ServerRequest

获取请求实例。

返回值

Cake\Http\ServerRequest

getResponse() ¶ public

getResponse(): Cake\Http\Response

获取响应实例。

返回值

Cake\Http\Response

getSubDir() ¶ public

getSubDir(): string

获取此模板文件的子目录。

返回值

字符串

另请参阅

\Cake\View\View::$subDir

getTemplate() ¶ public

getTemplate(): string

获取要渲染的模板文件的文件名。指定的文件名是 templates/<SubFolder>/ 中的文件名，不带 .php 扩展名。

返回值

字符串

getTemplatePath() ¶ public

getTemplatePath(): string

获取模板文件的路径。

返回值

字符串

getTheme() ¶ public

getTheme(): string|null

获取当前视图主题。

返回值

string|null

getVars() ¶ public

getVars(): list<string>

返回当前视图上下文中可用的变量列表

返回值

list<string>

helpers() ¶ public

helpers(): Cake\View\HelperRegistry

获取此视图类使用的助手注册表。

返回值

Cake\View\HelperRegistry

initialize() ¶ public

initialize(): void

初始化钩子方法。

诸如 $helpers 等属性不能在您的自定义视图类中静态初始化，因为它们会被构造函数中的控制器值覆盖。因此，此方法允许您在构造视图实例后根据需要操作它们。

可以使用 {@link addHelper()} 方法添加助手。

返回值

void

isAutoLayoutEnabled() ¶ public

isAutoLayoutEnabled(): bool

返回是否启用 CakePHP 的应用布局文件的传统模式。禁用意味着布局将不会自动应用于渲染的视图。

返回值

bool

loadHelper() ¶ public

loadHelper(string $name, array<string, mixed> $config = []): Cake\View\Helper

加载助手。委托给 HelperRegistry::load() 加载助手。

您应该使用 addHelper() 而不是此方法，方法是在 AppView 或其他自定义视图类的 initialize() 钩子中。

参数

string $name: 要加载的助手的名称。
array<string, mixed> $config optional: 助手的设置

返回值

Cake\View\Helper

另请参阅

\Cake\View\HelperRegistry::load()

loadHelpers() ¶ public

loadHelpers(): $this

与 HelperRegistry 交互以加载所有助手。

返回值

$this

log() ¶ public

log(Stringable|string $message, string|int $level = LogLevel::ERROR, array|string $context = []): bool

将消息写入日志的便捷方法。有关写入日志的更多信息，请参阅 Log::write()。

参数

Stringable|string $message: 日志消息。
string|int $level 可选: 错误级别。
array|string $context 可选: 与此消息相关的其他日志数据。

返回值

bool

pluginSplit() ¶ public

pluginSplit(string $name, bool $fallback = true): array

将点语法插件名称拆分为其插件和文件名。如果 $name 没有点，则索引 0 将为 null。它检查插件是否已加载，否则文件名将保持不变，用于包含点的文件名

参数

string $name: 要进行插件拆分的名称。
bool $fallback 可选: 如果为 true，则在解析的插件未加载时使用当前请求中设置的插件

返回值

array

prepend() ¶ public

prepend(string $name, mixed $value): $this

预先追加到现有或新的区块。

向新块追加将创建该块。

参数

string $name: 块的名称
mixed $value: 块的内容。值将被类型转换为字符串。

返回值

$this

另请参阅

\Cake\View\ViewBlock::concat()

render() ¶ public

render(string|null $template = null, string|false|null $layout = null): string

渲染没有主体的视图，并使用 406 状态码。

渲染会触发助手回调，这些回调在渲染模板之前和之后以及在布局之前和之后被调用。助手回调被调用

beforeRender
afterRender
beforeLayout
afterLayout

如果 View::$autoLayout 设置为 false，则将返回裸模板。

模板和布局名称可以指向插件模板或布局。使用 Plugin.template 语法，可以使用插件模板/布局/，而不是应用程序模板/布局/。如果找不到选定的插件，则将沿着常规视图路径级联查找模板。

参数

string|null $template 可选: 要使用的模板文件名称。
string|false|null $layout 可选: 要使用的布局。False 表示禁用。

返回值

字符串

renderLayout() ¶ public

renderLayout(string $content, string|null $layout = null): string

渲染布局。返回 _render() 的输出。

在布局中创建了一些变量供使用。

参数

string $content: 要渲染的模板内容，由周围的布局包裹。
string|null $layout optional: 布局名称。

返回值

字符串

抛出

Cake\Core\Exception\CakeException
如果视图中存在错误。

reset() ¶ public

reset(string $name): $this

重置区块的内容。这将覆盖任何现有内容。

参数

string $name: 块的名称

返回值

$this

另请参阅

\Cake\View\ViewBlock::set()

set() ¶ public

set(array|string $name, mixed $value = null): $this

保存变量或关联变量数组，供模板内部使用。

参数

array|string $name: 字符串或数据数组。
mixed $value optional: 如果 $name 是字符串，则为值（作为键使用）。如果 $name 是关联数组，则不使用，否则作为 $name 键的值。

返回值

$this

抛出

Cake\Core\Exception\CakeException
如果数组合并操作失败。

setConfig() ¶ public

setConfig(array<string, mixed>|string $key, mixed|null $value = null, bool $merge = true): $this

设置配置。

用法

设置特定值

$this->setConfig('key', $value);

设置嵌套值

$this->setConfig('some.nested.key', $value);

同时更新多个配置设置

$this->setConfig(['one' => 'value', 'another' => 'value']);

参数

array<string, mixed>|string $key: 要设置的键，或完整的配置数组。
mixed|null $value optional: 要设置的值。
bool $merge optional: 是否递归合并或覆盖现有配置，默认为 true。

返回值

$this

抛出

Cake\Core\Exception\CakeException
当尝试设置无效的键时。

setContentType() ¶ protected

setContentType(): void

基于视图的 contentType() 设置响应内容类型

返回值

void

setElementCache() ¶ public

setElementCache(string $elementCache): $this

设置视图将用来存储缓存元素的缓存配置

参数

string $elementCache: 缓存配置名称。

返回值

$this

另请参阅

\Cake\View\View::$elementCache

setEventManager() ¶ public

setEventManager(Cake\Event\EventManagerInterface $eventManager): $this

返回此对象的 Cake\Event\EventManagerInterface 实例。

可以使用此实例将任何新的监听器或回调注册到对象事件，或创建自己的事件并随意触发它们。

参数

Cake\Event\EventManagerInterface $eventManager: 要设置的事件管理器。

返回值

$this

setLayout() ¶ public

setLayout(string $name): $this

设置要渲染模板的布局文件的文件名。指定的文件名是 templates/layout/ 中的布局文件名，不带 .php 扩展名。

参数

string $name: 要设置的布局文件名。

返回值

$this

setLayoutPath() ¶ public

setLayoutPath(string $path): $this

设置布局文件的路径。

参数

string $path: 布局文件路径。

返回值

$this

setPlugin() ¶ public

setPlugin(string|null $name): $this

设置插件名称。

参数

string|null $name: 插件名称。

返回值

$this

setRequest() ¶ public

setRequest(Cake\Http\ServerRequest $request): $this

设置请求对象，并根据请求内容配置一些控制器属性。将设置的属性有

$this->request - 到 $request 参数
$this->plugin - 到 $request->getParam('plugin') 返回的值

参数

Cake\Http\ServerRequest $request: 请求实例。

返回值

$this

setResponse() ¶ public

setResponse(Cake\Http\Response $response): $this

设置响应实例。

参数

Cake\Http\Response $response: 响应实例。

返回值

$this

setSubDir() ¶ public

setSubDir(string $subDir): $this

设置此模板文件的子目录。

参数

string $subDir: 子目录名称。

返回值

$this

另请参阅

\Cake\View\View::$subDir

setTemplate() ¶ public

setTemplate(string $name): $this

设置要渲染的模板文件的文件名。指定的文件名是 templates/<SubFolder>/ 中的文件名，不带 .php 扩展名。

参数

string $name: 要设置的模板文件名。

返回值

$this

setTemplatePath() ¶ public

setTemplatePath(string $path): $this

设置模板文件的路径。

参数

string $path: 模板文件路径。

返回值

$this

setTheme() ¶ public

setTheme(string|null $theme): $this

设置要使用的视图主题。

参数

string|null $theme: 主题名称。

返回值

$this

start() ¶ public

start(string $name): $this

开始捕获“区块”的输出

您可以多次在块上使用 start，以在捕获模式下追加或添加内容。

// Append content to an existing block.
$this->start('content');
echo $this->fetch('content');
echo 'Some new content';
$this->end();

// Prepend content to an existing block
$this->start('content');
echo 'Some new content';
echo $this->fetch('content');
$this->end();

参数

string $name: 要捕获的块的名称。

返回值

$this

另请参阅

\Cake\View\ViewBlock::start()

属性详情

`$Blocks` ¶ public @property

类型

Cake\View\ViewBlock

`$Breadcrumbs` ¶ public @property

类型

Cake\View\Helper\BreadcrumbsHelper

`$Flash` ¶ public @property

类型

Cake\View\Helper\FlashHelper

`$Form` ¶ public @property

类型

Cake\View\Helper\FormHelper

`$Html` ¶ public @property

类型

Cake\View\Helper\HtmlHelper

`$Number` ¶ public @property

类型

Cake\View\Helper\NumberHelper

`$Paginator` ¶ public @property

类型

Cake\View\Helper\PaginatorHelper

`$Text` ¶ public @property

类型

Cake\View\Helper\TextHelper

`$Time` ¶ public @property

类型

Cake\View\Helper\TimeHelper

`$Url` ¶ public @property

类型

Cake\View\Helper\UrlHelper

`$_config` ¶ protected

运行时配置

类型

array<string, mixed>

`$_configInitialized` ¶ protected

配置属性是否已使用默认值进行配置

类型

bool

`$_current` ¶ protected

当前正在渲染的视图文件。用于解析父文件。

类型

字符串

`$_currentType` ¶ protected

当前正在渲染一个元素。用于查找元素的父片段。

类型

字符串

`$_defaultConfig` ¶ protected

默认自定义配置选项。

类型

array<string, mixed>

`$_eventClass` ¶ protected

新事件对象的默认类名。

类型

字符串

`$_eventManager` ¶ protected

此对象用于分发内部事件的 Cake\Event\EventManager 实例。

类型

Cake\Event\EventManagerInterface|null

`$_ext` ¶ protected

文件扩展名。默认为 ".php"。

类型

字符串

`$_helpers` ¶ protected

助手集合

类型

Cake\View\HelperRegistry|null

`$_parents` ¶ protected

与 View::extend(); 一起使用的视图及其父级的名称。

类型

array<string, string>

`$_passedVars` ¶ protected

要从关联控制器中收集的变量列表。

类型

list<string>

`$_paths` ¶ protected

保存路径数组。

类型

list<string>

`$_pathsForPlugin` ¶ protected

保存插件路径数组。

类型

array<string, list<string>>

`$_stack` ¶ protected

内容堆栈，用于所有使用 View::extend(); 的嵌套模板。

类型

list<string>

`$_viewBlockClass` ¶ protected

ViewBlock 类。

类型

字符串

`$autoLayout` ¶ protected

打开或关闭 CakePHP 的应用布局文件的传统模式。默认情况下为打开。设置为关闭意味着布局不会自动应用于渲染的模板。

类型

bool

`$elementCache` ¶ protected

视图将用于存储缓存元素的缓存配置。更改此配置将更改元素存储的默认配置。您也可以为每个元素选择一个缓存配置。

类型

字符串

`$helpers` ¶ 受保护的

用于加载助手的配置数组。

类型

array<string, array<string, mixed>>

`$layout` ¶ 受保护的

要在其中渲染模板的布局文件名称。指定的名称是 templates/layout/ 中的布局文件名，不带 .php 扩展名。

类型

字符串

`$layoutPath` ¶ 受保护的

包含此视图布局的布局子文件夹的名称。

类型

字符串

`$name` ¶ 受保护的

创建视图的控制器的名称（如果有）。

类型

字符串

`$plugin` ¶ 受保护的

插件的名称。

类型

string|null

`$request` ¶ 受保护的

一个包含有关当前请求的信息的 \Cake\Http\ServerRequest 对象实例。此对象包含有关请求的所有信息，以及用于读取有关请求的更多信息的方法。

类型

Cake\Http\ServerRequest

`$response` ¶ 受保护的

对响应对象的引用

类型

Cake\Http\Response

`$subDir` ¶ 受保护的

此模板文件的子目录。这通常用于基于扩展名的路由。例如，对于 xml 扩展名，$subDir 将为 xml/

类型

字符串

`$template` ¶ 受保护的

要渲染的模板文件名称。指定的名称是 templates/<SubFolder>/ 中的文件名，不带 .php 扩展名。

类型

字符串

`$templatePath` ¶ 受保护的

包含此视图模板的子文件夹的名称。

类型

字符串

`$theme` ¶ 受保护的

要使用的视图主题。

类型

string|null

`$viewVars` ¶ 受保护的

变量数组

类型

array<string, mixed>

命名空间

类 NegotiationRequiredView

常量

属性概览

方法概览

__construct() public

__get() public

_checkFilePath() protected

_configDelete() protected

_configRead() protected

_configWrite() protected

_createCell() protected

_elementCache() protected

_evaluate() protected

_getElementFileName() protected

_getLayoutFileName() protected

_getSubPaths() protected

_getTemplateFileName() protected

_inflectTemplateFileName() protected

_paths() protected

_render() protected

_renderElement() protected

addHelper() protected

append() public

assign() public

blocks() public

cache() public

cell() protected

configShallow() public

contentType() public static

disableAutoLayout() public

dispatchEvent() public

element() public

elementExists() public

enableAutoLayout() public

end() public

exists() public

extend() public

fetch() public

get() public

getConfig() public

getConfigOrFail() public

getCurrentType() public

getElementPaths() protected

getEventManager() public

getLayout() public

getLayoutPath() public

getLayoutPaths() protected

getName() public

getPlugin() public

getRequest() public

getResponse() public

getSubDir() public

getTemplate() public

getTemplatePath() public

getTheme() public

getVars() public

helpers() public

initialize() public

isAutoLayoutEnabled() public

loadHelper() public

loadHelpers() public

log() public

pluginSplit() public

prepend() public

render() public

renderLayout() public

reset() public

set() public

setConfig() public

setContentType() protected

setElementCache() public

setEventManager() public

setLayout() public

setLayoutPath() public

setPlugin() public

setRequest() public

setResponse() public

setSubDir() public

setTemplate() public