flexacms / php

v0.2.0 2026-10-12 20:25 UTC

Requires

• php: ^8.1

Requires (Dev)

• pestphp/pest: ^2.0 || ^3.0 || ^4.0 || ^5.0

Suggests

• ext-curl: Used by the default HTTP transport.

MIT

• cms
• sdk
• headless
• API-Client
• flexa

Published on Packagist.org on 2026-10-13 01:20 UTC

README

Framework-agnostic PHP client for the Flexa headless CMS. No dependencies; HTTP transport and cache are pluggable. Using Laravel? Try flexacms/laravel.

Read-only split of flexacms/sdk. Open issues there.

composer require flexacms/php

use FlexaCms\Client\Client;

$flexa = new Client('https://cms.example.com', getenv('FLEXA_API_KEY'), [
    'locale' => 'es',                 // translatable fields
    'fallback_locales' => ['en'],
    'cache_ttl' => 300,               // seconds; 0 disables
]);

$page = $flexa->entity('posts')->published()->list(page: 1, perPage: 12);

foreach ($page as $post) {
    echo $post->title, ' ', $post->value('headline'), ' ', $post->url('cover');
}

$about = $flexa->entity('pages')->find('about');   // null when missing

Queries are immutable: published(), status(), search(), category(), withRelations(), cache($seconds); then list(), cursor(), all(), find(), get(), schema(), create(), update(), delete() and restore(). Failures throw FlexaCms\Client\Exceptions\FlexaException (status, validation errors). Reads are retried after rate limits and network errors; writes never are.

Option	Default
api_path	/api/v1
timeout	30	seconds
retries	2	reads only
cache_ttl	60	seconds
cache	in-memory	implement FlexaCms\Client\Cache\Cache
transport	cURL	implement FlexaCms\Client\Http\Transport
locale, fallback_locales	—	for Entry::value() and Entry::url()