Singleton code complete and methods

创建于 2011年12月09日 22:22

We are using singleton classes in our projects called by using getInstance.  IE:

class whatever {
    public static function getInstance($config = '') {
        if (!(self::$_instance instanceof self)) {
            self::$_instance = new self($config);
        }

        return self::$_instance;
    }

    public function do() {
       return true;
    }
}

whatever::getInstance(array('db'=>'something'))->do();

The problem is that is appears phpStorm doesn't know how that they are a class inside the project and thus we cannot do code complete or method jumps or anything else with them.  Its sort of annoying.  Is there a way around this?  Some way to manually point them? Am I missing something?

3 条评论

Andriy Bazanov

创建于 2011年12月09日 22:55

Hi Bryan,

Based on your example: Add appropriate PHPDoc comments, e.g.

class ClassWhatever
{

    /**
     * @param array|string $config
     * @return ClassWhatever
     */
    public static function getInstance($config = '')
    {

        if (!(self::$_instance instanceof self)) {

            self::$_instance = new self($config);
        }

        return self::$_instance;
    }

    /**
     * @return bool
     */
    public function doThis()
    {
       return true;
    }
}

ClassWhatever::getInstance(array('db'=>'something'))->doThis();

But speaking in general -- have a look at these related tickets:

Bryan Heath

创建于 2011年12月09日 23:13

Ah, my problem was I was just being generic and saying instance and not the class name. THANK YOU! That has been annoying me for months.

Permanently deleted user

创建于 2011年12月14日 07:52

I noticed that having a @return <TYPE> breaks it if the type is not correct.
And the auto generated DocBlock ends up mixed when it should be object.

eg.
* @return mixed whatever  BROKEN

* @return whatever  WORKS
* @return object whatever  WORKS

Just thought it was worth mentioning as this can be a bit decieving as it is picky in that the TYPE either has to be correct or not present.

请先登录再写评论。