发光二极管/pimcore-rest-api

通过其REST API访问pimcore的Zend Framework 2模块

0.1.6 2016-06-13 12:05 UTC

This package is auto-updated.

Last update: 2024-09-26 08:28:09 UTC


README

通过其REST API访问 pimcore 的Zend Framework 2模块。

安装

此模块使用composer进行安装。有关composer文档,请参阅 getcomposer.org

php composer.phar require leuchtdiode/pimcore-rest-api

然后将 PimcoreRestApi 添加到您的 config/application.config.php 文件中。

使用方法

当前包含以下功能

  • 通过ID检索文档
  • 通过路径检索文档
  • 搜索文档
  • 用于打印文档纯文本的视图辅助器

设置

为了使用API,您必须在应用程序中指定一个配置集 pimcoreRestApi(例如,在 config/autoload/local.php 中)

您必须设置以下参数

  • host:您的pimcore API所在的主机(例如,cms.company.com)
  • ssl:默认为false。将其设置为true将通过SSL请求API。(例如,https://cms.company.com
  • apiKey:您在pimcore中为您的用户生成的API密钥

例如

<?php
$config = [
	...
	'pimcoreRestApi' => [
		'host'		=> 'cms.company.com',
		'ssl'		=> false,
		'apiKey'	=> '1233298asd89as9das89d9as9d8as89da9sd98as9dad',
	],
	...
];

服务

我们建议不要直接使用API,而是通过服务定位器使用模块提供的服务。目前包含一个文档服务。

您可以使用服务定位器中的 PimcoreRestApi\Service\Documents 来检索文档

  • 通过ID获取一个文档 getById($documentId)
  • 通过路径获取一个文档 getByPath($documentPath)
  • 通过路径获取所有文档 getAllByPath($path)

视图辅助器

该模块还提供了一种用于显示给定文档路径的纯文本的视图辅助器。

PraDocument

通过在您的视图中调用 $this->praDocument(),您可以获取文档视图辅助器的实例,该辅助器目前提供以下方法

打印路径的文本

$this->praDocument()->printTextForPath($path)

此方法尝试通过其路径获取文档,搜索所有WYSIWYG元素,将它们连接起来并输出文本。如果无法获取文档或找到WYSIWYG元素,则返回 null

缓存

为了最小化通过其REST API调用外部pimcore系统,我们建议设置由 zend-cache 提供的存储缓存。

该模块已经实现了缓存。您只需要告诉他。

设置非常简单,只需在服务定位器中定义一个工厂,该工厂返回一个 Zend\Cache\Storage\StorageInterface,键为 PimcoreRestApi\StorageCache