test/hyperf
1
0
Fork 0
mirror of https://gitee.com/hyperf/hyperf.git synced 2024-12-04 20:58:13 +08:00
Code Issues Actions 16 Packages Projects Releases Wiki Activity
4f4984031a
hyperf/doc/zh/view.md

171 lines
4.5 KiB
Markdown
Raw Normal View History

Added doc for view.
2019-07-18 16:20:02 +08:00
# 视图
Update view.md
2019-07-28 01:57:53 +08:00
视图组件由 [hyperf/view](https://github.com/hyperf-cloud/view) 实现并提供使用，满足您对视图渲染的需求，组件默认支持 `Blade` 和 `Smarty` 两种模板引擎。
Added doc for view.
2019-07-18 16:20:02 +08:00
## 安装
Update view.md
2019-07-28 01:57:53 +08:00
```bash
Added doc for view.
2019-07-18 16:20:02 +08:00
composer require hyperf/view
```
## 配置
Update view.md
2019-07-28 01:57:53 +08:00
View 组件的配置文件位于 `config/autoload/view.php`，若配置文件不存在可自行创建，以下为相关配置的说明：
Added aliyun logger.
2019-09-04 11:24:50 +08:00
| 配置 | 类型 | 默认值 | 备注 |
|:-----------------:|:------:|:-------------------------------------:|:----------------:|
Optimized
2019-07-22 02:06:27 +08:00
| engine | string | Hyperf\View\Engine\BladeEngine::class | 视图渲染引擎 |
Added aliyun logger.
2019-09-04 11:24:50 +08:00
| mode | string | Mode::TASK | 视图渲染模式 |
| config.view_path | string | 无 | 视图文件默认地址 |
| config.cache_path | string | 无 | 视图文件缓存地址 |
Added doc for view.
2019-07-18 16:20:02 +08:00
Update view.md
2019-07-28 01:57:53 +08:00
配置文件格式示例：
Added doc for view.
2019-07-18 16:20:02 +08:00
```php
<?php
declare(strict_types=1);
use Hyperf\View\Mode;
use Hyperf\View\Engine\BladeEngine;
return [
Optimized
2019-07-22 02:06:27 +08:00
// 使用的渲染引擎
Added doc for view.
2019-07-18 16:20:02 +08:00
'engine' => BladeEngine::class,
Update view.md
2019-07-28 01:57:53 +08:00
// 不填写则默认为 Task 模式，推荐使用 Task 模式
Added doc for view.
2019-07-18 16:20:02 +08:00
'mode' => Mode::TASK,
'config' => [
Update view.md
2019-07-28 01:57:53 +08:00
// 若下列文件夹不存在请自行创建
Added doc for view.
2019-07-18 16:20:02 +08:00
'view_path' => BASE_PATH . '/storage/view/',
'cache_path' => BASE_PATH . '/runtime/view/',
],
];
```
Optimized
2019-07-22 02:06:27 +08:00
> 使用 `Task` 模式时，需引入 [hyperf/task](https://github.com/hyperf-cloud/task) 组件且必须配置 `task_enable_coroutine` 为 `false`，否则会出现协程数据混淆的问题，更多请查阅 [Task](zh/task.md) 组件文档。
Update view.md
2019-07-18 16:27:00 +08:00
Update view.md
2019-07-28 01:57:53 +08:00
> 若使用 `Sync` 模式渲染视图时，请确保相关引擎是协程安全的，否则会出现数据混淆的问题，建议使用更加数据安全的 `Task` 模式。
Update view.md
2019-07-30 17:00:47 +08:00
### 配置静态资源
Update view.md
2019-07-30 17:45:12 +08:00
如果您希望 `Swoole` 来管理静态资源，请在 `config/autoload/server.php` 配置中增加以下配置。
Update view.md
2019-07-30 17:00:47 +08:00
```
return [
'settings' => [
...
Update view.md
2019-07-30 17:45:12 +08:00
// 静态资源
Update view.md
2019-07-30 17:00:47 +08:00
'document_root' => BASE_PATH . '/public',
'static_handler_locations' => ['/'],
'enable_static_handler' => true,
],
];
```
Update view.md
2019-07-27 13:52:40 +08:00
## 视图渲染引擎
Update view.md
2019-07-28 01:57:53 +08:00
官方目前支持 `Blade` 和 `Smarty` 两种模板，默认安装 [hyperf/view](https://github.com/hyperf-cloud/view) 时不会自动安装任何模板引擎，需要您根据自身需求，自行安装对应的模板引擎，使用前必须安装任一模板引擎。
Update view.md
2019-07-27 13:52:40 +08:00
Update view.md
2019-07-28 01:57:53 +08:00
### 安装 Blade 引擎
Update view.md
2019-07-27 13:52:40 +08:00
Update view.md
2019-07-28 01:57:53 +08:00
```bash
Update view.md
2019-07-27 13:52:40 +08:00
composer require duncan3dc/blade
```
Update view.md
2019-07-28 01:57:53 +08:00
### 安装 Smarty 引擎
Update view.md
2019-07-27 13:52:40 +08:00
Update view.md
2019-07-28 01:57:53 +08:00
```bash
Update view.md
2019-07-27 13:52:40 +08:00
composer require smarty/smarty
```
### 接入其他模板
Update view.md
2019-07-28 01:57:53 +08:00
假设我们想要接入一个虚拟的模板引擎名为 `TemplateEngine`，那么我们需要在任意地方创建对应的 `TemplateEngine` 类，并实现 `Hyperf\View\Engine\EngineInterface` 接口。
Update view.md
2019-07-27 13:52:40 +08:00
```php
<?php
declare(strict_types=1);
namespace App\Engine;
class TemplateEngine implements EngineInterface
{
public function render($template, $data, $config): string
{
Update view.md
2019-07-28 01:57:53 +08:00
// 实例化对应的模板引擎的实例
$engine = new TemplateInstance();
// 并调用对应的渲染方法
return $engine->render($template, $data);
Update view.md
2019-07-27 13:52:40 +08:00
}
}
```
Update view.md
2019-07-28 01:57:53 +08:00
然后修改视图组件的配置：
Update view.md
2019-07-27 13:52:40 +08:00
```php
<?php
use App\Engine\TemplateEngine;
return [
Update view.md
2019-07-28 01:57:53 +08:00
// 将 engine 参数改为您的自定义模板引擎类
Update view.md
2019-07-27 13:52:40 +08:00
'engine' => TemplateEngine::class,
'mode' => Mode::TASK,
'config' => [
'view_path' => BASE_PATH . '/storage/view/',
'cache_path' => BASE_PATH . '/runtime/view/',
],
];
```
Update view.md
2019-08-03 12:38:22 +08:00
## 使用
以下以 `BladeEngine` 为例，首先在对应的目录里创建视图文件 `index.blade.php`。
```blade
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Hyperf</title>
</head>
<body>
Hello, {{ $name }}. You are using blade template now.
</body>
</html>
```
Update view.md
2019-09-18 10:37:25 +08:00
控制器中获取 `Hyperf\View\Render` 实例，然后调用 `render` 方法并传递视图文件地址 `index` 和 `渲染数据` 即可，文件地址忽略视图文件的后缀名。
Update view.md
2019-08-03 12:38:22 +08:00
```php
<?php
declare(strict_types=1);
namespace App\Controller;
use Hyperf\HttpServer\Annotation\AutoController;
use Hyperf\View\RenderInterface;
/**
* @AutoController
*/
class ViewController
{
public function index(RenderInterface $render)
{
return $render->render('index', ['name' => 'Hyperf']);
}
}
```
访问对应的 URL，即可获得如下所示的视图页面：
```
Hello, Hyperf. You are using blade template now.
```
Reference in New Issue Copy Permalink