PhpStorm specific attributes

Installs: 6 692 279

Dependents: 575

Suggesters: 2

Security: 0

Stars: 367

Watchers: 195

Forks: 12

1.1 2023-09-01 08:50 UTC

This package is auto-updated.

Last update: 2024-05-23 09:51:38 UTC


official JetBrains project

PhpStorm attributes

Use these PHP 8 attributes in PhpStorm to get more advanced code completion and analysis.

Learn more in the blog post.


The attributes are available in PhpStorm 2020.3 and later. They are bundled with PhpStorm so you don’t need to install them separately.

If you are using other static analysis tools and don’t want to get Class not found issues, then you might want to add the attributes package to your composer.json as a dev dependency:

composer require --dev jetbrains/phpstorm-attributes


Use this attribute when you want to notify users that an entity will be removed in the future.

Provide the explanation tip in reason and updating suggestion in replacement.

    reason: 'since Symfony 5.2, use setPublic() instead',
    replacement: '%class%->setPublic(!%parameter0%)'



Use Array Shape when you deal with object-like arrays and want to specify the keys’ names and types for values to get better coding assistance.

 // 'key' => 'type',
    'key1' => 'int',
    'key2' => 'string',
    'key3' => 'Foo',
    'key3' => App\PHP8\Foo::class,
function functionName(...): array

The attribute works with PHP ≤ 7.4 if specified in one line.



The attribute specifies possible object field names and their types. If applied, an IDE will suggest the specified field names and infer the specified types.

#[ObjectShape(["age" => "int", "name" => "string"])]
function functionName(): object {...}

$obj = functionName();

This usage effectively means that the $obj has 2 fields, the names are age and name, and the corresponding types are int and string.


Mark properties or entire objects with this attribute if you want to guarantee they won't be changed after initialization.

class DTO
    public string $val;

    public function __construct(string $val)
        $this->val = $val;

The attribute works with PHP ≤ 7.4 if specified in one line.



Use this attribute for functions that do not produce any side effects. All such PHP internal functions are already marked in PhpStorm.

function compare(Foo $a, Foo $b): int
    return $a->a <=> $b->b;



Use this attribute to specify which values exactly a function accepts as parameters and which it can return. This will improve coding assistance.

function response(
    #[ExpectedValues(valuesFromClass: Response::class)] $httpStatusCode,
) {



Mark functions that terminate script execution as exit points with this attribute to get a more accurate control flow analysis.

function redirect(): void {



Add this attribute to mark string parameters that contain text in some other [programming] language, for example, RegExp, SQL, and so on. This will improve highlighting and reveal additional features of PhpStorm for you.


Bugs and feature requests

Please report any issues to the PhpStorm issue tracker

Pull requests are also welcome.