Docs: Improve documentation for `WP_REST_Request` to highlight a caveat of ArrayAccess when it comes to passing similar arguments for multiple request methods.

Props danielbachhuber, DrewAPicture.
Fixes #35799.

Built from https://develop.svn.wordpress.org/trunk@36636


git-svn-id: http://core.svn.wordpress.org/trunk@36603 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2016-02-23 16:57:26 +00:00
parent 33048247c8
commit a0aa608970
2 changed files with 8 additions and 1 deletions

View File

@ -16,6 +16,13 @@
* used in that manner. It does not use ArrayObject (as we cannot rely on SPL), * used in that manner. It does not use ArrayObject (as we cannot rely on SPL),
* so be aware it may have non-array behaviour in some cases. * so be aware it may have non-array behaviour in some cases.
* *
* Note: When using features provided by ArrayAccess, be aware that WordPress deliberately
* does not distinguish between arguments of the same name for different request methods.
* For instance, in a request with `GET id=1` and `POST id=2`, `$request['id']` will equal
* 2 (`POST`) not 1 (`GET`). For more precision between request methods, use
* {@see WP_REST_Request::get_body_params()}, {@see WP_REST_Request::get_url_params()},
* etc.
*
* @since 4.4.0 * @since 4.4.0
* *
* @see ArrayAccess * @see ArrayAccess

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.5-alpha-36635'; $wp_version = '4.5-alpha-36636';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.