php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #76278 Categorization of get_headers and get_meta_tags
Submitted: 2018-04-27 17:06 UTC Modified: 2018-06-24 04:25 UTC
From: crazytonyi at gmail dot com Assigned:
Status: No Feedback Package: URL related
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: crazytonyi at gmail dot com
New email:
PHP Version: OS:

 

 [2018-04-27 17:06 UTC] 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.


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2018-04-28 00:01 UTC] requinix@php.net
-Status: Open +Status: Feedback -Package: Documentation problem +Package: URL related
 [2018-04-28 00:01 UTC] requinix@php.net
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."
 [2018-06-24 04:25 UTC] php-bugs at lists dot php dot net
No feedback was provided. The bug is being suspended because
we assume that you are no longer experiencing the problem.
If this is not the case and you are able to provide the
information that was requested earlier, please do so and
change the status of the bug back to "Re-Opened". Thank you.
 
PHP Copyright © 2001-2021 The PHP Group
All rights reserved.
Last updated: Wed Jul 28 11:01:24 2021 UTC