prismic/php-sdk

PHP development kit for Prismic


README

Github Actions CI Total Downloads Latest Stable Version License

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

  1. Getting started
    1. Installation
    2. Recommended PHP Extensions
    3. Basic Usage & API calls
    4. DOM Helper
  2. More information
  3. Contributing
  4. License

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.