mirror of
https://github.com/barryvdh/laravel-ide-helper.git
synced 2026-08-18 10:07:12 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0a8e5436d4 | ||
|
|
7c81b6388e | ||
|
|
66d6e3df01 | ||
|
|
1080504a78 | ||
|
|
647b8ff0d1 | ||
|
|
07e35d808c | ||
|
|
a44572676a | ||
|
|
e6f7ca7433 | ||
|
|
042d341b65 | ||
|
|
501ef7045a | ||
|
|
31e6479ee6 | ||
|
|
c0f4a497f9 | ||
|
|
00604a2431 | ||
|
|
ff18d80849 | ||
|
|
52ea63b5de | ||
|
|
7b263ffbce | ||
|
|
8f4ea3c100 | ||
|
|
3c348e7140 | ||
|
|
2f90dbdfce | ||
|
|
74935df8a1 | ||
|
|
b6fdfe0df7 | ||
|
|
99cebb5566 | ||
|
|
692b223e94 | ||
|
|
f321828778 | ||
|
|
6eb797f5ff | ||
|
|
604d327277 | ||
|
|
6ed5367f6b | ||
|
|
8c339bd6b0 | ||
|
|
52b9b52926 | ||
|
|
f909c82fcc | ||
|
|
e88c3669b7 | ||
|
|
5bd7eeda23 | ||
|
|
dae0b55bef | ||
|
|
3f9831c5cf | ||
|
|
2cc277440a | ||
|
|
14eab5ef84 | ||
|
|
c94012232f | ||
|
|
b9685a1f83 | ||
|
|
7bc74b1844 | ||
|
|
cfa0333446 | ||
|
|
5c6fa1d43f | ||
|
|
23db0e06ca | ||
|
|
52b3accd70 | ||
|
|
cc07cd3b2c | ||
|
|
3113f58f45 | ||
|
|
d00dc62ed6 | ||
|
|
073d90b791 | ||
|
|
5d4af73c29 | ||
|
|
39ffaa62f4 | ||
|
|
231e125821 | ||
|
|
f446326967 | ||
|
|
57dc033061 | ||
|
|
e2b59c6cb5 | ||
|
|
736f2f387e | ||
|
|
486d9d9c4d | ||
|
|
ac8b868261 | ||
|
|
c0eb7e2d7e | ||
|
|
89a17fc7b9 | ||
|
|
ec43d4e65b | ||
|
|
03cc70759b | ||
|
|
f94743fda5 | ||
|
|
3eabba3e5d | ||
|
|
f2de8d3c65 | ||
|
|
10e16a0bdc | ||
|
|
f135845100 | ||
|
|
3c54b17760 | ||
|
|
9a67d9132f | ||
|
|
bd33e05304 | ||
|
|
83bdb7acd7 | ||
|
|
4fc9c671e8 | ||
|
|
6c18c3f39a | ||
|
|
19aa77ac49 | ||
|
|
25ec6bd1ea | ||
|
|
1b608fc446 | ||
|
|
09055582af | ||
|
|
4cfcabb63d | ||
|
|
cbfd53e0f9 | ||
|
|
fd11d89fa7 | ||
|
|
7f335274bf | ||
|
|
c01769aebd | ||
|
|
b80db2cebf | ||
|
|
97a16c9ca4 | ||
|
|
91033293b9 | ||
|
|
41a15aa169 | ||
|
|
e9bc9347cc | ||
|
|
70ab315092 | ||
|
|
8dcc74a95f | ||
|
|
27ffcb883c | ||
|
|
f29e6037c0 | ||
|
|
8193fa0763 | ||
|
|
3151019947 | ||
|
|
0d3e70299e | ||
|
|
32187a580c | ||
|
|
a9dae91e4d | ||
|
|
645926fd37 | ||
|
|
0b70167182 | ||
|
|
138b3deeb1 | ||
|
|
9f265f0178 | ||
|
|
26e02d295f | ||
|
|
bfe955ce1f | ||
|
|
50e760bac1 | ||
|
|
e882cdf84d | ||
|
|
c1286d5a9e | ||
|
|
b92d24429d | ||
|
|
f77f5ae770 | ||
|
|
82ffa52d79 | ||
|
|
d8ed55be7a | ||
|
|
16f77638f1 | ||
|
|
348ecb361c | ||
|
|
df8852e8dd | ||
|
|
95ab3676dc | ||
|
|
bf6ca64a08 | ||
|
|
4e36c08168 | ||
|
|
0577429e4e | ||
|
|
77fbef112d | ||
|
|
bb92081dde | ||
|
|
23b41db33d | ||
|
|
7b47af171d | ||
|
|
512574de9a | ||
|
|
46558e9060 | ||
|
|
f79776d06f | ||
|
|
6a1f7d61cf | ||
|
|
14cd044103 | ||
|
|
b6a9d8e4f9 | ||
|
|
e6493fd9e8 | ||
|
|
caeb0227b6 | ||
|
|
948eb369a6 | ||
|
|
107fda3c20 | ||
|
|
0166a1bc9b | ||
|
|
cae77c279d | ||
|
|
2c3c1e96d5 | ||
|
|
874cd4c1a2 | ||
|
|
0dc098a7ba | ||
|
|
7ee52d7e61 | ||
|
|
430c5d7db4 | ||
|
|
facba3a5e6 | ||
|
|
7d09f324fa | ||
|
|
af34b1cca2 | ||
|
|
463bfdd70a | ||
|
|
ff7d2a33b0 | ||
|
|
3ebfcd1c6c | ||
|
|
c3afd5f63c | ||
|
|
92abb112e9 | ||
|
|
7e1c64fb95 | ||
|
|
5e5cfce28c | ||
|
|
098090ed36 | ||
|
|
7f055cec7e | ||
|
|
5a0f8f1b64 | ||
|
|
92ec89bf87 | ||
|
|
afeaf2f28b | ||
|
|
865bd8d32b | ||
|
|
e368338ba7 | ||
|
|
7bd3e1cc0a | ||
|
|
28ce1492ad | ||
|
|
d9516325f0 | ||
|
|
d1e396f658 | ||
|
|
a916da0ce4 | ||
|
|
fc887b4431 | ||
|
|
7b08db2682 | ||
|
|
742aeb2f56 | ||
|
|
c1619fd6b3 | ||
|
|
1a593833a2 |
+1
-1
@@ -1,3 +1,3 @@
|
|||||||
/vendor
|
/vendor
|
||||||
composer.lock
|
composer.lock
|
||||||
.idea
|
.idea/
|
||||||
|
|||||||
+26
@@ -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
|
||||||
+19
-5
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "barryvdh/laravel-ide-helper",
|
"name": "barryvdh/laravel-ide-helper",
|
||||||
"description": "Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.",
|
"description": "Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.",
|
||||||
"keywords": ["laravel", "autocomplete", "phpstorm", "netbeans", "sublime", "codeintel", "phpdoc"],
|
"keywords": ["laravel", "autocomplete", "ide", "helper", "phpstorm", "netbeans", "sublime", "codeintel", "phpdoc"],
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"authors": [
|
"authors": [
|
||||||
{
|
{
|
||||||
@@ -11,16 +11,30 @@
|
|||||||
],
|
],
|
||||||
"require": {
|
"require": {
|
||||||
"php": ">=5.3.0",
|
"php": ">=5.3.0",
|
||||||
|
"illuminate/config": "4.x",
|
||||||
"illuminate/support": "4.x",
|
"illuminate/support": "4.x",
|
||||||
"illuminate/console": "4.x",
|
"illuminate/console": "4.x",
|
||||||
"illuminate/filesystem": "4.x",
|
"illuminate/filesystem": "4.x",
|
||||||
"barryvdh/reflection-docblock": ">=2.0.1",
|
"illuminate/database": "4.x",
|
||||||
|
"illuminate/view": "4.x",
|
||||||
|
"phpdocumentor/reflection-docblock": "^2.0.4",
|
||||||
"symfony/class-loader": "~2.3"
|
"symfony/class-loader": "~2.3"
|
||||||
},
|
},
|
||||||
|
"require-dev": {
|
||||||
|
"doctrine/dbal": "~2.3",
|
||||||
|
"phpunit/phpunit": "~4.0"
|
||||||
|
},
|
||||||
|
"suggest": {
|
||||||
|
"doctrine/dbal": "Load information from the database about models for phpdocs (~2.3)"
|
||||||
|
},
|
||||||
"autoload": {
|
"autoload": {
|
||||||
"psr-0": {
|
"psr-4": {
|
||||||
"Barryvdh\\LaravelIdeHelper": "src/"
|
"Barryvdh\\LaravelIdeHelper\\": "src"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"minimum-stability": "dev"
|
"extra": {
|
||||||
|
"branch-alias": {
|
||||||
|
"dev-master": "1.11-dev"
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
+18
@@ -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>
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
{
|
||||||
|
"providers": [
|
||||||
|
"Barryvdh\\LaravelIdeHelper\\IdeHelperServiceProvider"
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -1,43 +1,77 @@
|
|||||||
## Laravel IDE Helper Generator
|
## Laravel IDE Helper Generator
|
||||||
[](https://packagist.org/packages/barryvdh/laravel-ide-helper) [](https://packagist.org/packages/barryvdh/laravel-ide-helper)
|
[](https://packagist.org/packages/barryvdh/laravel-ide-helper) [](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
|
### Complete phpDocs, directly from the source
|
||||||
|
|
||||||
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.
|
_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 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)
|
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
|
* Generated version: https://gist.github.com/barryvdh/5227822
|
||||||
|
|
||||||
Note: You do need CodeIntel for Sublime Text: https://github.com/SublimeCodeIntel/SublimeCodeIntel
|
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
|
### 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`
|
||||||
|
|
||||||
|
```php
|
||||||
'Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider',
|
'Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider',
|
||||||
|
```
|
||||||
|
|
||||||
You can now re-generate the docs yourself (for future updates) in artisan
|
You can now re-generate the docs yourself (for future updates) in artisan
|
||||||
|
|
||||||
|
```bash
|
||||||
php artisan ide-helper:generate
|
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..)
|
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:
|
You can configure your composer.json to do this after each commit:
|
||||||
|
|
||||||
|
```json
|
||||||
"scripts":{
|
"scripts":{
|
||||||
"post-update-cmd":[
|
"post-update-cmd":[
|
||||||
|
"php artisan clear-compiled",
|
||||||
"php artisan ide-helper:generate",
|
"php artisan ide-helper:generate",
|
||||||
"php artisan optimize",
|
"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.
|
You can also publish the config-file to change implementations (ie. interface to specific class) or set defaults for --helpers or --sublime.
|
||||||
|
|
||||||
|
```bash
|
||||||
php artisan config:publish barryvdh/laravel-ide-helper
|
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.
|
The generator tries to identify the real class, but if it cannot be found, you can define it in the config file.
|
||||||
|
|
||||||
@@ -47,19 +81,20 @@ 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.
|
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.
|
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
|
### Automatic phpDocs for Models
|
||||||
|
|
||||||
If you don't want to write your properties yourself, you can use the command `ide-helper:models` to generate
|
> **Note:** Since v1.10 you need to require `doctrine/dbal: ~2.3` in your own composer.json.
|
||||||
phpDocs, based on table columns, relations and getters/setters. Still in beta, so please provide feedback if you want.
|
|
||||||
Docs are written to a phpfile (_ide_helper_models.php) in the root of the project, so you can move the docs to the real model.
|
|
||||||
|
|
||||||
You can now also write the comments directly to your Model file, using the `--write (-W)` option. Please make sure to backup your models, before writing the info.
|
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)`).
|
||||||
|
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.
|
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.
|
With the `--reset (-R)` option, the existing phpdocs are ignored, only the newly found columns/relations are saved as phpdocs.
|
||||||
|
|
||||||
|
```bash
|
||||||
php artisan ide-helper:models Post
|
php artisan ide-helper:models Post
|
||||||
|
```
|
||||||
|
```php
|
||||||
/**
|
/**
|
||||||
* An Eloquent Model: 'Post'
|
* An Eloquent Model: 'Post'
|
||||||
*
|
*
|
||||||
@@ -72,12 +107,29 @@ With the `--reset (-R)` option, the existing phpdocs are ignored, only the newly
|
|||||||
* @property-read \User $author
|
* @property-read \User $author
|
||||||
* @property-read \Illuminate\Database\Eloquent\Collection|\Comment[] $comments
|
* @property-read \Illuminate\Database\Eloquent\Collection|\Comment[] $comments
|
||||||
*/
|
*/
|
||||||
|
```
|
||||||
|
|
||||||
For now, only models in app/models are scanned. The optional argument tells what models to use (also outside app/models).
|
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
|
||||||
|
```
|
||||||
|
|
||||||
Note: With namespaces, uses `\\` instead of `\`: `php artisan ide-helper:models API\\User`
|
You can also scan a different directory, using the --dir option (relative from the base path):
|
||||||
|
|
||||||
|
```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
|
||||||
|
|
||||||
|
```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`)
|
||||||
|
|
||||||
### License
|
### License
|
||||||
|
|
||||||
|
|||||||
+287
@@ -0,0 +1,287 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Laravel IDE Helper Generator
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @copyright 2014 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;
|
||||||
|
|
||||||
|
class Alias
|
||||||
|
{
|
||||||
|
protected $alias;
|
||||||
|
protected $facade;
|
||||||
|
protected $extends = null;
|
||||||
|
protected $classType = 'class';
|
||||||
|
protected $short;
|
||||||
|
protected $namespace = '__root';
|
||||||
|
protected $root = null;
|
||||||
|
protected $classes = array();
|
||||||
|
protected $methods = array();
|
||||||
|
protected $usedMethods = array();
|
||||||
|
protected $valid = false;
|
||||||
|
protected $magicMethods = array();
|
||||||
|
protected $interfaces = array();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param string $alias
|
||||||
|
* @param string $facade
|
||||||
|
* @param array $magicMethods
|
||||||
|
* @param array $interfaces
|
||||||
|
*/
|
||||||
|
public function __construct($alias, $facade, $magicMethods = array(), $interfaces = array())
|
||||||
|
{
|
||||||
|
$this->alias = $alias;
|
||||||
|
$this->magicMethods = $magicMethods;
|
||||||
|
$this->interfaces = $interfaces;
|
||||||
|
|
||||||
|
// Make the class absolute
|
||||||
|
$facade = '\\' . ltrim($facade, '\\');
|
||||||
|
$this->facade = $facade;
|
||||||
|
|
||||||
|
$this->detectRoot();
|
||||||
|
|
||||||
|
if ((!$this->isTrait() && $this->root)) {
|
||||||
|
$this->valid = true;
|
||||||
|
} else {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$this->addClass($this->root);
|
||||||
|
$this->detectNamespace();
|
||||||
|
$this->detectClassType();
|
||||||
|
|
||||||
|
if ($facade === '\Illuminate\Database\Eloquent\Model') {
|
||||||
|
$this->usedMethods = array('decrement', 'increment');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add one or more classes to analyze
|
||||||
|
*
|
||||||
|
* @param array|string $classes
|
||||||
|
*/
|
||||||
|
public function addClass($classes)
|
||||||
|
{
|
||||||
|
$classes = (array)$classes;
|
||||||
|
foreach ($classes as $class) {
|
||||||
|
if (class_exists($class) || interface_exists($class)) {
|
||||||
|
$this->classes[] = $class;
|
||||||
|
} else {
|
||||||
|
$this->error('Class not exists: ' . $class);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if this class is valid to process.
|
||||||
|
* @return bool
|
||||||
|
*/
|
||||||
|
public function isValid()
|
||||||
|
{
|
||||||
|
return $this->valid;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the classType, 'interface' or 'class'
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getClassType()
|
||||||
|
{
|
||||||
|
return $this->classType;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the class which this alias extends
|
||||||
|
*
|
||||||
|
* @return null|string
|
||||||
|
*/
|
||||||
|
public function getExtends()
|
||||||
|
{
|
||||||
|
return $this->extends;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the Alias by which this class is called
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getAlias()
|
||||||
|
{
|
||||||
|
return $this->alias;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return the short name (without namespace)
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getShortName()
|
||||||
|
{
|
||||||
|
return $this->short;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the namespace from the alias
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getNamespace()
|
||||||
|
{
|
||||||
|
return $this->namespace;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the methods found by this Alias
|
||||||
|
*
|
||||||
|
* @return array|Method[]
|
||||||
|
*/
|
||||||
|
public function getMethods()
|
||||||
|
{
|
||||||
|
$this->addMagicMethods();
|
||||||
|
$this->detectMethods();
|
||||||
|
return $this->methods;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Detect the namespace
|
||||||
|
*/
|
||||||
|
protected function detectNamespace()
|
||||||
|
{
|
||||||
|
if (strpos($this->alias, '\\')) {
|
||||||
|
$nsParts = explode('\\', $this->alias);
|
||||||
|
$this->short = array_pop($nsParts);
|
||||||
|
$this->namespace = implode('\\', $nsParts);
|
||||||
|
} else {
|
||||||
|
$this->short = $this->alias;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Detect the class type
|
||||||
|
*/
|
||||||
|
protected function detectClassType()
|
||||||
|
{
|
||||||
|
//Some classes extend the facade
|
||||||
|
if (interface_exists($this->facade)) {
|
||||||
|
$this->classType = 'interface';
|
||||||
|
$this->extends = $this->facade;
|
||||||
|
} else {
|
||||||
|
$this->classType = 'class';
|
||||||
|
if (class_exists($this->facade)) {
|
||||||
|
$this->extends = $this->facade;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the real root of a facade
|
||||||
|
*
|
||||||
|
* @return bool|string
|
||||||
|
*/
|
||||||
|
protected function detectRoot()
|
||||||
|
{
|
||||||
|
$facade = $this->facade;
|
||||||
|
|
||||||
|
try {
|
||||||
|
//If possible, get the facade root
|
||||||
|
if (method_exists($facade, 'getFacadeRoot')) {
|
||||||
|
$root = get_class($facade::getFacadeRoot());
|
||||||
|
} else {
|
||||||
|
$root = $facade;
|
||||||
|
}
|
||||||
|
|
||||||
|
//If it doesn't exist, skip it
|
||||||
|
if (!class_exists($root) && !interface_exists($root)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$this->root = $root;
|
||||||
|
|
||||||
|
//When the database connection is not set, some classes will be skipped
|
||||||
|
} catch (\PDOException $e) {
|
||||||
|
$this->error(
|
||||||
|
'PDOException: ' . $e->getMessage() . "\nPlease configure your database connection correctly, or use the sqlite memory driver (-M). Skipping $facade."
|
||||||
|
);
|
||||||
|
} catch (\Exception $e) {
|
||||||
|
$this->error('Exception: ' . $e->getMessage() . "\nSkipping $facade.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Detect if this class is a trait or not.
|
||||||
|
*
|
||||||
|
* @return bool
|
||||||
|
*/
|
||||||
|
protected function isTrait()
|
||||||
|
{
|
||||||
|
// Check if the facade is not a Trait
|
||||||
|
if (function_exists('trait_exists') && trait_exists($this->facade)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add magic methods, as defined in the configuration files
|
||||||
|
*/
|
||||||
|
protected function addMagicMethods()
|
||||||
|
{
|
||||||
|
foreach ($this->magicMethods as $magic => $real) {
|
||||||
|
list($className, $name) = explode('::', $real);
|
||||||
|
if (!class_exists($className) && !interface_exists($className)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
$method = new \ReflectionMethod($className, $name);
|
||||||
|
$class = new \ReflectionClass($className);
|
||||||
|
|
||||||
|
if (!in_array($method->name, $this->usedMethods)) {
|
||||||
|
if ($class !== $this->root) {
|
||||||
|
$this->methods[] = new Method($method, $this->alias, $class, $magic, $this->interfaces);
|
||||||
|
}
|
||||||
|
$this->usedMethods[] = $magic;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the methods for one or multiple classes.
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
protected function detectMethods()
|
||||||
|
{
|
||||||
|
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.
|
||||||
|
// And don't add the __*() methods
|
||||||
|
if ($this->extends !== $class && substr($method->name, 0, 2) !== '__') {
|
||||||
|
$this->methods[] = new Method($method, $this->alias, $reflection, $method->name, $this->interfaces);
|
||||||
|
}
|
||||||
|
$this->usedMethods[] = $method->name;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Output an error.
|
||||||
|
*
|
||||||
|
* @param string $string
|
||||||
|
* @return void
|
||||||
|
*/
|
||||||
|
protected function error($string)
|
||||||
|
{
|
||||||
|
echo $string . "\r\n";
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,449 +0,0 @@
|
|||||||
<?php
|
|
||||||
/**
|
|
||||||
* Laravel IDE Helper Generator
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
* @copyright 2013 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;
|
|
||||||
use Illuminate\Console\Command;
|
|
||||||
use Symfony\Component\Console\Input\InputOption;
|
|
||||||
use Symfony\Component\Console\Input\InputArgument;
|
|
||||||
use Illuminate\Foundation\AliasLoader;
|
|
||||||
use Barryvdh\Reflection\DocBlock;
|
|
||||||
use Barryvdh\Reflection\DocBlock\Context;
|
|
||||||
use Barryvdh\Reflection\DocBlock\Tag;
|
|
||||||
use Barryvdh\Reflection\DocBlock\Serializer as DocBlockSerializer;
|
|
||||||
/**
|
|
||||||
* A command to generate autocomplete information for your IDE
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
*/
|
|
||||||
class GeneratorCommand extends Command {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The console command name.
|
|
||||||
*
|
|
||||||
* @var string
|
|
||||||
*/
|
|
||||||
protected $name = 'ide-helper:generate';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The console command description.
|
|
||||||
*
|
|
||||||
* @var string
|
|
||||||
*/
|
|
||||||
protected $description = 'Generate a new IDE Helper file.';
|
|
||||||
|
|
||||||
protected $extra;
|
|
||||||
protected $onlyExtend;
|
|
||||||
protected $helpers;
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Execute the console command.
|
|
||||||
*
|
|
||||||
* @return void
|
|
||||||
*/
|
|
||||||
public function fire()
|
|
||||||
{
|
|
||||||
if (file_exists($compiled = base_path().'/bootstrap/compiled.php')){
|
|
||||||
$this->error('Error generating IDE Helper: first delete bootstrap/compiled.php (php artisan clear-compiled)');
|
|
||||||
}else{
|
|
||||||
$filename = $this->argument('filename');
|
|
||||||
|
|
||||||
if($this->option('memory')){
|
|
||||||
$this->useMemoryDriver();
|
|
||||||
}
|
|
||||||
|
|
||||||
$this->extra = \Config::get('laravel-ide-helper::extra');
|
|
||||||
|
|
||||||
if( $this->option('helpers') || (\Config::get('laravel-ide-helper::include_helpers') )){
|
|
||||||
$this->helpers = \Config::get('laravel-ide-helper::helper_files');
|
|
||||||
}else{
|
|
||||||
$this->helpers = array();
|
|
||||||
}
|
|
||||||
|
|
||||||
$content = $this->generateDocs();
|
|
||||||
|
|
||||||
$written = \File::put($filename, $content);
|
|
||||||
|
|
||||||
if($written !== false){
|
|
||||||
$this->info("A new helper file was written to $filename");
|
|
||||||
}else{
|
|
||||||
$this->error("The helper file could not be created at $filename");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
protected function useMemoryDriver(){
|
|
||||||
//Use a sqlite database in memory, to avoid connection errors on Database facades
|
|
||||||
\Config::set('database.connections.sqlite',array(
|
|
||||||
'driver' => 'sqlite',
|
|
||||||
'database' => ':memory:',
|
|
||||||
));
|
|
||||||
\Config::set('database.default', 'sqlite');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the console command arguments.
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
protected function getArguments()
|
|
||||||
{
|
|
||||||
return array(
|
|
||||||
array('filename', InputArgument::OPTIONAL, 'The path to the helper file', \Config::get('laravel-ide-helper::filename')),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the console command options.
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
protected function getOptions()
|
|
||||||
{
|
|
||||||
return array(
|
|
||||||
array('helpers', "H", InputOption::VALUE_NONE, 'Include the helper files'),
|
|
||||||
array('memory', "M", InputOption::VALUE_NONE, 'Use sqlite memory driver'),
|
|
||||||
array('sublime', "S", InputOption::VALUE_NONE, 'DEPRECATED: Use different style for SublimeText CodeIntel'),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate the docs for all facades in the AliasLoader
|
|
||||||
*
|
|
||||||
* @return string
|
|
||||||
*/
|
|
||||||
protected function generateDocs(){
|
|
||||||
|
|
||||||
$aliasLoader = AliasLoader::getInstance();
|
|
||||||
|
|
||||||
$output = "<?php
|
|
||||||
/**
|
|
||||||
* An helper file for Laravel 4, to provide autocomplete information to your IDE
|
|
||||||
* Generated with https://github.com/barryvdh/laravel-ide-helper
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
*/
|
|
||||||
exit('Only to be used as an helper for your IDE');\n\n";
|
|
||||||
|
|
||||||
//Get all aliases
|
|
||||||
$aliases = $aliasLoader->getAliases();
|
|
||||||
|
|
||||||
foreach($aliases as $alias => $facade){
|
|
||||||
|
|
||||||
$root = $this->getRoot($facade);
|
|
||||||
if(!$root){
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
|
|
||||||
try{
|
|
||||||
|
|
||||||
//Some classes extend the facade
|
|
||||||
if(class_exists($facade)){
|
|
||||||
$output .= "class $alias extends $facade{\n";
|
|
||||||
}else{
|
|
||||||
$output .= "class $alias{\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
$usedMethods = array();
|
|
||||||
|
|
||||||
//Only add the methods to the output when the root is not the same as the facade.
|
|
||||||
$addOutput = ($root !== $facade);
|
|
||||||
$output .= $this->getMethods($root, $alias, $usedMethods, $addOutput);
|
|
||||||
|
|
||||||
|
|
||||||
$driver = $this->getDriver($alias);
|
|
||||||
if($driver){
|
|
||||||
$output .= $this->getMethods($driver, $alias, $usedMethods);
|
|
||||||
}
|
|
||||||
|
|
||||||
//Add extra methods, from other classes (magic static calls)
|
|
||||||
if(array_key_exists($alias, $this->extra)){
|
|
||||||
$output .= $this->getMethods($this->extra[$alias], $alias, $usedMethods);
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
$output .= "}\n\n";
|
|
||||||
|
|
||||||
}catch(\Exception $e){
|
|
||||||
$this->error("Exception: ".$e->getMessage()."\nCould not analyze $root.");
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
//Include the helper file, if requested
|
|
||||||
if(!empty($helpers)){
|
|
||||||
foreach($helpers as $helper){
|
|
||||||
if (file_exists($helper)){
|
|
||||||
$output .= str_replace(array('<?php', '?>'), '', \File::get($helper));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return $output;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the real root of a facade
|
|
||||||
*
|
|
||||||
* @param $facade
|
|
||||||
* @return bool|string
|
|
||||||
*/
|
|
||||||
protected function getRoot($facade){
|
|
||||||
try{
|
|
||||||
//If possible, get the facade root
|
|
||||||
if(method_exists($facade, 'getFacadeRoot')){
|
|
||||||
$root = get_class($facade::getFacadeRoot());
|
|
||||||
}else{
|
|
||||||
$root = $facade;
|
|
||||||
}
|
|
||||||
|
|
||||||
//If it doesn't exist, skip it
|
|
||||||
if(!class_exists($root) && !interface_exists($root)){
|
|
||||||
$this->error("Class $root is not found.");
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
return $root;
|
|
||||||
|
|
||||||
//When the database connection is not set, some classes will be skipped
|
|
||||||
}catch(\PDOException $e){
|
|
||||||
$this->error("PDOException: ".$e->getMessage()."\nPlease configure your database connection correctly, or use the sqlite memory driver (-M). Skipping $facade.");
|
|
||||||
return false;
|
|
||||||
}catch(\Exception $e){
|
|
||||||
$this->error("Exception: ".$e->getMessage()."\nSkipping $facade.");
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
public function getDriver($alias){
|
|
||||||
if($alias == "Auth"){
|
|
||||||
$driver = \Auth::driver();
|
|
||||||
}elseif($alias == "DB"){
|
|
||||||
$driver = \DB::connection();
|
|
||||||
}elseif($alias == "Cache"){
|
|
||||||
$driver = \Cache::driver();
|
|
||||||
}elseif($alias == "Queue"){
|
|
||||||
$driver = \Queue::connection();
|
|
||||||
}else{
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
return get_class($driver);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the methods for one or multiple classes.
|
|
||||||
*
|
|
||||||
* @param $classes
|
|
||||||
* @param $alias
|
|
||||||
* @param $usedMethods
|
|
||||||
* @param bool $addOutput
|
|
||||||
* @return string
|
|
||||||
*/
|
|
||||||
protected function getMethods($classes, $alias, &$usedMethods, $addOutput = true){
|
|
||||||
if(!is_array($classes)){
|
|
||||||
$classes = array($classes);
|
|
||||||
}
|
|
||||||
$output = '';
|
|
||||||
foreach($classes as $class){
|
|
||||||
if(!class_exists($class) && !interface_exists($class)){
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
$reflection = new \ReflectionClass($class);
|
|
||||||
|
|
||||||
$methods = $reflection->getMethods(\ReflectionMethod::IS_PUBLIC);
|
|
||||||
if($methods)
|
|
||||||
{
|
|
||||||
foreach ($methods as $method)
|
|
||||||
{
|
|
||||||
if(!in_array($method->name, $usedMethods)){
|
|
||||||
if( $addOutput){
|
|
||||||
$output .= $this->parseMethod($method, $alias, $reflection);
|
|
||||||
}
|
|
||||||
$usedMethods[] = $method->name;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return $output;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @param \ReflectionMethod $method
|
|
||||||
* @param string $alias
|
|
||||||
* @return string
|
|
||||||
*/
|
|
||||||
protected function parseMethod($method, $alias, $class){
|
|
||||||
$output = '';
|
|
||||||
|
|
||||||
// Don't add the __clone() functions
|
|
||||||
if($method->name === '__clone'){
|
|
||||||
return $output;
|
|
||||||
}
|
|
||||||
|
|
||||||
$namespace = $method->getDeclaringClass()->getNamespaceName();
|
|
||||||
|
|
||||||
//Create a DocBlock and serializer instance
|
|
||||||
$phpdoc = new DocBlock($method, new Context($namespace));
|
|
||||||
$serializer = new DocBlockSerializer(1, "\t");
|
|
||||||
|
|
||||||
//Normalize the description and inherit the docs from parents/interfaces
|
|
||||||
$this->normalizeDescription($phpdoc, $method);
|
|
||||||
|
|
||||||
//Correct the return values
|
|
||||||
$returnValue = $this->normalizeReturn($phpdoc, $method, $alias);
|
|
||||||
|
|
||||||
//Get the parameters, including formatted default values
|
|
||||||
list($params, $paramsWithDefault) = $this->getParameters($method);
|
|
||||||
|
|
||||||
//Make the method static
|
|
||||||
$phpdoc->appendTag(Tag::createInstance('@static', $phpdoc));
|
|
||||||
|
|
||||||
//Write the output, using the DocBlock serializer
|
|
||||||
$output .= $serializer->getDocComment($phpdoc) ."\n\t public static function ".$method->name."(";
|
|
||||||
|
|
||||||
$output .= implode($paramsWithDefault, ", ");
|
|
||||||
$output .= "){\r\n";
|
|
||||||
|
|
||||||
//Only return when not a constructor and not void.
|
|
||||||
$return = ($returnValue && $returnValue !== "void" && $method->name !== "__construct") ? 'return' : '';
|
|
||||||
|
|
||||||
//Reference the 'real' function in the declaringclass
|
|
||||||
$declaringClass = $method->getDeclaringClass();
|
|
||||||
$root = $class->getName();
|
|
||||||
|
|
||||||
if($declaringClass->name != $root){
|
|
||||||
$output .= "\t\t//Method inherited from $declaringClass->name\r\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
$output .= "\t\t$return $root::";
|
|
||||||
|
|
||||||
//Write the default parameters in the function call
|
|
||||||
$output .= $method->name."(".implode($params, ", ").");\r\n";
|
|
||||||
$output .= "\t }\n\n";
|
|
||||||
|
|
||||||
return $output;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the description and get the inherited docs.
|
|
||||||
*
|
|
||||||
* @param $phpdoc
|
|
||||||
* @param $method
|
|
||||||
*/
|
|
||||||
protected function normalizeDescription(&$phpdoc, $method){
|
|
||||||
//Get the short + long description from the DocBlock
|
|
||||||
$description = $phpdoc->getText();
|
|
||||||
|
|
||||||
//Loop through parents/interfaces, to fill in {@inheritdoc}
|
|
||||||
if(strpos($description, '{@inheritdoc}') !== false){
|
|
||||||
$inheritdoc = $this->getInheritDoc($method);
|
|
||||||
$inheritDescription = $inheritdoc->getText();
|
|
||||||
|
|
||||||
$description = str_replace('{@inheritdoc}', $inheritDescription, $description);
|
|
||||||
$phpdoc->setText($description);
|
|
||||||
|
|
||||||
//Add the tags that are inherited
|
|
||||||
$inheritTags = $inheritdoc->getTags();
|
|
||||||
if($inheritTags){
|
|
||||||
foreach($inheritTags as $tag){
|
|
||||||
$tag->setDocBlock();
|
|
||||||
$phpdoc->appendTag($tag);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Make some changes to the return types, if needed.
|
|
||||||
*
|
|
||||||
* @param $phpdoc
|
|
||||||
* @param $method
|
|
||||||
* @param $alias
|
|
||||||
* @return null
|
|
||||||
*/
|
|
||||||
protected function normalizeReturn(&$phpdoc, $method, $alias){
|
|
||||||
//Get the return type and adjust them for beter autocomplete
|
|
||||||
$returnTags = $phpdoc->getTagsByName('return');
|
|
||||||
if($returnTags){
|
|
||||||
/** @var $tag */
|
|
||||||
$tag = reset($returnTags);
|
|
||||||
$returnValue = $tag->getType();
|
|
||||||
|
|
||||||
if($method->name == "__construct"){
|
|
||||||
$tag->setType('self');
|
|
||||||
}elseif($alias == 'Eloquent' and in_array($method->name, array('hasOne', 'hasMany', 'belongsTo', 'belongsToMany', 'morphOne', 'morphTo', 'morphMany'))){
|
|
||||||
$tag->addType('\Eloquent');
|
|
||||||
}
|
|
||||||
}else{
|
|
||||||
$returnValue = null;
|
|
||||||
}
|
|
||||||
return $returnValue;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the parameters and format them correctly
|
|
||||||
*
|
|
||||||
* @param $method
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
public function getParameters($method){
|
|
||||||
//Loop through the default values for paremeters, 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)){
|
|
||||||
$default = $default? 'true':'false';
|
|
||||||
}elseif(is_array($default)){
|
|
||||||
$default = 'array()';
|
|
||||||
}elseif(is_null($default)){
|
|
||||||
$default = 'null';
|
|
||||||
}elseif(is_int($default)){
|
|
||||||
//$default = $default;
|
|
||||||
}else{
|
|
||||||
$default = "'".trim($default)."'";
|
|
||||||
}
|
|
||||||
$paramStr .= " = $default";
|
|
||||||
}
|
|
||||||
$paramsWithDefault[] = $paramStr;
|
|
||||||
}
|
|
||||||
return array($params, $paramsWithDefault);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @param \ReflectionMethod $reflectionMethod
|
|
||||||
* @return string
|
|
||||||
*/
|
|
||||||
protected function getInheritDoc($reflectionMethod){
|
|
||||||
$parentClass = $reflectionMethod->getDeclaringClass()->getParentClass();
|
|
||||||
|
|
||||||
//Get either a parent or the interface
|
|
||||||
if($parentClass){
|
|
||||||
$method = $parentClass->getMethod($reflectionMethod->getName());
|
|
||||||
}else{
|
|
||||||
$method = $reflectionMethod->getPrototype();
|
|
||||||
}
|
|
||||||
if($method){
|
|
||||||
$phpdoc = new DocBlock($method);
|
|
||||||
if(strpos($phpdoc->getText(), '{@inheritdoc}') !== false ){
|
|
||||||
//Not at the end yet, try another parent/interface..
|
|
||||||
return $this->getInheritDoc($method);
|
|
||||||
}else{
|
|
||||||
return $phpdoc;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
<?php
|
|
||||||
/**
|
|
||||||
* Laravel IDE Helper Generator
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
* @copyright 2013 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;
|
|
||||||
|
|
||||||
use Illuminate\Support\ServiceProvider;
|
|
||||||
|
|
||||||
class IdeHelperServiceProvider extends ServiceProvider {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Indicates if loading of the provider is deferred.
|
|
||||||
*
|
|
||||||
* @var bool
|
|
||||||
*/
|
|
||||||
protected $defer = false;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Bootstrap the application events.
|
|
||||||
*
|
|
||||||
* @return void
|
|
||||||
*/
|
|
||||||
public function boot()
|
|
||||||
{
|
|
||||||
$this->package('barryvdh/laravel-ide-helper');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Register the service provider.
|
|
||||||
*
|
|
||||||
* @return void
|
|
||||||
*/
|
|
||||||
public function register()
|
|
||||||
{
|
|
||||||
|
|
||||||
$this->app['command.ide-helper.generate'] = $this->app->share(function($app)
|
|
||||||
{
|
|
||||||
return new GeneratorCommand;
|
|
||||||
});
|
|
||||||
$this->commands('command.ide-helper.generate');
|
|
||||||
|
|
||||||
$this->app['command.ide-helper.models'] = $this->app->share(function($app)
|
|
||||||
{
|
|
||||||
return new ModelsCommand();
|
|
||||||
});
|
|
||||||
$this->commands('command.ide-helper.models');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the services provided by the provider.
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
public function provides()
|
|
||||||
{
|
|
||||||
return array('command.ide-helper.generate', 'command.ide-helper.models');
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,390 +0,0 @@
|
|||||||
<?php
|
|
||||||
/**
|
|
||||||
* Laravel IDE Helper Generator
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
* @copyright 2013 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;
|
|
||||||
use Illuminate\Console\Command;
|
|
||||||
use Symfony\Component\Console\Input\InputOption;
|
|
||||||
use Symfony\Component\Console\Input\InputArgument;
|
|
||||||
use Symfony\Component\ClassLoader\ClassMapGenerator;
|
|
||||||
use Barryvdh\Reflection\DocBlock;
|
|
||||||
use Barryvdh\Reflection\DocBlock\Context;
|
|
||||||
use Barryvdh\Reflection\DocBlock\Tag;
|
|
||||||
use Barryvdh\Reflection\DocBlock\Serializer as DocBlockSerializer;
|
|
||||||
/**
|
|
||||||
* A command to generate autocomplete information for your IDE
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
*/
|
|
||||||
class ModelsCommand extends Command {
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The console command name.
|
|
||||||
*
|
|
||||||
* @var string
|
|
||||||
*/
|
|
||||||
protected $name = 'ide-helper:models';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The console command description.
|
|
||||||
*
|
|
||||||
* @var string
|
|
||||||
*/
|
|
||||||
protected $description = 'Generate autocompletion for models';
|
|
||||||
|
|
||||||
protected $properties = array();
|
|
||||||
protected $methods = array();
|
|
||||||
protected $write = false;
|
|
||||||
protected $dir;
|
|
||||||
protected $reset;
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Execute the console command.
|
|
||||||
*
|
|
||||||
* @return void
|
|
||||||
*/
|
|
||||||
public function fire()
|
|
||||||
{
|
|
||||||
$filename = $this->option('filename');
|
|
||||||
$this->write = $this->option('write');
|
|
||||||
$this->dir = $this->option('dir');
|
|
||||||
$model = $this->argument('model');
|
|
||||||
$this->reset = $this->option('reset');
|
|
||||||
|
|
||||||
$content = $this->generateDocs($model);
|
|
||||||
|
|
||||||
if(!$this->write){
|
|
||||||
$written = \File::put($filename, $content);
|
|
||||||
if($written !== false){
|
|
||||||
$this->info("Model information was written to $filename");
|
|
||||||
}else{
|
|
||||||
$this->error("Failed to write model information to $filename");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the console command arguments.
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
protected function getArguments()
|
|
||||||
{
|
|
||||||
return array(
|
|
||||||
array('model', InputArgument::OPTIONAL, 'Which models to include', '*'),
|
|
||||||
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the console command options.
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
protected function getOptions()
|
|
||||||
{
|
|
||||||
return array(
|
|
||||||
array('filename', 'F', InputOption::VALUE_OPTIONAL, 'The path to the helper file', '_ide_helper_models.php'),
|
|
||||||
array('dir', 'D', InputOption::VALUE_OPTIONAL, 'The model dir','app/models'),
|
|
||||||
array('write', 'W', InputOption::VALUE_NONE, 'Write to Model file'),
|
|
||||||
array('reset', 'R', InputOption::VALUE_NONE, 'Remove the original phpdocs instead of appending'),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
protected function generateDocs($model){
|
|
||||||
|
|
||||||
|
|
||||||
$output = "<?php
|
|
||||||
/**
|
|
||||||
* An helper file for your Eloquent Models
|
|
||||||
* Copy the phpDocs from this file to the correct Model,
|
|
||||||
* And remove them from this file, to prevent double declarations.
|
|
||||||
*
|
|
||||||
* @author Barry vd. Heuvel <[email protected]>
|
|
||||||
*/
|
|
||||||
\n\n";
|
|
||||||
|
|
||||||
if($model === '*'){
|
|
||||||
$models = $this->loadModels();
|
|
||||||
}else{
|
|
||||||
$models = explode(',', $model);
|
|
||||||
}
|
|
||||||
|
|
||||||
foreach($models as $name){
|
|
||||||
$this->properties = array();
|
|
||||||
$this->methods = array();
|
|
||||||
if(class_exists($name)){
|
|
||||||
try{
|
|
||||||
$model = new $name();
|
|
||||||
$this->getPropertiesFromTable($model);
|
|
||||||
$this->getPropertiesFromMethods($model);
|
|
||||||
$output .= $this->createPhpDocs($name);
|
|
||||||
}catch(\Exception $e){
|
|
||||||
$this->error("Exception: ".$e->getMessage()."\nCould not analyze class $name.");
|
|
||||||
}
|
|
||||||
}else{
|
|
||||||
$this->error("Class $name does not exist");
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
return $output;
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
protected function loadModels(){
|
|
||||||
$dir = base_path().'/'.$this->dir;
|
|
||||||
$models = array();
|
|
||||||
if(file_exists($dir)){
|
|
||||||
foreach(ClassMapGenerator::createMap($dir) as $model=> $path){
|
|
||||||
$models[] = $model;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return $models;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load the properties from the database table.
|
|
||||||
*
|
|
||||||
* @param \Illuminate\Database\Eloquent\Model $model
|
|
||||||
*/
|
|
||||||
protected function getPropertiesFromTable($model){
|
|
||||||
$table = $model->getTable();
|
|
||||||
$schema = $model->getConnection()->getDoctrineSchemaManager($table);
|
|
||||||
$schema->getDatabasePlatform()->registerDoctrineTypeMapping('enum', 'string');
|
|
||||||
|
|
||||||
$columns = $schema->listTableColumns($table);
|
|
||||||
|
|
||||||
if($columns){
|
|
||||||
foreach ($columns as $column) {
|
|
||||||
$name = $column->getName();
|
|
||||||
$type = $column->getType()->getName();
|
|
||||||
|
|
||||||
switch($type){
|
|
||||||
case 'string':
|
|
||||||
case 'text':
|
|
||||||
case 'date':
|
|
||||||
case 'time':
|
|
||||||
case 'guid':
|
|
||||||
$type = 'string';
|
|
||||||
break;
|
|
||||||
case 'integer':
|
|
||||||
case 'bigint':
|
|
||||||
case 'smallint':
|
|
||||||
$type = 'integer';
|
|
||||||
break;
|
|
||||||
case 'decimal':
|
|
||||||
case 'float':
|
|
||||||
$type = 'float';
|
|
||||||
break;
|
|
||||||
case 'boolean':
|
|
||||||
$type = 'boolean';
|
|
||||||
break;
|
|
||||||
case 'datetimetz': //String or DateTime, depending on $dates
|
|
||||||
case 'datetime':
|
|
||||||
$type = '\Carbon\Carbon';
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
$type = 'mixed';
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
$this->setProperty($name, $type, true, true);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @param \Illuminate\Database\Eloquent\Model $model
|
|
||||||
*/
|
|
||||||
protected function getPropertiesFromMethods($model){
|
|
||||||
$methods = get_class_methods($model);
|
|
||||||
if($methods){
|
|
||||||
foreach($methods as $method){
|
|
||||||
if(\Str::startsWith($method, 'get') && \Str::endsWith($method, 'Attribute') && $method !== 'setAttribute'){
|
|
||||||
//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($method, 'Attribute') && $method !== 'setAttribute'){
|
|
||||||
//Magic set<name>Attribute
|
|
||||||
$name = \Str::snake(substr($method, 3, -9));
|
|
||||||
if(!empty($name)){
|
|
||||||
$this->setProperty($name, null, null, true);
|
|
||||||
}
|
|
||||||
}elseif(\Str::startsWith($method, 'scope') && $method !== 'scopeQuery'){
|
|
||||||
//Magic set<name>Attribute
|
|
||||||
$name = \Str::snake(substr($method, 5));
|
|
||||||
if(!empty($name)){
|
|
||||||
$this->setMethod($name, 'static');
|
|
||||||
}
|
|
||||||
}elseif(!method_exists('Eloquent', $method) && !\Str::startsWith($method, 'get')){
|
|
||||||
|
|
||||||
//Use reflection to inspect the code, based on Illuminate/Support/SerializableClosure.php
|
|
||||||
$reflection = new \ReflectionMethod($model, $method);
|
|
||||||
|
|
||||||
$file = new \SplFileObject($reflection->getFileName());
|
|
||||||
$file->seek($reflection->getStartLine() - 1);
|
|
||||||
|
|
||||||
$code = '';
|
|
||||||
while ($file->key() < $reflection->getEndLine())
|
|
||||||
{
|
|
||||||
$code .= $file->current(); $file->next();
|
|
||||||
}
|
|
||||||
$begin = strpos($code, 'function(');
|
|
||||||
$code = substr($code, $begin, strrpos($code, '}') - $begin + 1);
|
|
||||||
|
|
||||||
$begin = stripos($code, 'return $this->');
|
|
||||||
$parts = explode("'", substr($code, $begin+14),3); //"return $this->" is 14 chars
|
|
||||||
if (isset($parts[2]))
|
|
||||||
{
|
|
||||||
list($relation, $returnModel, $rest) = $parts;
|
|
||||||
$returnModel = "\\".ltrim($returnModel, "\\");
|
|
||||||
$relation = trim($relation, ' (');
|
|
||||||
|
|
||||||
if($relation === "belongsTo" or $relation === 'hasOne'){
|
|
||||||
//Single model is returned
|
|
||||||
$this->setProperty($method, $returnModel, true, null);
|
|
||||||
}elseif($relation === "belongsToMany" or $relation === 'hasMany'){
|
|
||||||
//Collection or array of models (because Collection is Arrayable)
|
|
||||||
$this->setProperty($method, '\Illuminate\Database\Eloquent\Collection|'.$returnModel.'[]', true, null);
|
|
||||||
}
|
|
||||||
}else{
|
|
||||||
//Not a relation
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @param string $name
|
|
||||||
* @param string|null $type
|
|
||||||
* @param bool|null $read
|
|
||||||
* @param bool|null $write
|
|
||||||
*/
|
|
||||||
protected function setProperty($name, $type = null, $read = null, $write = null){
|
|
||||||
if(!isset($this->properties[$name])){
|
|
||||||
$this->properties[$name] = array();
|
|
||||||
$this->properties[$name]['type'] = 'mixed';
|
|
||||||
$this->properties[$name]['read'] = false;
|
|
||||||
$this->properties[$name]['write'] = false;
|
|
||||||
}
|
|
||||||
if($type !== null){
|
|
||||||
$this->properties[$name]['type'] = $type;
|
|
||||||
}
|
|
||||||
if($read !== null){
|
|
||||||
$this->properties[$name]['read'] = $read;
|
|
||||||
}
|
|
||||||
if($write !== null){
|
|
||||||
$this->properties[$name]['write'] = $write;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
protected function setMethod($name, $type = null){
|
|
||||||
if(!isset($this->methods[$name])){
|
|
||||||
$this->methods[$name] = array();
|
|
||||||
$this->methods[$name]['type'] = 'static';
|
|
||||||
}
|
|
||||||
if($type !== null){
|
|
||||||
$this->methods[$name]['type'] = $type;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @param string $class
|
|
||||||
* @return string
|
|
||||||
*/
|
|
||||||
protected function createPhpDocs($class){
|
|
||||||
|
|
||||||
$reflection = new \ReflectionClass($class);
|
|
||||||
$namespace = $reflection->getNamespaceName();
|
|
||||||
$classname = $reflection->getShortName();
|
|
||||||
$originalDoc = $reflection->getDocComment();
|
|
||||||
|
|
||||||
if($this->reset){
|
|
||||||
$phpdoc = new DocBlock('', new Context($namespace));
|
|
||||||
}else{
|
|
||||||
$phpdoc = new DocBlock($reflection, new Context($namespace));
|
|
||||||
}
|
|
||||||
|
|
||||||
if(!$phpdoc->getText()){
|
|
||||||
$phpdoc->setText("An Eloquent Model: '$class'");
|
|
||||||
}
|
|
||||||
|
|
||||||
$properties = array();
|
|
||||||
$methods = array();
|
|
||||||
foreach($phpdoc->getTags() as $tag){
|
|
||||||
$name = $tag->getName();
|
|
||||||
if($name == "property" || $name == "property-read" || $name == "property-write"){
|
|
||||||
$properties[] =$tag->getVariableName();
|
|
||||||
}elseif($name == "method"){
|
|
||||||
$methods[] = $tag->getMethodName();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
foreach($this->properties as $name => $property){
|
|
||||||
$name = "\$$name";
|
|
||||||
if(in_array($name, $properties)){
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
if($property['read'] && $property['write']){
|
|
||||||
$attr = 'property';
|
|
||||||
}elseif($property['write']){
|
|
||||||
$attr = 'property-write';
|
|
||||||
}else{
|
|
||||||
$attr = 'property-read';
|
|
||||||
}
|
|
||||||
$tag = Tag::createInstance("@{$attr} {$property['type']} {$name}", $phpdoc);
|
|
||||||
$phpdoc->appendTag($tag);
|
|
||||||
}
|
|
||||||
|
|
||||||
foreach($this->methods as $name => $method){
|
|
||||||
if(in_array($name, $methods)){
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
$name = "$name()";
|
|
||||||
$tag = Tag::createInstance("@method {$method['type']} {$name}", $phpdoc);
|
|
||||||
$phpdoc->appendTag($tag);
|
|
||||||
}
|
|
||||||
|
|
||||||
$serializer = new DocBlockSerializer();
|
|
||||||
$serializer->getDocComment($phpdoc);
|
|
||||||
$docComment = $serializer->getDocComment($phpdoc);
|
|
||||||
|
|
||||||
|
|
||||||
if($this->write){
|
|
||||||
$filename = $reflection->getFileName();
|
|
||||||
$contents = \File::get($filename);
|
|
||||||
if($originalDoc){
|
|
||||||
$contents = str_replace($originalDoc, $docComment, $contents);
|
|
||||||
}else{
|
|
||||||
$needle = "class {$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)){
|
|
||||||
$this->info('Written new phpDocBlock to '.$filename);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
$output = "namespace {$namespace}{\n{$docComment}\n\tclass {$classname} {}\n}\n\n";
|
|
||||||
return $output;
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,154 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Laravel IDE Helper Generator
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @copyright 2014 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 Barryvdh\LaravelIdeHelper\Generator;
|
||||||
|
use Illuminate\Config\Repository as ConfigRepository;
|
||||||
|
use Illuminate\Console\Command;
|
||||||
|
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
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
*/
|
||||||
|
class GeneratorCommand extends Command
|
||||||
|
{
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected $name = 'ide-helper:generate';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected $description = 'Generate a new IDE Helper file.';
|
||||||
|
|
||||||
|
/** @var \Illuminate\Config\Repository */
|
||||||
|
protected $config;
|
||||||
|
|
||||||
|
/** @var \Illuminate\Filesystem\Filesystem */
|
||||||
|
protected $files;
|
||||||
|
|
||||||
|
/** @var \Illuminate\View\Factory */
|
||||||
|
protected $view;
|
||||||
|
|
||||||
|
protected $onlyExtend;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*
|
||||||
|
* @param \Illuminate\Config\Repository $config
|
||||||
|
* @param \Illuminate\Filesystem\Filesystem $files
|
||||||
|
* @param \Illuminate\View\Factory $view
|
||||||
|
*/
|
||||||
|
public function __construct(ConfigRepository $config, Filesystem $files, $view) {
|
||||||
|
$this->config = $config;
|
||||||
|
$this->files = $files;
|
||||||
|
$this->view = $view;
|
||||||
|
parent::__construct();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Execute the console command.
|
||||||
|
*
|
||||||
|
* @return void
|
||||||
|
*/
|
||||||
|
public function fire()
|
||||||
|
{
|
||||||
|
if (file_exists($compiled = base_path() . '/bootstrap/compiled.php')) {
|
||||||
|
$this->error(
|
||||||
|
'Error generating IDE Helper: first delete bootstrap/compiled.php (php artisan clear-compiled)'
|
||||||
|
);
|
||||||
|
} 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) {
|
||||||
|
if (file_exists($helper)) {
|
||||||
|
$helpers .= str_replace(array('<?php', '?>'), '', $this->files->get($helper));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
$helpers = '';
|
||||||
|
}
|
||||||
|
|
||||||
|
$generator = new Generator($this->config, $this->view, $this->getOutput(), $helpers);
|
||||||
|
$content = $generator->generate($format);
|
||||||
|
$written = $this->files->put($filename, $content);
|
||||||
|
|
||||||
|
if ($written !== false) {
|
||||||
|
$this->info("A new helper file was written to $filename");
|
||||||
|
} else {
|
||||||
|
$this->error("The helper file could not be created at $filename");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function useMemoryDriver()
|
||||||
|
{
|
||||||
|
//Use a sqlite database in memory, to avoid connection errors on Database facades
|
||||||
|
$this->config->set(
|
||||||
|
'database.connections.sqlite',
|
||||||
|
array(
|
||||||
|
'driver' => 'sqlite',
|
||||||
|
'database' => ':memory:',
|
||||||
|
)
|
||||||
|
);
|
||||||
|
$this->config->set('database.default', 'sqlite');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected function getArguments()
|
||||||
|
{
|
||||||
|
$filename = $this->config->get('laravel-ide-helper::filename');
|
||||||
|
|
||||||
|
return array(
|
||||||
|
array(
|
||||||
|
'filename', InputArgument::OPTIONAL, 'The path to the helper file', $filename
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected function getOptions()
|
||||||
|
{
|
||||||
|
$format = $this->config->get('laravel-ide-helper::format');
|
||||||
|
|
||||||
|
return array(
|
||||||
|
array('format', 'F', InputOption::VALUE_OPTIONAL, 'The format for the IDE Helper', $format),
|
||||||
|
array('helpers', 'H', InputOption::VALUE_NONE, 'Include the helper files'),
|
||||||
|
array('memory', 'M', InputOption::VALUE_NONE, 'Use sqlite memory driver'),
|
||||||
|
array('sublime', 'S', InputOption::VALUE_NONE, 'DEPRECATED: Use different style for SublimeText CodeIntel'),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -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")'),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,516 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Laravel IDE Helper Generator
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @copyright 2014 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 Illuminate\Support\Str;
|
||||||
|
use Symfony\Component\Console\Input\InputOption;
|
||||||
|
use Symfony\Component\Console\Input\InputArgument;
|
||||||
|
use Symfony\Component\ClassLoader\ClassMapGenerator;
|
||||||
|
use phpDocumentor\Reflection\DocBlock;
|
||||||
|
use phpDocumentor\Reflection\DocBlock\Context;
|
||||||
|
use phpDocumentor\Reflection\DocBlock\Tag;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A command to generate autocomplete information for your IDE
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @property \Illuminate\Container\Container $laravel
|
||||||
|
*/
|
||||||
|
class ModelsCommand extends Command
|
||||||
|
{
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected $name = 'ide-helper:models';
|
||||||
|
protected $filename = '_ide_helper_models.php';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected $description = 'Generate autocompletion for models';
|
||||||
|
|
||||||
|
protected $properties = array();
|
||||||
|
protected $methods = array();
|
||||||
|
protected $write = false;
|
||||||
|
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.
|
||||||
|
*
|
||||||
|
* @return void
|
||||||
|
*/
|
||||||
|
public function fire()
|
||||||
|
{
|
||||||
|
$filename = $this->option('filename');
|
||||||
|
$this->write = $this->option('write');
|
||||||
|
$this->dirs = array_merge(
|
||||||
|
$this->laravel['config']->get('laravel-ide-helper::model_locations'),
|
||||||
|
$this->option('dir')
|
||||||
|
);
|
||||||
|
$model = $this->argument('model');
|
||||||
|
$ignore = $this->option('ignore');
|
||||||
|
$this->reset = $this->option('reset');
|
||||||
|
|
||||||
|
//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("Do you want to overwrite the existing model files? Choose no to write to $filename instead? (Yes/No): ")) {
|
||||||
|
$this->write = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$content = $this->generateDocs($model, $ignore);
|
||||||
|
|
||||||
|
if (!$this->write) {
|
||||||
|
$written = $this->files->put($filename, $content);
|
||||||
|
if ($written !== false) {
|
||||||
|
$this->info("Model information was written to $filename");
|
||||||
|
} else {
|
||||||
|
$this->error("Failed to write model information to $filename");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected function getArguments()
|
||||||
|
{
|
||||||
|
return array(
|
||||||
|
array('model', InputArgument::OPTIONAL | InputArgument::IS_ARRAY, 'Which models to include', array()),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected function getOptions()
|
||||||
|
{
|
||||||
|
return array(
|
||||||
|
array('filename', 'F', InputOption::VALUE_OPTIONAL, 'The path to the helper file', $this->filename),
|
||||||
|
array('dir', 'D', InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY, 'The model dir', array()),
|
||||||
|
array('write', 'W', InputOption::VALUE_NONE, 'Write to Model file'),
|
||||||
|
array('nowrite', 'N', InputOption::VALUE_NONE, 'Don\'t write to Model file'),
|
||||||
|
array('reset', 'R', InputOption::VALUE_NONE, 'Remove the original phpdocs instead of appending'),
|
||||||
|
array('ignore', 'I', InputOption::VALUE_OPTIONAL, 'Which models to ignore', ''),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function generateDocs($loadModels, $ignore = '')
|
||||||
|
{
|
||||||
|
$output = "<?php
|
||||||
|
/**
|
||||||
|
* An helper file for your Eloquent Models
|
||||||
|
* Copy the phpDocs from this file to the correct Model,
|
||||||
|
* And remove them from this file, to prevent double declarations.
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
*/
|
||||||
|
\n\n";
|
||||||
|
|
||||||
|
$hasDoctrine = interface_exists('Doctrine\DBAL\Driver');
|
||||||
|
|
||||||
|
if (empty($loadModels)) {
|
||||||
|
$models = $this->loadModels();
|
||||||
|
} else {
|
||||||
|
$models = array();
|
||||||
|
foreach ($loadModels as $model) {
|
||||||
|
$models = array_merge($models, explode(',', $model));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$ignore = explode(',', $ignore);
|
||||||
|
|
||||||
|
foreach ($models as $name) {
|
||||||
|
if (in_array($name, $ignore)) {
|
||||||
|
$this->comment("Ignoring model '$name'");
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
$this->properties = array();
|
||||||
|
$this->methods = array();
|
||||||
|
if (class_exists($name)) {
|
||||||
|
try {
|
||||||
|
// handle abstract classes, interfaces, ...
|
||||||
|
$reflectionClass = new \ReflectionClass($name);
|
||||||
|
|
||||||
|
if (!$reflectionClass->isSubclassOf('Illuminate\Database\Eloquent\Model')) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
$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.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
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`.'
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
return $output;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function loadModels()
|
||||||
|
{
|
||||||
|
$models = array();
|
||||||
|
foreach ($this->dirs as $dir) {
|
||||||
|
$dir = base_path() . '/' . $dir;
|
||||||
|
if (file_exists($dir)) {
|
||||||
|
foreach (ClassMapGenerator::createMap($dir) as $model => $path) {
|
||||||
|
$models[] = $model;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return $models;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Load the properties from the database table.
|
||||||
|
*
|
||||||
|
* @param \Illuminate\Database\Eloquent\Model $model
|
||||||
|
*/
|
||||||
|
protected function getPropertiesFromTable($model)
|
||||||
|
{
|
||||||
|
$table = $model->getConnection()->getTablePrefix() . $model->getTable();
|
||||||
|
$schema = $model->getConnection()->getDoctrineSchemaManager($table);
|
||||||
|
$schema->getDatabasePlatform()->registerDoctrineTypeMapping('enum', 'string');
|
||||||
|
|
||||||
|
$columns = $schema->listTableColumns($table);
|
||||||
|
|
||||||
|
if ($columns) {
|
||||||
|
foreach ($columns as $column) {
|
||||||
|
$name = $column->getName();
|
||||||
|
if (in_array($name, $model->getDates())) {
|
||||||
|
$type = '\Carbon\Carbon';
|
||||||
|
} else {
|
||||||
|
$type = $column->getType()->getName();
|
||||||
|
switch ($type) {
|
||||||
|
case 'string':
|
||||||
|
case 'text':
|
||||||
|
case 'date':
|
||||||
|
case 'time':
|
||||||
|
case 'guid':
|
||||||
|
case 'datetimetz':
|
||||||
|
case 'datetime':
|
||||||
|
$type = 'string';
|
||||||
|
break;
|
||||||
|
case 'integer':
|
||||||
|
case 'bigint':
|
||||||
|
case 'smallint':
|
||||||
|
$type = 'integer';
|
||||||
|
break;
|
||||||
|
case 'decimal':
|
||||||
|
case 'float':
|
||||||
|
$type = 'float';
|
||||||
|
break;
|
||||||
|
case 'boolean':
|
||||||
|
$type = 'boolean';
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
$type = 'mixed';
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$comment = $column->getComment();
|
||||||
|
$this->setProperty($name, $type, true, true, $comment);
|
||||||
|
$this->setMethod(
|
||||||
|
Str::camel('where_' . $name),
|
||||||
|
'\Illuminate\Database\Query\Builder|\\' . get_class($model),
|
||||||
|
array('$value')
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param \Illuminate\Database\Eloquent\Model $model
|
||||||
|
*/
|
||||||
|
protected function getPropertiesFromMethods($model)
|
||||||
|
{
|
||||||
|
$methods = get_class_methods($model);
|
||||||
|
if ($methods) {
|
||||||
|
foreach ($methods as $method) {
|
||||||
|
if (Str::startsWith($method, 'get') && Str::endsWith($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($method, 'Attribute') && $method !== 'setAttribute') {
|
||||||
|
//Magic set<name>Attribute
|
||||||
|
$name = Str::snake(substr($method, 3, -9));
|
||||||
|
if (!empty($name)) {
|
||||||
|
$this->setProperty($name, null, null, true);
|
||||||
|
}
|
||||||
|
} elseif (Str::startsWith($method, 'scope') && $method !== 'scopeQuery') {
|
||||||
|
//Magic set<name>Attribute
|
||||||
|
$name = Str::camel(substr($method, 5));
|
||||||
|
if (!empty($name)) {
|
||||||
|
$reflection = new \ReflectionMethod($model, $method);
|
||||||
|
$args = $this->getParameters($reflection);
|
||||||
|
//Remove the first ($query) argument
|
||||||
|
array_shift($args);
|
||||||
|
$this->setMethod($name, '\\' . $reflection->class, $args);
|
||||||
|
}
|
||||||
|
} elseif (!method_exists('Eloquent', $method) && !Str::startsWith($method, 'get')) {
|
||||||
|
|
||||||
|
//Use reflection to inspect the code, based on Illuminate/Support/SerializableClosure.php
|
||||||
|
$reflection = new \ReflectionMethod($model, $method);
|
||||||
|
|
||||||
|
$file = new \SplFileObject($reflection->getFileName());
|
||||||
|
$file->seek($reflection->getStartLine() - 1);
|
||||||
|
|
||||||
|
$code = '';
|
||||||
|
while ($file->key() < $reflection->getEndLine()) {
|
||||||
|
$code .= $file->current();
|
||||||
|
$file->next();
|
||||||
|
}
|
||||||
|
$begin = strpos($code, 'function(');
|
||||||
|
$code = substr($code, $begin, strrpos($code, '}') - $begin + 1);
|
||||||
|
|
||||||
|
foreach (array('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, strpos($code, ');')));
|
||||||
|
//Remove quotes, ensure 1 \ in front of the model
|
||||||
|
$returnModel = $this->getClassName($arguments[0], $model);
|
||||||
|
if ($relation === 'belongsToMany' or $relation === 'hasMany' or $relation === 'morphMany' or $relation === 'morphToMany') {
|
||||||
|
//Collection or array of models (because Collection is Arrayable)
|
||||||
|
$this->setProperty(
|
||||||
|
$method,
|
||||||
|
'\Illuminate\Database\Eloquent\Collection|' . $returnModel . '[]',
|
||||||
|
true,
|
||||||
|
null
|
||||||
|
);
|
||||||
|
} else {
|
||||||
|
//Single model is returned
|
||||||
|
$this->setProperty($method, $returnModel, true, null);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param string $name
|
||||||
|
* @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, $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;
|
||||||
|
}
|
||||||
|
if ($read !== null) {
|
||||||
|
$this->properties[$name]['read'] = $read;
|
||||||
|
}
|
||||||
|
if ($write !== null) {
|
||||||
|
$this->properties[$name]['write'] = $write;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function setMethod($name, $type = '', $arguments = array())
|
||||||
|
{
|
||||||
|
if (!isset($this->methods[$name])) {
|
||||||
|
$this->methods[$name] = array();
|
||||||
|
$this->methods[$name]['type'] = $type;
|
||||||
|
$this->methods[$name]['arguments'] = $arguments;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param string $class
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
protected function createPhpDocs($class)
|
||||||
|
{
|
||||||
|
$reflection = new \ReflectionClass($class);
|
||||||
|
$namespace = $reflection->getNamespaceName();
|
||||||
|
$className = $reflection->getShortName();
|
||||||
|
$originalDoc = $reflection->getDocComment();
|
||||||
|
|
||||||
|
if ($this->reset) {
|
||||||
|
$phpdoc = new DocBlock('', new Context($namespace));
|
||||||
|
} else {
|
||||||
|
$phpdoc = new DocBlock($reflection, new Context($namespace));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!$phpdoc->getText()) {
|
||||||
|
$phpdoc->setText($class);
|
||||||
|
}
|
||||||
|
|
||||||
|
$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') {
|
||||||
|
$properties[] = $tag->getVariableName();
|
||||||
|
} elseif ($name == 'method') {
|
||||||
|
$methods[] = $tag->getMethodName();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($this->properties as $name => $property) {
|
||||||
|
$name = "\$$name";
|
||||||
|
if (in_array($name, $properties)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if ($property['read'] && $property['write']) {
|
||||||
|
$attr = 'property';
|
||||||
|
} elseif ($property['write']) {
|
||||||
|
$attr = 'property-write';
|
||||||
|
} else {
|
||||||
|
$attr = 'property-read';
|
||||||
|
}
|
||||||
|
$tag = Tag::createInstance("@{$attr} {$property['type']} {$name} {$property['comment']}", $phpdoc);
|
||||||
|
$phpdoc->appendTag($tag);
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($this->methods as $name => $method) {
|
||||||
|
if (in_array($name, $methods)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
$arguments = implode(', ', $method['arguments']);
|
||||||
|
$tag = Tag::createInstance("@method static {$method['type']} {$name}({$arguments})", $phpdoc);
|
||||||
|
$phpdoc->appendTag($tag);
|
||||||
|
}
|
||||||
|
|
||||||
|
$serializer = new DocBlock\Serializer();
|
||||||
|
$serializer->getDocComment($phpdoc);
|
||||||
|
$docComment = $serializer->getDocComment($phpdoc);
|
||||||
|
|
||||||
|
if ($this->write) {
|
||||||
|
$filename = $reflection->getFileName();
|
||||||
|
$contents = $this->files->get($filename);
|
||||||
|
if ($originalDoc) {
|
||||||
|
$contents = str_replace($originalDoc, $docComment, $contents);
|
||||||
|
} else {
|
||||||
|
$needle = "class {$className}";
|
||||||
|
$replace = "{$docComment}\nclass {$className}";
|
||||||
|
$pos = strpos($contents, $needle);
|
||||||
|
if ($pos !== false) {
|
||||||
|
$contents = substr_replace($contents, $replace, $pos, strlen($needle));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ($this->files->put($filename, $contents)) {
|
||||||
|
$this->info('Written new phpDocBlock to ' . $filename);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$output = "namespace {$namespace}{\n{$docComment}\n\tclass {$className} {}\n}\n\n";
|
||||||
|
return $output;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the parameters and format them correctly
|
||||||
|
*
|
||||||
|
* @param \ReflectionMethod $method
|
||||||
|
* @return array
|
||||||
|
*/
|
||||||
|
public function getParameters($method)
|
||||||
|
{
|
||||||
|
//Loop through the default values for parameters, and make the correct output string
|
||||||
|
$paramsWithDefault = array();
|
||||||
|
|
||||||
|
foreach ($method->getParameters() as $param) {
|
||||||
|
$paramStr = '$' . $param->getName();
|
||||||
|
|
||||||
|
if ($param->isOptional()) {
|
||||||
|
$default = $param->getDefaultValue();
|
||||||
|
if (is_bool($default)) {
|
||||||
|
$default = $default ? 'true' : 'false';
|
||||||
|
} elseif (is_array($default)) {
|
||||||
|
$default = 'array()';
|
||||||
|
} elseif (is_null($default)) {
|
||||||
|
$default = 'null';
|
||||||
|
} elseif (is_int($default)) {
|
||||||
|
//$default = $default;
|
||||||
|
} else {
|
||||||
|
$default = "'" . trim($default) . "'";
|
||||||
|
}
|
||||||
|
$paramStr .= " = $default";
|
||||||
|
}
|
||||||
|
$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, ' "\''), '\\');
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,245 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Laravel IDE Helper Generator
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @copyright 2014 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;
|
||||||
|
|
||||||
|
use /** @noinspection PhpUndefinedNamespaceInspection,PhpUndefinedClassInspection */Illuminate\Foundation\AliasLoader;
|
||||||
|
use Illuminate\Config\Repository as ConfigRepository;
|
||||||
|
use Symfony\Component\Console\Output\OutputInterface;
|
||||||
|
|
||||||
|
class Generator
|
||||||
|
{
|
||||||
|
/** @var \Illuminate\Config\Repository */
|
||||||
|
protected $config;
|
||||||
|
|
||||||
|
/** @var \Illuminate\View\Factory */
|
||||||
|
protected $view;
|
||||||
|
|
||||||
|
/** @var \Symfony\Component\Console\Output\OutputInterface */
|
||||||
|
protected $output;
|
||||||
|
|
||||||
|
protected $extra = array();
|
||||||
|
protected $magic = array();
|
||||||
|
protected $interfaces = array();
|
||||||
|
protected $helpers;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param \Illuminate\Config\Repository $config
|
||||||
|
* @param \Illuminate\View\Factory $view
|
||||||
|
* @param \Symfony\Component\Console\Output\OutputInterface $output
|
||||||
|
* @param string $helpers
|
||||||
|
*/
|
||||||
|
public function __construct(ConfigRepository $config, $view, OutputInterface $output = null, $helpers = '')
|
||||||
|
{
|
||||||
|
$this->config = $config;
|
||||||
|
$this->view = $view;
|
||||||
|
|
||||||
|
// Find the drivers to add to the extra/interfaces
|
||||||
|
$this->detectDrivers();
|
||||||
|
|
||||||
|
$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'));
|
||||||
|
$this->interfaces = array_merge($this->interfaces, $this->config->get('laravel-ide-helper::interfaces'));
|
||||||
|
|
||||||
|
// Make all interface classes absolute
|
||||||
|
foreach ($this->interfaces as &$interface) {
|
||||||
|
$interface = '\\' . ltrim($interface, '\\');
|
||||||
|
}
|
||||||
|
$this->helpers = $helpers;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Generate the helper file contents;
|
||||||
|
*
|
||||||
|
* @param string $format The format to generate the helper in (php/json)
|
||||||
|
* @return string;
|
||||||
|
*/
|
||||||
|
public function generate($format = 'php')
|
||||||
|
{
|
||||||
|
// Check if the generator for this format exists
|
||||||
|
$method = 'generate' . ucfirst($format) . 'Helper';
|
||||||
|
if (method_exists($this, $method)) {
|
||||||
|
return $this->$method();
|
||||||
|
}
|
||||||
|
|
||||||
|
return $this->generatePhpHelper();
|
||||||
|
}
|
||||||
|
|
||||||
|
public function generatePhpHelper()
|
||||||
|
{
|
||||||
|
$app = app();
|
||||||
|
return $this->view->make('laravel-ide-helper::ide-helper')
|
||||||
|
->with('namespaces', $this->getNamespaces())
|
||||||
|
->with('helpers', $this->helpers)
|
||||||
|
->with('version', $app::VERSION)
|
||||||
|
->render();
|
||||||
|
}
|
||||||
|
|
||||||
|
public function generateJsonHelper()
|
||||||
|
{
|
||||||
|
$classes = array();
|
||||||
|
foreach ($this->getNamespaces() as $aliases) {
|
||||||
|
foreach ($aliases as $alias) {
|
||||||
|
$functions = array();
|
||||||
|
foreach ($alias->getMethods() as $method) {
|
||||||
|
$functions[$method->getName()] = '(' . $method->getParamsWithDefault() . ')';
|
||||||
|
}
|
||||||
|
$classes[$alias->getAlias()] = array(
|
||||||
|
'functions' => $functions,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$flags = JSON_FORCE_OBJECT;
|
||||||
|
if (defined('JSON_PRETTY_PRINT')) {
|
||||||
|
$flags |= JSON_PRETTY_PRINT;
|
||||||
|
}
|
||||||
|
|
||||||
|
return json_encode(array(
|
||||||
|
'php' => array(
|
||||||
|
'classes' => $classes,
|
||||||
|
),
|
||||||
|
), $flags);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected function detectDrivers()
|
||||||
|
{
|
||||||
|
try {
|
||||||
|
if (class_exists('Auth') && is_a('Auth', '\Illuminate\Support\Facades\Auth', true)) {
|
||||||
|
/** @noinspection PhpUndefinedClassInspection */
|
||||||
|
$class = get_class(\Auth::driver());
|
||||||
|
$this->extra['Auth'] = array($class);
|
||||||
|
$this->interfaces['\Illuminate\Auth\UserProviderInterface'] = $class;
|
||||||
|
}
|
||||||
|
} catch (\Exception $e) {}
|
||||||
|
|
||||||
|
try {
|
||||||
|
if (class_exists('DB') && is_a('DB', '\Illuminate\Support\Facades\DB', true)) {
|
||||||
|
/** @noinspection PhpUndefinedClassInspection */
|
||||||
|
$class = get_class(\DB::connection());
|
||||||
|
$this->extra['DB'] = array($class);
|
||||||
|
$this->interfaces['\Illuminate\Database\ConnectionInterface'] = $class;
|
||||||
|
}
|
||||||
|
} catch (\Exception $e) {}
|
||||||
|
|
||||||
|
try {
|
||||||
|
if (class_exists('Cache') && is_a('Cache', '\Illuminate\Support\Facades\Cache', true)) {
|
||||||
|
/** @noinspection PhpUndefinedClassInspection */
|
||||||
|
$driver = get_class(\Cache::driver());
|
||||||
|
/** @noinspection PhpUndefinedClassInspection */
|
||||||
|
$store = get_class(\Cache::getStore());
|
||||||
|
$this->extra['Cache'] = array($driver, $store);
|
||||||
|
$this->interfaces['\Illuminate\Cache\StoreInterface'] = $store;
|
||||||
|
}
|
||||||
|
} catch (\Exception $e) {}
|
||||||
|
|
||||||
|
try {
|
||||||
|
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;
|
||||||
|
}
|
||||||
|
} catch (\Exception $e) {}
|
||||||
|
|
||||||
|
try {
|
||||||
|
if (class_exists('SSH') && is_a('SSH', '\Illuminate\Support\Facades\SSH', true)) {
|
||||||
|
/** @noinspection PhpUndefinedClassInspection */
|
||||||
|
$class = get_class(\SSH::connection());
|
||||||
|
$this->extra['SSH'] = array($class);
|
||||||
|
$this->interfaces['\Illuminate\Remote\ConnectionInterface'] = $class;
|
||||||
|
}
|
||||||
|
} catch (\Exception $e) {}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Find all namespaces/aliases that are valid for us to render
|
||||||
|
*
|
||||||
|
* @return array|Alias[][]
|
||||||
|
*/
|
||||||
|
protected function getNamespaces()
|
||||||
|
{
|
||||||
|
$namespaces = array();
|
||||||
|
|
||||||
|
// Get all aliases
|
||||||
|
/** @noinspection PhpUndefinedClassInspection */
|
||||||
|
foreach (AliasLoader::getInstance()->getAliases() as $name => $facade) {
|
||||||
|
$magicMethods = array_key_exists($name, $this->magic) ? $this->magic[$name] : array();
|
||||||
|
$alias = new Alias($name, $facade, $magicMethods, $this->interfaces);
|
||||||
|
if ($alias->isValid()) {
|
||||||
|
|
||||||
|
//Add extra methods, from other classes (magic static calls)
|
||||||
|
if (array_key_exists($name, $this->extra)) {
|
||||||
|
$alias->addClass($this->extra[$name]);
|
||||||
|
}
|
||||||
|
|
||||||
|
$namespace = $alias->getNamespace();
|
||||||
|
if (!isset($namespaces[$namespace])) {
|
||||||
|
$namespaces[$namespace] = array();
|
||||||
|
}
|
||||||
|
$namespaces[$namespace][] = $alias;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
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";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,79 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Laravel IDE Helper Generator
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @copyright 2014 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;
|
||||||
|
|
||||||
|
use Illuminate\Support\ServiceProvider;
|
||||||
|
use Barryvdh\LaravelIdeHelper\Console\MetaCommand;
|
||||||
|
use Barryvdh\LaravelIdeHelper\Console\ModelsCommand;
|
||||||
|
use Barryvdh\LaravelIdeHelper\Console\GeneratorCommand;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @property \Illuminate\Container\Container $app
|
||||||
|
*/
|
||||||
|
class IdeHelperServiceProvider extends ServiceProvider
|
||||||
|
{
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected $defer = true;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
public function boot()
|
||||||
|
{
|
||||||
|
$this->package('barryvdh/laravel-ide-helper', 'laravel-ide-helper', __DIR__);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
public function register()
|
||||||
|
{
|
||||||
|
$this->app['command.ide-helper.generate'] = $this->app->share(
|
||||||
|
function ($app) {
|
||||||
|
return new GeneratorCommand($app['config'], $app['files'], $app['view']);
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
$this->app['command.ide-helper.models'] = $this->app->share(
|
||||||
|
function ($app) {
|
||||||
|
return new ModelsCommand($app);
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
$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');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
public function provides()
|
||||||
|
{
|
||||||
|
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}";
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
+332
@@ -0,0 +1,332 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Laravel IDE Helper Generator
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @copyright 2014 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;
|
||||||
|
|
||||||
|
use phpDocumentor\Reflection\DocBlock;
|
||||||
|
use phpDocumentor\Reflection\DocBlock\Context;
|
||||||
|
use phpDocumentor\Reflection\DocBlock\Tag;
|
||||||
|
use phpDocumentor\Reflection\DocBlock\Tag\ReturnTag;
|
||||||
|
|
||||||
|
class Method
|
||||||
|
{
|
||||||
|
/** @var \phpDocumentor\Reflection\DocBlock */
|
||||||
|
protected $phpdoc;
|
||||||
|
|
||||||
|
/** @var \ReflectionMethod */
|
||||||
|
protected $method;
|
||||||
|
|
||||||
|
protected $name;
|
||||||
|
protected $namespace;
|
||||||
|
protected $params = array();
|
||||||
|
protected $params_with_default = array();
|
||||||
|
protected $interfaces = array();
|
||||||
|
protected $return = null;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param \ReflectionMethod $method
|
||||||
|
* @param string $alias
|
||||||
|
* @param \ReflectionClass $class
|
||||||
|
* @param string|null $methodName
|
||||||
|
* @param array $interfaces
|
||||||
|
*/
|
||||||
|
public function __construct(\ReflectionMethod $method, $alias, $class, $methodName = null, $interfaces = array())
|
||||||
|
{
|
||||||
|
$this->method = $method;
|
||||||
|
$this->interfaces = $interfaces;
|
||||||
|
$this->name = $methodName ?: $method->name;
|
||||||
|
$declaringClass = $method->getDeclaringClass();
|
||||||
|
$this->namespace = $declaringClass->getNamespaceName();
|
||||||
|
|
||||||
|
//Create a DocBlock and serializer instance
|
||||||
|
$this->phpdoc = new DocBlock($method, new Context($this->namespace, static::getUseStatements($declaringClass)));
|
||||||
|
|
||||||
|
//Normalize the description and inherit the docs from parents/interfaces
|
||||||
|
try {
|
||||||
|
$this->normalizeReturnTags($this->phpdoc);
|
||||||
|
$this->normalizeDescription($this->phpdoc);
|
||||||
|
} catch (\Exception $e) {}
|
||||||
|
|
||||||
|
//Get the parameters, including formatted default values
|
||||||
|
$this->getParameters($method);
|
||||||
|
|
||||||
|
//Make the method static
|
||||||
|
//$this->phpdoc->appendTag(Tag::createInstance('@static', $this->phpdoc));
|
||||||
|
|
||||||
|
//Reference the 'real' function in the declaringClass
|
||||||
|
$this->declaringClassName = '\\' . ltrim($declaringClass->name, '\\');
|
||||||
|
$this->root = '\\' . ltrim($class->getName(), '\\');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the class wherein the function resides
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getDeclaringClass()
|
||||||
|
{
|
||||||
|
return $this->declaringClassName;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return the class from which this function would be called
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getRoot()
|
||||||
|
{
|
||||||
|
return $this->root;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the docblock for this method
|
||||||
|
*
|
||||||
|
* @param string $prefix
|
||||||
|
* @param bool $trim
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getDocComment($prefix = "\t\t", $trim = false)
|
||||||
|
{
|
||||||
|
$serializer = new DocBlock\Serializer(1, $prefix);
|
||||||
|
$str = $serializer->getDocComment($this->phpdoc);
|
||||||
|
if ($trim) {
|
||||||
|
$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 $str;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the method name
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function getName()
|
||||||
|
{
|
||||||
|
return $this->name;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Checks whether the method is deprecated
|
||||||
|
*
|
||||||
|
* @return bool
|
||||||
|
*/
|
||||||
|
public function isDeprecated()
|
||||||
|
{
|
||||||
|
return $this->phpdoc->hasTag('deprecated');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the declared parameters for this method
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
|
*/
|
||||||
|
public function getDocParams()
|
||||||
|
{
|
||||||
|
return $this->phpdoc->getTagsByName('param');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the parameters for this method
|
||||||
|
*
|
||||||
|
* @param bool $implode Whether to implode the array or not
|
||||||
|
* @return string|array
|
||||||
|
*/
|
||||||
|
public function getParams($implode = true)
|
||||||
|
{
|
||||||
|
return $implode ? implode(', ', $this->params) : $this->params;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the parameters for this method including default values
|
||||||
|
*
|
||||||
|
* @param bool $implode Whether to implode the array or not
|
||||||
|
* @return string|array
|
||||||
|
*/
|
||||||
|
public function getParamsWithDefault($implode = true)
|
||||||
|
{
|
||||||
|
return $implode ? implode(', ', $this->params_with_default) : $this->params_with_default;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the description and get the inherited docs.
|
||||||
|
*
|
||||||
|
* @param DocBlock $phpdoc
|
||||||
|
*/
|
||||||
|
protected function normalizeDescription(DocBlock $phpdoc)
|
||||||
|
{
|
||||||
|
//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();
|
||||||
|
|
||||||
|
$description = str_ireplace('{@inheritdoc}', $inheritDescription, $description);
|
||||||
|
$phpdoc->setText($description);
|
||||||
|
|
||||||
|
$this->normalizeReturnTags($inheritdoc);
|
||||||
|
|
||||||
|
//Add the tags that are inherited
|
||||||
|
foreach ($inheritdoc->getTags() as $tag) {
|
||||||
|
$tag->setDocBlock();
|
||||||
|
$phpdoc->appendTag($tag);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Normalize the return tag (make full namespace, replace interfaces)
|
||||||
|
*
|
||||||
|
* @param DocBlock $phpdoc
|
||||||
|
*/
|
||||||
|
protected function normalizeReturnTags(DocBlock $phpdoc)
|
||||||
|
{
|
||||||
|
static $typeProp;
|
||||||
|
if (!isset($typeProp)) {
|
||||||
|
$typeProp = new \ReflectionProperty('phpDocumentor\Reflection\DocBlock\Tag\ReturnTag', 'type');
|
||||||
|
$typeProp->setAccessible(true);
|
||||||
|
}
|
||||||
|
|
||||||
|
$this->return = null;
|
||||||
|
//Get the return type and adjust them for better autocomplete
|
||||||
|
foreach ($phpdoc->getTags() as $tag) {
|
||||||
|
if ($tag instanceof ReturnTag) {
|
||||||
|
// Convert the keywords
|
||||||
|
$typeValue = static::convertKeywords($typeProp->getValue($tag));
|
||||||
|
$typeProp->setValue($tag, $typeValue);
|
||||||
|
|
||||||
|
// Get the expanded type
|
||||||
|
$typeValue = $tag->getType();
|
||||||
|
|
||||||
|
// Replace the interfaces
|
||||||
|
if (preg_match('/\bReturnTag$/', get_class($tag))) {
|
||||||
|
foreach ($this->interfaces as $interface => $real) {
|
||||||
|
$typeValue = preg_replace('/(^|\|)' . preg_quote($interface, '/') . '\b/', $real, $typeValue);
|
||||||
|
}
|
||||||
|
$this->return = $typeValue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Re-set the type
|
||||||
|
$typeProp->setValue($tag, $typeValue);
|
||||||
|
$tag->setDescription($tag->getDescription());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Convert keywords that are incorrect.
|
||||||
|
*
|
||||||
|
* @param string $string
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
protected static function convertKeywords($string)
|
||||||
|
{
|
||||||
|
$types = explode('|', $string);
|
||||||
|
foreach ($types as &$type) {
|
||||||
|
if ($type === 'Closure')
|
||||||
|
$type = '\Closure';
|
||||||
|
elseif ($type === 'dynamic')
|
||||||
|
$type = 'mixed';
|
||||||
|
elseif (strrpos($type, '\\') && $type[0] !== '\\' && (class_exists($type) || interface_exists($type)))
|
||||||
|
$type = '\\' . $type;
|
||||||
|
}
|
||||||
|
return implode('|', $types);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Should the function return a value?
|
||||||
|
*
|
||||||
|
* @return bool|int
|
||||||
|
*/
|
||||||
|
public function shouldReturn()
|
||||||
|
{
|
||||||
|
if ($this->return !== 'void' && $this->method->name !== '__construct') {
|
||||||
|
return isset($this->return) ? true : 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the parameters and format them correctly
|
||||||
|
*
|
||||||
|
* @param \ReflectionMethod $method
|
||||||
|
* @return void
|
||||||
|
*/
|
||||||
|
public function getParameters($method)
|
||||||
|
{
|
||||||
|
//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->isDefaultValueAvailable() ? $param->getDefaultValue() : null;
|
||||||
|
if (is_bool($default)) {
|
||||||
|
$default = $default ? 'true' : 'false';
|
||||||
|
} elseif (is_array($default)) {
|
||||||
|
$default = 'array()';
|
||||||
|
} elseif (is_null($default)) {
|
||||||
|
$default = 'null';
|
||||||
|
} elseif (is_int($default)) {
|
||||||
|
//$default = $default;
|
||||||
|
} else {
|
||||||
|
$default = "'" . trim($default) . "'";
|
||||||
|
}
|
||||||
|
$paramStr .= " = $default";
|
||||||
|
}
|
||||||
|
|
||||||
|
$paramsWithDefault[] = $paramStr;
|
||||||
|
}
|
||||||
|
|
||||||
|
$this->params = $params;
|
||||||
|
$this->params_with_default = $paramsWithDefault;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param \ReflectionMethod $reflectionMethod
|
||||||
|
* @return DocBlock|null
|
||||||
|
*/
|
||||||
|
protected function getInheritDoc($reflectionMethod)
|
||||||
|
{
|
||||||
|
$parentClass = $reflectionMethod->getDeclaringClass()->getParentClass();
|
||||||
|
|
||||||
|
//Get either a parent or the interface
|
||||||
|
if ($parentClass) {
|
||||||
|
$method = $parentClass->getMethod($reflectionMethod->getName());
|
||||||
|
} 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();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -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;
|
||||||
|
}
|
||||||
|
}
|
||||||
Executable → Regular
+49
-3
@@ -1,17 +1,20 @@
|
|||||||
<?php
|
<?php
|
||||||
|
|
||||||
|
use Illuminate\Support\Facades\Config;
|
||||||
|
|
||||||
return array(
|
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',
|
||||||
|
|
||||||
/*
|
/*
|
||||||
|--------------------------------------------------------------------------
|
|--------------------------------------------------------------------------
|
||||||
@@ -29,6 +32,20 @@ return array(
|
|||||||
base_path().'/vendor/laravel/framework/src/Illuminate/Support/helpers.php',
|
base_path().'/vendor/laravel/framework/src/Illuminate/Support/helpers.php',
|
||||||
),
|
),
|
||||||
|
|
||||||
|
/*
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
| Model locations to include
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
|
|
||||||
|
| Define in which directories the ide-helper:models command should look
|
||||||
|
| for models.
|
||||||
|
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
'model_locations' => array(
|
||||||
|
'app/models',
|
||||||
|
),
|
||||||
|
|
||||||
|
|
||||||
/*
|
/*
|
||||||
|--------------------------------------------------------------------------
|
|--------------------------------------------------------------------------
|
||||||
@@ -40,7 +57,36 @@ return array(
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
'extra' => array(
|
'extra' => array(
|
||||||
|
'Artisan' => array('Illuminate\Foundation\Artisan'),
|
||||||
'Eloquent' => array('Illuminate\Database\Eloquent\Builder', 'Illuminate\Database\Query\Builder'),
|
'Eloquent' => array('Illuminate\Database\Eloquent\Builder', 'Illuminate\Database\Query\Builder'),
|
||||||
|
'Session' => array('Illuminate\Session\Store'),
|
||||||
),
|
),
|
||||||
|
|
||||||
|
'magic' => array(
|
||||||
|
'Log' => array(
|
||||||
|
'debug' => 'Monolog\Logger::addDebug',
|
||||||
|
'info' => 'Monolog\Logger::addInfo',
|
||||||
|
'notice' => 'Monolog\Logger::addNotice',
|
||||||
|
'warning' => 'Monolog\Logger::addWarning',
|
||||||
|
'error' => 'Monolog\Logger::addError',
|
||||||
|
'critical' => 'Monolog\Logger::addCritical',
|
||||||
|
'alert' => 'Monolog\Logger::addAlert',
|
||||||
|
'emergency' => 'Monolog\Logger::addEmergency',
|
||||||
|
)
|
||||||
|
),
|
||||||
|
|
||||||
|
/*
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
| Interface implementations
|
||||||
|
|--------------------------------------------------------------------------
|
||||||
|
|
|
||||||
|
| These interfaces will be replaced with the implementing class. Some interfaces
|
||||||
|
| are detected by the helpers, others can be listed below.
|
||||||
|
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
'interfaces' => array(
|
||||||
|
'\Illuminate\Auth\UserInterface' => Config::get('auth.model', 'User'),
|
||||||
|
)
|
||||||
|
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -0,0 +1,46 @@
|
|||||||
|
<?= '<?php' ?>
|
||||||
|
|
||||||
|
/**
|
||||||
|
* An helper file for Laravel 4, to provide autocomplete information to your IDE
|
||||||
|
* Generated for Laravel <?= $version ?> on <?= date('Y-m-d') ?>.
|
||||||
|
*
|
||||||
|
* @author Barry vd. Heuvel <[email protected]>
|
||||||
|
* @see https://github.com/barryvdh/laravel-ide-helper
|
||||||
|
*/
|
||||||
|
|
||||||
|
<?php foreach ($namespaces as $namespace => $aliases/* @var \Barryvdh\LaravelIdeHelper\Alias[] $aliases */): ?>
|
||||||
|
namespace <?= $namespace == '__root' ? '' : $namespace ?>{
|
||||||
|
<?php if ($namespace == '__root'): ?>
|
||||||
|
exit('This file should not be included, only analyzed by your IDE');
|
||||||
|
<?= $helpers ?>
|
||||||
|
<?php endif; ?>
|
||||||
|
<?php foreach ($aliases as $alias): ?>
|
||||||
|
|
||||||
|
<?php if (($cBase = class_basename($alias->getExtends())) != $alias->getExtends() && $cBase != $alias->getShortName()): ?>
|
||||||
|
/** @noinspection PhpUnnecessaryFullyQualifiedNameInspection */
|
||||||
|
<?php endif; ?>
|
||||||
|
<?= $alias->getClassType() ?> <?= $alias->getShortName() ?> <?= $alias->getExtends() ? 'extends ' . $alias->getExtends() : '' ?>{
|
||||||
|
<?php foreach ($alias->getMethods() as $method): ?>
|
||||||
|
|
||||||
|
<?php if (($nParams = count($method->getDocParams())) > count($mParams = $method->getParamsWithDefault(false))): ?>
|
||||||
|
/** @noinspection PhpDocSignatureInspection */
|
||||||
|
<?php endif; ?>
|
||||||
|
<?php if ($docComment = str_replace("/**\n\t\t */", '', trim($method->getDocComment("\t\t", true)))): ?>
|
||||||
|
<?= $docComment ?>
|
||||||
|
|
||||||
|
<?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 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; ?>
|
||||||
@@ -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 ?>
|
||||||
|
);
|
||||||
|
|
||||||
|
}
|
||||||
@@ -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());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -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();
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user