netglue / prismic-doctype-client
Prismic 自定义类型 API 客户端
1.4.0
2023-12-01 11:28 UTC
Requires
- php: ~8.1 || ~8.2.0 || ~8.3
- ext-json: *
- php-http/discovery: ^1.14.1
- psr/http-client: ^1.0
- psr/http-client-implementation: *
- psr/http-factory: ^1.0
- psr/http-message: ^1.0 || ^2.0
- symfony/http-client: ^6.2 || ^7.0
- webmozart/assert: ^1.10
Requires (Dev)
- ext-curl: *
- doctrine/coding-standard: ^12.0
- infection/infection: ^0.27.8
- laminas/laminas-diactoros: ^3.3.0
- php-http/curl-client: ^2.3.1
- phpunit/phpunit: ^10.5.0
- psalm/plugin-phpunit: ^0.18.4
- react/child-process: ^0.6.5
- react/http: ^1.9
- roave/security-advisories: dev-latest
- squizlabs/php_codesniffer: ^3.7.2
- vimeo/psalm: ^5.16
README
简介
这个库提供了一个 API 客户端,使您可以使用 Prismic 自定义类型 API 来读取和写入您的文档类型定义。
目前,您可以列出、读取、插入和更新文档类型。
客户端要求您使用(以及它返回的)随附的 Definition
值对象。
通常,您不会直接与客户端交互,而是将其作为构建过程的一部分,该过程会为您处理所有这些工作。这个客户端相当新,但它的主要用途很快将成为 netglue/prismic-cli
的一部分,这样您就可以轻松地同步本地开发文档定义与生产 Prismic 存储库中的定义(反之亦然)。
安装
唯一支持的安装方法是使用 composer
composer require --dev netglue/prismic-doctype-client
配置
客户端已被设计为与您喜欢的任何 PSR-18 HTTP 客户端 和 PSR-7 和 PSR-17 实现 一起工作。一旦您获得了自定义类型 API 的 API 令牌,您可以使用以下方式创建客户端:
<?php use Prismic\DocumentType\BaseClient; $client = new BaseClient( 'some-token', 'my-repository-name', $httpClient, // \Psr\Http\Client\ClientInterface $requestFactory, // \Psr\Http\Message\RequestFactoryInterface $uriFactory, // \Psr\Http\Message\UriFactoryInterface $streamFactory // \Psr\Http\Message\StreamFactoryInterface )
限制/路线图
身份验证
目前,身份验证只能通过您从 Prismic 存储库设置中创建/检索的 永久访问令牌 完成。不支持基于会话的令牌。
片段
对共享片段的 CRUD 操作尚未实现,但计划在未来的开发中实现。如果您真的需要这个功能,欢迎您贡献。
贡献
请随时参与开发。该项目使用 PHPUnit 进行测试,Psalm 进行静态分析,以及 Infection 进行突变测试。如果您想提交功能或修复,CI 应该会支持您;)
许可证
变更日志
请参阅 CHANGELOG.md
。