Merge pull request #615 from nthachus/1.11

Update to release v1.11.7

.gitignore

@@ -1,3 +1,3 @@
 /vendor
 composer.lock
-.idea
+.idea/

.travis.yml

@@ -0,0 +1,26 @@
+language: php
+php:
+  - 5.4
+  - 5.5
+  - 5.6
+  - hhvm
+
+matrix:
+  include:
+    - php: 5.3
+      dist: precise
+  allow_failures:
+    - php: hhvm
+  fast_finish: true
+
+cache:
+  directories:
+    - vendor
+    - $HOME/.composer/cache
+
+before_script:
+  - travis_retry composer self-update
+  - travis_retry composer install --no-interaction --no-suggest --no-progress
+
+script:
+  - vendor/bin/phpunit

composer.json

@@ -11,14 +11,18 @@
     ],
     "require": {
         "php": ">=5.3.0",
+        "illuminate/config": "4.x",
         "illuminate/support": "4.x",
         "illuminate/console": "4.x",
         "illuminate/filesystem": "4.x",
-        "phpdocumentor/reflection-docblock": "2.0.x",
+        "illuminate/database": "4.x",
+        "illuminate/view": "4.x",
+        "phpdocumentor/reflection-docblock": "^2.0.4",
         "symfony/class-loader": "~2.3"
     },
     "require-dev": {
-        "doctrine/dbal": "~2.3"
+        "doctrine/dbal": "~2.3",
+        "phpunit/phpunit": "~4.0"
     },
     "suggest": {
         "doctrine/dbal": "Load information from the database about models for phpdocs (~2.3)"

phpunit.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/4.0/phpunit.xsd"
+         backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false">
+    <testsuites>
+        <testsuite name="Package Test Suite">
+            <directory suffix=".php">./tests/</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

provides.json

@@ -1,5 +1,5 @@
 {
   "providers": [
-    "Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider"
+    "Barryvdh\\LaravelIdeHelper\\IdeHelperServiceProvider"
   ]
-}
+}

readme.md

