php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #33045 reflection api is not documented
Submitted: 2005-05-17 08:54 UTC Modified: 2019-06-28 11:36 UTC
Votes:3
Avg. Score:4.3 ± 0.9
Reproduced:2 of 3 (66.7%)
Same Version:0 (0.0%)
Same OS:0 (0.0%)
From: cweiske at cweiske dot de Assigned:
Status: Open Package: Reflection related
PHP Version: Irrelevant OS: any
Private report: No CVE-ID: None
View Add Comment Developer Edit
Have you experienced this issue?
Rate the importance of this bug to you:

 [2005-05-17 08:54 UTC] cweiske at cweiske dot de 
Description:
------------
The reflection api is not documented in a way that makes it easy for extension developers to support parameter reflection in their extensions.

I wrote a small howto which covers this:
http://www.cweiske.de/howto/hackingphp5/Hacking.html

Just contact me if you want the docbook sources.

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2005-05-17 16:07 UTC] nlopess@php.net 
In fact, we don't have any documentation that can help extension developers..
Although it would be good to have a developers' manual, it doesn't exist. And we will not document this in the main manual.
 [2005-05-17 19:35 UTC] wez@php.net 
We *do* have other extension developer docs.
Someone might document the reflection API related features someday.
 [2009-03-30 10:51 UTC] cweiske@php.net 
Docbook sources: http://tmp.cweiske.de/HackingPHP5.xml
 [2016-06-29 17:28 UTC] cmb@php.net
-Status: Suspended +Status: Feedback -Assigned To: +Assigned To: cmb
 [2016-06-29 17:28 UTC] cmb@php.net 
> Docbook sources: http://tmp.cweiske.de/HackingPHP5.xml

404 Not found.
 [2016-06-29 18:15 UTC] cweiske@php.net 
I've restored the file.
 [2016-06-29 18:33 UTC] cmb@php.net 
> I've restored the file.

Thanks. Having had a quick glance at the file, it seems to be a
good addition to "PHP at the Core: A Hacker's Guide"[1]. To do so
would require to transfer the copyright to the "PHP Documentation
Group" and to change the license to CC BY 3.0[2]. Would you agree
to do so?

[1] <http://php.net/manual/en/internals2.php>
[2] <http://php.net/manual/en/copyright.php>
 [2016-06-29 18:41 UTC] cweiske@php.net 
Yes, I agree to the license change and copyright transfer.
 [2016-06-29 19:02 UTC] cmb@php.net
-Status: Feedback +Status: Verified -Package: Documentation problem +Package: Reflection related
 [2016-06-29 19:02 UTC] cmb@php.net 
> Yes, I agree to the license change and copyright transfer.

Thanks. Will include the doc ASAP.
 [2017-10-24 05:26 UTC] kalle@php.net
-Status: Verified +Status: Assigned
 [2019-06-28 11:36 UTC] cmb@php.net
-Status: Assigned +Status: Open -Assigned To: cmb +Assigned To:
 [2019-06-28 11:36 UTC] cmb@php.net 
Well, since quite a while I don't think it makes sense to add
internals documentation to the PHP manual, because there is
insufficient man power to maintain what's already there.  In my
opinion, out-dated documentation is worse than no documentation.

Unassigning myself, so that perhaps somebody else will take this
to <http://www.phpinternalsbook.com/> or somewhere else, where it
can be maintained.

Thanks!
 
PHP Copyright © 2001-2020 The PHP Group
All rights reserved. 		Last updated: Fri Aug 14 21:01:24 2020 UTC