# willdurand/Hateoas

A PHP library to support implementing representations for HATEOAS REST web services.

Repository: https://github.com/willdurand/Hateoas
Canonical: https://ross.abutalabs.com/products/hateoas
Homepage: https://williamdurand.fr/Hateoas/
Language: PHP
License: NOASSERTION
License Family: other
Topics: php, json, rest, serializer, hateoas
Last push: 2026-01-10T10:11:02+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 61, release rhythm 65, longevity 100
- inputs: {"age_days": 5130, "days_push": 235, "days_rel": 235, "gap_med": 20, "n_releases_24m": 4}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1042, forks 118 (observed 2026-08-28T04:03:20.899974+00:00)

## What it is
A PHP library for building HATEOAS REST web service representations by adding hypermedia links and embedded resources to API responses. It integrates with the JMS Serializer and Symfony via the BazingaHateoasBundle, supporting JSON-HAL, XML, and XML-HAL formats.

## Use cases
- add hypermedia links to PHP REST API responses
- generate JSON-HAL representations in PHP
- embed related resources in API payloads
- build HATEOAS REST web services with Symfony
- serialize API resources with links in XML and JSON
- configure API relations via annotations or YAML

## When to choose
- you build REST APIs in PHP and want hypermedia-driven responses
- you use Symfony or JMS Serializer and need HATEOAS support
- you need HAL JSON or XML link serialization out of the box

## When to avoid
- you build GraphQL or non-hypermedia JSON APIs
- your project is not PHP-based
- you prefer a full API framework rather than a serialization-focused library

## Facets
- artifact type: library
- maturity: stable
- function: serialization, api-framework, middleware
- domain: web-development, backend, apis
- platform: php
- tags: hateoas, rest, hypermedia, json-hal, symfony, jms-serializer, web-server

## Member repositories
- willdurand/Hateoas (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:20.899974+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:02:49.091738+00:00, confidence not recorded.
  - readme: https://github.com/willdurand/Hateoas (fetched 2026-08-28T04:03:20.899974+00:00, sha 99274ea1229d)
  - homepage: https://williamdurand.fr/Hateoas/ (fetched 2026-08-29T13:03:43.784006+00:00, sha c787ab2ff7e1)
- Data as of 2026-08-30T08:39:29.467469+00:00.