包简介

Twig powered View for CakePHP

README 文档

README

This plugin allows you to use the Twig Templating Language for your views.

It provides wrappers for common View operations and many helpful extensions that expose CakePHP functions and jasny/twig-extensions helpers.

Installation

To install with Composer, use the command below.

composer require cakephp/twig-view

Then, load the Cake/TwigView plugin in your Application bootstrap just like other Cake plugins.

Configuration

TwigView allows you to configure the Twig Environment through View options. You can set these through ViewBuilder in the Controller or set them directly in TwigView.

// In controller
public function initialize(): void
{
    $this->viewBuilder()->setOption('environment', ['cache' => false]);
}

// In your AppView
public function initialize(): void
{
    $this->setConfig('environment', ['cache' => false]);

    // Call parent TwigView initialize
    parent::initialize();
}

Available Options

environment

Twig Environment options.

Defaults to empty.
markdown

Which markdown engine is used for markdown_to_html filter. Set to default to use DefaultMarkdown or set custom Twig Markdown extension MarkdownInterface instance.

If using default, require one of: - erusev/parsedown - league/commonmark - michelf/php-markdown

Defaults to disabled.

AppView Setup

To start using Twig templates in your application, simply extend TwigView in your AppView. In general, it is safe to add your application's setup in AppView::initialize().

namespace App\View;

use Cake\TwigView\View\TwigView;

class AppView extends TwigView
{
    public function initialize(): void
    {
        parent::initialize();

        // Add application-specific extensions
    }
}

Customization

You can override several parts of TwigView initialization to create a custom Twig setup.

File Extensions

You can specify the file extensions used to search for templates by overriding the $extensions property.
```
class AppView extends TwigView
{
    protected $extensions = [
        '.custom',
    ];
}
```

Twig Loader

You can override the template loader used by Twig.

protected function createLoader(): \Twig\Loader\LoaderInterface
{
    // Return a custom Twig template loader
}

Twig Extensions

You can override the Twig Extensions loading. If you want to use the built-in View wrappers, make sure you load Cake\TwigView\Twig\Extensions\ViewExtension.
```
protected function initializeExtensions(): void
{
    // Load only specific extensions
}
```

Twig Profiler

You can override the Twig profiler used when DebugKit is loaded.

    protected function initializeProfiler(): void
    {
        parent::initializeProfiler();
        // Add custom profiler logging using $this->getProfile()
    }

Templates

You can create views using Twig templates much like you can with standard CakePHP templates.

Templates are loaded the same way wherever they are used and follow the View path conventions.

{% extends 'Common/base' %}
{{ include('Common/helper') }}

Template names are always relative to App.path.templates not the current file.
File extensions are automatically generated. Defaults to '.twig'.
Templates can be loaded from plugins the same as View templates.

Layout templates are supported and loaded the same way as View layouts.

templates/layout/default.twig:

<!DOCTYPE html>
<html>
<head>
    <title>
        {{ fetch('title') }}
    </title>

    {{ fetch('meta') }}
    {{ fetch('css') }}
    {{ fetch('script') }}
</head>
<body>
    {{ fetch('content') }}
</body>
</html>

The layout can be set from the template using the layout tag.

{% layout 'Error' %}

Accessing View

You can access the View instance using the _view global.

TwigView provides wrappers for fetch(), cell() and element() rendering. Cell and element templates are always loaded from cell/ and element/ sub-directories the same as View templates.

{{ fetch('content')}}

{{ cell('myCell')}}
{{ element('myElement') }}

TwigView also provides wrappers for any loaded helper using a special naming convention - helper_Name_function().

{{ helper_Text_autoParagraph('some text for a paragarph') }}

All wrapper functions are pre-escaped and do not require using |raw filter. However, keep in mind that Twig keeps the whitespace when using {{ }} to print. Please read the Twig documentation on how to remove the extra white space when needed.

Extension Filters

low maps to strtolower
up maps to strtoupper
env maps to env
pluralize maps to Cake\Utility\Inflector::pluralize
singularize maps to Cake\Utility\Inflector::singularize
camelize maps to Cake\Utility\Inflector::camelize
underscore maps to Cake\Utility\Inflector::underscore
humanize maps to Cake\Utility\Inflector::humanize
tableize maps to Cake\Utility\Inflector::tableize
classify maps to Cake\Utility\Inflector::classify
variable maps to Cake\Utility\Inflector::variable
slug maps to Cake\Utility\Inflector::slug
toReadableSize maps to Cake\I18n\Number::toReadableSize
toPercentage maps to Cake\I18n\Number::toPercentage
cake_number_format maps to Cake\I18n\Number::format
formatDelta maps to Cake\I18n\Number::formatDelta
currency maps to Cake\I18n\Number::currency
substr maps to substr
tokenize maps to Cake\Utility\Text::tokenize
insert maps to Cake\Utility\Text::insert
cleanInsert maps to Cake\Utility\Text::cleanInsert
wrap maps to Cake\Utility\Text::wrap
wrapBlock maps to Cake\Utility\Text::wrapBlock
wordWrap maps to Cake\Utility\Text::wordWrap
highlight maps to Cake\Utility\Text::highlight
tail maps to Cake\Utility\Text::tail
truncate maps to Cake\Utility\Text::truncate
excerpt maps to Cake\Utility\Text::excerpt
toList maps to Cake\Utility\Text::toList
stripLinks maps to Cake\Utility\Text::stripLinks
isMultibyte maps to Cake\Utility\Text::isMultibyte
utf8 maps to Cake\Utility\Text::utf8
ascii maps to Cake\Utility\Text::ascii
parseFileSize maps to Cake\Utility\Text::parseFileSize
serialize maps to serialize
unserialize maps to unserialize
md5 maps to md5
base64_encode maps to base64_encode
base64_decode maps to base64_decode
string cast to string

See jasny/twig-extensions for the filters they provide.

Extension Functions

in_array maps to in_array
explode maps to explode
array cast to array
array_push maps to push
array_prev maps to prev
array_next maps to next
array_current maps to current
__ maps to __
__d maps to __d
__n maps to __n
__x maps to __x
__dn maps to __dn
defaultCurrency maps to Cake\I18n\Number::getDefaultCurrency
uuid maps to Cake\Utility\Text::uuid
time passed the first and optional second argument into new \Cake\I18n\DateTime()
timezones maps to Cake\I18n\DateTime::listTimezones()

See jasny/twig-extensions for the functions they provide.

cakephp/twig-view 适用场景与选型建议

cakephp/twig-view 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 5.63M 次下载、GitHub Stars 达 15，最近一次更新时间为 2020 年 03 月 08 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「twig」「template」「view」「cakephp」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 cakephp/twig-view 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 cakephp/twig-view 我们能提供哪些服务？

定制开发 / 二次开发

基于 cakephp/twig-view 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 cakephp/twig-view 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

shoot/shoot 40

Shoot aims to make providing data to your templates more manageable

erelke/twig-spreadsheet-bundle 2

This Symfony bundle integrates PhpSpreadsheet into Symfony using Twig.

nerds-and-company/css-to-inline-styles-twig-extension 3

A Twig extension to insert css as inline styles with a tag

odan/twig-assets 22

Caching and compression for Twig assets (JavaScript and CSS).

yep/tracy-twig-extensions 5

Twig extensions for Tracy Debugger

morningmedley/view 0

Illuminate View for Morningmedley.

cakephp/twig-view

包简介

关键字：