PhpDoc for return type for class constructors should be the class type.

[comanche]

PhpDoc for return type for class constructors should be the class type that's is being instantiated.

Example: return type for Blueprint's constructor should be Blueprint instead of void.
File: vendor/laravel/framework/src/Illuminate/Database/Schema/Blueprint.php

<?php namespace Illuminate\Database\Schema;

use Closure;
use Illuminate\Support\Fluent;
use Illuminate\Database\Connection;
use Illuminate\Database\Schema\Grammars\Grammar;

class Blueprint {

    /**
     * Create a new schema blueprint.
     *
     * @param  string   $table
     * @param  Closure  $callback
     * @return Blueprint (this was previously void)
     */
    public function __construct($table, Closure $callback = null)
    {
        $this->table = $table;

        if ( ! is_null($callback)) $callback($this);
    }
    //...
}

[taylorotwell]

Constructors don't have a return value?

[RSully]

According to the Wikipedia page for PHPDoc:

@return [type description] This tag should not be used for constructors or methods defined with a void return type.

However on phpdoc.org:

constructors, the @return tag MAY be omitted here, in which case @return self is implied.

[taylorotwell]

So, sounds like a PHPStorm problem. They should assume self on constructors, and they aren't.

[RSully]

@taylorotwell Well I think the problem is mixed. From what I can tell @return void would be incorrect as it should either be omitted or @return self. This is the first time I've actually seen the phpdoc website, but that is how I interpreted it.