PhpDoc 生成警告答案

【问题标题】：PhpDoc generating warningPhpDoc 生成警告
【发布时间】：2018-11-26 11:23:06
【问题描述】：

以下文档中生成的警告消息是文档内所有方法中看到的消息。

警告：count()：参数必须是在 C:\php72\pear\phpDocumentor\vendor\twig\twig\lib\Twig\Extension\Core.php 中实现 Countable 的数组或对象，第 1198 行警告： count()：参数必须是数组或对象，在 C:\php72\pear\phpDocumentor\vendor\twig\twig\lib\Twig\Extension\Core.php 1198行enter image description here中实现Countable@

【问题讨论】：

请分享代码
它是一个 phpdoc pear 包。因为它将 core.php 显示为导致此警告的行。我会在这里发布文件。我不能在这里发布完整的代码。找到导致问题的代码。函数 twig_length_filter(Twig_Environment $env, $thing) { return is_scalar($thing) ？ mb_strlen($thing, $env->getCharset()) : count($thing); }

标签： warnings messages phpdoc

【解决方案1】：

我为纠正同样的错误付出了很多努力，所以我希望在这里分享完整的解决方案：要更改什么以及如何编辑 phar 文件：

将此脚本复制到您的 phar 文件夹中的一个文件中，并使用 php 命令行运行它，并在代码中指定选项：

<?php
//to be run with php -d phar.readonly=Off -f thisFileName 
if (ini_get('phar.readonly')==1){
    die("\n\nThis script must be run with option -d phar.readonly=Off so that it can write the .phar file\n\n"); 
}

//the file you want to change
$file = 'vendor/twig/twig/lib/Twig/Extension/Core.php';

//the function in the file you want to change
$oldFunction = '#function twig_length_filter[^{]*[^}]*}#'; //assuming it's still the actual one line function, regex might need updates in the furure

//the replacement function
$newFunction = <<<'funct'
function twig_length_filter(Twig_Environment $env, $thing)
    {
        if (null === $thing) {
        return 0;
        }
        if (is_scalar($thing)) {
            return mb_strlen($thing, $env->getCharset());
        }
        if (is_object($thing) && method_exists($thing, '__toString') && !$thing instanceof \Countable) {
            return mb_strlen((string) $thing, $env->getCharset());
        }
        if ($thing instanceof \Countable || is_array($thing)) {
            return count($thing);
        }
        return 1;
    }
funct;

//access the phar
$p = new Phar('phpDocumentor.phar', FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::KEY_AS_FILENAME);
//extract the file
$p->extractTo('./', $file, true);

//return here if you want to check the file first
//return;

//change the function 
file_put_contents($file,
    $newFile = preg_replace(
            $oldFunction, 
            $newFunction, 
            file_get_contents($file)
        )
    );

//update the file
$p[$file] = $file;

//done
echo 'Done. Don\'t forget to delete the "vendor" folder extracted from the phar !';

【讨论】：

【解决方案2】：

好的，找到了解决方案。

查看链接 https://area51.phpbb.com/phpBB/viewtopic.php?t=52691

更改了 core.php 文件中的函数

    /**
 * Returns the length of a variable.
 *
 * @param Twig_Environment $env
 * @param mixed            $thing A variable
 *
 * @return int The length of the value
 */
function twig_length_filter(Twig_Environment $env, $thing)
{
    if (is_scalar($thing)) {
        return mb_strlen($thing, $env->getCharset());
    }

    if (is_object($thing) && method_exists($thing, '__toString') && !$thing instanceof \Countable) {
        return mb_strlen((string) $thing, $env->getCharset());
    }

    return count($thing);
}

关注

/**
 * Returns the length of a variable.
 *
 * @param Twig_Environment $env
 * @param mixed            $thing A variable
 *
 * @return int The length of the value
 */
function twig_length_filter(Twig_Environment $env, $thing)
{
    if (null === $thing) {
        return 0;
    }
    if (is_scalar($thing)) {
        return mb_strlen($thing, $env->getCharset());
    }
    if (is_object($thing) && method_exists($thing, '__toString') && !$thing instanceof \Countable) {
        return mb_strlen((string) $thing, $env->getCharset());
    }
    if ($thing instanceof \Countable || is_array($thing)) {
        return count($thing);
    }
    return 1;
}

【讨论】：