包简介

A templating system for PHP

README 文档

README

A simple templating engine for PHP

Spackle allows you to add code blocks and substitutions to any file.

Creating Templates

Substitutions

Substitution Notation: {{...}}

<body>
   Hello, my name is {{name}}.
</body>

Substitutions will be replaced based on the configuration of their Parser.

Code Blocks

Code Block Notation: {{> ... <}}

<body>
  {{>
    echo "Hello, Word!";
  <}}
</body>

Code blocks are always parsed last, this way you can use substitutions and other plugins within code blocks.

<ul>
{{> 
  foreach ({{likes}} as $likeable) {
    echo '<li>';
    echo $likeable;
    echo '</li>';
  }
<}}
</ul>

Plugins

Plugin Notation: {{key ... <}}

You can create your own plugins to parse custom template keys.

See CodeBlockParser.php for an example of a plugin.

class MyPlugin extends \Spackle\Plugin
{
    // The key used to notate the beginning of this element.
    public $key = 'url';

    // Parse each element found matching this plugin.
    // {{url some/data <}} woud come out to https://localhost/some/data
    public function parse($data)
    {
        return 'https://localhost/'.$data;
    }
}

. . .

// Add on a global scope
\Spackle\Plugin::add(new MyPlugin());

// Add to a specific parser
$parser->addPlugin(new MyPlugin());

Parsing Templates

Once you've created a template, you can parse it in PHP. To parse the template you need to create an instance of \Spackle\TemplateParser. In the following example, we will use the \Spackle\FileParser class. It is a subclass of the TemplateParser, the only difference being that it loads the contents of a file in instead of using a string.

For this example, we will use the following Spackle Template stored in ./test.spackle.

<h4>Welcome to Spackle!</h4>

Spackle was created by <a href="{{github_url}}" target="_blank">{{name}}</a>.<br />

Some things that {{name}} likes are:<br />
<ul>

{{> 
    foreach ({{likes}} as $likeable) {
        echo '<li>';
        echo $likeable;
        echo '</li>';
    }
<}}

</ul>

<b>Bound: {{> echo $this->bound; <}}

Now, to parse it we will need to tell it what values to use.

<?php

include_once __DIR__.'/vendor/autoload.php';

use \Spackle\FileParser;

// The FileParser extends the TemplateParser
// and instead of cunstructing with a string
// is uses a file path.
$parser = new FileParser(
    // Template File Path
    __DIR__.'/test.spackle',

    // Optional Substitutions (add more with $parser->setSubstitution($key, $val))
    [
        'github_url' => 'https://github.com/nathan-fiscaletti/',
    ]
);

// You can set substitutions easily using the setSubstitution
// member function of a TemplateParser.
$parser->setSubstitution('name', 'Nathan Fiscaletti');

// You can also bind the Parser to a specific object.
// Anytime you reference `$this` in your code blocks
// within the template, this bound object will be
// referenced.
$bindTest = (object)[
    'bound' => 'Yes, Bound.'
];
$parser->bindTo($bindTest);

// You can use functions for substitutions.
// When the return value is an integer or
// a string, it will be directly substituted.
// Otherwise, the value will be used.
$parser->setSubstitution('likes', function() {
    return ['Coding', 'PHP', 'Trial by Combat'];
});

// The ->parse() function will parse the template
// and return the parsed value.
echo $parser->parse();

This should output something like this:

Welcome to Spackle!

Spackle was created by Nathan Fiscaletti.

Some things that Nathan Fiscaletti likes are:
    * Coding
    * PHP
    * Trial by Combat

Bound: Yes, Bound.

(You can find this example in ./example/

Why stop there?

You can use Spackle for any file type you want, since it's a glorified regex matcher.

For example, JavaScript:

console.log("Hello, {{name}}!");

nafisc/spackle 适用场景与选型建议

nafisc/spackle 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 1.71k 次下载、GitHub Stars 达 2，最近一次更新时间为 2019 年 05 月 07 日，在 PHP 生态内属于活跃度较高的组件。

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

围绕 nafisc/spackle 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

nafisc/spackle

包简介