Error while executing

[josesilva]

My phpdox.xml.dist content:

<?xml version="1.0" encoding="utf-8" ?>

<phpdox xmlns="http://phpdox.de/config">
 <project name="Ubibanking" source="." workdir="build/phpdox">
  <collector publiconly="false">
   <include mask="*.php" />
   <exclude mask="lib/vendor/*,plugins/*,cache/*,build/*" />
  </collector>

  <generator output="build">
   <build engine="html" enabled="true" output="api"/>
  </generator>

When executing, I get the following output:

jenkins@beubiServer:~/jobs/UbibankingPrepareJenkins/workspace$ phpdox 
phpdox 0.4.0 - Copyright (C) 2010 - 2012 by Arne Blankerts

[20.02.2012 - 10:46:00] Using config file '/var/lib/jenkins/jobs/UbibankingPrepareJenkins/workspace/phpdox.xml.dist'
[20.02.2012 - 10:46:00] Registered output engine 'html'
[20.02.2012 - 10:46:00] Registered output engine 'graph'
[20.02.2012 - 10:46:00] Registered output engine 'todo'
[20.02.2012 - 10:46:00] Registered output engine 'xslrunner'
[20.02.2012 - 10:46:00] Starting to process project 'Ubibanking'
[20.02.2012 - 10:46:00] Starting collector

..................................................  [50]
..................................................  [100]
..................................................  [150]
..................................................  [200]
..................................................  [250]
..................................................  [300]
..................................................  [350]
..................................................  [400]
..................................................  [450]
..................................................  [500]
..................................................  [550]
..................................................  [600]
..................................................  [650]
..................................................  [700]
..................................................  [750]
..................................................  [800]
..................................................  [850]
..................................................  [900]
..................................................  [950]
..................................................  [1000]
..................................................  [1050]
..................................................  [1100]
..................................................  [1150]
..................................................  [1200]
..................................................  [1250]
..................................................  [1300]
..................................................  [1350]
..................................................  [1400]
..................................................  [1450]
..................................................  [1500]
..................................................  [1550]
..................................................  [1600]
..................................................  [1650]
..................................................  [1700]
..................................................  [1750]
..................................................  [1800]
..................................................  [1850]
..................................................  [1900]
..................................................  [1950]
..................................................  [2000]
..................................................  [2050]
..................................................  [2100]
..................................................  [2150]
..................................................  [2200]
..................................................  [2250]
..................................................  [2300]
..................................................  [2350]
..................................ff..............  [2400]
..................................................  [2450]
..................................................  [2500]
..................................................  [2550]
..................................................  [2600]
..................................................  [2650]
.........f

Oups... phpDox encountered a problem and has terminated!
It most likely means you've found a bug, so please file a report for this and paste the stacktrace (if given) along!

Exception: TheSeer\phpDox\ClassBuilderException
Location: /usr/share/php/TheSeer/phpDox/collector/ClassBuilder.php (Line 127)

Processing DocBlock failed

#0 /usr/share/php/TheSeer/phpDox/collector/ClassBuilder.php(92): TheSeer\phpDox\ClassBuilder->processMethods()
#1 /usr/share/php/TheSeer/phpDox/collector/Analyser.php(114): TheSeer\phpDox\ClassBuilder->process()
#2 /usr/share/php/TheSeer/phpDox/collector/Analyser.php(85): TheSeer\phpDox\Analyser->handleClass()
#3 /usr/share/php/TheSeer/phpDox/collector/Collector.php(89): TheSeer\phpDox\Analyser->processFile()
#4 /usr/share/php/TheSeer/phpDox/Application.php(123): TheSeer\phpDox\Collector->run()
#5 /usr/share/php/TheSeer/phpDox/CLI.php(124): TheSeer\phpDox\Application->runCollector()
#6 /usr/bin/phpdox(62): TheSeer\phpDox\CLI->run()

[theseer]

Thank you for using phpDox and for reporting the issue.

It looks like your codebase contains a structure the DocBlock parser doesn't handle properly and thus fails hard. Since I don't have the source files triggering that behavior, it is quite hard to debug though.

Would it be possible for you to checkout the latest version of phpDox from github? It includes various changes and an enhanced error handling output which should allow to give a bit more of a detail what exactly happened. If you need a pear installable package, let me know and I'll provide one.

If the problem persists, it would be helpful if you could provide the code that triggers the crash.

[theseer]

No feedback provided - closing ticket.

[devtop]

I got same error, since annotation contains illegal blank between @ and return.

<?php
class foo
{
    /**
     * Exampel
     * @ return 
     */
    public function bar()
    {
    }
}

Installed version 0.4.0 - pear package. Currently I can not check github version.

phpdox 0.4.0 - Copyright (C) 2010 - 2012 by Arne Blankerts 

[10.05.2013 - 12:49:09] Using config file 'phpdox.xml' 
[10.05.2013 - 12:49:09] Registered output engine 'html' 
[10.05.2013 - 12:49:09] Registered output engine 'graph' 
[10.05.2013 - 12:49:09] Registered output engine 'todo' 
[10.05.2013 - 12:49:09] Registered output engine 'xslrunner' 
[10.05.2013 - 12:49:09] Starting to process project 'louis.de' 
[10.05.2013 - 12:49:09] Starting collector 

f 

Oups... phpDox encountered a problem and has terminated! 
It most likely means you've found a bug, so please file a report for this and paste the stacktrace (if given) along! 

Exception: TheSeer\phpDox\ClassBuilderException 
Location: /usr/share/php/TheSeer/phpDox/collector/ClassBuilder.php (Line 127) 

Processing DocBlock failed 

#0 /usr/share/php/TheSeer/phpDox/collector/ClassBuilder.php(92): TheSeer\phpDox\ClassBuilder->processMethods() 
#1 /usr/share/php/TheSeer/phpDox/collector/Analyser.php(114): TheSeer\phpDox\ClassBuilder->process() 
#2 /usr/share/php/TheSeer/phpDox/collector/Analyser.php(85): TheSeer\phpDox\Analyser->handleClass() 
#3 /usr/share/php/TheSeer/phpDox/collector/Collector.php(89): TheSeer\phpDox\Analyser->processFile() 
#4 /usr/share/php/TheSeer/phpDox/Application.php(123): TheSeer\phpDox\Collector->run() 
#5 /usr/share/php/TheSeer/phpDox/CLI.php(124): TheSeer\phpDox\Application->runCollector() 
#6 /usr/bin/phpdox(62): TheSeer\phpDox\CLI->run() 

[theseer]

Please upgrade to Version 0.5.0 and reopen this ticket in case the problem persists