Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

ItsDavidSQ's avatar

[WIP Package] API Evolution ("versioning")

Inspired by a Stripe blog post I read a while ago I have been working on a (not yet) open source Laravel package to facilitate the development of an API following the concept of API Evolution. For those that may not be familiar with it, it is basically a technique that allows to make changes to an API in an incremental manner while maintaining backwards compatibility.

The goal of the package is to provide similar functionality to what Stripe describes on their blog post — including the pinned versions.

Even though Stripe's blog post is from August 2017, I haven't seen many people talking about it or implementing it, so here I am to see if any one here is familiar with the concept, has implemented it themeselves or knows someone who has. Also, any articles or packages (whether PHP or other languages) that you can reference would be appreciated.

Besides, if you're thinking about versioning your API and would like to give a go at API Evolution, let's talk.

Reference articles:

APIs as infrastructure: future-proofing Stripe with versioning - Stripe's Blog

API Evolution for REST/HTTP APIs - APIs you won't hate

Evolution Techniques for RESTful APIs - Alessandro Desantis

0 likes
2 replies
ItsDavidSQ's avatar

That's actually the package I was working on. I released it a few weeks ago. I was meant to come back and update the post to include a link, but life got in the way and never did.

Let me know if you have any questions or suggestions about the package, I would love to hear some feedback and keep improving it.

Please or to participate in this conversation.