netglue / prismic-doctype-client
Prismic Custom Type API Client
Installs: 66 722
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 4
Forks: 0
Open Issues: 3
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
Introduction
This library provides an API client so that you can read and write your document type definitions using the Prismic Custom Types API.
Currently, you can list, read, insert and update document types.
The client requires that you make use of (And similarly, it returns instances of) the shipped Definition
value object.
Typically, you wouldn't interact with the client directly, but as part of a build process that takes care of all that stuff for you. This client is quite fresh, but it's primary use will soon be part of netglue/prismic-cli
, so that it will become trivial to synchronise your local development document definitions with those in your production Prismic repository (and vice-versa).
Installation
The only supported installation method is via composer:
composer require --dev netglue/prismic-doctype-client
Configuration
The client has been designed to work with whatever PSR-18 HTTP Client and PSR-7 and PSR-17 implementations that you like to use. Once you have got hold of an API token for the custom types API, you can create a client with:
<?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 )
Limitations/Roadmap
Authentication
Currently, authentication is only possible with a permanent access token that you create/retrieve from the Prismic repository settings. Session based tokens are not supported.
Slices
CRUD operations on shared slices are not yet implemented but are planned for future development. If you really want this feature, you're welcome to contribute.
Contributing
Please feel free to get involved with development. The project uses PHPUnit for tests, Psalm for static analysis and Infection for mutation testing. CI should have your back if you want to submit a feature or fix ;)
License
Changelog
See CHANGELOG.md
.