tutorigo/laravel-ide-macros

This package is abandoned and no longer maintained. No replacement package was suggested.

Generating a helper file for IDEs to support Laravel's macros.

1.6.0 2022-02-10 15:08 UTC

Requires

• php: >=7.0
• laravel/framework: ^5.0|^6.0|^7.0|^8.0|^9.0

MIT

• Kristóf Morva

• phpdoc
• autocomplete
• helper
• laravel
• ide
• phpstorm
• netbeans
• sublime
• codeintel
• macros

README

Warning
This repository is archived because I'm unable to maintain it, as I'm not a web developer anymore and forgot most of this stuff.

Please use an existing fork, or create your own with your changes.

Sorry about this, have fun working on whatever you're currently building :)

Laravel IDE Macros

It is advised to be used with Laravel IDE Helper, which generates helper files for your IDE, so it'll be able to highlight and understand some Laravel-specific syntax. This package provides an additional IDE helper file for Laravel macros with the syntax you are already used to in Laravel IDE Helper.

Installation

Just require it in your Composer file, and you are good to go:

"tutorigo/laravel-ide-macros": "*"

If you are using Laravel 5.4 or lower, you must register the IdeMacrosServiceProvider manually.

Configuration

Run the following command to publish the configuration file to config/ide-macros.php:

php artisan vendor:publish --provider="Tutorigo\LaravelMacroHelper\IdeMacrosServiceProvider"

Usage

Generate helper file

Run the following command to generate the macro IDE helpers:

php artisan ide-helper:macros

Use of non-static macros

Macros can be both static (ie. Route::sth()) and non-static (ie. Request::route()->sth()). To distinct the two, use the @instantiated tag in the PHPDoc of macros, which depend on $this, for example:

/**
 * Gets the amount of route parameters
 *
 * @return array
 * @instantiated
 */
\Illuminate\Routing\Route::macro('parameterCount', function () {
    /** @var \Illuminate\Routing\Route $this */
    return count($this->parameters);
});