PHP SDK

composer require buttercms/buttercms-php

require_once('vendor/autoload.php');

use ButterCMS\ButterCMS;

$butterCms = new ButterCMS('your_read_api_token');

// Fetch a single page
$page = $butterCms->fetchPage('landing_page', 'home-page', [
    'locale' => 'en',
    'preview' => 1  // Include draft content
]);

// Access page fields
echo $page->getFields()['headline'];
echo $page->getField('body');

// Fetch paginated pages
$pages = $butterCms->fetchPages('landing_page', [
    'page' => 1,
    'page_size' => 10,
    'locale' => 'en'
]);

// Access pages array
foreach ($pages->getPages() as $page) {
    echo $page->getField('headline');
}

// Access pagination metadata
$meta = $pages->getMeta();
echo $meta['next_page'];

// Fetch collections
$collections = $butterCms->fetchCollections(['faq', 'navigation'], [
    'locale' => 'en'
]);

// Access collection data
$faqItems = $collections->getCollection('faq');
foreach ($faqItems->getItems() as $item) {
    echo $item->getField('question');
    echo $item->getField('answer');
}

// Alternative: Content Fields (legacy method)
$content = $butterCms->fetchContentFields(['faq'], [
    'locale' => 'en'
]);

// List blog posts
$response = $butterCms->fetchPosts([
    'page' => 1,
    'page_size' => 10,
    'exclude_body' => true  // Exclude body for faster response
]);

// Access posts
foreach ($response->getPosts() as $post) {
    echo $post->getTitle();
    echo $post->getSlug();
}

// Access pagination
$meta = $response->getMeta();
echo $meta['next_page'];

// Fetch a single post
$post = $butterCms->fetchPost('my-post-slug')->getPost();
echo $post->getTitle();
echo $post->getBody();

// Search posts
$results = $butterCms->searchPosts('search query', [
    'page' => 1,
    'page_size' => 10
]);

// List all authors
$authors = $butterCms->fetchAuthors([
    'include' => 'recent_posts'  // Include recent posts
]);

foreach ($authors as $author) {
    echo $author->getFirstName();
    echo $author->getLastName();
}

// Fetch a single author (fetchAuthor() takes no params argument)
$author = $butterCms->fetchAuthor('jennifer-smith');

// List all categories
$categories = $butterCms->fetchCategories([
    'include' => 'recent_posts'
]);

foreach ($categories as $category) {
    echo $category->getName();
    echo $category->getSlug();
}

// Fetch a single category
$category = $butterCms->fetchCategory('news');

// List all tags
$tags = $butterCms->fetchTags();

foreach ($tags as $tag) {
    echo $tag->getName();
    echo $tag->getSlug();
}

// Fetch a single tag
$tag = $butterCms->fetchTag('featured');

// Get RSS feed
$rss = $butterCms->fetchFeed('rss');

// Get Atom feed
$atom = $butterCms->fetchFeed('atom');

// Get Sitemap
$sitemap = $butterCms->fetchFeed('sitemap');

<?php
require_once('vendor/autoload.php');

use ButterCMS\ButterCMS;

$butterCms = new ButterCMS(getenv('BUTTERCMS_API_KEY'));

function fetchHomepageData($butterCms) {
    try {
        // Fetch the home page
        $page = $butterCms->fetchPage('landing_page', 'home', [
            'locale' => 'en'
        ]);

        // Fetch navigation from collection
        $collections = $butterCms->fetchCollections(['main_navigation']);
        $navigation = $collections->getCollection('main_navigation');

        // Fetch recent blog posts
        $postsResponse = $butterCms->fetchPosts([
            'page' => 1,
            'page_size' => 3,
            'exclude_body' => true
        ]);

        return [
            'page' => $page,
            'navigation' => $navigation->getItems(),
            'recentPosts' => $postsResponse->getPosts()
        ];
    } catch (\Exception $e) {
        error_log("Error fetching content: " . $e->getMessage());
        return null;
    }
}

// Usage
$data = fetchHomepageData($butterCms);
if ($data) {
    echo "Page headline: " . $data['page']->getField('headline') . "\n";
    echo "Navigation items: " . count($data['navigation']) . "\n";
    echo "Recent posts: " . count($data['recentPosts']) . "\n";
}