Home » Tools and Utilities » PhpDocumentor » Bug #7623

[2006-05-14 15:26 UTC] claus at webclaus dot com

Description:
------------
After upgrading my PHP from 5.1.2 to 5.1.4 my PhpDocumentor will no longer acknowledge my page level docblocks.

Test script:
---------------
Running PhpDocumentor on this test file fails:

<?php
/**
* @package MyPackage
*/
/**
* This brilliant class of mine
*
* @package MyPackage
*/
class Dummy {
function __construct() {
echo "I'm dummy\n";
}
}

?>

[2006-05-15 23:35 UTC] claus at webclaus dot com

Sorry about the version number. After experiencing this problem I upgraded to 1.3.0RC6, but the problem persisted. I believe I was using RC3 before that.

[2006-05-18 08:47 UTC] claus at webclaus dot com

Ok, well, I don't know what to tell you then. Running the following command on the test file:

phpdoc -f class.Dummy.php -t /tmp

Gives me this warning:

Reading file /usr/home/m2/dev/etc/class.Dummy.php -- Parsing file
WARNING in class.Dummy.php on line 0: File "/usr/home/m2/dev/etc/class.Dummy.php" has no page-level DocBlock, use @package in the first DocBlock to create one
done

If that can't be reproduced, do you have a tip to how I can debug my local environment? (which is clean freebsd with only port versions of php, and pear packages installed using the pear command line installer)

[2006-12-12 14:58 UTC] ashnazg at users dot sourceforge dot net

I am also unable to duplicate this problem, using v1.3.1 on PHP v5.1.6 via Cygwin.

Can you update your PhpDocumentor installation to v1.3.1 and see if the issue remains? If it does, I think someone will have to troubleshoot it directly on a FreeBSD install.

[2006-12-12 15:00 UTC] ashnazg at users dot sourceforge dot net

Then again, that "after upgrading my PHP" just caught my eye...

If v1.3.1 doesn't fix this for you, I'd try doing a fresh install of PHP (rather than upgrading versions) and see if that helps. I've seen more than one comment recently about people suspecting PHP problems due to issues with the upgrades themselves.