Download the PHP package ethelserth/biblionet-php without Composer
On this page you can find all versions of the php package ethelserth/biblionet-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ethelserth/biblionet-php
More information about ethelserth/biblionet-php
Files in ethelserth/biblionet-php
Package biblionet-php
Short Description A framework-agnostic PHP client for the Biblionet Greek books API
License MIT
Informations about the package biblionet-php
ethelserth/biblionet-php
A framework-agnostic PHP client for the Biblionet Greek books API.
Biblionet is the primary books-in-print database for Greece, covering over 200,000 titles with full bibliographic data, contributor information, subject classification, and commercial details.
This package provides a clean, typed interface to the Biblionet web service. It has no framework dependency and works with any PSR-18 compatible HTTP client.
If you are using Laravel, see ethelserth/biblionet-laravel for a ready-made service provider and configuration.
Requirements
- PHP 8.1 or higher
- A PSR-18 HTTP client (e.g.
guzzlehttp/guzzle) - A PSR-17 HTTP factory (e.g.
guzzlehttp/psr7) - Biblionet API credentials (request access at biblionet.gr)
Installation
You will also need a PSR-18 client and PSR-17 factories. If you do not already have one:
Usage
Instantiation
Fetching titles
Fetching related data
Fetching persons and companies
Fetching subjects and languages
DTOs
All responses are returned as immutable typed value objects. No business logic lives in the DTOs — they carry exactly what the API returns, with proper PHP types and empty strings converted to null.
| DTO | Source endpoint | Notes |
|---|---|---|
Title |
get_title |
Full bibliographic record |
TitleSummary |
get_month_titles |
Lighter listing record |
Contributor |
get_contributors |
Title-contributor relationship |
Company |
get_title_companies |
Title-company relationship |
TitleSubject |
get_title_subject |
Title-subject relationship with DDC |
Person |
get_person |
Full person record |
CompanyInfo |
get_company |
Full company record |
Subject |
get_subject |
Subject with DDC and parent ID |
Language |
get_language |
Language name by ID |
Error handling
All errors throw Ethelserth\Biblionet\Exceptions\BiblionetException:
Testing credentials
Biblionet provides public test credentials for development:
- Username:
testuser - Password:
testpsw
These are rate-limited and should not be used in production.
License
MIT. See LICENSE.