Skip to content

Remove faulty PHP code blocks #9554

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

Merged
merged 1 commit into from
Apr 5, 2018
Merged

Remove faulty PHP code blocks #9554

merged 1 commit into from
Apr 5, 2018

Conversation

stof
Copy link
Member

@stof stof commented Apr 4, 2018

The _instanceof and _defaults APIs have not equivalent for the low-level Definition API, as they are resource-scoped features and the low-level API does not have any concept of resource doing the definition.

registerForAutoconfiguration is totally unrelated to _instanceof. It is the partner of the autoconfigure API.

A valid replacement could be to use the new PHP DSL (which has equivalent features), but I don't think it is used anywhere in the DI documentation yet. And using it would require a policy about how to distinguish code blocks using the PHP DSL in a config file, and code blocks using the lower-level PHP API. So I kept this out of this PR, by only removing wrong doc.

The `_instanceof` and `_defaults` APIs have not equivalent for the low-level Definition API, as they are resource-scoped features and the low-level API does not have any concept of resource doing the definition.
@xabbuh xabbuh added this to the 3.4 milestone Apr 5, 2018
@javiereguiluz
Copy link
Member

Thanks Christophe.

@javiereguiluz javiereguiluz merged commit cbcbb43 into symfony:3.4 Apr 5, 2018
javiereguiluz added a commit that referenced this pull request Apr 5, 2018
This PR was merged into the 3.4 branch.

Discussion
----------

Remove faulty PHP code blocks

The `_instanceof` and `_defaults` APIs have not equivalent for the low-level Definition API, as they are resource-scoped features and the low-level API does not have any concept of resource doing the definition.

`registerForAutoconfiguration` is totally unrelated to `_instanceof`. It is the partner of the ` autoconfigure` API.

A valid replacement could be to use the new PHP DSL (which has equivalent features), but I don't think it is used anywhere in the DI documentation yet. And using it would require a policy about how to distinguish code blocks using the PHP DSL in a config file, and code blocks using the lower-level PHP API. So I kept this out of this PR, by only removing wrong doc.

Commits
-------

cbcbb43 Remove faulty PHP code blocks
@stof stof deleted the patch-1 branch March 16, 2021 16:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants