can't configure php to get docblock

[zordsdavini]

Installed doge via Plug. Tool itself works - tried with python but I can't get it working for php. Maybe there should be some additional installs? Thought about PhpDocumentor2 but DoGe didn't start working

[kkoomen]

Hi. Every language, besides C or C++, will work out-of-the-box without the use of third party. Only C and C++ require third ypart libs. You can simple do this:

function greet(string $name) {
  echo "Hello " . $name;
}

Keep your cursor at line 1 here and press <Leader>d. It should give you something like this:

/**
 * [TODO:description]
 *
 * @param string $name [TODO:description]
 * @return [TODO:type] [TODO:description]
 */
function greet(string $name) {
  echo "Hello " . $name;
}

[kkoomen]

If you can't get it to work, then I suggest you paste your code here you try to generate documentation for. Maybe you have found a scenario that doesn't generate properly.

[zordsdavini]

    public function koja(string $ggg): array
    {
        throw new \Exception('sfdsfdsds');
    }

I removed return type and it started working. Is there possibilities to show return type. And maybe there is example how template can be adjusted: I don't need all helper texts and params should be tabbed, space before return. And as I understand Exceptions are not shown, too

[zordsdavini]

the result what I want is

    /**
     * @param string $ggg
     * @param array  $a
     *
     * @return array
     * @throws \Exception
     */
    public function koja(string $ggg, array $a): array
    {
        throw new \Exception('sfdsfdsds');
    }

[kkoomen]

Ah, yeah, since a recent php 7 version it's possible to add return types, which hasn't been supported. I'll add support for this after #65 has been merged.

[kkoomen]

This feature has been merged and released in v2.1.0.

I've added support for PHP 7 return type declarations and PHP 8 proposed union types.

Feel free to submit any new issues if you experience any unwanted behavior in the future. Thanks for your contribution.