@@ -1,46 +1,77 @@
 ## Laravel IDE Helper Generator
 [![Latest Stable Version](https://poser.pugx.org/barryvdh/laravel-ide-helper/version.png)](https://packagist.org/packages/barryvdh/laravel-ide-helper) [![Total Downloads](https://poser.pugx.org/barryvdh/laravel-ide-helper/d/total.png)](https://packagist.org/packages/barryvdh/laravel-ide-helper)
 
+### For Laravel 5, check the [2.0 branch](https://github.com/barryvdh/laravel-ide-helper)
+
 ### Complete phpDocs, directly from the source
 
 _Checkout [this Laracasts video](https://laracasts.com/series/how-to-be-awesome-in-phpstorm/episodes/15) for a quick introduction/explanation!_
 
-This packages generates a file that your IDE can understand, so it can provide accurate autocompletion. Generation is done, based on the files in your project, so they are alway up-to-date.
+This packages generates a file that your IDE can understand, so it can provide accurate autocompletion. Generation is done, based on the files in your project, so they are always up-to-date.
 If you don't want to generate it, you can add a pre-generated file to the root folder of your laravel project. (But this isn't as up-to-date as self generated files)
 
 * Generated version: https://gist.github.com/barryvdh/5227822
 
 Note: You do need CodeIntel for Sublime Text: https://github.com/SublimeCodeIntel/SublimeCodeIntel
 
+### New: PhpStorm Meta for Container instances
+
+It's possible to generate a PhpStorm meta file, to [add support for factory design pattern](https://confluence.jetbrains.com/display/PhpStorm/PhpStorm+Advanced+Metadata). For Laravel, this means we can make PhpStorm understand what kind of object we are resolving from the IoC Container. For example, `events` will return ann `Illuminate\Events\Dispatcher` object, so with the meta file you can call `app('events')` and it will autocomplete the Dispatcher methods.
+
+```bash
+php artisan ide-helper:meta
+```
+```php
+app('events')->fire();
+\App::make('events')->fire();
+
+/** @var \Illuminate\Foundation\Application $app */
+$app->make('events')->fire();
+```
+
+Pre-generated example: https://gist.github.com/barryvdh/bb6ffc5d11e0a75dba67
+
+> Note: You might need to restart PhpStorm and make sure `.phpstorm.meta.php` is indexed.
+
 ### Automatic phpDoc generation for Laravel Facades
 
-Require this package in your composer.json and run composer update (or run `composer require barryvdh/laravel-ide-helper:1.*` directly):
+Require this package with composer using the following command:
 
-    "barryvdh/laravel-ide-helper": "1.*"
+```bash
+composer require barryvdh/laravel-ide-helper ~1.11
+```
 
-After updating composer, add the ServiceProvider to the providers array in app/config/app.php
+After updating composer, add the ServiceProvider to the providers array in `app/config/app.php`
 
-    'Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider',
+```php
+'Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider',
+```
 
 You can now re-generate the docs yourself (for future updates) in artisan
 
-    php artisan ide-helper:generate
+```bash
+php artisan ide-helper:generate
+```
 
 Note: bootstrap/compiled.php has to be cleared first, so run `php artisan clear-compiled` before generating (and `php artisan optimize` after..)
 
 You can configure your composer.json to do this after each commit:
 
-    "scripts":{
+```json
-        "post-update-cmd":[
+"scripts":{
-            "php artisan clear-compiled",
+    "post-update-cmd":[
-            "php artisan ide-helper:generate",
+        "php artisan clear-compiled",
-            "php artisan optimize",
+        "php artisan ide-helper:generate",
-        ]
+        "php artisan optimize"
-    },
+    ]
+},
+```
 
 You can also publish the config-file to change implementations (ie. interface to specific class) or set defaults for --helpers or --sublime.
 
-    php artisan config:publish barryvdh/laravel-ide-helper
+```bash
+php artisan config:publish barryvdh/laravel-ide-helper
+```
 
 The generator tries to identify the real class, but if it cannot be found, you can define it in the config file.
 
@@ -50,10 +81,9 @@ You can use a in-memory sqlite driver, using the -M option.
 You can choose to include helper files. This is not enabled by default, but you can override this with the --helpers (-H) option.
 The Illuminate/Support/helpers.php is already set-up, but you can add/remove your own files in the config file.
 
-
 ### Automatic phpDocs for Models
 
-> **Note:** Since v1.10 you need to require `doctrine/dbal: ~2.3` in your own composer.json. 
+> **Note:** Since v1.10 you need to require `doctrine/dbal: ~2.3` in your own composer.json.
 
 If you don't want to write your properties yourself, you can use the command `ide-helper:models` to generate
 phpDocs, based on table columns, relations and getters/setters. You can write the comments directly to your Model file, using the `--write (-W)` option. By default, you are asked to overwrite or write to a separate file (\_ide\_helper\_models.php) (You can force No with `--nowrite (-N)`).
@@ -61,34 +91,43 @@ Please make sure to backup your models, before writing the info.
 It should keep the existing comments and only append new properties/methods. The existing phpdoc is replaced, or added if not found.
 With the `--reset (-R)` option, the existing phpdocs are ignored, only the newly found columns/relations are saved as phpdocs.
 
-    php artisan ide-helper:models Post
+```bash
-
+php artisan ide-helper:models Post
-    /**
+```
-     * An Eloquent Model: 'Post'
+```php
-     *
+/**
-     * @property integer $id
+ * An Eloquent Model: 'Post'
-     * @property integer $author_id
+ *
-     * @property string $title
+ * @property integer $id
-     * @property string $text
+ * @property integer $author_id
-     * @property \Carbon\Carbon $created_at
+ * @property string $title
-     * @property \Carbon\Carbon $updated_at
+ * @property string $text
-     * @property-read \User $author
+ * @property \Carbon\Carbon $created_at
-     * @property-read \Illuminate\Database\Eloquent\Collection|\Comment[] $comments
+ * @property \Carbon\Carbon $updated_at
-     */
+ * @property-read \User $author
+ * @property-read \Illuminate\Database\Eloquent\Collection|\Comment[] $comments
+ */
+```
 
 By default, models in app/models are scanned. The optional argument tells what models to use (also outside app/models).
 
-    php artisan ide-helper:models Post User
+```bash
+php artisan ide-helper:models Post User
+```
 
 You can also scan a different directory, using the --dir option (relative from the base path):
 
-    php artisan ide-helper:models --dir="app/workbench/name/package/models" --dir="app/src/Model"
+```bash
-   
+php artisan ide-helper:models --dir="app/workbench/name/package/models" --dir="app/src/Model"
+```
+
 You can publish the config file (`php artisan config:publish barryvdh/laravel-ide-helper`) and set the default directories.
 
 Models can be ignored using the --ignore (-I) option
 
-    php artisan ide-helper:models --ignore="Post,User"
+```bash
+php artisan ide-helper:models --ignore="Post,User"
+```
 
 Note: With namespaces, wrap your model name in " signs: `php artisan ide-helper:models "API\User"`, or escape the slashes (`Api\\User`)
 

src/Alias.php

@@ -1,275 +1,287 @@
-<?php
+<?php
-/**
+/**
- * Laravel IDE Helper Generator
+ * Laravel IDE Helper Generator
- *
+ *
- * @author    Barry vd. Heuvel <[email protected]>
+ * @author    Barry vd. Heuvel <[email protected]>
- * @copyright 2014 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
+ * @copyright 2014 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
+ * @license   http://www.opensource.org/licenses/mit-license.php MIT
- * @link      https://github.com/barryvdh/laravel-ide-helper
+ * @link      https://github.com/barryvdh/laravel-ide-helper
- */
+ */
-
+
-namespace Barryvdh\LaravelIdeHelper;
+namespace Barryvdh\LaravelIdeHelper;
-
+
-class Alias
+class Alias
-{
+{
-
+    protected $alias;
-    protected $alias;
+    protected $facade;
-    protected $facade;
+    protected $extends = null;
-    protected $extends = null;
+    protected $classType = 'class';
-    protected $classType = 'class';
+    protected $short;
-    protected $namespace = '__root';
+    protected $namespace = '__root';
-    protected $root = null;
+    protected $root = null;
-    protected $classes = array();
+    protected $classes = array();
-    protected $methods = array();
+    protected $methods = array();
-    protected $usedMethods = array();
+    protected $usedMethods = array();
-    protected $valid = false;
+    protected $valid = false;
-    protected $magicMethods = array();
+    protected $magicMethods = array();
-    protected $interfaces = array();
+    protected $interfaces = array();
-
+
-    /**
+    /**
-     * @param string $alias
+     * @param string $alias
-     * @param string $facade
+     * @param string $facade
-     * @param array $magicMethods
+     * @param array $magicMethods
-     * @param array $interfaces
+     * @param array $interfaces
-     */
+     */
-    public function __construct($alias, $facade, $magicMethods = array(), $interfaces = array())
+    public function __construct($alias, $facade, $magicMethods = array(), $interfaces = array())
-    {
+    {
-        $this->alias = $alias;
+        $this->alias = $alias;
-        $this->magicMethods = $magicMethods;
+        $this->magicMethods = $magicMethods;
-        $this->interfaces = $interfaces;
+        $this->interfaces = $interfaces;
-
+
-        // Make the class absolute
+        // Make the class absolute
-        $facade = '\\' . ltrim($facade, '\\');
+        $facade = '\\' . ltrim($facade, '\\');
-        $this->facade = $facade;
+        $this->facade = $facade;
-
+
-
+        $this->detectRoot();
-        $this->detectRoot();
+
-
+        if ((!$this->isTrait() && $this->root)) {
-        if ((!$this->isTrait() && $this->root)) {
+            $this->valid = true;
-            $this->valid = true;
+        } else {
-        } else {
+            return;
-            return;
+        }
-        }
+
-
+        $this->addClass($this->root);
-        $this->addClass($this->root);
+        $this->detectNamespace();
-        $this->detectNamespace();
+        $this->detectClassType();
-        $this->detectClassType();
+
-
+        if ($facade === '\Illuminate\Database\Eloquent\Model') {
-
+            $this->usedMethods = array('decrement', 'increment');
-    }
+        }
-
+    }
-    /**
+
-     * Add one or more classes to analyze
+    /**
-     *
+     * Add one or more classes to analyze
-     * @param array|string $classes
+     *
-     */
+     * @param array|string $classes
-    public function addClass($classes)
+     */
-    {
+    public function addClass($classes)
-        $classes = (array)$classes;
+    {
-        foreach ($classes as $class) {
+        $classes = (array)$classes;
-            if (class_exists($class) || interface_exists($class)) {
+        foreach ($classes as $class) {
-                $this->classes[] = $class;
+            if (class_exists($class) || interface_exists($class)) {
-            }else{
+                $this->classes[] = $class;
-                echo "Class not exists: $class\r\n";
+            } else {
-            }
+                $this->error('Class not exists: ' . $class);
-        }
+            }
-    }
+        }
-
+    }
-    /**
+
-     * Check if this class is valid to process.
+    /**
-     * @return bool
+     * Check if this class is valid to process.
-     */
+     * @return bool
-    public function isValid()
+     */
-    {
+    public function isValid()
-        return $this->valid;
+    {
-    }
+        return $this->valid;
-
+    }
-    /**
+
-     * Get the classtype, 'interface' or 'class'
+    /**
-     *
+     * Get the classType, 'interface' or 'class'
-     * @return string
+     *
-     */
+     * @return string
-    public function getClasstype()
+     */
-    {
+    public function getClassType()
-        return $this->classType;
+    {
-    }
+        return $this->classType;
-
+    }
-    /**
+
-     * Get the class which this alias extends
+    /**
-     *
+     * Get the class which this alias extends
-     * @return null|string
+     *
-     */
+     * @return null|string
-    public function getExtends()
+     */
-    {
+    public function getExtends()
-        return $this->extends;
+    {
-    }
+        return $this->extends;
-
+    }
-    /**
+
-     * Get the Alias by which this class is called
+    /**
-     *
+     * Get the Alias by which this class is called
-     * @return string
+     *
-     */
+     * @return string
-    public function getAlias()
+     */
-    {
+    public function getAlias()
-        return $this->alias;
+    {
-    }
+        return $this->alias;
-
+    }
-    /**
+
-     * Get the namespace from the alias
+    /**
-     *
+     * Return the short name (without namespace)
-     * @return string
+     *
-     */
+     * @return string
-    public function getNamespace()
+     */
-    {
+    public function getShortName()
-        return $this->namespace;
+    {
-    }
+        return $this->short;
-
+    }
-    /**
+
-     * Get the methods found by this Alias
+    /**
-     *
+     * Get the namespace from the alias
-     * @return array
+     *
-     */
+     * @return string
-    public function getMethods()
+     */
-    {
+    public function getNamespace()
-        $this->addMagicMethods();
+    {
-        $this->detectMethods();
+        return $this->namespace;
-        return $this->methods;
+    }
-    }
+
-
+    /**
-    /**
+     * Get the methods found by this Alias
-     * Detect the namespace
+     *
-     */
+     * @return array|Method[]
-    protected function detectNamespace()
+     */
-    {
+    public function getMethods()
-        if (strpos($this->alias, '\\')) {
+    {
-            $nsParts = explode('\\', $this->alias);
+        $this->addMagicMethods();
-            $this->short = array_pop($nsParts);
+        $this->detectMethods();
-            $this->namespace = implode('\\', $nsParts);
+        return $this->methods;
-        }
+    }
-    }
+
-
+    /**
-    /**
+     * Detect the namespace
-     * Detect the class type
+     */
-     */
+    protected function detectNamespace()
-    protected function detectClassType()
+    {
-    {
+        if (strpos($this->alias, '\\')) {
-        //Some classes extend the facade
+            $nsParts = explode('\\', $this->alias);
-        if (interface_exists($this->facade)) {
+            $this->short = array_pop($nsParts);
-            $this->classType = 'interface';
+            $this->namespace = implode('\\', $nsParts);
-            $this->extends = $this->facade;
+        } else {
-        } else {
+            $this->short = $this->alias;
-            $this->classType = 'class';
+        }
-            if (class_exists($this->facade)) {
+    }
-                $this->extends = $this->facade;
+
-            }
+    /**
-        }
+     * Detect the class type
-    }
+     */
-
+    protected function detectClassType()
-    /**
+    {
-     * Get the real root of a facade
+        //Some classes extend the facade
-     *
+        if (interface_exists($this->facade)) {
-     * @return bool|string
+            $this->classType = 'interface';
-     */
+            $this->extends = $this->facade;
-    protected function detectRoot()
+        } else {
-    {
+            $this->classType = 'class';
-        $facade = $this->facade;
+            if (class_exists($this->facade)) {
-
+                $this->extends = $this->facade;
-        try {
+            }
-            //If possible, get the facade root
+        }
-            if (method_exists($facade, 'getFacadeRoot')) {
+    }
-                $root = get_class($facade::getFacadeRoot());
+
-            } else {
+    /**
-                $root = $facade;
+     * Get the real root of a facade
-            }
+     *
-
+     * @return bool|string
-            //If it doesn't exist, skip it
+     */
-            if (!class_exists($root) && !interface_exists($root)) {
+    protected function detectRoot()
-                return;
+    {
-            }
+        $facade = $this->facade;
-
+
-            $this->root = $root;
+        try {
-
+            //If possible, get the facade root
-            //When the database connection is not set, some classes will be skipped
+            if (method_exists($facade, 'getFacadeRoot')) {
-        } catch (\PDOException $e) {
+                $root = get_class($facade::getFacadeRoot());
-            $this->error(
+            } else {
-                "PDOException: " . $e->getMessage() . "\nPlease configure your database connection correctly, or use the sqlite memory driver (-M). Skipping $facade."
+                $root = $facade;
-            );
+            }
-        } catch (\Exception $e) {
+
-            $this->error("Exception: " . $e->getMessage() . "\nSkipping $facade.");
+            //If it doesn't exist, skip it
-        }
+            if (!class_exists($root) && !interface_exists($root)) {
-    }
+                return;
-
+            }
-    /**
+
-     * Detect if this class is a trait or not.
+            $this->root = $root;
-     *
+
-     * @return bool
+            //When the database connection is not set, some classes will be skipped
-     */
+        } catch (\PDOException $e) {
-    protected function isTrait()
+            $this->error(
-    {
+                'PDOException: ' . $e->getMessage() . "\nPlease configure your database connection correctly, or use the sqlite memory driver (-M). Skipping $facade."
-        // Check if the facade is not a Trait
+            );
-        if (function_exists('trait_exists') && trait_exists($this->facade)) {
+        } catch (\Exception $e) {
-            return true;
+            $this->error('Exception: ' . $e->getMessage() . "\nSkipping $facade.");
-        }
+        }
-        return false;
+    }
-    }
+
-
+    /**
-    /**
+     * Detect if this class is a trait or not.
-     * Add magic methods, as defined in the configuration files
+     *
-     */
+     * @return bool
-    protected function addMagicMethods()
+     */
-    {
+    protected function isTrait()
-        foreach($this->magicMethods as $magic => $real){
+    {
-            list($className, $name) = explode('::', $real);
+        // Check if the facade is not a Trait
-            if(!class_exists($className) && !interface_exists($className)){
+        if (function_exists('trait_exists') && trait_exists($this->facade)) {
-                continue;
+            return true;
-            }
+        }
-            $method = new \ReflectionMethod($className, $name);
+        return false;
-            $class = new \ReflectionClass($className);
+    }
-
+
-            if(!in_array($method->name, $this->usedMethods)){
+    /**
-                if($class !== $this->root){
+     * Add magic methods, as defined in the configuration files
-                    $this->methods[] = new Method($method, $this->alias, $class, $magic, $this->interfaces);
+     */
-                }
+    protected function addMagicMethods()
-                $this->usedMethods[] = $magic;
+    {
-            }
+        foreach ($this->magicMethods as $magic => $real) {
-        }
+            list($className, $name) = explode('::', $real);
-    }
+            if (!class_exists($className) && !interface_exists($className)) {
-
+                continue;
-    /**
+            }
-     * Get the methods for one or multiple classes.
+            $method = new \ReflectionMethod($className, $name);
-     *
+            $class = new \ReflectionClass($className);
-     * @return string
+
-     */
+            if (!in_array($method->name, $this->usedMethods)) {
-    protected function detectMethods()
+                if ($class !== $this->root) {
-    {
+                    $this->methods[] = new Method($method, $this->alias, $class, $magic, $this->interfaces);
-
+                }
-        foreach ($this->classes as $class) {
+                $this->usedMethods[] = $magic;
-            $reflection = new \ReflectionClass($class);
+            }
-
+        }
-            $methods = $reflection->getMethods(\ReflectionMethod::IS_PUBLIC);
+    }
-            if ($methods) {
+
-                foreach ($methods as $method) {
+    /**
-                    if (!in_array($method->name, $this->usedMethods)) {
+     * Get the methods for one or multiple classes.
-                        // Only add the methods to the output when the root is not the same as the class.
+     *
-                        // And don't add the __*() methods
+     * @return string
-                        if ($this->extends !== $class && $method->name !== '__clone') {
+     */
-                            $this->methods[] = new Method($method, $this->alias, $reflection, $method->name, $this->interfaces);
+    protected function detectMethods()
-                        }
+    {
-                        $this->usedMethods[] = $method->name;
+        foreach ($this->classes as $class) {
-                    }
+            $reflection = new \ReflectionClass($class);
-                }
+
-            }
+            $methods = $reflection->getMethods(\ReflectionMethod::IS_PUBLIC);
-        }
+            if ($methods) {
-    }
+                foreach ($methods as $method) {
-
+                    if (!in_array($method->name, $this->usedMethods)) {
-    /**
+                        // Only add the methods to the output when the root is not the same as the class.
-     * Output an error.
+                        // And don't add the __*() methods
-     *
+                        if ($this->extends !== $class && substr($method->name, 0, 2) !== '__') {
-     * @param  string  $string
+                            $this->methods[] = new Method($method, $this->alias, $reflection, $method->name, $this->interfaces);
-     * @return void
+                        }
-     */
+                        $this->usedMethods[] = $method->name;
-    protected function error($string)
+                    }
-    {
+                }
-        echo $string . "\r\n";
+            }
-    }
+        }
-}
+    }
+
+    /**
+     * Output an error.
+     *
+     * @param  string $string
+     * @return void
+     */
+    protected function error($string)
+    {
+        echo $string . "\r\n";
+    }
+}

src/Console/GeneratorCommand.php

@@ -17,7 +17,6 @@ use Illuminate\Filesystem\Filesystem;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Input\InputArgument;
 
-
 /**
  * A command to generate autocomplete information for your IDE
  *
@@ -27,16 +26,12 @@ class GeneratorCommand extends Command
 {
 
     /**
-     * The console command name.
+     * {@inheritdoc}
-     *
-     * @var string
      */
     protected $name = 'ide-helper:generate';
 
     /**
-     * The console command description.
+     * {@inheritdoc}
-     *
-     * @var string
      */
     protected $description = 'Generate a new IDE Helper file.';
 
@@ -51,18 +46,14 @@ class GeneratorCommand extends Command
 
     protected $onlyExtend;
 
-
     /**
+     * {@inheritdoc}
      *
      * @param \Illuminate\Config\Repository $config
      * @param \Illuminate\Filesystem\Filesystem $files
      * @param \Illuminate\View\Factory $view
      */
-    public function __construct(
+    public function __construct(ConfigRepository $config, Filesystem $files, $view) {
-        ConfigRepository $config,
-        Filesystem $files, /* Illuminate\View\Factory */
-        $view
-    ) {
         $this->config = $config;
         $this->files = $files;
         $this->view = $view;
@@ -82,12 +73,19 @@ class GeneratorCommand extends Command
             );
         } else {
             $filename = $this->argument('filename');
+            $format = $this->option('format');
+
+            // Strip the php extension
+            if (substr($filename, -4, 4) == '.php') {
+                $filename = substr($filename, 0, -4);
+            }
+
+            $filename .= '.' . $format;
 
             if ($this->option('memory')) {
                 $this->useMemoryDriver();
             }
 
-
             $helpers = '';
             if ($this->option('helpers') || ($this->config->get('laravel-ide-helper::include_helpers'))) {
                 foreach ($this->config->get('laravel-ide-helper::helper_files', array()) as $helper) {
@@ -100,7 +98,7 @@ class GeneratorCommand extends Command
             }
 
             $generator = new Generator($this->config, $this->view, $this->getOutput(), $helpers);
-            $content = $generator->generate();
+            $content = $generator->generate($format);
             $written = $this->files->put($filename, $content);
 
             if ($written !== false) {
@@ -125,33 +123,31 @@ class GeneratorCommand extends Command
     }
 
     /**
-     * Get the console command arguments.
+     * {@inheritdoc}
-     *
-     * @return array
      */
     protected function getArguments()
     {
+        $filename = $this->config->get('laravel-ide-helper::filename');
+
         return array(
             array(
-                'filename',
+                'filename', InputArgument::OPTIONAL, 'The path to the helper file', $filename
-                InputArgument::OPTIONAL,
-                'The path to the helper file',
-                $this->config->get('laravel-ide-helper::filename')
             ),
         );
     }
 
     /**
-     * Get the console command options.
+     * {@inheritdoc}
-     *
-     * @return array
      */
     protected function getOptions()
     {
+        $format = $this->config->get('laravel-ide-helper::format');
+
         return array(
-            array('helpers', "H", InputOption::VALUE_NONE, 'Include the helper files'),
+            array('format', 'F', InputOption::VALUE_OPTIONAL, 'The format for the IDE Helper', $format),
-            array('memory', "M", InputOption::VALUE_NONE, 'Use sqlite memory driver'),
+            array('helpers', 'H', InputOption::VALUE_NONE, 'Include the helper files'),
-            array('sublime', "S", InputOption::VALUE_NONE, 'DEPRECATED: Use different style for SublimeText CodeIntel'),
+            array('memory', 'M', InputOption::VALUE_NONE, 'Use sqlite memory driver'),
+            array('sublime', 'S', InputOption::VALUE_NONE, 'DEPRECATED: Use different style for SublimeText CodeIntel'),
         );
     }
 

src/Console/MetaCommand.php

@@ -0,0 +1,140 @@
+<?php
+/**
+ * Laravel IDE Helper Generator
+ *
+ * @author    Barry vd. Heuvel <[email protected]>
+ * @copyright 2015 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
+ * @license   http://www.opensource.org/licenses/mit-license.php MIT
+ * @link      https://github.com/barryvdh/laravel-ide-helper
+ */
+
+namespace Barryvdh\LaravelIdeHelper\Console;
+
+use Illuminate\Console\Command;
+use Symfony\Component\Console\Input\InputOption;
+
+/**
+ * A command to generate phpstorm meta data
+ *
+ * @author Barry vd. Heuvel <[email protected]>
+ * @property \Illuminate\Container\Container $laravel
+ */
+class MetaCommand extends Command {
+
+    /**
+     * {@inheritdoc}
+     */
+    protected $name = 'ide-helper:meta';
+    protected $filename = '.phpstorm.meta.php';
+
+    /**
+     * {@inheritdoc}
+     */
+    protected $description = 'Generate metadata for PhpStorm';
+
+    /** @var \Illuminate\Filesystem\Filesystem */
+    protected $files;
+
+    /** @var \Illuminate\View\Factory */
+    protected $view;
+
+    protected $methods = array(
+        //'\Illuminate\Foundation\Application::make',
+        'new \Illuminate\Container\Container',
+        '\Illuminate\Container\Container::make',
+        '\App::make',
+        'app',
+    );
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param \Illuminate\Container\Container $app
+     */
+    public function __construct($app)
+    {
+        $this->laravel = $app;
+        $this->files = $app['files'];
+        $this->view = $app['view'];
+        parent::__construct();
+    }
+
+    /**
+     * Execute the console command.
+     *
+     * @return void
+     */
+    public function fire()
+    {
+        $bindings = array_flip($this->getAppAliases());
+        $exclude = $this->option('exclude');
+        if (!empty($exclude)) {
+            $exclude = '/' . str_replace('\|', '|', preg_quote($exclude, '/')) . '/';
+        }
+
+        foreach ($this->getAbstracts() as $abstract) {
+            if (!empty($exclude) && preg_match($exclude, $abstract))
+                continue;
+
+            try {
+                $concrete = $this->laravel->make($abstract);
+                if (is_object($concrete)) {
+                    $bindings[$abstract] = get_class($concrete);
+                }
+            } catch (\Exception $e) {
+                $this->error("Cannot make $abstract: " . $e->getMessage());
+            }
+        }
+        asort($bindings);
+
+        $content = $this->view->make('laravel-ide-helper::meta', array(
+            'bindings' => $bindings,
+            'methods' => $this->methods,
+        ))->render();
+
+        $filename = $this->option('filename');
+        $written = $this->files->put($filename, $content);
+
+        if ($written !== false) {
+            $this->info("A new meta file was written to $filename");
+        } else {
+            $this->error("The meta file could not be created at $filename");
+        }
+    }
+
+    /**
+     * Get a list of abstracts from the Laravel Application.
+     *
+     * @return array
+     */
+    protected function getAbstracts()
+    {
+        return array_keys($this->laravel->getBindings());
+    }
+
+    /**
+     * Get a list of aliases from the Laravel Application.
+     *
+     * @return array
+     */
+    protected function getAppAliases()
+    {
+        static $aliasProp;
+        if (!isset($aliasProp)) {
+            $aliasProp = new \ReflectionProperty('Illuminate\Container\Container', 'aliases');
+            $aliasProp->setAccessible(true);
+        }
+        return $aliasProp->getValue($this->laravel);
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function getOptions()
+    {
+        return array(
+            array('filename', 'F', InputOption::VALUE_OPTIONAL, 'The path to the meta file', $this->filename),
+            array('exclude', 'E', InputOption::VALUE_OPTIONAL, 'Laravel bindings to exclude (e.g. "bar.|.foo")'),
+        );
+    }
+}

src/Console/ModelsCommand.php

@@ -18,28 +18,24 @@ use Symfony\Component\ClassLoader\ClassMapGenerator;
 use phpDocumentor\Reflection\DocBlock;
 use phpDocumentor\Reflection\DocBlock\Context;
 use phpDocumentor\Reflection\DocBlock\Tag;
-use phpDocumentor\Reflection\DocBlock\Serializer as DocBlockSerializer;
 
 /**
  * A command to generate autocomplete information for your IDE
  *
  * @author Barry vd. Heuvel <[email protected]>
+ * @property \Illuminate\Container\Container $laravel
  */
 class ModelsCommand extends Command
 {
 
     /**
-     * The console command name.
+     * {@inheritdoc}
-     *
-     * @var string
      */
     protected $name = 'ide-helper:models';
     protected $filename = '_ide_helper_models.php';
 
     /**
-     * The console command description.
+     * {@inheritdoc}
-     *
-     * @var string
      */
     protected $description = 'Generate autocompletion for models';
 
@@ -49,6 +45,20 @@ class ModelsCommand extends Command
     protected $dirs = array();
     protected $reset;
 
+    /** @var \Illuminate\Filesystem\Filesystem */
+    protected $files;
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param \Illuminate\Container\Container $app
+     */
+    public function __construct($app)
+    {
+        $this->laravel = $app;
+        $this->files = $app['files'];
+        parent::__construct();
+    }
 
     /**
      * Execute the console command.
@@ -69,10 +79,7 @@ class ModelsCommand extends Command
 
         //If filename is default and Write is not specified, ask what to do
         if (!$this->write && $filename === $this->filename && !$this->option('nowrite')) {
-            if ($this->confirm(
+            if ($this->confirm("Do you want to overwrite the existing model files? Choose no to write to $filename instead? (Yes/No): ")) {
-                "Do you want to overwrite the existing model files? Choose no to write to $filename instead? (Yes/No): "
-            )
-            ) {
                 $this->write = true;
             }
         }
@@ -80,7 +87,7 @@ class ModelsCommand extends Command
         $content = $this->generateDocs($model, $ignore);
 
         if (!$this->write) {
-            $written = \File::put($filename, $content);
+            $written = $this->files->put($filename, $content);
             if ($written !== false) {
                 $this->info("Model information was written to $filename");
             } else {
@@ -89,11 +96,8 @@ class ModelsCommand extends Command
         }
     }
 
-
     /**
-     * Get the console command arguments.
+     * {@inheritdoc}
-     *
-     * @return array
      */
     protected function getArguments()
     {
@@ -103,9 +107,7 @@ class ModelsCommand extends Command
     }
 
     /**
-     * Get the console command options.
+     * {@inheritdoc}
-     *
-     * @return array
      */
     protected function getOptions()
     {
@@ -121,8 +123,6 @@ class ModelsCommand extends Command
 
     protected function generateDocs($loadModels, $ignore = '')
     {
-
-
         $output = "<?php
 /**
  * An helper file for your Eloquent Models
@@ -150,8 +150,6 @@ class ModelsCommand extends Command
             if (in_array($name, $ignore)) {
                 $this->comment("Ignoring model '$name'");
                 continue;
-            } else {
-                $this->comment("Loading model '$name'");
             }
             $this->properties = array();
             $this->methods = array();
@@ -159,41 +157,41 @@ class ModelsCommand extends Command
                 try {
                     // handle abstract classes, interfaces, ...
                     $reflectionClass = new \ReflectionClass($name);
-                    if (!$reflectionClass->IsInstantiable()) {
+
-                        throw new \Exception($name . ' is not instanciable.');
+                    if (!$reflectionClass->isSubclassOf('Illuminate\Database\Eloquent\Model')) {
-                    } elseif (!$reflectionClass->isSubclassOf('Illuminate\Database\Eloquent\Model')) {
-                        $this->comment("Class '$name' is not a model");
                         continue;
                     }
 
-                    $model = new $name();
+                    $this->comment("Loading model '$name'");
+
+                    if (!$reflectionClass->isInstantiable()) {
+                        throw new \Exception($name . ' is not instantiable.');
+                    }
+
+                    $model = $this->laravel->make($name);
+
                     if ($hasDoctrine) {
                         $this->getPropertiesFromTable($model);
                     }
+
                     $this->getPropertiesFromMethods($model);
                     $output .= $this->createPhpDocs($name);
                 } catch (\Exception $e) {
-                    $this->error("Exception: " . $e->getMessage() . "\nCould not analyze class $name.");
+                    $this->error('Exception: ' . $e->getMessage() . "\nCould not analyze class $name.");
                 }
-            } elseif (interface_exists($name) || (function_exists('trait_exists') && trait_exists($name))) {
-                $this->info("Skipping interface/trait $name");
-            } else {
-                $this->error("Class $name does not exist");
             }
 
         }
 
         if (!$hasDoctrine) {
             $this->error(
-                "Warning: 'doctrine/dbal: ~2.3' is required to load database information. Please require that in your composer.json and run 'composer update'."
+                'Warning: `"doctrine/dbal": "~2.3"` is required to load database information. Please require that in your composer.json and run `composer update`.'
             );
         }
 
         return $output;
-
     }
 
-
     protected function loadModels()
     {
         $models = array();
@@ -256,10 +254,10 @@ class ModelsCommand extends Command
                     }
                 }
 
-
+                $comment = $column->getComment();
-                $this->setProperty($name, $type, true, true);
+                $this->setProperty($name, $type, true, true, $comment);
                 $this->setMethod(
-                    Str::camel("where_" . $name),
+                    Str::camel('where_' . $name),
                     '\Illuminate\Database\Query\Builder|\\' . get_class($model),
                     array('$value')
                 );
@@ -275,21 +273,13 @@ class ModelsCommand extends Command
         $methods = get_class_methods($model);
         if ($methods) {
             foreach ($methods as $method) {
-                if (Str::startsWith($method, 'get') && Str::endsWith(
+                if (Str::startsWith($method, 'get') && Str::endsWith($method, 'Attribute') && $method !== 'getAttribute') {
-                        $method,
-                        'Attribute'
-                    ) && $method !== 'getAttribute'
-                ) {
                     //Magic get<name>Attribute
                     $name = Str::snake(substr($method, 3, -9));
                     if (!empty($name)) {
                         $this->setProperty($name, null, true, null);
                     }
-                } elseif (Str::startsWith($method, 'set') && Str::endsWith(
+                } elseif (Str::startsWith($method, 'set') && Str::endsWith($method, 'Attribute') && $method !== 'setAttribute') {
-                        $method,
-                        'Attribute'
-                    ) && $method !== 'setAttribute'
-                ) {
                     //Magic set<name>Attribute
                     $name = Str::snake(substr($method, 3, -9));
                     if (!empty($name)) {
@@ -321,22 +311,14 @@ class ModelsCommand extends Command
                     $begin = strpos($code, 'function(');
                     $code = substr($code, $begin, strrpos($code, '}') - $begin + 1);
 
-                    foreach (array(
+                    foreach (array('hasMany', 'belongsToMany', 'hasOne', 'belongsTo', 'morphTo', 'morphMany', 'morphToMany') as $relation) {
-                                 'hasMany',
-                                 'belongsToMany',
-                                 'hasOne',
-                                 'belongsTo',
-                                 'morphTo',
-                                 'morphMany',
-                                 'morphToMany'
-                             ) as $relation) {
                         $search = '$this->' . $relation . '(';
                         if ($pos = stripos($code, $search)) {
                             $code = substr($code, $pos + strlen($search));
-                            $arguments = explode(',', substr($code, 0, stripos($code, ')')));
+                            $arguments = explode(',', substr($code, 0, strpos($code, ');')));
                             //Remove quotes, ensure 1 \ in front of the model
-                            $returnModel = "\\" . ltrim(trim($arguments[0], " \"'"), "\\");
+                            $returnModel = $this->getClassName($arguments[0], $model);
-                            if ($relation === "belongsToMany" or $relation === 'hasMany' or $relation === 'morphMany' or $relation === 'morphToMany') {
+                            if ($relation === 'belongsToMany' or $relation === 'hasMany' or $relation === 'morphMany' or $relation === 'morphToMany') {
                                 //Collection or array of models (because Collection is Arrayable)
                                 $this->setProperty(
                                     $method,
@@ -361,14 +343,16 @@ class ModelsCommand extends Command
      * @param string|null $type
      * @param bool|null $read
      * @param bool|null $write
+     * @param string|null $comment
      */
-    protected function setProperty($name, $type = null, $read = null, $write = null)
+    protected function setProperty($name, $type = null, $read = null, $write = null, $comment = '')
     {
         if (!isset($this->properties[$name])) {
             $this->properties[$name] = array();
             $this->properties[$name]['type'] = 'mixed';
             $this->properties[$name]['read'] = false;
             $this->properties[$name]['write'] = false;
+            $this->properties[$name]['comment'] = (string)$comment;
         }
         if ($type !== null) {
             $this->properties[$name]['type'] = $type;
@@ -396,10 +380,9 @@ class ModelsCommand extends Command
      */
     protected function createPhpDocs($class)
     {
-
         $reflection = new \ReflectionClass($class);
         $namespace = $reflection->getNamespaceName();
-        $classname = $reflection->getShortName();
+        $className = $reflection->getShortName();
         $originalDoc = $reflection->getDocComment();
 
         if ($this->reset) {
@@ -415,10 +398,11 @@ class ModelsCommand extends Command
         $properties = array();
         $methods = array();
         foreach ($phpdoc->getTags() as $tag) {
+            /* @var Tag|Tag\PropertyTag|Tag\MethodTag $tag */
             $name = $tag->getName();
-            if ($name == "property" || $name == "property-read" || $name == "property-write") {
+            if ($name == 'property' || $name == 'property-read' || $name == 'property-write') {
                 $properties[] = $tag->getVariableName();
-            } elseif ($name == "method") {
+            } elseif ($name == 'method') {
                 $methods[] = $tag->getMethodName();
             }
         }
@@ -435,7 +419,7 @@ class ModelsCommand extends Command
             } else {
                 $attr = 'property-read';
             }
-            $tag = Tag::createInstance("@{$attr} {$property['type']} {$name}", $phpdoc);
+            $tag = Tag::createInstance("@{$attr} {$property['type']} {$name} {$property['comment']}", $phpdoc);
             $phpdoc->appendTag($tag);
         }
 
@@ -444,51 +428,50 @@ class ModelsCommand extends Command
                 continue;
             }
             $arguments = implode(', ', $method['arguments']);
-            $tag = Tag::createInstance("@method static {$method['type']} {$name}({$arguments}) ", $phpdoc);
+            $tag = Tag::createInstance("@method static {$method['type']} {$name}({$arguments})", $phpdoc);
             $phpdoc->appendTag($tag);
         }
 
-        $serializer = new DocBlockSerializer();
+        $serializer = new DocBlock\Serializer();
         $serializer->getDocComment($phpdoc);
         $docComment = $serializer->getDocComment($phpdoc);
 
-
         if ($this->write) {
             $filename = $reflection->getFileName();
-            $contents = \File::get($filename);
+            $contents = $this->files->get($filename);
             if ($originalDoc) {
                 $contents = str_replace($originalDoc, $docComment, $contents);
             } else {
-                $needle = "class {$classname}";
+                $needle = "class {$className}";
-                $replace = "{$docComment}\nclass {$classname}";
+                $replace = "{$docComment}\nclass {$className}";
                 $pos = strpos($contents, $needle);
                 if ($pos !== false) {
                     $contents = substr_replace($contents, $replace, $pos, strlen($needle));
                 }
             }
-            if (\File::put($filename, $contents)) {
+            if ($this->files->put($filename, $contents)) {
                 $this->info('Written new phpDocBlock to ' . $filename);
             }
         }
 
-        $output = "namespace {$namespace}{\n{$docComment}\n\tclass {$classname} {}\n}\n\n";
+        $output = "namespace {$namespace}{\n{$docComment}\n\tclass {$className} {}\n}\n\n";
         return $output;
     }
 
     /**
      * Get the parameters and format them correctly
      *
-     * @param $method
+     * @param \ReflectionMethod $method
      * @return array
      */
     public function getParameters($method)
     {
-        //Loop through the default values for paremeters, and make the correct output string
+        //Loop through the default values for parameters, and make the correct output string
-        $params = array();
         $paramsWithDefault = array();
+
         foreach ($method->getParameters() as $param) {
             $paramStr = '$' . $param->getName();
-            $params[] = $paramStr;
+
             if ($param->isOptional()) {
                 $default = $param->getDefaultValue();
                 if (is_bool($default)) {
@@ -506,7 +489,28 @@ class ModelsCommand extends Command
             }
             $paramsWithDefault[] = $paramStr;
         }
+
         return $paramsWithDefault;
     }
 
+    /**
+     * @param string $className
+     * @param \Illuminate\Database\Eloquent\Model $model
+     * @return string
+     */
+    private function getClassName($className, $model)
+    {
+        // If the class name was resolved via get_class($this) or static::class
+        if (strpos($className, 'get_class($this)') !== false || strpos($className, 'static::class') !== false) {
+            return get_class($model);
+        }
+
+        // If the class name was resolved via ::class (PHP 5.5+)
+        if (strpos($className, '::class') !== false) {
+            $end = -1 * strlen('::class');
+            return substr($className, 0, $end);
+        }
+
+        return '\\' . ltrim(trim($className, ' "\''), '\\');
+    }
 }

src/Generator.php

@@ -1,196 +1,245 @@
-<?php
+<?php
-/**
+/**
- * Laravel IDE Helper Generator
+ * Laravel IDE Helper Generator
- *
+ *
- * @author    Barry vd. Heuvel <[email protected]>
+ * @author    Barry vd. Heuvel <[email protected]>
- * @copyright 2014 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
+ * @copyright 2014 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
+ * @license   http://www.opensource.org/licenses/mit-license.php MIT
- * @link      https://github.com/barryvdh/laravel-ide-helper
+ * @link      https://github.com/barryvdh/laravel-ide-helper
- */
+ */
-
+
-namespace Barryvdh\LaravelIdeHelper;
+namespace Barryvdh\LaravelIdeHelper;
-
+
-use Illuminate\Foundation\AliasLoader;
+use /** @noinspection PhpUndefinedNamespaceInspection,PhpUndefinedClassInspection */Illuminate\Foundation\AliasLoader;
-use Illuminate\Config\Repository as ConfigRepository;
+use Illuminate\Config\Repository as ConfigRepository;
-use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
-
+
-class Generator
+class Generator
-{
+{
-    /** @var \Illuminate\Config\Repository */
+    /** @var \Illuminate\Config\Repository */
-    protected $config;
+    protected $config;
-
+
-    /** @var \Illuminate\View\Factory */
+    /** @var \Illuminate\View\Factory */
-    protected $view;
+    protected $view;
-
+
-    /** @var \Symfony\Component\Console\Output\OutputInterface */
+    /** @var \Symfony\Component\Console\Output\OutputInterface */
-    protected $output;
+    protected $output;
-
+
-    protected $extra = array();
+    protected $extra = array();
-    protected $magic = array();
+    protected $magic = array();
-    protected $interfaces = array();
+    protected $interfaces = array();
-    protected $helpers;
+    protected $helpers;
-
+
-    /**
+    /**
-     * @param \Illuminate\Config\Repository $config
+     * @param \Illuminate\Config\Repository $config
-     * @param \Illuminate\View\Factory $view
+     * @param \Illuminate\View\Factory $view
-     * @param \Symfony\Component\Console\Output\OutputInterface $output
+     * @param \Symfony\Component\Console\Output\OutputInterface $output
-     * @param string $helpers
+     * @param string $helpers
-     */
+     */
-    public function __construct(ConfigRepository $config,
+    public function __construct(ConfigRepository $config, $view, OutputInterface $output = null, $helpers = '')
-        /* Illuminate\View\Factory */ $view,
+    {
-        OutputInterface $output = null,
+        $this->config = $config;
-        $helpers = ''
+        $this->view = $view;
-    ) {
+
-        $this->config = $config;
+        // Find the drivers to add to the extra/interfaces
-        $this->view = $view;
+        $this->detectDrivers();
-
+
-        // Find the drivers to add to the extra/interfaces
+        $this->extra = array_merge($this->extra, $this->config->get('laravel-ide-helper::extra'));
-        $this->detectDrivers();
+        $this->magic = array_merge($this->magic, $this->config->get('laravel-ide-helper::magic'));
-
+        $this->interfaces = array_merge($this->interfaces, $this->config->get('laravel-ide-helper::interfaces'));
-        $this->extra = array_merge($this->extra, $this->config->get('laravel-ide-helper::extra'));
+
-        $this->magic = array_merge($this->magic, $this->config->get('laravel-ide-helper::magic'));
+        // Make all interface classes absolute
-        $this->interfaces = array_merge($this->interfaces, $this->config->get('laravel-ide-helper::interfaces'));
+        foreach ($this->interfaces as &$interface) {
-        $this->helpers = $helpers;
+            $interface = '\\' . ltrim($interface, '\\');
-    }
+        }
-
+        $this->helpers = $helpers;
-    /**
+    }
-     * Generate the helper file contents;
+
-     *
+    /**
-     * @return string;
+     * Generate the helper file contents;
-     */
+     *
-    public function generate()
+     * @param  string $format The format to generate the helper in (php/json)
-    {
+     * @return string;
-        $app = app();
+     */
-        return $this->view->make('laravel-ide-helper::ide-helper')
+    public function generate($format = 'php')
-            ->with('namespaces', $this->getNamespaces())
+    {
-            ->with('helpers', $this->helpers)
+        // Check if the generator for this format exists
-            ->with('version', $app::VERSION)
+        $method = 'generate' . ucfirst($format) . 'Helper';
-            ->render();
+        if (method_exists($this, $method)) {
-    }
+            return $this->$method();
-
+        }
-    protected function detectDrivers()
+
-    {
+        return $this->generatePhpHelper();
-        try{
+    }
-            if (class_exists('Auth')) {
+
-                $class = get_class(\Auth::driver());
+    public function generatePhpHelper()
-                $this->extra['Auth'] = array($class);
+    {
-                $this->interfaces['\Illuminate\Auth\UserProviderInterface'] = $class;
+        $app = app();
-            }
+        return $this->view->make('laravel-ide-helper::ide-helper')
-        }catch (\Exception $e) {}
+            ->with('namespaces', $this->getNamespaces())
-
+            ->with('helpers', $this->helpers)
-        try{
+            ->with('version', $app::VERSION)
-            if (class_exists('DB')) {
+            ->render();
-                $class = get_class(\DB::connection());
+    }
-                $this->extra['DB'] = array($class);
+
-                $this->interfaces['\Illuminate\Database\ConnectionInterface'] = $class;
+    public function generateJsonHelper()
-            }
+    {
-        }catch (\Exception $e) {}
+        $classes = array();
-
+        foreach ($this->getNamespaces() as $aliases) {
-        try{
+            foreach ($aliases as $alias) {
-            if (class_exists('Cache')) {
+                $functions = array();
-                $driver = get_class(\Cache::driver());
+                foreach ($alias->getMethods() as $method) {
-                $store = get_class(\Cache::getStore());
+                    $functions[$method->getName()] = '(' . $method->getParamsWithDefault() . ')';
-                $this->extra['Cache'] = array($driver, $store);
+                }
-                $this->interfaces['\Illuminate\Cache\StoreInterface'] = $store;
+                $classes[$alias->getAlias()] = array(
-            }
+                    'functions' => $functions,
-        }catch (\Exception $e) {}
+                );
-
+            }
-        try{
+        }
-            if (class_exists('Queue')) {
+
-                $class = get_class(\Queue::connection());
+        $flags = JSON_FORCE_OBJECT;
-                $this->extra['Queue'] = array($class);
+        if (defined('JSON_PRETTY_PRINT')) {
-                $this->interfaces['\Illuminate\Queue\QueueInterface'] = $class;
+            $flags |= JSON_PRETTY_PRINT;
-            }
+        }
-        }catch (\Exception $e) {}
+
-
+        return json_encode(array(
-        try{
+            'php' => array(
-            if (class_exists('SSH')){
+                'classes' => $classes,
-                $class = get_class(\SSH::connection());
+            ),
-                $this->extra['SSH'] = array($class);
+        ), $flags);
-                $this->interfaces['\Illuminate\Remote\ConnectionInterface'] = $class;
+    }
-            }
+
-        }catch (\Exception $e) {}
+    protected function detectDrivers()
-
+    {
-        // Make all interface classes absolute
+        try {
-        foreach ($this->interfaces as &$interface) {
+            if (class_exists('Auth') && is_a('Auth', '\Illuminate\Support\Facades\Auth', true)) {
-            $interface = '\\' . ltrim($interface, '\\');
+                /** @noinspection PhpUndefinedClassInspection */
-        }
+                $class = get_class(\Auth::driver());
-    }
+                $this->extra['Auth'] = array($class);
-
+                $this->interfaces['\Illuminate\Auth\UserProviderInterface'] = $class;
-    /**
+            }
-     * Find all namespaces/aliases that are valid for us to render
+        } catch (\Exception $e) {}
-     *
+
-     * @return array
+        try {
-     */
+            if (class_exists('DB') && is_a('DB', '\Illuminate\Support\Facades\DB', true)) {
-    protected function getNamespaces()
+                /** @noinspection PhpUndefinedClassInspection */
-    {
+                $class = get_class(\DB::connection());
-        $namespaces = array();
+                $this->extra['DB'] = array($class);
-
+                $this->interfaces['\Illuminate\Database\ConnectionInterface'] = $class;
-        // Get all aliases
+            }
-        foreach (AliasLoader::getInstance()->getAliases() as $name => $facade) {
+        } catch (\Exception $e) {}
-            $magicMethods = array_key_exists($name, $this->magic) ? $this->magic[$name] : array();
+
-            $alias = new Alias($name, $facade, $magicMethods, $this->interfaces);
+        try {
-            if ($alias->isValid()) {
+            if (class_exists('Cache') && is_a('Cache', '\Illuminate\Support\Facades\Cache', true)) {
-
+                /** @noinspection PhpUndefinedClassInspection */
-                //Add extra methods, from other classes (magic static calls)
+                $driver = get_class(\Cache::driver());
-                if (array_key_exists($name, $this->extra)) {
+                /** @noinspection PhpUndefinedClassInspection */
-                    $alias->addClass($this->extra[$name]);
+                $store = get_class(\Cache::getStore());
-                }
+                $this->extra['Cache'] = array($driver, $store);
-
+                $this->interfaces['\Illuminate\Cache\StoreInterface'] = $store;
-                $namespace = $alias->getNamespace();
+            }
-                if (!isset($namespaces[$namespace])) {
+        } catch (\Exception $e) {}
-                    $namespaces[$namespace] = array();
+
-                }
+        try {
-                $namespaces[$namespace][] = $alias;
+            if (class_exists('Queue') && is_a('Queue', '\Illuminate\Support\Facades\Queue', true)) {
-            }
+                /** @noinspection PhpUndefinedClassInspection */
-
+                $class = get_class(\Queue::connection());
-        }
+                $this->extra['Queue'] = array($class);
-
+                $this->interfaces['\Illuminate\Queue\QueueInterface'] = $class;
-        return $namespaces;
+            }
-    }
+        } catch (\Exception $e) {}
-
+
-    /**
+        try {
-     * Get the driver/connection/store from the managers
+            if (class_exists('SSH') && is_a('SSH', '\Illuminate\Support\Facades\SSH', true)) {
-     *
+                /** @noinspection PhpUndefinedClassInspection */
-     * @param $alias
+                $class = get_class(\SSH::connection());
-     * @return array|bool|string
+                $this->extra['SSH'] = array($class);
-     */
+                $this->interfaces['\Illuminate\Remote\ConnectionInterface'] = $class;
-    public function getDriver($alias)
+            }
-    {
+        } catch (\Exception $e) {}
-        try {
+
-            if ($alias == "Auth") {
+    }
-                $driver = \Auth::driver();
+
-            } elseif ($alias == "DB") {
+    /**
-                $driver = \DB::connection();
+     * Find all namespaces/aliases that are valid for us to render
-            } elseif ($alias == "Cache") {
+     *
-                $driver = get_class(\Cache::driver());
+     * @return array|Alias[][]
-                $store = get_class(\Cache::getStore());
+     */
-                return array($driver, $store);
+    protected function getNamespaces()
-            } elseif ($alias == "Queue") {
+    {
-                $driver = \Queue::connection();
+        $namespaces = array();
-            } else {
+
-                return false;
+        // Get all aliases
-            }
+        /** @noinspection PhpUndefinedClassInspection */
-
+        foreach (AliasLoader::getInstance()->getAliases() as $name => $facade) {
-            return get_class($driver);
+            $magicMethods = array_key_exists($name, $this->magic) ? $this->magic[$name] : array();
-        } catch (\Exception $e) {
+            $alias = new Alias($name, $facade, $magicMethods, $this->interfaces);
-            $this->error("Could not determine driver/connection for $alias.");
+            if ($alias->isValid()) {
-            return false;
+
-        }
+                //Add extra methods, from other classes (magic static calls)
-    }
+                if (array_key_exists($name, $this->extra)) {
-
+                    $alias->addClass($this->extra[$name]);
-    /**
+                }
-     * Write a string as error output.
+
-     *
+                $namespace = $alias->getNamespace();
-     * @param  string  $string
+                if (!isset($namespaces[$namespace])) {
-     * @return void
+                    $namespaces[$namespace] = array();
-     */
+                }
-    protected function error($string)
+                $namespaces[$namespace][] = $alias;
-    {
+            }
-        if($this->output){
+
-            $this->output->writeln("<error>$string</error>");
+        }
-        }else{
+
-            echo $string . "\r\n";
+        return $namespaces;
-        }
+    }
-    }
+
-}
+    /**
+     * Get the driver/connection/store from the managers
+     *
+     * @param $alias
+     * @return array|bool|string
+     */
+    public function getDriver($alias)
+    {
+        try {
+            if ($alias == 'Auth') {
+                /** @noinspection PhpUndefinedClassInspection */
+                $driver = \Auth::driver();
+            } elseif ($alias == 'DB') {
+                /** @noinspection PhpUndefinedClassInspection */
+                $driver = \DB::connection();
+            } elseif ($alias == 'Cache') {
+                /** @noinspection PhpUndefinedClassInspection */
+                $driver = get_class(\Cache::driver());
+                /** @noinspection PhpUndefinedClassInspection */
+                $store = get_class(\Cache::getStore());
+                return array($driver, $store);
+            } elseif ($alias == 'Queue') {
+                /** @noinspection PhpUndefinedClassInspection */
+                $driver = \Queue::connection();
+            } else {
+                return false;
+            }
+
+            return get_class($driver);
+        } catch (\Exception $e) {
+            $this->error("Could not determine driver/connection for $alias.");
+            return false;
+        }
+    }
+
+    /**
+     * Write a string as error output.
+     *
+     * @param  string $string
+     * @return void
+     */
+    protected function error($string)
+    {
+        if ($this->output) {
+            $this->output->writeln("<error>$string</error>");
+        } else {
+            echo $string . "\r\n";
+        }
+    }
+}

src/IdeHelperServiceProvider.php

@@ -11,24 +11,23 @@
 namespace Barryvdh\LaravelIdeHelper;
 
 use Illuminate\Support\ServiceProvider;
+use Barryvdh\LaravelIdeHelper\Console\MetaCommand;
+use Barryvdh\LaravelIdeHelper\Console\ModelsCommand;
 use Barryvdh\LaravelIdeHelper\Console\GeneratorCommand;
-use Barryvdh\LaravelIdeHelper\Console\Generator2Command;
-Use Barryvdh\LaravelIdeHelper\Console\ModelsCommand;
 
+/**
+ * @property \Illuminate\Container\Container $app
+ */
 class IdeHelperServiceProvider extends ServiceProvider
 {
 
     /**
-     * Indicates if loading of the provider is deferred.
+     * {@inheritdoc}
-     *
-     * @var bool
      */
     protected $defer = true;
 
     /**
-     * Bootstrap the application events.
+     * {@inheritdoc}
-     *
-     * @return void
      */
     public function boot()
     {
@@ -36,9 +35,7 @@ class IdeHelperServiceProvider extends ServiceProvider
     }
 
     /**
-     * Register the service provider.
+     * {@inheritdoc}
-     *
-     * @return void
      */
     public function register()
     {
@@ -49,22 +46,34 @@ class IdeHelperServiceProvider extends ServiceProvider
         );
 
         $this->app['command.ide-helper.models'] = $this->app->share(
-            function () {
+            function ($app) {
-                return new ModelsCommand();
+                return new ModelsCommand($app);
             }
         );
 
-        $this->commands('command.ide-helper.generate', 'command.ide-helper.models');
+        $this->app['command.ide-helper.meta'] = $this->app->share(
+            function ($app) {
+                return new MetaCommand($app);
+            }
+        );
+
+        $this->commands('command.ide-helper.generate', 'command.ide-helper.models', 'command.ide-helper.meta');
     }
 
     /**
-     * Get the services provided by the provider.
+     * {@inheritdoc}
-     *
-     * @return array
      */
     public function provides()
     {
-        return array('command.ide-helper.generate', 'command.ide-helper.models');
+        return array('command.ide-helper.generate', 'command.ide-helper.models', 'command.ide-helper.meta');
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function getAppViewPath($package, $namespace = null)
+    {
+        return $this->app['path'] . "/views/packages/{$package}";
     }
 
 }

src/Method.php

@@ -1,311 +1,332 @@
-<?php
+<?php
-/**
+/**
- * Laravel IDE Helper Generator
+ * Laravel IDE Helper Generator
- *
+ *
- * @author    Barry vd. Heuvel <[email protected]>
+ * @author    Barry vd. Heuvel <[email protected]>
- * @copyright 2014 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
+ * @copyright 2014 Barry vd. Heuvel / Fruitcake Studio (http://www.fruitcakestudio.nl)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
+ * @license   http://www.opensource.org/licenses/mit-license.php MIT
- * @link      https://github.com/barryvdh/laravel-ide-helper
+ * @link      https://github.com/barryvdh/laravel-ide-helper
- */
+ */
-
+
-namespace Barryvdh\LaravelIdeHelper;
+namespace Barryvdh\LaravelIdeHelper;
-
+
-use phpDocumentor\Reflection\DocBlock;
+use phpDocumentor\Reflection\DocBlock;
-use phpDocumentor\Reflection\DocBlock\Context;
+use phpDocumentor\Reflection\DocBlock\Context;
-use phpDocumentor\Reflection\DocBlock\Tag;
+use phpDocumentor\Reflection\DocBlock\Tag;
-use phpDocumentor\Reflection\DocBlock\Tag\ReturnTag;
+use phpDocumentor\Reflection\DocBlock\Tag\ReturnTag;
-use phpDocumentor\Reflection\DocBlock\Tag\ParamTag;
+
-use phpDocumentor\Reflection\DocBlock\Serializer as DocBlockSerializer;
+class Method
-
+{
-class Method
+    /** @var \phpDocumentor\Reflection\DocBlock */
-{
+    protected $phpdoc;
-    /** @var \phpDocumentor\Reflection\DocBlock  */
+
-    protected $phpdoc;
+    /** @var \ReflectionMethod */
-
+    protected $method;
-    /** @var \ReflectionMethod  */
+
-    protected $method;
+    protected $name;
-
+    protected $namespace;
-    protected $output = '';
+    protected $params = array();
-    protected $name;
+    protected $params_with_default = array();
-    protected $namespace;
+    protected $interfaces = array();
-    protected $params = array();
+    protected $return = null;
-    protected $params_with_default = array();
+
-    protected $interfaces = array();
+    /**
-    protected $return = null;
+     * @param \ReflectionMethod $method
-
+     * @param string $alias
-    /**
+     * @param \ReflectionClass $class
-     * @param \ReflectionMethod $method
+     * @param string|null $methodName
-     * @param string $alias
+     * @param array $interfaces
-     * @param string $class
+     */
-     * @param string|null $methodName
+    public function __construct(\ReflectionMethod $method, $alias, $class, $methodName = null, $interfaces = array())
-     * @param array $interfaces
+    {
-     */
+        $this->method = $method;
-    public function __construct(\ReflectionMethod $method, $alias, $class, $methodName = null, $interfaces = array())
+        $this->interfaces = $interfaces;
-    {
+        $this->name = $methodName ?: $method->name;
-        $this->method = $method;
+        $declaringClass = $method->getDeclaringClass();
-        $this->interfaces = $interfaces;
+        $this->namespace = $declaringClass->getNamespaceName();
-        $this->name = $methodName ?: $method->name;
+
-        $this->namespace = $method->getDeclaringClass()->getNamespaceName();
+        //Create a DocBlock and serializer instance
-
+        $this->phpdoc = new DocBlock($method, new Context($this->namespace, static::getUseStatements($declaringClass)));
-        //Create a DocBlock and serializer instance
+
-        $this->phpdoc = new DocBlock($method, new Context($this->namespace));
+        //Normalize the description and inherit the docs from parents/interfaces
-
+        try {
-        //Normalize the description and inherit the docs from parents/interfaces
+            $this->normalizeReturnTags($this->phpdoc);
-        try {
+            $this->normalizeDescription($this->phpdoc);
-            $this->normalizeParams($this->phpdoc);
+        } catch (\Exception $e) {}
-            $this->normalizeReturn($this->phpdoc);
+
-            $this->normalizeDescription($this->phpdoc);
+        //Get the parameters, including formatted default values
-        } catch (\Exception $e) {}
+        $this->getParameters($method);
-
+
-        //Get the parameters, including formatted default values
+        //Make the method static
-        $this->getParameters($method);
+        //$this->phpdoc->appendTag(Tag::createInstance('@static', $this->phpdoc));
-
+
-        //Make the method static
+        //Reference the 'real' function in the declaringClass
-        $this->phpdoc->appendTag(Tag::createInstance('@static', $this->phpdoc));
+        $this->declaringClassName = '\\' . ltrim($declaringClass->name, '\\');
-
+        $this->root = '\\' . ltrim($class->getName(), '\\');
-        //Reference the 'real' function in the declaringclass
+    }
-        $declaringClass = $method->getDeclaringClass();
+
-        $this->declaringClassName = '\\' . ltrim($declaringClass->name, '\\');
+    /**
-        $this->root = '\\' . ltrim($class->getName(), '\\');
+     * Get the class wherein the function resides
-    }
+     *
-
+     * @return string
-    /**
+     */
-     * Get the class wherein the function resides
+    public function getDeclaringClass()
-     *
+    {
-     * @return string
+        return $this->declaringClassName;
-     */
+    }
-    public function getDeclaringClass()
+
-    {
+    /**
-        return $this->declaringClassName;
+     * Return the class from which this function would be called
-    }
+     *
-
+     * @return string
-    /**
+     */
-     * Return the class from which this function would be called
+    public function getRoot()
-     *
+    {
-     * @return string
+        return $this->root;
-     */
+    }
-    public function getRoot()
+
-    {
+    /**
-        return $this->root;
+     * Get the docblock for this method
-    }
+     *
-
+     * @param string $prefix
-    /**
+     * @param bool $trim
-     * Get the docblock for this method
+     * @return string
-     *
+     */
-     * @param string $prefix
+    public function getDocComment($prefix = "\t\t", $trim = false)
-     * @return mixed
+    {
-     */
+        $serializer = new DocBlock\Serializer(1, $prefix);
-    public function getDocComment($prefix = "\t\t")
+        $str = $serializer->getDocComment($this->phpdoc);
-    {
+        if ($trim) {
-        $serializer = new DocBlockSerializer(1, $prefix);
+            $str = preg_replace(array('/\s+$/m', '#^(\s*/\*\*[\r\n])(?:\s*\*[\r\n])+#u', '#(?:[\r\n]\s*\*)+([\r\n]\s*\*/)$#u'), array('', '$1', '$1'), $str);
-        return $serializer->getDocComment($this->phpdoc);
+        }
-    }
+        return $str;
-
+    }
-    /**
+
-     * Get the method name
+    /**
-     *
+     * Get the method name
-     * @return string
+     *
-     */
+     * @return string
-    public function getName()
+     */
-    {
+    public function getName()
-        return $this->name;
+    {
-    }
+        return $this->name;
-
+    }
-    /**
+
-     * Get the parameters for this method
+    /**
-     *
+     * Checks whether the method is deprecated
-     * @param bool $implode Wether to implode the array or not
+     *
-     * @return string
+     * @return bool
-     */
+     */
-    public function getParams($implode = true)
+    public function isDeprecated()
-    {
+    {
-        return $implode ? implode(', ', $this->params) : $this->params;
+        return $this->phpdoc->hasTag('deprecated');
-    }
+    }
-
+
-    /**
+    /**
-     * Get the parameters for this method including default values
+     * Get the declared parameters for this method
-     *
+     *
-     * @param bool $implode Wether to implode the array or not
+     * @return array
-     * @return string
+     */
-     */
+    public function getDocParams()
-    public function getParamsWithDefault($implode = true)
+    {
-    {
+        return $this->phpdoc->getTagsByName('param');
-        return $implode ? implode(', ', $this->params_with_default) : $this->params_with_default;
+    }
-    }
+
-
+    /**
-    /**
+     * Get the parameters for this method
-     * Get the description and get the inherited docs.
+     *
-     *
+     * @param bool $implode Whether to implode the array or not
-     * @param DocBlock $phpdoc
+     * @return string|array
-     */
+     */
-    protected function normalizeDescription(DocBlock $phpdoc)
+    public function getParams($implode = true)
-    {
+    {
-        //Get the short + long description from the DocBlock
+        return $implode ? implode(', ', $this->params) : $this->params;
-        $description = $phpdoc->getText();
+    }
-
+
-        //Loop through parents/interfaces, to fill in {@inheritdoc}
+    /**
-        if (strpos($description, '{@inheritdoc}') !== false) {
+     * Get the parameters for this method including default values
-            $inheritdoc = $this->getInheritDoc($this->method);
+     *
-            $inheritDescription = $inheritdoc->getText();
+     * @param bool $implode Whether to implode the array or not
-
+     * @return string|array
-            $description = str_replace('{@inheritdoc}', $inheritDescription, $description);
+     */
-            $phpdoc->setText($description);
+    public function getParamsWithDefault($implode = true)
-
+    {
-            $this->normalizeParams($inheritdoc);
+        return $implode ? implode(', ', $this->params_with_default) : $this->params_with_default;
-            $this->normalizeReturn($inheritdoc);
+    }
-
+
-            //Add the tags that are inherited
+    /**
-            $inheritTags = $inheritdoc->getTags();
+     * Get the description and get the inherited docs.
-            if ($inheritTags) {
+     *
-                /** @var Tag $tag */
+     * @param DocBlock $phpdoc
-                foreach ($inheritTags as $tag) {
+     */
-                    $tag->setDocBlock();
+    protected function normalizeDescription(DocBlock $phpdoc)
-                    $phpdoc->appendTag($tag);
+    {
-                }
+        //Get the short + long description from the DocBlock
-            }
+        $description = $phpdoc->getText();
-        }
+
-    }
+        //Loop through parents/interfaces, to fill in {@inheritdoc}
-
+        if (stripos($description, '{@inheritdoc}') !== false && ($inheritdoc = $this->getInheritDoc($this->method))) {
-    /**
+            $inheritDescription = $inheritdoc->getText();
-     * Normalize the parameters
+
-     *
+            $description = str_ireplace('{@inheritdoc}', $inheritDescription, $description);
-     * @param DocBlock $phpdoc
+            $phpdoc->setText($description);
-     */
+
-    protected function normalizeParams(DocBlock $phpdoc)
+            $this->normalizeReturnTags($inheritdoc);
-    {
+
-        //Get the return type and adjust them for beter autocomplete
+            //Add the tags that are inherited
-        $paramTags = $phpdoc->getTagsByName('param');
+            foreach ($inheritdoc->getTags() as $tag) {
-        if ($paramTags) {
+                $tag->setDocBlock();
-            /** @var ParamTag $tag */
+                $phpdoc->appendTag($tag);
-            foreach($paramTags as $tag){
+            }
-                // Convert the keywords
+        }
-                $content = $this->convertKeywords($tag->getContent());
+    }
-                $tag->setContent($content);
+
-
+    /**
-                // Get the expanded type and re-set the content
+     * Normalize the return tag (make full namespace, replace interfaces)
-                $content = $tag->getType() . ' ' . $tag->getVariableName() . ' ' . $tag->getDescription();
+     *
-                $tag->setContent(trim($content));
+     * @param DocBlock $phpdoc
-            }
+     */
-        }
+    protected function normalizeReturnTags(DocBlock $phpdoc)
-    }
+    {
-
+        static $typeProp;
-    /**
+        if (!isset($typeProp)) {
-     * Normalize the return tag (make full namespace, replace interfaces)
+            $typeProp = new \ReflectionProperty('phpDocumentor\Reflection\DocBlock\Tag\ReturnTag', 'type');
-     *
+            $typeProp->setAccessible(true);
-     * @param DocBlock $phpdoc
+        }
-     */
+
-    protected function normalizeReturn(DocBlock $phpdoc)
+        $this->return = null;
-    {
+        //Get the return type and adjust them for better autocomplete
-        //Get the return type and adjust them for beter autocomplete
+        foreach ($phpdoc->getTags() as $tag) {
-        $returnTags = $phpdoc->getTagsByName('return');
+            if ($tag instanceof ReturnTag) {
-        if ($returnTags) {
+                // Convert the keywords
-            /** @var ReturnTag $tag */
+                $typeValue = static::convertKeywords($typeProp->getValue($tag));
-            $tag = reset($returnTags);
+                $typeProp->setValue($tag, $typeValue);
-            // Get the expanded type
+
-            $returnValue = $tag->getType();
+                // Get the expanded type
-
+                $typeValue = $tag->getType();
-            // Replace the interfaces
+
-            foreach($this->interfaces as $interface => $real){
+                // Replace the interfaces
-                $returnValue = str_replace($interface, $real, $returnValue);
+                if (preg_match('/\bReturnTag$/', get_class($tag))) {
-            }
+                    foreach ($this->interfaces as $interface => $real) {
-
+                        $typeValue = preg_replace('/(^|\|)' . preg_quote($interface, '/') . '\b/', $real, $typeValue);
-            // Set the changed content
+                    }
-            $tag->setContent($returnValue . ' ' . $tag->getDescription());
+                    $this->return = $typeValue;
-            $this->return = $returnValue;
+                }
-        }else{
+
-            $this->return = null;
+                // Re-set the type
-        }
+                $typeProp->setValue($tag, $typeValue);
-    }
+                $tag->setDescription($tag->getDescription());
-
+            }
-    /**
+        }
-     * Convert keywwords that are incorrect.
+    }
-     *
+
-     * @param  string $string
+    /**
-     * @return string
+     * Convert keywords that are incorrect.
-     */
+     *
-    protected function convertKeywords($string)
+     * @param  string $string
-    {
+     * @return string
-        $string = str_replace('\Closure', 'Closure', $string);
+     */
-        $string = str_replace('Closure', '\Closure', $string);
+    protected static function convertKeywords($string)
-        $string = str_replace('dynamic', 'mixed', $string);
+    {
-
+        $types = explode('|', $string);
-        return $string;
+        foreach ($types as &$type) {
-    }
+            if ($type === 'Closure')
-
+                $type = '\Closure';
-    /**
+            elseif ($type === 'dynamic')
-     * Should the function return a value?
+                $type = 'mixed';
-     *
+            elseif (strrpos($type, '\\') && $type[0] !== '\\' && (class_exists($type) || interface_exists($type)))
-     * @return bool
+                $type = '\\' . $type;
-     */
+        }
-    public function shouldReturn()
+        return implode('|', $types);
-    {
+    }
-        if($this->return !== "void" && $this->method->name !== "__construct"){
+
-            return true;
+    /**
-        }
+     * Should the function return a value?
-
+     *
-        return false;
+     * @return bool|int
-    }
+     */
-
+    public function shouldReturn()
-    /**
+    {
-     * Get the parameters and format them correctly
+        if ($this->return !== 'void' && $this->method->name !== '__construct') {
-     *
+            return isset($this->return) ? true : 1;
-     * @param $method
+        }
-     * @return array
+
-     */
+        return false;
-    public function getParameters($method)
+    }
-    {
+
-        //Loop through the default values for paremeters, and make the correct output string
+    /**
-        $params = array();
+     * Get the parameters and format them correctly
-        $paramsWithDefault = array();
+     *
-        foreach ($method->getParameters() as $param) {
+     * @param \ReflectionMethod $method
-            $paramStr = '$' . $param->getName();
+     * @return void
-            $params[] = $paramStr;
+     */
-            if ($param->isOptional()) {
+    public function getParameters($method)
-                $default = $param->getDefaultValue();
+    {
-                if (is_bool($default)) {
+        //Loop through the default values for parameters, and make the correct output string
-                    $default = $default ? 'true' : 'false';
+        $params = array();
-                } elseif (is_array($default)) {
+        $paramsWithDefault = array();
-                    $default = 'array()';
+
-                } elseif (is_null($default)) {
+        foreach ($method->getParameters() as $param) {
-                    $default = 'null';
+            $paramStr = '$' . $param->getName();
-                } elseif (is_int($default)) {
+            $params[] = $paramStr;
-                    //$default = $default;
+
-                } else {
+            if ($param->isOptional()) {
-                    $default = "'" . trim($default) . "'";
+                $default = $param->isDefaultValueAvailable() ? $param->getDefaultValue() : null;
-                }
+                if (is_bool($default)) {
-                $paramStr .= " = $default";
+                    $default = $default ? 'true' : 'false';
-            }
+                } elseif (is_array($default)) {
-            $paramsWithDefault[] = $paramStr;
+                    $default = 'array()';
-        }
+                } elseif (is_null($default)) {
-
+                    $default = 'null';
-        $this->params = $params;
+                } elseif (is_int($default)) {
-        $this->params_with_default = $paramsWithDefault;
+                    //$default = $default;
-    }
+                } else {
-
+                    $default = "'" . trim($default) . "'";
-    /**
+                }
-     * @param \ReflectionMethod $reflectionMethod
+                $paramStr .= " = $default";
-     * @return DocBlock
+            }
-     */
+
-    protected function getInheritDoc($reflectionMethod)
+            $paramsWithDefault[] = $paramStr;
-    {
+        }
-        $parentClass = $reflectionMethod->getDeclaringClass()->getParentClass();
+
-
+        $this->params = $params;
-        //Get either a parent or the interface
+        $this->params_with_default = $paramsWithDefault;
-        if ($parentClass) {
+    }
-            $method = $parentClass->getMethod($reflectionMethod->getName());
+
-        } else {
+    /**
-            $method = $reflectionMethod->getPrototype();
+     * @param \ReflectionMethod $reflectionMethod
-        }
+     * @return DocBlock|null
-        if ($method) {
+     */
-            $namespace = $method->getDeclaringClass()->getNamespaceName();
+    protected function getInheritDoc($reflectionMethod)
-            $phpdoc = new DocBlock($method, new Context($namespace));
+    {
-            
+        $parentClass = $reflectionMethod->getDeclaringClass()->getParentClass();
-            if (strpos($phpdoc->getText(), '{@inheritdoc}') !== false) {
+
-                //Not at the end yet, try another parent/interface..
+        //Get either a parent or the interface
-                return $this->getInheritDoc($method);
+        if ($parentClass) {
-            } else {
+            $method = $parentClass->getMethod($reflectionMethod->getName());
-                return $phpdoc;
+        } else {
-            }
+            $method = $reflectionMethod->getPrototype();
-        }
+        }
-    }
+        if ($method) {
-}
+            $namespace = $method->getDeclaringClass()->getNamespaceName();
+            $phpdoc = new DocBlock($method, new Context($namespace, static::getUseStatements($method->getDeclaringClass())));
+
+            if (stripos($phpdoc->getText(), '{@inheritdoc}') !== false) {
+                //Not at the end yet, try another parent/interface..
+                return $this->getInheritDoc($method);
+            } else {
+                return $phpdoc;
+            }
+        }
+        return null;
+    }
+
+    protected static function getUseStatements(\ReflectionClass $class)
+    {
+        try {
+            return PhpReflection::getUseStatements($class);
+        } catch (\Exception $e) {
+            return array();
+        }
+    }
+}

src/PhpReflection.php

@@ -0,0 +1,166 @@
+<?php namespace Barryvdh\LaravelIdeHelper;
+
+/**
+ * PHP reflection helpers.
+ *
+ * This file is part of the Nette Framework (https://nette.org)
+ * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
+ *
+ * @see https://github.com/nette/di/blob/v2.4/src/DI/PhpReflection.php
+ */
+class PhpReflection
+{
+    /**
+     * Expands class name into full name.
+     *
+     * @param  string $name
+     * @param  \ReflectionClass $rc
+     * @return string  full name
+     * @throws \InvalidArgumentException
+     */
+    public static function expandClassName($name, \ReflectionClass $rc)
+    {
+        $lower = strtolower($name);
+        if (empty($name)) {
+            throw new \InvalidArgumentException('Class name must not be empty.');
+        } elseif (self::isBuiltinType($lower)) {
+            return $lower;
+        } elseif ($lower === 'self' || $lower === 'static' || $lower === '$this') {
+            return $rc->getName();
+        } elseif ($name[0] === '\\') { // fully qualified name
+            return ltrim($name, '\\');
+        }
+
+        $uses = self::getUseStatements($rc);
+        $parts = explode('\\', $name, 2);
+        if (isset($uses[$parts[0]])) {
+            $parts[0] = $uses[$parts[0]];
+            return implode('\\', $parts);
+        } elseif ($rc->inNamespace()) {
+            return $rc->getNamespaceName() . '\\' . $name;
+        } else {
+            return $name;
+        }
+    }
+
+    /**
+     * @param  \ReflectionClass
+     * @return array of [alias => class]
+     */
+    public static function getUseStatements(\ReflectionClass $class)
+    {
+        static $cache = array();
+        if (!isset($cache[$name = $class->getName()])) {
+            if ($class->isInternal() || !($code = @file_get_contents($class->getFileName()))) {
+                $cache[$name] = array();
+            } else {
+                $cache = self::parseUseStatements($code, $name) + $cache;
+            }
+        }
+        return $cache[$name];
+    }
+
+    /**
+     * @param  string
+     * @return bool
+     */
+    public static function isBuiltinType($type)
+    {
+        return in_array(strtolower($type), array('string', 'int', 'float', 'bool', 'array', 'callable'), true);
+    }
+
+    /**
+     * Parses PHP code.
+     *
+     * @param  string $code
+     * @param  string $forClass
+     * @return array of [class => [alias => class, ...]]
+     */
+    public static function parseUseStatements($code, $forClass = null)
+    {
+        $tokens = token_get_all($code);
+        $namespace = $class = $classLevel = $level = null;
+        $res = $uses = array();
+
+        while ($token = current($tokens)) {
+            next($tokens);
+            switch (is_array($token) ? $token[0] : $token) {
+                case T_NAMESPACE:
+                    $namespace = ltrim(self::fetch($tokens, array(T_STRING, T_NS_SEPARATOR)) . '\\', '\\');
+                    $uses = array();
+                    break;
+
+                case T_CLASS:
+                case T_INTERFACE:
+                case PHP_VERSION_ID < 50400 ? -1 : T_TRAIT:
+                    if ($name = self::fetch($tokens, T_STRING)) {
+                        $class = $namespace . $name;
+                        $classLevel = $level + 1;
+                        $res[$class] = $uses;
+                        if ($class === $forClass) {
+                            return $res;
+                        }
+                    }
+                    break;
+
+                case T_USE:
+                    while (!$class && ($name = self::fetch($tokens, array(T_STRING, T_NS_SEPARATOR)))) {
+                        $name = ltrim($name, '\\');
+                        if (self::fetch($tokens, '{')) {
+                            while ($suffix = self::fetch($tokens, array(T_STRING, T_NS_SEPARATOR))) {
+                                if (self::fetch($tokens, T_AS)) {
+                                    $uses[self::fetch($tokens, T_STRING)] = $name . $suffix;
+                                } else {
+                                    $tmp = explode('\\', $suffix);
+                                    $uses[end($tmp)] = $name . $suffix;
+                                }
+                                if (!self::fetch($tokens, ',')) {
+                                    break;
+                                }
+                            }
+
+                        } elseif (self::fetch($tokens, T_AS)) {
+                            $uses[self::fetch($tokens, T_STRING)] = $name;
+
+                        } else {
+                            $tmp = explode('\\', $name);
+                            $uses[end($tmp)] = $name;
+                        }
+                        if (!self::fetch($tokens, ',')) {
+                            break;
+                        }
+                    }
+                    break;
+
+                case T_CURLY_OPEN:
+                case T_DOLLAR_OPEN_CURLY_BRACES:
+                case '{':
+                    $level++;
+                    break;
+
+                case '}':
+                    if ($level === $classLevel) {
+                        $class = $classLevel = null;
+                    }
+                    $level--;
+            }
+        }
+
+        return $res;
+    }
+
+    private static function fetch(&$tokens, $take)
+    {
+        $res = null;
+        while ($token = current($tokens)) {
+            list($token, $s) = is_array($token) ? $token : array($token, $token);
+            if (in_array($token, (array)$take, true)) {
+                $res .= $s;
+            } elseif (!in_array($token, array(T_DOC_COMMENT, T_WHITESPACE, T_COMMENT), true)) {
+                break;
+            }
+            next($tokens);
+        }
+        return $res;
+    }
+}

src/config/config.php

@@ -1,17 +1,20 @@
-<?php
+<?php 
+
+use Illuminate\Support\Facades\Config;
 
 return array(
 
     /*
     |--------------------------------------------------------------------------
-    | Filename
+    | Filename & Format
     |--------------------------------------------------------------------------
     |
-    | The default path to the helper file
+    | The default filename (without extension) and the format (php or json)
     |
     */
 
-    'filename' => '_ide_helper.php',
+    'filename'  => '_ide_helper',
+    'format'    => 'php',
 
     /*
     |--------------------------------------------------------------------------
@@ -83,7 +86,7 @@ return array(
     */
     
     'interfaces' => array(
-        '\Illuminate\Auth\UserInterface' => '\User',
+        '\Illuminate\Auth\UserInterface' => Config::get('auth.model', 'User'),
     )
 
 );

src/views/ide-helper.php

@@ -1,39 +1,46 @@
-<?= '<?php' ?>
+<?= '<?php' ?>
-
+
-/**
+/**
- * An helper file for Laravel 4, to provide autocomplete information to your IDE
+ * An helper file for Laravel 4, to provide autocomplete information to your IDE
- * Generated for Laravel <?= $version ?> on <?= date("Y-m-d") ?>.
+ * Generated for Laravel <?= $version ?> on <?= date('Y-m-d') ?>.
- *
+ *
- * @author Barry vd. Heuvel <[email protected]>
+ * @author Barry vd. Heuvel <[email protected]>
- * @see https://github.com/barryvdh/laravel-ide-helper
+ * @see https://github.com/barryvdh/laravel-ide-helper
- */
+ */
-
+
-<?php foreach($namespaces as $namespace => $aliases): ?>
+<?php foreach ($namespaces as $namespace => $aliases/* @var \Barryvdh\LaravelIdeHelper\Alias[] $aliases */): ?>
-namespace <?= $namespace == '__root' ? '' : $namespace ?>{
+namespace <?= $namespace == '__root' ? '' : $namespace ?>{
-<?php if($namespace == '__root'): ?>
+<?php if ($namespace == '__root'): ?>
-    exit("This file should not be included, only analyzed by your IDE");
+	exit('This file should not be included, only analyzed by your IDE');
-<?= $helpers ?>
+<?= $helpers ?>
-<?php endif; ?>
+<?php endif; ?>
-<?php foreach($aliases as $alias): ?>
+<?php foreach ($aliases as $alias): ?>
-
+
-    <?= $alias->getClassType() ?> <?= $alias->getAlias() ?> <?= $alias->getExtends() ? 'extends ' . $alias->getExtends() : '' ?>{
+<?php if (($cBase = class_basename($alias->getExtends())) != $alias->getExtends() && $cBase != $alias->getShortName()): ?>
-        <?php foreach($alias->getMethods() as $method): ?>
+	/** @noinspection PhpUnnecessaryFullyQualifiedNameInspection */
-
+<?php endif; ?>
-        <?= trim($method->getDocComment('        ')) ?>
+	<?= $alias->getClassType() ?> <?= $alias->getShortName() ?> <?= $alias->getExtends() ? 'extends ' . $alias->getExtends() : '' ?>{
-
+<?php foreach ($alias->getMethods() as $method): ?>
-        public static function <?= $method->getName() ?>(<?= $method->getParamsWithDefault() ?>){<?php if($method->getDeclaringClass() !== $method->getRoot()): ?>
+
-
+<?php if (($nParams = count($method->getDocParams())) > count($mParams = $method->getParamsWithDefault(false))): ?>
-            //Method inherited from <?= $method->getDeclaringClass() ?>
+		/** @noinspection PhpDocSignatureInspection */
-            <?php endif; ?>
+<?php endif; ?>
-
+<?php if ($docComment = str_replace("/**\n\t\t */", '', trim($method->getDocComment("\t\t", true)))): ?>
-            <?= $method->shouldReturn() ? 'return ': '' ?><?= $method->getRoot() ?>::<?= $method->getName() ?>(<?= $method->getParams() ?>);
+		<?= $docComment ?>
-        }
+
-        <?php endforeach; ?>
+<?php endif; ?>
-
+		public static function <?= $method->getName() ?>(<?= ($docComment && $nParams < count($mParams)) ? '/** @noinspection PhpDocSignatureInspection */' . implode(', /** @noinspection PhpDocSignatureInspection */', $mParams) : $method->getParamsWithDefault() ?>){
-    }
+<?php if ($method->getDeclaringClass() !== $method->getRoot()): ?>
-
+			//Method inherited from <?= $method->getDeclaringClass() ?>
-<?php endforeach; ?>
+
-
+<?php endif; ?>
-}
+			/** @noinspection PhpUnnecessaryFullyQualifiedNameInspection,PhpDynamicAsStaticMethodCallInspection<?= ($method->shouldReturn() === 1 ? ',PhpVoidFunctionResultUsedInspection' : '') . ($method->isDeprecated() ? ',PhpDeprecationInspection' : '') ?> */
-
+			<?= $method->shouldReturn() ? 'return ' : '' ?><?= $method->getRoot() ?>::<?= $method->getName() ?>(<?= $method->getParams() ?>);
-<?php endforeach; ?>
+		}
+<?php endforeach; ?>
+
+	}
+<?php endforeach; ?>
+
+}
+<?php endforeach; ?>

src/views/meta.php

@@ -0,0 +1,22 @@
+<?= '<?php' ?> namespace PHPSTORM_META {
+
+	/**
+	 * PhpStorm Meta file, to provide autocomplete information for PhpStorm
+	 * Generated on <?= date('Y-m-d') ?>.
+	 *
+	 * @author Barry vd. Heuvel <[email protected]>
+	 * @see https://github.com/barryvdh/laravel-ide-helper
+	 */
+
+	/** @noinspection PhpIllegalArrayKeyTypeInspection,PhpUnusedLocalVariableInspection,PhpUnnecessaryFullyQualifiedNameInspection */
+	$STATIC_METHOD_TYPES = array(
+<?php foreach ($methods as $method): ?>
+		<?= strpos($method, 'new ') === 0 ? $method : $method . '(\'\')' ?> => array(
+<?php foreach ($bindings as $abstract => $class): ?>
+			<?= var_export($abstract, true) ?> instanceof \<?= $class ?>,
+<?php endforeach ?>
+		),
+<?php endforeach ?>
+	);
+
+}

tests/MethodTest.php

@@ -0,0 +1,38 @@
+<?php namespace Barryvdh\LaravelIdeHelper;
+
+class MethodTest extends \PHPUnit_Framework_TestCase
+{
+	/**
+	 * @expectedException \PHPUnit_Framework_Error
+	 * @expectedExceptionMessage Argument 1 passed to
+	 */
+	public function testConstructorWithoutMethod()
+	{
+		new Method(null, null, null);
+	}
+
+	public function testConstructor()
+	{
+		$method = new \ReflectionMethod('PHPUnit_Framework_TestCase', 'getMock');
+		$object = new Method($method, null, new \ReflectionClass(get_class($this)));
+
+		$this->assertSame('\PHPUnit_Framework_TestCase', $object->getDeclaringClass());
+		$this->assertSame('\\' . get_class($this), $object->getRoot());
+		$this->assertSame('getMock', $object->getName());
+
+		$prop = new \ReflectionProperty(get_class($object), 'namespace');
+		$prop->setAccessible(true);
+		$this->assertSame('', $prop->getValue($object));
+
+		$this->assertFalse($object->isDeprecated());
+		$this->assertCount($method->getNumberOfParameters(), $object->getDocParams());
+
+		$doc = $object->getDocComment('', true);
+		$this->assertContains("\n * " . '@param array|null $methods', $doc);
+		$this->assertContains("\n * " . '@return \PHPUnit_Framework_MockObject_MockObject', $doc);
+		$this->assertContains("\n * " . '@throws \PHPUnit_Framework_Exception', $doc);
+
+		$this->assertTrue($object->shouldReturn());
+	}
+
+}

tests/ServiceProviderTest.php

@@ -0,0 +1,83 @@
+<?php namespace Barryvdh\LaravelIdeHelper;
+
+class ServiceProviderTest extends \PHPUnit_Framework_TestCase
+{
+	/** @var \PHPUnit_Framework_MockObject_MockObject|\Illuminate\Container\Container */
+	protected $app;
+	/** @var IdeHelperServiceProvider */
+	protected $provider;
+
+	static function makeAppMock(\PHPUnit_Framework_TestCase $testCase)
+	{
+		$app = $testCase->getMock('Illuminate\Container\Container', array('make', 'bind'));
+
+		$fs = $testCase->getMock('Illuminate\Filesystem\Filesystem', null);
+		$config = $testCase->getMock('Illuminate\Config\Repository', array('get', 'set', 'package'), array(), '', false);
+		$events = $testCase->getMock('Illuminate\Events\Dispatcher', array('listen'), array($app));
+		$view = $testCase->getMock('Illuminate\View\Factory', array('addNamespace'), array(), '', false);
+
+		$app->expects($testCase->any())->method('make')->willReturnMap(array(
+			array('files', array(), $fs),
+			array('config', array(), $config),
+			array('events', array(), $events),
+			array('view', array(), $view),
+			array('path', array(), __DIR__),
+		));
+
+		return $app;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	protected function setUp()
+	{
+		$this->app = static::makeAppMock($this);
+		/** @noinspection PhpParamsInspection */
+		$this->provider = new IdeHelperServiceProvider($this->app);
+	}
+
+	public function testDeferred()
+	{
+		$this->assertTrue($this->provider->isDeferred());
+	}
+
+	public function testProvides()
+	{
+		$this->assertEquals(array('command.ide-helper.generate', 'command.ide-helper.models', 'command.ide-helper.meta'), $this->provider->provides());
+	}
+
+	public function testRegister()
+	{
+		$this->app->expects($this->exactly(3))->method('bind')->withConsecutive(
+			array('command.ide-helper.generate', $this->isType(\PHPUnit_Framework_Constraint_IsType::TYPE_CALLABLE), $this->isFalse()),
+			array('command.ide-helper.models', $this->isType(\PHPUnit_Framework_Constraint_IsType::TYPE_CALLABLE), $this->isFalse()),
+			array('command.ide-helper.meta', $this->isType(\PHPUnit_Framework_Constraint_IsType::TYPE_CALLABLE), $this->isFalse())
+		);
+
+		/** @var \PHPUnit_Framework_MockObject_MockObject|\Illuminate\Events\Dispatcher $events */
+		$events = $this->app['events'];
+		$events->expects($this->once())->method('listen')->with('artisan.start', $this->callback(function ($listener) {
+			$params = print_r(array('commands' => array('command.ide-helper.generate', 'command.ide-helper.models', 'command.ide-helper.meta')), true);
+			return strpos(preg_replace('/^\s+/mu', '', print_r($listener, true)), preg_replace('/^\s+/mu', '', $params));
+		}), 0);
+
+		$this->provider->register();
+	}
+
+	public function testBoot()
+	{
+		$path = realpath(__DIR__ . '/../src');
+
+		/** @var \PHPUnit_Framework_MockObject_MockObject|\Illuminate\Config\Repository $config */
+		$config = $this->app['config'];
+		$config->expects($this->once())->method('package')->with('barryvdh/laravel-ide-helper', $path . '/config', 'laravel-ide-helper');
+
+		/** @var \PHPUnit_Framework_MockObject_MockObject|\Illuminate\View\Factory $view */
+		$view = $this->app['view'];
+		$view->expects($this->once())->method('addNamespace')->with('laravel-ide-helper', $path . '/views');
+
+		$this->provider->boot();
+	}
+
+}