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
Installation using Composer:
$ composer require prismic/php-sdk
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.
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');
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.
<?php
use Prismic\Dom\Link;
echo Link::asUrl($document->data->link, $linkResolver);
<?php
use Prismic\Dom\RichText;
echo RichText::asText($document->data->title);
echo RichText::asHtml($document->data->description, $linkResolver);
<?php
use Prismic\Dom\Date;
$date = Date::asDate($document->data->date);
echo $date->format('Y-m-d H:i:s');
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.
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.