Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BC break since removing PHP7 support #1164

Closed
aschempp opened this issue Aug 3, 2022 · 2 comments
Closed

BC break since removing PHP7 support #1164

aschempp opened this issue Aug 3, 2022 · 2 comments

Comments

@aschempp
Copy link

aschempp commented Aug 3, 2022

Not sure if this bundle is following semantic versioning, or what is considered API. But removing methods from PhpCompatUtil in #1122 causes a BC break of our custom maker bundle (see contao/contao#5051). Is there no semver here or is this not considered API?

/cc @jrushlow

@jrushlow
Copy link
Collaborator

jrushlow commented Aug 3, 2022

Howdy @aschempp - We do follow Semantic Versioning through Symfony's Backward Compatibility Promise. See https://github.com/symfony/maker-bundle#backwards-compatibility-promise

However, the PhpCompatUtil is marked as internal and is not apart of the public API, changes may be made that will break libraries that use the utility outside of maker bundle. This concept applies to any file within this bundle (and even Symfony) that is maked with the @internal annotation.

I can't remember which, but i believe PHPUnit and/or Psalm have checks that can be used to detect if a library is directly using an internal class.

@jrushlow jrushlow closed this as completed Aug 3, 2022
@aschempp
Copy link
Author

aschempp commented Aug 3, 2022

Thanks @jrushlow, I didn't notice the @internal flag. Then it's clearly a problem on our end 😊

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants