Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JetBrains/phpstorm-attributes
PhpStorm specific attributes
https://github.com/JetBrains/phpstorm-attributes
php8 phpstorm
Last synced: 3 months ago
JSON representation
PhpStorm specific attributes
- Host: GitHub
- URL: https://github.com/JetBrains/phpstorm-attributes
- Owner: JetBrains
- License: apache-2.0
- Created: 2020-11-12T14:16:29.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T09:36:07.000Z (6 months ago)
- Last Synced: 2024-05-27T12:33:37.399Z (5 months ago)
- Topics: php8, phpstorm
- Language: PHP
- Homepage: https://packagist.org/packages/jetbrains/phpstorm-attributes
- Size: 18.6 KB
- Stars: 367
- Watchers: 192
- Forks: 12
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
# PhpStorm attributes
Use these PHP 8 attributes in PhpStorm to get more advanced code completion and analysis.
Learn more in the [blog post](https://blog.jetbrains.com/phpstorm/2020/10/phpstorm-2020-3-eap-4/).
## Installation
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
```
## `#[Deprecated]`
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`.
```PHP
#[Deprecated(
reason: 'since Symfony 5.2, use setPublic() instead',
replacement: '%class%->setPublic(!%parameter0%)'
)]
```
## `#[ArrayShape]`
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.
```PHP
#[ArrayShape([
// '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.
## `#[ObjectShape]`
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.
```PHP
#[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`.
## `#[Immutable]`
Mark properties or entire objects with this attribute if you want to guarantee they won't be changed after initialization.
```PHP
#[Immutable]
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.
## `#[Pure]`
Use this attribute for functions that do not produce any side effects. All such PHP internal functions are already marked in PhpStorm.
```PHP
#[Pure]
function compare(Foo $a, Foo $b): int
{
return $a->a <=> $b->b;
}
```
## `#[ExpectedValues]`
Use this attribute to specify which values exactly a function accepts as parameters and which it can return. This will improve coding assistance.
```PHP
function response(
#[ExpectedValues(valuesFromClass: Response::class)] $httpStatusCode,
//...
) {
//...
}
```
## `#[NoReturn]`
Mark functions that terminate script execution as exit points with this attribute to get a more accurate control flow analysis.
```PHP
#[NoReturn]
function redirect(): void {
//...
exit();
}
```
## `#[Language]`
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 https://youtrack.jetbrains.com/newIssue?project=WI.
Pull requests are also welcome.