silverleague / ideannotator
Generate PHP DocBlock annotations for DataObject and DataExtension databasefields and relation methods
Installs: 50 594
Dependents: 15
Suggesters: 0
Security: 0
Stars: 46
Watchers: 6
Forks: 24
Open Issues: 8
Type:silverstripe-vendormodule
Requires
- php: ^8.0
- phpdocumentor/reflection-docblock: ^5.4
- silverstripe/framework: ^4 || ^5
Requires (Dev)
- phpunit/phpunit: ^9.5
- squizlabs/php_codesniffer: ^3.0
- dev-master / 3.x-dev
- 3.5.1
- 3.5.0
- 3.4.1
- 3.4.0
- 3.3.0
- 3.2.4
- 3.2.3
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.x-dev
- 3.1.2
- 3.1.1
- 3.1.0
- 3.0.x-dev
- 3.0.1
- 3.0.0
- 3.0-rc1
- 3.0-beta1
- 3.0.0-alpha1
- 2.0.x-dev
- 2.0.8
- 2.0.7
- 2.0.6
- 2.0.5
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0
- 0.8
- dev-dbfield-from-config
- dev-update-reflector
- dev-hans/ss5-compatibility
- dev-controller-fixes
This package is auto-updated.
Last update: 2024-12-03 20:04:01 UTC
README
This module generates @property, @method and @mixin tags for DataObjects, PageControllers and (Data)Extensions, so ide's like PHPStorm recognize the database and relations that are set in the $db, $has_one, $has_many and $many_many arrays.
The docblocks can be generated/updated with each dev/build and with a DataObjectAnnotatorTask per module or classname.
Requirements
SilverStripe Framework and possible custom code.
By default, mysite
and app
are enabled "modules".
Version ^2:
SilverStripe 3.x framework
Version ^3:
SilverStripe 4.x+
Installation
{ "require-dev": { "silverleague/ideannotator": "3.x-dev" } }
Please note, this example omitted any possible modules you require yourself!
Example result
<?php /** * Class NewsItem * * @property string $Title * @property int $Sort * @property int $Version * @property int $AuthorID * @method \SilverStripe\Security\Member Author() * @method \SilverStripe\ORM\DataList|Category[] Categories() * @method \SilverStripe\ORM\ManyManyList|Tag[] Tags() * @mixin Versioned */ class NewsItem extends \SilverStripe\ORM\DataObject { private static $db = array( 'Title' => 'Varchar(255)', 'Sort' => 'Int' ); private static $has_one = array( 'Author' => Member::class ); private static $has_many = array( 'Categories' => Category::class ); private static $many_many = array( 'Tags' => Tag::class ); }
Further information
For installation, see installation
For the Code of Conduct, see CodeOfConduct
For contributing, see Contributing
For further documentation information, see the docs
A word of caution
This module changes the content of your files and currently there is no backup functionality. PHPStorm has a Local history for files and of course you have your code version controlled... I tried to add complete UnitTests, but I can't garantuee every situation is covered.
Windows users should be aware that the PHP Docs are generated with PSR in mind and use \n for line endings rather than Window's \r\n, some editors may have a hard time with these line endings.
This module should never be installed on a production environment.