Bagaimanakah Saya Boleh Menentukan Petua Jenis untuk Tatasusunan Objek dalam PHPDoc?

Menentukan Petua Jenis untuk Tatasusunan Objek dalam PHPDoc

Untuk mengisytiharkan teg PHPDoc bagi tatasusunan objek, gunakan sintaks berikut:

@var array<\Fully\Qualified\Class\Name>

Untuk contoh:

  /** @var SomeObj[] */
  private $someObjInstances;

Sintaks ini memberitahu IDE bahawa pembolehubah $someObjInstances ialah tatasusunan objek SomeObj. IDE kemudiannya akan memberikan cerapan kod yang sesuai dan pemeriksaan jenis apabila bekerja dengan pembolehubah itu.

Sokongan IDE

Perhatikan bahawa tidak semua IDE menyokong sintaks ini untuk tatasusunan objek. Sebagai contoh, PHPEd mungkin tidak mengenalinya. Walau bagaimanapun, IDE popular seperti PhpStorm dan Visual Studio Code menyokongnya di luar kotak.

Sintaks Alternatif

Dalam PHP 8.1, sintaks alternatif telah diperkenalkan untuk menentukan jenis unsur dalam tatasusunan:

@var array{key: type, key: type, ...}

Untuk contoh:

  /** @var array{object: SomeObj, string: string} */
  private $someObjsArray;

Sintaks ini membolehkan anda menentukan jenis kunci tertentu dalam tatasusunan. Ia amat berguna apabila berurusan dengan tatasusunan bersekutu.

Atas ialah kandungan terperinci Bagaimanakah Saya Boleh Menentukan Petua Jenis untuk Tatasusunan Objek dalam PHPDoc?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!