jmartin82/dic-doc

Magic type hinting for dependency injection container results

DIC - DOC

Dependency Injection Container Documentator, _(*1)

, _(*2)

The problem

Since I've been using Dependency Injection Containers in my projects, the IDEs no longer understands what’s going on in some places in my code., _(*3)

This problems affect the code hints, autocompletion and refactoring tools when dealing with classes. Then my IDE becomes useless., _(*4)

The solution

You can define class of the variable returned by DIC 'manually':, _(*5)

/** @var YourClassType $mailer */
$mailer = $container['mailer'];

Use two asterisks and write the data type before the name of the variable. You can write the data type without the name of the variable (but not the name without the data type)., _(*6)

In the major part of the IDEs this comment solves your problems. But..., _(*7)

The lazy solution

If you are a lazy person like me, you can use de DIC., _(*8)

To document any variable from your code, you should enclose the variable with dd function, execute the code and black magic is going to happen (ok, not too magic, but it works)!, _(*9)

Before:, _(*10)

$mailer = dd($container['mailer']);

Start:, _(*11)

/** @var YourClassType $mailer */
$mailer = $container['mailer'];

Installation / Usage

1. Download and install Composer by following the official instructions.

2. Create a composer.json defining the dependencies., _(*12)

   json { "require-dev": { "jmartin82/DicDoc": "dev-master" } }, _(*13)

3. Run Composer: php composer.phar install, _(*14)

Important

• The code have to run to be replaced
• Never use the dd function in production code
• Always review the changes
• Remember refresh the file if the IDE doesn't do it automatically.