Download the PHP package jooservices/flickr without Composer

JOOservices Flickr SDK

jooservices/flickr is a pure PHP, framework-agnostic Flickr SDK for PHP 8.5+. It is not a Laravel package and intentionally does not ship service providers, facades, routes, migrations, config publishing, or Artisan commands.

The SDK uses jooservices/dto for public data objects and jooservices/client for HTTP transport. Official Flickr documentation remains the source of truth for API method behavior: https://www.flickr.com/services/api/

Current coverage:

• all 224 official REST API methods from the Flickr API index have method-registry entries;
• all 224 official REST API methods have service wrapper methods;
• core workflows have typed request DTOs and typed response helpers for priority methods;
• raw fallback remains available for custom parameters and future methods.

Install

Configure

First Public Search

flickr.photos.search can run unauthenticated for public photos. Private and semi-private results require OAuth read permission.

For lazy public search pagination, use searchPages():

Priority methods also expose typed *Data() helpers backed by hydrators:

Build Flickr image URLs from photo metadata:

Raw API Fallback

Unknown methods are still allowed so the package can call future Flickr methods before this package is updated.

Full API Method Wrappers

Every method in the official Flickr method index is available through a service wrapper. Wrappers that do not yet have a specialized DTO accept an associative parameter array and return ApiResponseData.

Examples:

The method registry stores docs URL, auth requirement, OAuth permission, cacheability, and GET/POST metadata scraped from the official method docs.

OAuth 1.0a

Flickr supports HMAC-SHA1 for OAuth request signing.

Upload, Replace, And Async Tickets

Upload and replace are separate from normal REST calls because Flickr sends binary files to up.flickr.com.

Replace:

Upload and replace require OAuth write permission. Delete requires delete permission. The SDK builds multipart requests with a readable file stream and closes that handle after the transport request completes.

Error Handling

Normal API responses are mapped to ApiResponseData. Flickr stat=fail responses return ok=false with ApiErrorData unless request options set throwOnApiError. Malformed, empty, or structurally invalid responses throw InvalidResponseException. Transport failures throw TransportException. Rate-limit and authorization failures throw RateLimitException and AuthorizationException respectively when Flickr or the transport signals those conditions.

Cache

V1 includes NullCache, Psr16Cache, and CacheKeyResolver. Runtime caching is disabled by default because FlickrFactory uses NullCache unless a cache adapter is passed.

When a cache adapter is passed, only public cacheable GET REST calls can be cached. Mutation, auth, OAuth, upload, replace, upload ticket polling, authenticated options, auth-required methods, POST methods, and Flickr stat=fail responses are never cached by default.

XML Support

JSON is the primary supported REST response format. XML parsing exists for Flickr upload/replace responses and has limited REST response parsing for compatibility, but REST XML should be treated as experimental unless a workflow has explicit tests.

Testing

Normal tests do not call Flickr:

Use the public fake transport to test application code without network calls:

Real API tests are opt-in:

Docs

See docs/README.md for architecture, getting started, user guide, examples, testing, release readiness, and V2 gaps.