PHPackages vincentauger/sierra-php-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. vincentauger/sierra-php-sdk ActiveLibrary[API Development](/categories/api) vincentauger/sierra-php-sdk =========================== A modern PHP SDK for the Sierra ILS API platform v1.1.4(1mo ago)20MITPHPPHP ^8.4.0CI passing Since Jul 18Pushed 1mo agoCompare [ Source](https://github.com/vincentauger/sierra-php-sdk)[ Packagist](https://packagist.org/packages/vincentauger/sierra-php-sdk)[ RSS](/packages/vincentauger-sierra-php-sdk/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (18)Versions (8)Used By (0) Sierra SDK for PHP (Unofficial) =============================== [](#sierra-sdk-for-php-unofficial) A modern PHP SDK for the Sierra ILS API (v6) platform, built for maintainability and clarity using [Saloon](https://docs.saloon.dev) for HTTP integration. > **Current Status:** Focused on querying (read-only) the **Bibliographic API (Bib API)**. Designed for future expansion to other Sierra endpoints. For detailed information on the Sierra API, visit the [docs](https://techdocs.iii.com/sierraapi/Content/titlePage.htm) [![Tests](https://github.com/vincentauger/sierra-php-sdk/actions/workflows/tests.yml/badge.svg)](https://github.com/vincentauger/sierra-php-sdk/actions/workflows/tests.yml)[![DOI](https://camo.githubusercontent.com/e348b4cc604471da43f7fc9441f36b5ca38951996a210a879538a92b99bd025f/68747470733a2f2f7a656e6f646f2e6f72672f62616467652f444f492f31302e353238312f7a656e6f646f2e31373533363338382e737667)](https://doi.org/10.5281/zenodo.17536388) --- Features -------- [](#features) - ✅ PHP 8.4+ with modern syntax (typed properties, readonly, enums, attributes) - ✅ Clean HTTP layer built on [Saloon](https://docs.saloon.dev) - ✅ PSR-4 autoloading and testable structure - ✅ Composer-native and framework-agnostic --- Installation ------------ [](#installation) ``` composer require vincentauger/sierra-php-sdk ``` Usage ----- [](#usage) ### Initialize the client [](#initialize-the-client) ``` use VincentAuger\SierraSdk\Sierra; $sierra = new Sierra( baseUrl: 'https://your.sierra.server/iii/sierra-api/v6', clientKey: 'your_client_key', clientSecret: 'your_client_secret', ); ``` ### Fetch a bibliographic record [](#fetch-a-bibliographic-record) ``` use VincentAuger\SierraSdk\Requests\Bib\GetBib; $request = new GetBib(123456); $response = $sierra->send($request); $record = $request->createDtoFromResponse($response); echo $record->title; // Access via typed DTO echo $record->author; echo $record->materialType?->getDisplayValue(); ``` ### Search the bibliographic index [](#search-the-bibliographic-index) ``` use VincentAuger\SierraSdk\Requests\Bib\GetSearchBib; $request = new GetSearchBib('climate change'); $response = $sierra->send($request); $results = $request->createDtoFromResponse($response); foreach ($results->entries as $entry) { echo $entry->bib->id . ': ' . $entry->bib->title . PHP_EOL; } ``` ### Advanced querying with QueryFactory [](#advanced-querying-with-queryfactory) For detailed query examples and advanced usage, see the [Query Factory documentation](docs/QUERY_FACTORY.md). ``` use VincentAuger\SierraSdk\Data\Query\QueryFactory; use VincentAuger\SierraSdk\Requests\Bib\PostQueryBib; // Search for titles starting with "climate" $query = QueryFactory::bib() ->field('t') // title field ->startsWith('climate'); $request = new PostQueryBib($query, limit: 25); $response = $sierra->send($request); $results = $request->createDtoFromResponse($response); foreach ($results->entries as $bibId) { // Get full record details $bibRequest = new GetBib($bibId); $bibResponse = $sierra->send($bibRequest); $bib = $bibRequest->createDtoFromResponse($bibResponse); echo $bib->title . PHP_EOL; } ``` Configuration ------------- [](#configuration) You must provide: ParameterDescriptionbaseUrlBase URL of the Sierra API (ends with `/v6`)clientKeyOAuth2 client keyclientSecretOAuth2 client secretStructure --------- [](#structure) - **Sierra** – main entry point, wraps Saloon connector - **Requests** – one Saloon Request per endpoint (e.g., GetBib, GetSearchBib, PostQueryBib) - **Data** – Data DTOs for API responses (e.g., BibObject, BibResultSet, BibSearchResultSet) - **Tests** – Pest tests Roadmap ------- [](#roadmap) - Basic client and authentication - Query the bib records `GET /v6/bibs/` - Search the bib records `GET /v6/bibs/search` - Query the bib records with JSON `POST /v6/bibs/query` - Fetch single bib record `GET /v6/bibs/{id}` Requirements ------------ [](#requirements) - PHP 8.4+ - Composer - Saloon (installed automatically) Contributing ------------ [](#contributing) Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details on development setup, testing, and guidelines. License ------- [](#license) MIT License — see the LICENSE file for details. Disclaimer ---------- [](#disclaimer) - This SDK is not affiliated with [Innovative Interfaces Inc.](https://www.iii.com/) - Use at your own risk. Respect your ILS API usage limits and security requirements. ### Health Score 44 — FairBetter than 91% of packages Maintenance98 Actively maintained with recent releases Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~50 days Recently: every ~62 days Total 6 Last Release 40d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/86c5e11f0405a38fa5411ed2c3445fa72b850fcb21f2ecb7c91ad1d4776327fd?d=identicon)[vincentauger](/maintainers/vincentauger) --- Top Contributors [![vincentauger](https://avatars.githubusercontent.com/u/19717710?v=4)](https://github.com/vincentauger "vincentauger (50 commits)") --- Tags phpapipackageBibliographysierra ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/vincentauger-sierra-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/vincentauger-sierra-php-sdk/health.svg)](https://phpackages.com/packages/vincentauger-sierra-php-sdk) ``` ### Alternatives [joisarjignesh/bigbluebutton BigBlueButton Server API Library for Laravel 162145.5k1](/packages/joisarjignesh-bigbluebutton)[musheabdulhakim/gohighlevel-php php sdk for gohighlevel api 151.1k](/packages/musheabdulhakim-gohighlevel-php)[okolaa/termiiphp Termii Rest API php library 112.4k](/packages/okolaa-termiiphp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)