README

简介

此模块将帮助您使用TWIG模板引擎构建交互式面向对象的UI元素。本版本仅支持Zend Framework 2.5+和3.0+版本，但仅测试了与Zend 3.0+版本一起使用。

安装前

• 您必须有一个Zend Framework 3项目，
• 以下依赖项
  • 开发者工具栏（用于调试项目），
  • 支持缓存（在生产中使用TWIG很有用），
  • 支持JSON反序列化，
  • 支持会话。

可选地，您还可以安装

• 国际化支持（如果需要），
• 官方MVC插件，包括PRG支持、身份验证和闪存消息（如果您使用身份验证），

使用Composer安装

要安装 GraphicObjectTemplating，请使用以下命令

composer.phar require celtic34fr/zf-graphic-object-templating-twig dev-master

为了使用已安装的模块，您需要按以下方式配置您的应用程序

首先，在 config/modules.config.php 文件中，添加以下行

...,
'ZfcTwig',
'GraphicObjectTemplating',
...,

在您的项目公共文件夹中，创建一个指向 vendor/celtic34fr/zf-graphic-object-templating-twig/public 目录的链接目录，命名为 graphicobjecttemplating，使用以下命令：如果您使用Linux，请运行以下命令

ln -s ../vendor/celtic34fr/zf-graphic-object-templating-twig/public graphicobjecttemplating

如果您使用Windows，请以管理员身份使用cmd.exe在公共文件夹中运行以下命令

mklink /D graphicobjecttemplating ..\vendor\celtic34fr\zf-graphic-object-templating\public

将位于 GraphicObjectTemplating 配置文件夹中的文件 zfGraphicObjectTemplting.local.php.dist 和 zfGrpahicObjectTemplating.development.local.php.dist 复制到您的项目 config/autoload 文件夹中，无需 .dist 扩展名。它们将激活 GraphicObjectTemplating 所需的所有基本参数。

为了能够使用 ODDragNDrop 对象、通过拖放下载文件，您需要执行 2 个操作。

在您的项目 config/autoload 文件夹中，您必须在 global.php 文件中添加以下行

return [
    ...
    'publicFolder' => __DIR__.'/../../public',
    ...
];

在您的项目公共文件夹中，创建 uploadfiles 文件夹，然后分配公共文件夹和 uploadedfiles 文件夹的所有用户的写权限（Linux 'chmod 777 ...'）。

使用 Twig 模板引擎，您需要替换一些模板和参数。您可以在项目的 view/twigtemplates 中找到模板

• 在 application/index 文件夹中，您有 index.twig 模板，它与标准项目中的 index.phtml 相同，
• 在 error 文件夹中，您将找到 index.twig 和 404.twig 文件。使用它们替换您项目 error 文件夹中的 index.phtml 和 404.phtml 文件，
• 在 layout 文件夹中，您将找到 layout.twig 文件，它是原始 layout.phtml 文件的修改版，用于与Twig模板引擎一起使用。

完成此操作后，您将体验到与原始Zend Framework 3项目相同的体验。为了复制不使用TWIG进行页面渲染的Zend Framework 3项目的相同机制，对TWIG进行了一些扩展。

这只是一个开发基础，您可以根据需要对其进行修改/调整。当前的 layout.twig 模板与TWIG块模式一起工作。在此模式中，定义了多个变量和块，因此您可以输入自己的数据

• 变量 local 允许您定义页面的语言，例如；'fr' 或 'en'，
• 《Hmeta》块定义了基本元数据，您可以选择修改或补充。
• 《Hstyle》块定义了在任意页面运行 GraphicObjectTemplating 所需的样式表。
• 《Hscript》块定义了在任意页面运行 GraphicObjectTemplating 所需的JavaScript文件。
• 《Bcontent》块包含或将要包含您页面的结构，content 块包含页面的主要内容（不包括导航栏和页脚）。
• 《Bscript》块用于允许您在页面主体中添加JavaScript代码或文件。

最后，在开发应用程序之前，您必须在模块/Application/config/module.config.php文件中进行一些更改。在template_map 块中，您必须将所有文件扩展名从.phtml 更改为.twig。在确认一切正常工作之前，不要忘记在控制之前进行自动加载。

开发模式

首先，安装您开发环境所需的所有包。

composer.phar require --dev zendframework/zend-developer-tools ^1.1.0
composer.phar require --dev san/san-session-toolbar ^2.0.2

由于 GraphicObjectTemplating 使用Php会话，我们需要能够根据需要查看和删除其内容。为此，并且仅在开发模式下，已经将 san/san-session-toolbar 扩展与 GraphicObjectTemplating 一起安装。要使用此扩展，请将以下行添加到您的项目的 config/development.config.php 文件中：

...
'modules' => [
    ...
    'ZendDeveloperTools',
    'SanSessionToolBar',
    ...
],
...

运行单元测试