NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2077 most downloaded on Packagist
A PHP library to support implementing representations for HATEOAS REST web services
Latest stable
3.14.0
Last release 10 months ago
10 Jan 2026
Release timing varies
gaps range from 8 days to 1.1 years
Most releases are documented
notes for 28 of 45 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
53 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Fix SplObjectStorage deprecation warning in PHP 8.5 by @W0rma in https://github.com/willdurand/Hateoas/pull/346
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.13.0...3.14.0
Simplify CI config by @W0rma in https://github.com/willdurand/Hateoas/pull/337
LinkExtension by @mvhirsch in https://github.com/willdurand/Hateoas/pull/338ClassMetadata serialization methods by @mvhirsch in https://github.com/willdurand/Hateoas/pull/340Full Changelog: https://github.com/willdurand/Hateoas/compare/3.12.0...3.13.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Make doctrine/annotations an optional dependency by @W0rma in https://github.com/willdurand/Hateoas/pull/334
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.11.0...3.12.0
Use PHPUnit 10 by @W0rma in https://github.com/willdurand/Hateoas/pull/335
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.12.0-beta1...3.12.0-beta2
Make doctrine/annotations an optional dependency by @W0rma in https://github.com/willdurand/Hateoas/pull/334
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.11.0...3.12.0-beta1
Add PHP 8 Attributes support by @ixarlie in https://github.com/willdurand/Hateoas/pull/326
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.10.0...3.11.0
Issue 325 php8 attributes by @ixarlie in https://github.com/willdurand/Hateoas/pull/326
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.10.0...3.11.0-beta1
Allow Symfony 7 by @W0rma in https://github.com/willdurand/Hateoas/pull/329
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.9.0...3.10.0
Test against PHP 8.1/8.2 and symfony 6 by @W0rma in https://github.com/willdurand/Hateoas/pull/328
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.8.0...3.9.0
Fix Deprecated Notice for PHP8 by @rogerb87 in https://github.com/willdurand/Hateoas/pull/324
Full Changelog: https://github.com/willdurand/Hateoas/compare/3.7.0...3.8.0
format link attributes as string when serializing xml #306
Address deprecations from persistence lib #302
Nothing published for this version
Nothing published for this version
remove unused symfony/dependency-injection component
[feature] Expressions in attributes are not supported when using YAML. #297
[feature] Allow jms/serializer 3.0 #291
removed deprecated functionalities
Improvement are:
A detailed list of closed issues is here
Information on how to upgrade are in the UPGRADING document
In parallel has been released willdurand/BazingaHateoasBundle 2.0.0 that integrates this library into Symfony.
removed deprecated functionalities
This is the first release candidate for willdurand/Hateoas v3.0 that brings major improvement as:
A detailed list of closed issues is here
Information on how to upgrade are in the UPGRADING document
In parallel has been relreased willdurand/BazingaHateoasBundle 2.0.0-RC1 that integrates this library into Symfony.
A stable release is expected in a couple of weeks.
This release adds support for Symfony 4.
This release adds support for Symfony 4.
Added: JMS serializer had a BC break in 1.6.1 and 1.6.2 that has been reverted in 1.7.0
MaxDepth issues when used in embedded collectionsThanks to all contributors, especiall Asmir!
Added: class name & allow possibility to register extension later
Fixed: Use UrlGeneratorInterface constants for UrlGenerator::generate For relative path (with absolute url) use Symfony\Component\Routing\Generator\Ur
UrlGeneratorInterface constants for UrlGenerator::generate For relative path (with absolute url) use Symfony\Component\Routing\Generator\UrlGeneratorInterface::ABSOLUTE_PATHThis release adds Symfony 3.0 support.
This release adds Symfony 3.0 support.
Fixed: assign class, name and type properties on RelationPropertyMetadata
RelationPropertyMetadataAdded: Evaluate ExcludeIf after JMS exclusion strategy (see #212)
Hateoas now relies on JMS Serializer ~1.0 and PHP 5.3 is not supported anymore!
Hateoas now relies on JMS Serializer ~1.0 and PHP 5.3 is not supported anymore!
Added: OffsetRepresentation and AbstractSegmentedRepresentation
OffsetRepresentation and AbstractSegmentedRepresentationType on PaginatedRepresentationFixed: set a default exclusion configuration to Embedded
Added: cache for Expression Language evaluations
RelationProviderInterfaceAdded: total attribute to PaginatedRepresentation
total attribute to PaginatedRepresentationRemoved: the Hateoas::getLinkHref() has been removed according to the deprecated message added a while ago. Use the getLinkHelper() method instead, an…
VndErrorRepresentationPagerFantaFactoryHateoasBuilder:create() functionHateoas::getLinkHref() has been removed according to the deprecated message added a while ago. Use the getLinkHelper() method instead, and call getLinkHref() on the helper itself — BC BreakPagerfantaFactory::create() has been removed according to the deprecated message added a while ago. Use the createRepresentation() method instead — BC BreakAdded: PagerfantaFactory now exposes a createRepresentation() method, and replaces the deprecated create() method. See the important note below. (#131…
JsonHalSerializerLinkExtension, a Twig extension to generate links, cf. documentationVndErrorRepresentation representation class to support vnd.error specification, cf. documentation (#111, #114)PagerfantaFactory now exposes a createRepresentation() method, and replaces the deprecated create() method. See the important note below. (#131, #133)PagerfantaFactory inlines \Traversable results (#128)The PagerfantaFactory has been refactored, and now exposes a createRepresentation() method. It is heavily recommended to use it! The old create() method has been deprecated and will be removed as of version 2.2.0.
As this class is not part of the "core" of the lib, but rather a helper class, we decided not to bump the major version number. Such a change was required as this factory is nearly unusable in real life, and that is why we see this change as a "fix" rather than a "BC break". This is a sort of "soft" backward compatibility break, we apologize for the inconvenience.
Nothing published for this version
Nothing published for this version
This is the first stable version of the new Hateoas library!
This is the first stable version of the new Hateoas library!
The library has been rewritten from scratch, and merges both the plain old Hateoas library and the FSCHateoasBundle. This is a standalone PHP library, PSR-* compliant and extensively unit tested. We also provide a Symfony2 bundle: BazingaHateoasBundle.
You will find the documentation here: http://hateoas-php.org/ (or here). There is no upgrade instructions as it is nearly impossible, but upgrading should not be that difficult, things being a lot easier now.
Thank you @adrienbrault for the hard work! :heart: :yellow_heart: :blue_heart:
Let's celebrate! :ship: :star: :stars: :star2: :tada: :boom: :cake: :candy:
Added: tests for XmlSerializer::serializeEmbeds()
XmlSerializer::serializeEmbeds()$inline to the PagerfantaFactorySerializerContext into *SerializerInterface::createLinks()SimpleCollectionTest (related to the change made on collections)LinksFactory::createLinks() to LinksFactory::create() to be consistent with the EmbedsFactoryPaginatedCollectionTestAdded: LinkHelper and LinkExpressionFunction classes (see LinkHelper)
LinkHelper and LinkExpressionFunction classes (see LinkHelper)ExpressionFunctionInterface to extend the Expression LanguageXmlDriversymfony/expression-language 2.4 stablesetUrlGenerator() method (builder)Hateoas::getRelationsRepository() methodAdded: file resources into the metadata for XML an YAML drivers, so cache can be rebuild when needed
This is the very first release of Hateoas 2.0. :ship: :star: :star2: :fireworks: :clap:
This is the very first release of Hateoas 2.0. :ship: :star: :star2: :fireworks: :clap:
As we expect people to start playing with it but we didn't provide any documentation yet, this version is not meant for production use. We need your feedback, so don't hesitate to open issues!
We are now working on the documentation to release a stable version as soon as possible, but we can't give any ETA yet.
One more thing, I (@willdurand) would like to personally thank @adrienbrault for his impressive work on this new powerful version!
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.