Skip to content

Commit b9f2970

Browse files
committed
docs: add notes
1 parent 9bf6793 commit b9f2970

1 file changed

Lines changed: 12 additions & 2 deletions

File tree

user_guide_src/source/incoming/incomingrequest.rst

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,12 @@ You can check the HTTP method that this request represents with the ``method()``
4343

4444
.. literalinclude:: incomingrequest/005.php
4545

46-
By default, the method is returned as a lower-case string (i.e., ``'get'``, ``'post'``, etc). You can get an
46+
By default, the method is returned as a lower-case string (i.e., ``'get'``, ``'post'``, etc).
47+
48+
.. note:: The functionality to convert the return value to lower case is deprecated.
49+
It will be removed in the future version, and this method will be PSR-7 equivalent.
50+
51+
You can get an
4752
uppercase version by wrapping the call in ``strtoupper()``::
4853

4954
// Returns 'GET'
@@ -57,7 +62,12 @@ Retrieving Input
5762
----------------
5863

5964
You can retrieve input from ``$_SERVER``, ``$_GET``, ``$_POST``, and ``$_ENV`` through the Request object.
60-
The data is not automatically filtered and returns the raw input data as passed in the request. The main
65+
The data is not automatically filtered and returns the raw input data as passed in the request.
66+
67+
.. note:: It is bad practice to use global variables. Basically, it should be avoided
68+
and it is recommended to use methods of the Request object.
69+
70+
The main
6171
advantages to using these methods instead of accessing them directly (``$_POST['something']``), is that they
6272
will return null if the item doesn't exist, and you can have the data filtered. This lets you conveniently
6373
use data without having to test whether an item exists first. In other words, normally you might do something

0 commit comments

Comments
 (0)