prismic / php-sdk
PHP development kit for Prismic
Installs: 1 705 017
Dependents: 17
Suggesters: 0
Security: 0
Stars: 109
Watchers: 23
Forks: 83
Open Issues: 1
Requires
- php: ~8.0 || ~8.1
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.5
Requires (Dev)
- phpspec/prophecy: ^1.15
- phpspec/prophecy-phpunit: ^2.0
- phpunit/phpunit: ^9
- squizlabs/php_codesniffer: ^3.3
Suggests
- ext-apcu: *
- dev-master
- 5.3.0
- 5.2.1
- 5.2.0
- 5.1.2
- 5.1.1
- 5.1.0
- 5.0.1
- 5.0.0
- v4.0.0
- 4.0.0-beta
- 3.4.2
- 3.4.1
- 3.4.0
- 3.3.2
- 3.3.1
- 3.3.0
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.0
- 3.0.0
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 2.0.0-beta1
- 1.7.1
- 1.7.0
- 1.6.1
- 1.6.0
- 1.5.12
- 1.5.11
- 1.5.10
- 1.5.9
- 1.5.8
- 1.5.7
- 1.5.6
- 1.5.5
- 1.5.4
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.5
- 1.4.4
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.1
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.25
- 1.0.24
- 1.0.23
- 1.0.22
- 1.0.21
- 1.0.20
- 1.0.19
- 1.0.18
- 1.0.17
- 1.0.16
- 1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- 1.0.8
- 1.0.7
- 1.0.6-beta
- 1.0.5-beta
- 1.0.4-beta
- 1.0.3-beta
- 1.0.2-beta
- 1.0.1-beta
- dev-aa/ci
- dev-aa/test-travis-ci
- dev-release-4.0.0
- dev-alw/uid-crosslang
- dev-develop
- dev-php7only
- dev-apiv2
- dev-docs-gh-pages
- dev-jbdb/api-v2
- dev-sre/remove-symphony-deps
- dev-new-slice-wip
- dev-missing-helpers
- dev-alw/cache
- dev-travis
- dev-guzzle
- dev-fixtravis
- dev-php-unit
- dev-standardize_code
This package is auto-updated.
Last update: 2024-11-05 19:29:29 UTC
README
This is the official PHP SDK for Prismic.io, providing a straightforward way to connect to Prismic’s headless API. It is maintained by the community to help developers get started with Prismic in PHP.
- Offers an easy-to-use interface for basic interactions with Prismic content
- Covers core features of the Prismic API
Overview
Getting started
Installation
Installation using Composer:
$ composer require prismic/php-sdk
Recommended PHP Extensions
We recommend installing and enabeling the APCu extension to have the built-in default cache support. Otherwise, you can implement your own cache strategy by extending the Prismic\Cache\CacheInterface
interface.
Basic Usage & API calls
If you are not using automatic autoloading, include the Composer autoload file:
<?php include_once __DIR__.'/../vendor/autoload.php'; use Prismic\Api;
Then you can start making your first API calls:
$api = Api::get('https://your-repo-name.prismic.io/api/v2'); $document = $api->getByUID('get-started-type', 'get-started');
DOM Helper
The PHP SDK provides a set of DOM helpers to help you render your Prismic content.
In these examples we have a document variable corresponding to the fetched Prismic document. We also have a $linkResolver variable containing the functional link resolver, read our docs to learn more about Link Resolving.
Link
<?php use Prismic\Dom\Link; echo Link::asUrl($document->data->link, $linkResolver);
Rich Text
<?php use Prismic\Dom\RichText; echo RichText::asText($document->data->title); echo RichText::asHtml($document->data->description, $linkResolver);
Date
<?php use Prismic\Dom\Date; $date = Date::asDate($document->data->date); echo $date->format('Y-m-d H:i:s');
More information
Contributing
Whether you're helping us fix bugs, improve the docs, or spread the word, we'd love to have you as part of the Prismic developer community!
Reporting a bug: Open an issue explaining your application's setup and the bug you're encountering.
Suggesting an improvement: Open an issue explaining your improvement or feature so we can discuss and learn more.
Submitting code changes: For small fixes, feel free to open a pull request with a description of your changes. For large changes, please first open an issue so we can discuss if and how the changes should be implemented.
For more clarity on this project, check out the detailed CONTRIBUTING.md for our guidelines.
License
This software is licensed under the Apache 2 License, quoted below:
Copyright 2013-2024 Prismic <contact@prismic.io> (https://prismic.io)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.