php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #14339 no parse_str function on-site ???
Submitted: 2001-12-04 09:56 UTC Modified: 2001-12-04 14:14 UTC
From: sschmidt at strategyfirst dot com Assigned: hholzgra (profile)
Status: Closed Package: Documentation problem
PHP Version: 4.1.0 OS: irrelevant
Private report: No CVE-ID: None
 [2001-12-04 09:56 UTC] sschmidt at strategyfirst dot com
This is simple.

I know that the function "parse_str()" exists in PHP3 and PHP4.  It is supposed to parse a query string (of the style that is placed after a '?' on a url) and assign variables based on that string.

Anyway, it doesn't seem to exist on your website, and I've used that function many times...

Patches

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2001-12-04 10:12 UTC] hholzgra@php.net
you are right, it is undocumented yet ...

http://zugeschaut-und-mittgebaut.de/php/function.parse_str.html
 [2001-12-04 11:14 UTC] eschmid@php.net
This function is documented in the PHP Manual. You can verify this if you use your function tables at zend.com. It seems that the links at http://www.zugeschaut-und-mitgebaut.de/php/ are broken.
 [2001-12-04 11:18 UTC] derick@php.net
It's not in the manual. It's called parse_url. SO not a bug in the first place :)
 [2001-12-04 11:31 UTC] eschmid@php.net
Both functions are documented, parse_str() and parse_url().
 [2001-12-04 11:38 UTC] hholzgra@php.net
ok, i'm not able to read (or write the url for) my own pages :(

but the function *is* there and is something similar, but not  identical, to parse_url

see

http://zugeschaut-und-mitgebaut.de/php/function.parse_str.html

and 

http://zugeschaut-und-mitgebaut.de/php/function.parse_url.html


there is documentation for it in the manual source (and has been for ages), its in en/functions/string.xml, right between functions ord() and print(), but for some strange reason it does not show up in the online manual

right now i'm rebuilding a html manual from scratch on my local machine to further investigate this ...
 [2001-12-04 11:56 UTC] eschmid@php.net
Look at the two functions at http://zend.com/phpfunc/p.php. Both functions have valid links to the online manual.
 [2001-12-04 12:11 UTC] hholzgra@php.net
Egon, please ...
we are not talking about the Zend site, 
we are talking about the php.net site

feel free to close this report if you 
can show me http://php.net/parse_str or
http://php.net/manual/en/function.parse-str.php,
but i bet you won't be able to find any page
for parse_str in the annotated english online 
manual ...
 [2001-12-04 12:25 UTC] sander@php.net
