Skip to content
This repository has been archived by the owner on Jan 24, 2024. It is now read-only.

spiral-modules/ide-helper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spiral IDE Helper

Latest Stable Version Total Downloads License Scrutinizer Code Quality Coverage Status

This module generate IDE help files for spiral framework components like Controllers, RequestsFilters, Records, Documents and etc.

Install

composer require spiral/ide-helper
./spiral register spiral/ide-helper && ./spiral console:reload

Usage

./spiral ide-helper

Configuration and Terminology

The module is configured via config/modules/ide-helper.php file.

The config has 3 sections: writers, locators, scopes.

VIEW CONFIG FILE

locators section includes any Locators used by the module. Locator is a class that responsible for searching classes and it's [magic] members.

writers section includes any Writers used by the modules. Writers are responsible to write the stuff collected by locators to some destination.

Both locators and writers must be represented by associated array, where the key is any human reasonable name for locator or writer and the value is class string or \Spiral\Core\Container\Autowire instance (can be obtained by bind method).

scopes section is also associated array, where the keys is any human reasonable name for the scope and the value is scope definition. Scope definition consists of number of locators and writers to execute, just check config above to understand the syntax. Each scope is executed independently.

The package includes following locators and writers:

  • BindingsLocator — find short bindings (SharedTrait)
  • ContainersLocator — find container and it's bindings
  • DocumentsLocator — find documents and it's fields
  • RecordsLocator — find records and it's fields
  • FilePerClassWriter — write every class to it's own file
  • SingleFileWriter — write everything to one file

Extending

Custom Locators

To create your own locator you must implement \Spiral\IdeHelper\Locators\LocatorInerface:

interface LocatorInterface
{
    /**
     * @return ClassDefinition[]
     */
    public function locate(): array;
}

and then register it in configuration file.

Custom Writers

Same as custom locator but \Spiral\IdeHelper\Writers\WriterInterface interface:

interface WriterInterface
{
    /**
     * @param ClassDefinition[] $classes
     */
    public function write(array $classes);
}

FilePerClassWriter and SingleFileWriter are using \Spiral\IdeHelper\Rendere\RendererInterface for rendering content, so if you want only to change the way files are looks like you can create your own implementation.

interface RendererInterface
{
    /**
     * @param ClassDefinition[] $classes
     * @return string
     */
    public function render(array $classes): string;
}