Skip to content

v1.0.0 — Initial MVP release

Latest

Choose a tag to compare

@fsans fsans released this 12 Jul 08:19

PHP client for the Claris FileMaker Server OData v4 API.

Mirrors fms-odata-js and
fms-odata-py. Depends on
fsans/fms-odata-spec-php
for shared types, error hierarchy, auth helpers, and URL literal formatting.

Core features

  • Client/FMSOData entry point with base URL construction, version
    detection, and feature gating
  • HttpClient with auth header injection (Basic/Bearer), OData headers,
    one-time 401 retry, JSON/XML error parsing, and typed error mapping
  • CurlTransport (ext-curl) production transport with TransportInterface
    for swappable transports
  • Fluent Query builder (select, filter, expand, orderBy, top, skip, count)
    with deterministic URL serialization
  • Filter/FilterFactory for OData $filter expressions
  • EntityRef for single-record CRUD (get, patch, delete) with
    If-Match/Prefer header support
  • MetadataParser (regex-based CSDL) and MetadataFetcher with caching
  • Url utilities with FileMaker-aware encoding

Requirements

  • PHP 8.2+
  • ext-curl
  • fsans/fms-odata-spec-php ^2.0

Quality

  • 197 tests passing
  • PHPStan level max clean