#[Атрибути] в PHP від arifhossen.dev

Що таке атрибути PHP і чому це важливо?

PHP 8.0 впровадив атрибути — важливу функцію, яка дозволяє розробникам додавати структуровану метадані до їхнього коду.
```PHP
// приклад використання атрибутів в PHP

[Route("/home", methods: ["GET"])]

public function home() {
return "Home Page";
}

Атрибути дозволяють додавати метадані без необхідності використовувати коментарі. Це дозволяє зробити код більш зручним для автоматичного оброблення за допомогою рефлексії (Reflection).
PHP

[Route("/users", methods: ["POST"])]

public function createUser(Request $request) {
// код для створення користувача
}

Цей новий синтаксис є альтернативою старішим коментарям або анотаціям, даючи більшу чіткість і потужність для інтеграційних фреймворків.
PHP

[ORM\Entity]

class User {
// код моделі
}

Думайте про атрибути як про спеціальні мітки, які покращують функціональність вашого коду без його ускладнення.

Приклад із реального життя: створення REST API

Створимо простий API для управління користувачами, використовуючи атрибути:

use App\Attributes\Route;  
use App\Attributes\Validate;  

class UserController  
{  
 #[Route("/users", methods: ["GET"])]  
 #[CacheFor(minutes: 15)]  
 public function getUsers(): array  
 {  
 return $this->userRepository->findAll();  
 }  

 #[Route("/users", methods: ["POST"])]  
 #[Validate]  
 public function createUser(  
 #[Email]   
 #[MaxLength(100)]   
 string $email,  

 #[MinLength(8)]  
 string $password  
 ): User {  
 return $this->userService->create($email, $password);  
 }  
}

Ключові переваги

1. Чистий код: замініть заплутані docblock-і на структуровані атрибути
2. Типова безпека: виявляйте помилки на етапі компіляції, а не під час виконання
3. Підтримка IDE: краща автодоповнення та валідація
   4.
   Інтеграція з фреймворками: сучасні PHP фреймворки використовують атрибути для маршрутизації, валідації та інших функцій

Створення власних атрибутів

Потрібно щось специфічне? Створіть власні атрибути:

#[Attribute]  
class RateLimit  
{  
 public function __construct(  
 public int $requests,  
 public int $minutes  
 ) {}  
}  

#[RateLimit(requests: 100, minutes: 60)]  
class PaymentAPI  
{  
 // Реалізація API  
}

Кращі практики

• Використовуйте атрибути для задач, які стосуються різних аспектів програми, таких як валідація, кешування та маршрутизація.
• Тримайте логіку атрибутів окремо від бізнес-логіки.
• Документуйте власні атрибути детально.
• Зважайте на вплив на продуктивність при використанні реалізацій атрибутів, що сильно залежать від рефлексії (Reflection).

Типові випадки використання

• Документація API
• Маппінг ORM для баз даних
• Валідація введених даних
• Контроль доступу
• Ін'єкція залежностей (Dependency Injection)
• Обробка подій (Event Handling)

Висновок

Атрибути PHP модернізують організацію коду та покращують його підтримку.
Почніть з атрибутів, наданих фреймворком, а потім створюйте власні за потреби. Вони особливо потужні для API та корпоративних додатків.

Готові покращити свої навички в PHP? Почніть з рефакторингу існуючих анотацій docblock у атрибути.

Щасливого кодування!

Перекладено з: How to use Attributes in PHP: A Modern Approach to Metadata