Doc #76278 [Opn->Fbk]: Categorization of get_headers and get_meta_tags
| From: | requinix@php.net | Date: | Sat, 28 Apr 2018 00:01:13 +0000 |
| Subject: | Doc #76278 [Opn->Fbk]: Categorization of get_headers and get_meta_tags | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-15629@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=76278&edit=1
ID: 76278
Updated by: requinix@php.net
Reported by: crazytonyi at gmail dot com
Summary: Categorization of get_headers and get_meta_tags
-Status: Open
+Status: Feedback
Type: Documentation Problem
-Package: Documentation problem
+Package: URL related
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
Here's all the sections:
http://php.net/manual/en/funcref.php
Can you see a better place for those functions to go in? I can't.
Saying that the only relation they have to URLs is that they expect on as their argument kinda
ignores the fact that the entire purpose of both of them is to provide information about the
resource/HTML page fetched from that URL. That's a really important aspect of their behavior to
gloss over.
How about just fixing the description on the introduction page?
http://php.net/manual/en/intro.url.php
"Dealing with URL strings: encoding, decoding and parsing."
Previous Comments:
------------------------------------------------------------------------
[2018-04-27 17:06:54] crazytonyi at gmail dot com
Description:
------------
---
From manual page: http://www.php.net/function.get-headers
From manual page: http://www.php.net/function.get-meta-tags
---
These are pretty nifty functions, but are currently listed under:
http://php.net/manual/en/ref.url.php
Is this really where they belong? I'm not sure what section of the documentation would be the
right home for them, but URLs isn't it. The functions don't manipulate or parse a URL
string, contribute to generating a URL, or have anything else relating to URLs other than they
expect a URL as their primary argument.
It isn't just a matter of "it's kind of weird that these functions are listed
here." I've actually never heard of them until today when someone referenced it in a SO
post. I thought "these are neat, how have I not noticed them before?" and then saw they
were under the URL function category. I'm pretty nerdy and will peruse function categories
looking for neat functions I might not use regularly, and thus these were essentially hidden because
I wouldn't really look for functions under URL functions that involve sending HTTP requests.
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=76278&edit=1