Skip to content

Body parameters are the parsed body.#23

Merged
pmjones merged 2 commits intophp-fig:masterfrom
weierophinney:feature/parsed-body
Feb 13, 2015
Merged

Body parameters are the parsed body.#23
pmjones merged 2 commits intophp-fig:masterfrom
weierophinney:feature/parsed-body

Conversation

@weierophinney
Copy link
Copy Markdown
Contributor

This PR syncs the repo with the changes specified in php-fig/fig-standards#429

Per conversations with @Crell, @ircmaxell, @pmjones, and several others, the
body parameters are always the parsed body content; calling them out as such,
and without the "parameters" verbiage, implies that parsing may create non-array
values, which is exceptionally likely when working with API and/or
non-form-encoded payloads.

Moreover, the content will always be specific to the incoming request, so
supporting one method representing POST and another representing parsed content
is redundant and potentially confusing.

Finally, considering the fact that the parsed body is an ambiguous domain,
forcing an ubiquitous signature is an unnecessary and limiting constraint.

However, IF the request method is POST, AND the Content-Type is
application/x-www-form-urlencoded, THEN the parsed body MUST be
equivalent to $_POST.

Per conversations with @Crell, @ircmaxell, @pmjones, and several others, the
body parameters are always the parsed body content; calling them out as such,
and without the "parameters" verbiage, implies that parsing may create non-array
values, which is exceptionally likely when working with API and/or
non-form-encoded payloads.

Moreover, the content will always be specific to the incoming request, so
supporting one method representing POST and another representing parsed content
is redundant and potentially confusing.

Finally, considering the fact that the parsed body is an ambiguous domain,
forcing an ubiquitous signature is an unnecessary and limiting constraint.

However, IF the request method is POST, AND the Content-Type is
application/x-www-form-urlencoded, THEN the parsed body MUST be
equivalent to $_POST.
@weierophinney
Copy link
Copy Markdown
Contributor Author

@pmjones Please merge after php-fig/fig-standards#429, and tag as 0.9.0 with the message "Use the verbiage 'parsed body' instead of 'body params'".

pmjones pushed a commit that referenced this pull request Feb 13, 2015
Body parameters are the parsed body.
@pmjones pmjones merged commit 4727540 into php-fig:master Feb 13, 2015
@weierophinney weierophinney deleted the feature/parsed-body branch March 1, 2015 20:43
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