Anotasi PHP/Symfony untuk teg Throw

Question

Baru-baru ini saya mengalami sedikit kekeliruan mengenai anotasi dalam Symfony (tidak pasti sama ada ini adalah perkara PHP tulen juga).

Anotasi laluan baharu kelihatan seperti ini: #[路由('route', name: 'route_name')]

Apabila saya mahu @throws jenis anotasi yang sama, saya tidak dapat mencari sebarang cara untuk menggantikan jenis lama yang kelihatan seperti ini:

/**
 * @throws Exception
 */

Jadi saya mahukan jenis komen baharu, malah @throws

Answer 1

Idea utama di sebalik sifat adalah untuk melampirkan metadata statik pada kod kami (kaedah, sifat, dll.). Metadata ini selalunya merangkumi konsep seperti "konfigurasi". Dalam contoh anda, sifat ini menetapkan laluan ke bingkai anda. Dengan prinsip, anda boleh membina entiti anda. Beberapa tahun yang lalu, tiada sifat, jadi pembangun menggunakan anotasi untuk mengisytiharkannya. PHP8 membolehkan kami menggunakan sifat. Mari elakkan menggunakan anotasi (@Route).

Teg Throw tidak menetapkan apa-apa dalam aplikasi anda. Pengecualian ini hanya boleh dilemparkan oleh kod anda.

/**
 * @throws Exception //this line has no impact on your code
 */
#[Route('route', name: 'route_name')] //this line has an impact by setting up your routes
public myAction() {
  throw new Exception('foo'); // This line have an impact on your code
}

Ini adalah maklumat untuk pembangun (dan IDE berharga) untuk membantu kami memahami kod kami. Oleh itu, tag @Throw tidak mempunyai versi atribut. @Throw tag ialah dokumentasi "hanya", PHPDoc, ulasan :) Kod anda sepatutnya mempunyai gabungan komen dan sifat