发光二极管 / pimcore-rest-api
通过其REST API访问pimcore的Zend Framework 2模块
Requires
- php: >=5.6
- netresearch/jsonmapper: ^0.11.0
- zendframework/zend-http: ~2.5
Suggests
- zendframework/zend-cache: Using Zend cache to minimize REST API calls
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
。