init

Author: ueaner

.editorconfig

@@ -0,0 +1,8 @@
+# EditorConfig is awesome: http://EditorConfig.org
+root = true
+
+[*]
+end_of_line = lf
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true

.gitignore

@@ -0,0 +1,5 @@
+!.gitkeep
+examples/vendor/*
+examples/cache/*
+examples/composer.lock
+examples/composer.json

README.md

@@ -0,0 +1,25 @@
+Soli View
+--------------
+
+此项目对常用模版引擎进行封装，便于集成到开发者所熟悉的框架。
+目前支持以下模版引擎：
+
+- Twig
+- Smarty
+
+## 安装
+
+使用 `composer` 安装到你的项目：
+
+    composer require soliphp/view
+
+## 使用
+
+详见：[examples].
+
+## License
+
+MIT Public License
+
+
+[examples]: examples

composer.json

@@ -0,0 +1,30 @@
+{
+    "name": "soliphp/view",
+    "description": "Smarty and Twig View Parser package",
+    "type": "library",
+    "keywords": ["templating", "view", "soliphp"],
+    "homepage": "https://github.com/soliphp/view",
+    "support": {
+        "issues": "https://github.com/soliphp/view/issues",
+        "source": "https://github.com/soliphp/view"
+    },
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "ueaner",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "php": ">=5.5.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Soli\\": "src/"
+        }
+    },
+    "suggest": {
+        "smarty/smarty": "Smarty templating system",
+        "twig/twig": "Twig templating system"
+    }
+}

examples/README.md

@@ -0,0 +1,30 @@
+Soli View examples
+------------------
+
+当前目录提供了 Soli View 的相关示例。
+
+## 使用
+
+首先需要安装 Soli View 包：
+
+    composer require soliphp/view
+
+### Twig
+
+安装 Twig 模版引擎：
+
+    composer require twig/twig
+
+运行：
+
+    php twig.php
+
+### Smarty
+
+安装 Smarty 模版引擎：
+
+    composer require smarty/smarty
+
+运行：
+
+    php smarty.php

examples/smarty.php

@@ -0,0 +1,41 @@
+<?php
+
+use Soli\View;
+use Soli\View\Engine\Smarty as SmartyEngine;
+
+include __DIR__ . "/vendor/autoload.php";
+
+$config = [
+    'viewsDir'        => __DIR__ . '/views/smarty/',
+    'viewsCacheDir'   => __DIR__ . '/cache/templates/',
+    'viewsCompileDir' => __DIR__ . '/cache/templates_c/',
+];
+
+$view = new View();
+$view->setViewsDir($config['viewsDir']);
+$view->setViewExtension('.tpl');
+
+// 通过匿名函数来设置模版引擎，延迟对模版引擎的实例化
+$view->setEngine(function () use ($config, $view) {
+    $engine = new SmartyEngine($view);
+    // 开启 debug 不进行缓存
+    $engine->setDebug(true);
+    $engine->setOptions(array(
+        'compile_dir'     => $config['viewsCompileDir'],
+        'cache_dir'       => $config['viewsCacheDir'],
+        'caching'         => true,
+        'caching_type'    => 'file',
+        'cache_lifetime'  => 86400,
+        'left_delimiter'  => '{{',
+        'right_delimiter' => '}}',
+    ));
+    return $engine;
+});
+
+$view->setVar('name', 'Soli');
+
+$template = 'home/index';
+
+echo $view->render($template);
+
+

examples/twig.php

@@ -0,0 +1,33 @@
+<?php
+
+use Soli\View;
+use Soli\View\Engine\Twig as TwigEngine;
+
+include __DIR__ . "/vendor/autoload.php";
+
+$config = [
+    'viewsDir'      => __DIR__ . '/views/twig/',
+    'viewsCacheDir' => __DIR__ . '/cache/twig/',
+];
+
+$view = new View();
+$view->setViewsDir($config['viewsDir']);
+$view->setViewExtension('.twig');
+
+// 通过匿名函数来设置模版引擎，延迟对模版引擎的实例化
+$view->setEngine(function () use ($config, $view) {
+    $engine = new TwigEngine($view);
+    // 开启 debug 不进行缓存
+    $engine->setDebug(true);
+    $engine->setCacheDir($config['viewsCacheDir']);
+    // 使用扩展
+    // $engine->addExtension(new MyTwigExtension());
+    return $engine;
+});
+
+$view->setVar('name', 'Soli');
+
+$template = 'home/index';
+
+echo $view->render($template);
+

examples/views/smarty/home/index.tpl

@@ -0,0 +1 @@
+Hi, {{$name}}.

examples/views/twig/home/index.twig

@@ -0,0 +1 @@
+Hi, {{ name }}.

phpcs.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0"?>
+<ruleset name="Soli Coding Standard">
+    <description>Soli Coding Standard</description>
+
+    <!-- display progress -->
+    <arg value="p"/>
+    <!-- display sniff codes -->
+    <arg value="s"/>
+    <!-- use colors in output -->
+    <arg name="colors"/>
+    <!-- file extensions -->
+    <arg name="extensions" value="php"/>
+
+    <!-- inherit rules from: -->
+    <rule ref="PSR2"/>
+    <rule ref="Generic.Arrays.DisallowLongArraySyntax"/>
+    <rule ref="PSR1">
+        <exclude name="PSR1.Classes.ClassDeclaration"/>
+    </rule>
+
+    <!-- ignore vendor -->
+    <exclude-pattern>*/vendor/*</exclude-pattern>
+    <exclude-pattern>*/examples/*</exclude-pattern>
+</ruleset>