PHPDocumentor 2 and PHP 7 with opcache issues in Doctrine

Question

Hopefully someone here knows a thing or 2 about this.

Short Question

I am running into an error using phpdoc on the command line, installed via pear on PHP 7.0.2. The error is:

#> phpdoc
PHP Fatal error:  Uncaught Doctrine\Common\Annotations\AnnotationException: 
You have to enable opcache.load_comments=1 or zend_optimizerplus.load_comments=1. 
in /usr/local/php5-7.0.2-20160108-102134/lib/php/phpDocumentor/vendor/doctrine/annotations/lib/Doctrine/Common/Annotations/AnnotationException.php:193

How do I fix this error?

Details

Opcache is enabled and opcache.load_comments=1 is in my opcache.ini file, verified by using the commands: php -i | grep "Opcode" and php -i | grep "opcache" respectively. Within that .ini file I can verify that changes are loaded by checking enable and disable opcache via that file.

With that said, if I have opcache.load_comments=1 in my .ini file, why am I still getting this error?

Thanks!

Answer 1

I encountered the same problem while using the PHAR version of PHPDocumentor. The PHAR includes an obsolete version of Doctrine Annotations.

The older version of Annotations is referring to the opcache.load_comments setting in php.ini, which does not exist in PHP 7:

• Removed opcache.load_comments configuration directive.

This has been fixed upstream in Annotations:

• opcache.load_comments has been removed from PHP 7.

For now, using the composer version of PHPDocumentor by executing composer require --dev phpdocumentor/phpdocumentor resolved the problem for me.

Answer 2

You can also use composer without manually switching vendors directory contents. Just use:

composer require doctrine/annotations

to have the latest version of doctrine/annotations (at least 1.2.5 solves the problem)