正在生成所有其他文件的文档，但对于 src/Pagination/Paginator.php，它不是。这是一个 Symfony 4 应用程序。
相关的错误是：
error: Line 0: No summary was found for this file
没有总结？那是错误的。该文件在结构上似乎与其他文件没有什么不同。文件的 DocBlock 和每个类的 DocBlock。看一看：
<?php
/**
* This file is part of DevDungeon.
*
* Copyright 2019 <my_name>.
*
* DevDungeon is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with DevDungeon. If not, see <https://www.gnu.org/licenses/>.
*/
namespace App\Pagination;
use Doctrine\ORM\QueryBuilder as DoctrineQueryBuilder;
use Doctrine\ORM\Tools\Pagination\CountWalker;
use Doctrine\ORM\Tools\Pagination\Paginator as DoctrinePaginator;
/**
* This class defines the pagination logic.
*/
class Paginator
{
/**
* @var int The number of items displayed on a single page
*/
private const PAGE_SIZE = 10;
(...)
当浏览生成的文档时，Paginator 类就不见了。走了。这里发生了什么？
我在 Windows 系统上使用 PHAR 文件。它位于项目的根目录，就在 src/ 之外。GraphViz 是后来手动安装的。
这是我使用的命令：
php phpDocumentor.phar -d src/ -t docs/
这是输出：
Collecting files .. OK
Initializing parser .. OK
Parsing files
Parsing C:\wamp64\www\devdungeon\src\Controller\BlogController.php
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
No summary for method __construct()
No summary for property $session
Parsing C:\wamp64\www\devdungeon\src\Entity\Post.php
Parse Error: Syntax error, unexpected '?' on line 91 No summary was found for t
his file
Parsing C:\wamp64\www\devdungeon\src\Form\PostType.php
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
No summary for method __construct()
No summary for method buildForm()
Parsing C:\wamp64\www\devdungeon\src\Kernel.php
Parse Error: Syntax error, unexpected T_CONST, expecting T_FUNCTION on line 35
No summary was found for this file
Parsing C:\wamp64\www\devdungeon\src\Migrations\Version20190724140200.php
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
No summary for method getDescription()
Argument $schema is missing from the Docblock of up
No summary for method up()
Argument $schema is missing from the Docblock of down
No summary for method down()
Parsing C:\wamp64\www\devdungeon\src\Migrations\Version20190727112301.php
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
No summary for method getDescription()
Argument $schema is missing from the Docblock of up
No summary for method up()
Argument $schema is missing from the Docblock of down
No summary for method down()
Parsing C:\wamp64\www\devdungeon\src\Pagination\Paginator.php
Parse Error: Syntax error, unexpected T_CONST, expecting T_FUNCTION on line 35
No summary was found for this file
Parsing C:\wamp64\www\devdungeon\src\Repository\PostRepository.php
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
No summary for method __construct()
Parsing C:\wamp64\www\devdungeon\src\Validator\Constraints\ContainsSlug.php
No summary for class \App\Validator\Constraints\ContainsSlug
Parsing C:\wamp64\www\devdungeon\src\Validator\Constraints\ContainsSlugValidator
.php
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Warning: count(): Parameter must be an array or an object that implements Counta
ble in phar://C:/wamp64/www/devdungeon/phpDocumentor.phar/src/phpDocumentor/Plug
in/Core/Descriptor/Validator/Constraints/Functions/IsArgumentInDocBlockValidator
.php on line 33
Storing cache in "C:\wamp64\www\devdungeon\docs" .. OK
Load cache .. 0.006s
Preparing template "clean" .. 0.007s
Preparing 17 transformations .. 0.000s
Build "elements" index .. 0.000s
Replace textual FQCNs with object aliases .. 0.001s
Resolve @link and @see tags in descriptions .. 0.001s
Enriches inline example tags with their sources .. 0.000s
Build "packages" index .. 0.001s
Build "namespaces" index and add namespaces to "elements" .. 0.000s
Collect all markers embedded in tags .. 0.000s
Transform analyzed project into artifacts ..
Applying 17 transformations
Initialize writer "phpDocumentor\Plugin\Core\Transformer\Writer\FileIo"
Initialize writer "phpDocumentor\Plugin\Twig\Writer\Twig"
Initialize writer "phpDocumentor\Plugin\Graphs\Writer\Graph"
Execute transformation using writer "FileIo"
Execute transformation using writer "FileIo"
Execute transformation using writer "FileIo"
Execute transformation using writer "FileIo"
Execute transformation using writer "FileIo"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "twig"
Execute transformation using writer "Graph"
0.543s
Analyze results and write report to log .. 0.000s