It is in CVS (http://cvs.php.net/co.php/phpdoc/en/functions/strings.xml?r=1.128).
But not in the filelist in the build log (http://www.php.net/manual/en/build.log):
function.pack.php
function.parse-ini-file.php
function.parse-url.php
function.passthru.php
 [2001-12-04 12:26 UTC] eschmid@php.net
Look at the two functions at http://zend.com/phpfunc/p.php. Both functions have valid links to the online manual.
 [2001-12-04 12:39 UTC] hholzgra@php.net
Egon, these are links to the ZEND online manual!

Please stay on topic ...
 [2001-12-04 13:04 UTC] hholzgra@php.net
for some strange reason openjade totaly ignores
this function ... 
needs further investigation, but not today ... :(
 [2001-12-04 13:10 UTC] sschmidt at strategyfirst dot com
It never even occurred to me to try www.zend.com.

I've been spoiled by the semming user-friendliness at www.php.net (not to mention the easy to remember URL...) but I finally found the function in my print (paper) PHP book.

Who works on the www.php.net?  Anybody here who can just fix it?  Isn't it an obvious and easy thing to fix, if all the text is already on the Zend website?
 [2001-12-04 13:13 UTC] eschmid@php.net
Look at the two functions at http://zend.com/phpfunc/p.php. Both functions have valid links to the online manual.
 [2001-12-04 13:24 UTC] goba@php.net
I am one webmaster@php.net. I can say, that the problem is not at php.net, Jade our XML->HTML generator program cannot generate that function.parse-str.php named HTML file used in the online manual to show the documentation. This may be an undocumented thing in the Jade program. This is why this function is listed at zend.com and in the XML file, but not in the online manual at php.net.

Strange thing though that there is a 

http://www.zend.com/manual/function.parse-str.php

but no

http://www.php.net/manual/en/function.parse-str.php

I don't know how often the zend.com manual is updated,
but I think not that often as the php.net one (daily)...
 [2001-12-04 13:35 UTC] hholzgra@php.net
Egon: repeating off-topic facts doesn't help at all

both jade and openjade on my local system do not
generate the parse_str() page, to

and there are even more functions affected:

- iis_add_server
- iis_get_dir_security
- iis_get_script_map
- iis_get_server_by_comment
- iis_get_server_by_path
- iis_get_server_rights
- iis_remove_server
- iis_set_app_settings
- iis_set_dir_security
- iis_set_script_map
- iis_set_server_rights
- iis_start_server
- iis_start_service
- iis_stop_server
- iis_stop_service
- parse_str
- pcntl_fork
- pcntl_signal
- pcntl_waitpid
- pcntl_wexitstatus
- pcntl_wifexited
- pcntl_wifsignaled
- pcntl_wifstopped
- pcntl_wstopsig
- pcntl_wtermsig
- yp_err_string
- yp_errno

 [2001-12-04 13:36 UTC] eschmid@php.net
Sorry making traffic, it was only my stupid Windows ME.

There many people working for php.net. But the source of the PHP manual should be the same.

I have now looked over the history of en/functions/strings.xml and found only parse_str() but no parse_url(). Hartmut, could it possible, that you have branched out the parse_url() function :) If parse_str() isn?t visible in the online manual, we are using wrong tools. 

I know this is not a place to start discussions about books. Which book are you using? Please mail per PM to eschmid@php.net
 [2001-12-04 13:41 UTC] hholzgra@php.net
... :( 

forget about the iis_* functions (not documented)
and the pcntl_* stuff (documented but not included
in manual.xml)

but at least yp_errno and yp_err_string are definetly
missing
 [2001-12-04 13:43 UTC] goba@php.net
Erm, Hartmut you are actually not right...

iis and pcntl.xml is not added to manual.xml[.in], so they are not showing up, and those two yp functions are  ommented out in nis.xml with a comment that they are not existstent.

So the conclusion is that _only_ that parse_str is affected.

Maybe Jade has an undocumented feature called parse-str and it cant handle that id...

Sidenote: The IIS and PCNTL authors need to be asked whether they would like to put in their functions to manual.xml, or just playing some more before it is ready to be added... I don't know...
 [2001-12-04 13:48 UTC] derick@php.net
mmm, weird. It is generated in my daily builds. And the CHM manuals have it too...

Derick
 [2001-12-04 13:52 UTC] hholzgra@php.net
parse_url() is documented in url.xml, not string.xml

i have just scanned the openjade sources and the docbook
dsl stylesheets for 'parse_str' and 'parse-str' 
without results

as a sidenote: mb_parse_str shows up in the manual

but anyway, its to late, lack of concentration,
will be leaving now ...
 [2001-12-04 13:52 UTC] eschmid@php.net
I know both NIS functions doesn?t exist. So I have removed it in the documentation. If someone else have written the two missing functions, you can remove the comments in the documentation. IIRC it was Stephanie Wehner who wrote the code.
 [2001-12-04 13:54 UTC] derick@php.net
Even weirder... the other functions Hartmut mentioned are not in my builds.
 [2001-12-04 14:14 UTC] hholzgra@php.net
ok, blame me ... (have a look at the ord() example
and you'll see what's wrong)

fixed in CVS

 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Mon Sep 09 01:01:29 2024 UTC