README

Prismic 的 PHP 开发工具包

入门

为您的项目安装工具包

首先，安装 apc 以启用默认内置缓存支持。

使用 Composer 安装

$ composer require roelofjan-elsinga/prismic-php

用法

包含依赖项

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

use Prismic\Api;

然后调用 API

<?php
$api = Api::get('https://your-repo-name.prismic.io/api/v2');
$doc = $api->getByUID('get-started');

此工具包支持 PHP 版本 >= 7.4。

由于依赖于事件调度器，此库与 Symfony 版本 2.8 及以上版本兼容。对于 Symfony 2.7 项目，请使用版本 2.0.3。

DOM 辅助程序使用

在这些示例中，我们有一个与获取的 Prismic 文档对应的 $doc 变量。我们还有一个包含功能链接解析器的 $linkResolver 变量，阅读我们的文档了解更多关于链接解析的信息。

链接

<?php
use Prismic\Dom\Link;

echo Link::asUrl($doc->data->link, $linkResolver);

富文本

<?php
use Prismic\Dom\RichText;

echo RichText::asText($doc->data->title);
echo RichText::asHtml($doc->data->description, $linkResolver);

日期

<?php
use Prismic\Dom\Date;

$date = Date::asDate($doc->data->date);
echo $date->format('Y-m-d H:i:s');

更多信息

• 开发者文档
• PHP 快速入门教程
• PHPDoc
• 变更日志

本地安装工具包

克隆此 GitHub 仓库，然后如果您还没有安装，请安装 Composer，并运行

$ composer install

测试

请为任何错误修复或新功能编写测试。

如果您发现现有代码测试不足，并希望改进，我们非常感激；但您应该在自己的分支和自己的拉取请求中对其进行记录。

通过运行以下命令来运行测试

$ ./vendor/bin/phpunit

此工具包的一些测试检查的是基于 APC 的内容，需要 APC 来在命令行中工作。如果您已安装并启用了 APC，但您的缓存测试未通过

• 通过运行 php -i | grep apc 检查您的 APC 是否为您的命令行启用；如果没有输出，那么您安装并启用的 APC 扩展可能仅对 Apache 启用，而未对您的命令行启用。检查您的 OS 如何操作以实现这一点，如果需要更改 php.ini 文件，请确保它是正确的 php.ini（您可能有一个用于 Apache 的，一个用于命令行的）
• 如果 APC 为命令行启用，但测试仍然失败，请确保您的 apc.enable_cli（您在 php -i | grep apc 的输出中看到）是 'On'。如果不是，请在您的 php.ini 的末尾添加此行：apc.enable_cli = 1。确保它是正确的 php.ini（您可能有一个用于 Apache 的，一个用于命令行的）

许可证

此软件根据以下 Apache 2 许可证进行许可。

版权所有 2018 Prismic (https://prismic.io).

根据 Apache License，版本 2.0（“许可证”）；除非适用法律要求或书面同意，否则不得使用本项目，除非符合许可证。您可以在 https://apache.ac.cn/licenses/LICENSE-2.0 获取许可证副本。

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”基础分发，不提供任何明示或暗示的保证或条件。有关许可证的具体语言管理权限和限制，请参阅许可证。