Skip to content

Comments

feat(symfony): allow disabling PHPStan PhpDocParser#7507

Merged
soyuka merged 1 commit intoapi-platform:4.1from
giosh94mhz:optional_php_docs
Nov 7, 2025
Merged

feat(symfony): allow disabling PHPStan PhpDocParser#7507
soyuka merged 1 commit intoapi-platform:4.1from
giosh94mhz:optional_php_docs

Conversation

@giosh94mhz
Copy link
Contributor

Q A
Branch 4.2.3
Tickets
License MIT
Doc PR (will updated as needed, waiting for feedback first)

PHP docblocks may be used for internal documentation only, so exposing
the details may leak internal information.

Another issue is that PHPStan may be available only on debug
environment, thus creating different behaviour when deploying an
application in production.

By default is enabled to avoid breaking changes.

Note: this is a bug from out point of view (since we found "leaking" internal information), but may be seen as a new feature since it's a new option. I'll wait for your feedback for changing description, docs & co

PHP docblocks may be used for internal documentation only, so exposing
the details may leak internal information.

Another issue is that PHPStan may be available only on debug
environment, thus creating different behaviour when deploying an
application in production.

By default is enabled to avoid breaking changes.
@soyuka soyuka force-pushed the optional_php_docs branch from 67775c3 to a6ef6c0 Compare November 7, 2025 14:24
@soyuka soyuka changed the base branch from main to 4.1 November 7, 2025 14:24
@soyuka
Copy link
Member

soyuka commented Nov 7, 2025

I agree that leaking information is not great and I'd like to merge this as a bug fix indeed.

@soyuka soyuka merged commit 3df65aa into api-platform:4.1 Nov 7, 2025
1 check failed
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

Successfully merging this pull request may close these issues.

2 participants