Hướng dẫn php annotation array of objects - mảng chú thích php của các đối tượng

Trong PHP, loại

class orderCollection implements RecursiveArrayIterator

List:

$a = [1, 2, 3, 4, 5];

Mảng liên kết:

$a = [0 => 'hello', 5 => 'goodbye'];
$b = ['a' => 'AA', 'b' => 'BB', 'c' => 'CC']

Cấu trúc tạm thời:

$a = ['name' => 'Psalm', 'type' => 'tool'];

PHP xử lý tất cả các mảng này giống nhau, về cơ bản (mặc dù có một số tối ưu hóa dưới mui xe cho trường hợp đầu tiên).

Thi thiên có một vài cách khác nhau để thể hiện các mảng trong hệ thống loại của nó:

Mảng chung

Thi thiên sử dụng cú pháp mượn từ Java cho phép bạn biểu thị các loại của cả khóa và giá trị:

/** @return array */

Bạn cũng có thể chỉ định rằng một mảng không trống với loại đặc biệt

class orderCollection implements RecursiveArrayIterator

Cú pháp PHPDOC

PHPDOC cho phép bạn chỉ định loại giá trị mà một mảng chung giữ với chú thích:

class orderCollection implements ArrayIterator

Trong Thi thiên, chú thích này tương đương với

class orderCollection implements RecursiveArrayIterator

Mảng chung bao gồm cả hai mảng và danh sách kết hợp.

Danh sách

(Thi thiên 3.6+)

Thi thiên hỗ trợ một loại

class orderCollection implements RecursiveArrayIterator

class orderCollection implements RecursiveArrayIterator

Một cách thường xuyên để tạo một danh sách là với ký hiệu

class orderCollection implements RecursiveArrayIterator

Các mảng này sẽ trả về đúng với ____ 29 (PHP 8.1+) và đại diện cho một tỷ lệ phần trăm lớn của tất cả việc sử dụng mảng trong các ứng dụng PHP.

Một loại

class orderCollection implements RecursiveArrayIterator

/**
 * [...]
 * @return Order
 */
orderCollection::current()

/**
 * [...]
 * @return integer E.g. database identifier of the order
 */
orderCollection::key()

/**
 * [...]
 * @return Order
 */
orderCollection::offsetGet()

/**
 * [...]
 * @return Order
 */
orderCollection::current()

/**
 * [...]
 * @return integer E.g. database identifier of the order
 */
orderCollection::key()

/**
 * [...]
 * @return Order
 */
orderCollection::offsetGet()

• class orderCollection implements RecursiveArrayIterator
  

  6 là một kiểu con của

  /**
   * [...]
   * @return Order
   */
  orderCollection::current()
  
  /**
   * [...]
   * @return integer E.g. database identifier of the order
   */
  orderCollection::key()
  
  /**
   * [...]
   * @return Order
   */
  orderCollection::offsetGet()
  

  4

• /**
   * [...]
   * @return Order
   */
  orderCollection::current()
  
  /**
   * [...]
   * @return integer E.g. database identifier of the order
   */
  orderCollection::key()
  
  /**
   * [...]
   * @return Order
   */
  orderCollection::offsetGet()
  

  5 là một loại phụ của

  /**
   * [...]
   * @return Order
   */
  orderCollection::current()
  
  /**
   * [...]
   * @return integer E.g. database identifier of the order
   */
  orderCollection::key()
  
  /**
   * [...]
   * @return Order
   */
  orderCollection::offsetGet()
  

  6.

Các loại danh sách hiển thị giá trị của chúng theo một số cách:

class orderCollection implements ArrayIterator

Hình dạng mảng

Thi thiên hỗ trợ một định dạng đặc biệt cho các mảng trong đó các độ lệch chính được biết đến: hình dạng mảng, còn được gọi là "mảng giống như đối tượng".

Đưa ra một mảng

class orderCollection implements ArrayIterator

Thi thiên sẽ nhập nó trong nội bộ như:

class orderCollection implements ArrayIterator

Bạn có thể chỉ định các loại trong định dạng đó, ví dụ:

class orderCollection implements ArrayIterator

Các phím tùy chọn có thể được ký hiệu bằng một dấu vết

/**
 * [...]
 * @return Order
 */
orderCollection::current()

/**
 * [...]
 * @return integer E.g. database identifier of the order
 */
orderCollection::key()

/**
 * [...]
 * @return Order
 */
orderCollection::offsetGet()

class orderCollection implements ArrayIterator

Mẹo: Nếu bạn thấy mình sao chép cùng một hình dạng mảng phức tạp nhiều lần để tránh các vấn đề

/**
 * [...]
 * @return Order
 */
orderCollection::current()

/**
 * [...]
 * @return integer E.g. database identifier of the order
 */
orderCollection::key()

/**
 * [...]
 * @return Order
 */
orderCollection::offsetGet()

Xác thực hình dạng mảng

Sử dụng Valinor ở chế độ nghiêm ngặt để dễ dàng khẳng định các hình dạng mảng khi chạy bằng cú pháp hình dạng mảng thánh vịnh (thay vì xác nhận thủ công các phím với ISSET):

class orderCollection implements ArrayIterator

Valinor cung cấp cả thời gian chạy và các xác nhận thánh vịnh tĩnh với hỗ trợ cú pháp thánh vịnh đầy đủ và nhiều tính năng khác, hãy xem tài liệu Valinor để biết thêm thông tin!

Danh sách hình dạng

Bắt đầu trong Thi thiên 5, Thi -thiên cũng hỗ trợ một định dạng đặc biệt cho các mảng danh sách nơi biết các độ lệch chính.

Đưa ra một mảng danh sách

class orderCollection implements ArrayIterator

Thi thiên sẽ nhập nó trong nội bộ như:

class orderCollection implements ArrayIterator

Bạn có thể chỉ định các loại trong định dạng đó, ví dụ:

class orderCollection implements ArrayIterator

Các phím tùy chọn có thể được ký hiệu bằng một dấu vết

/**
 * [...]
 * @return Order
 */
orderCollection::current()

/**
 * [...]
 * @return integer E.g. database identifier of the order
 */
orderCollection::key()

/**
 * [...]
 * @return Order
 */
orderCollection::offsetGet()

class orderCollection implements RecursiveArrayIterator

Mẹo: Nếu bạn thấy mình sao chép cùng một hình dạng mảng phức tạp nhiều lần để tránh các vấn đề

/**
 * [...]
 * @return Order
 */
orderCollection::current()

/**
 * [...]
 * @return integer E.g. database identifier of the order
 */
orderCollection::key()

/**
 * [...]
 * @return Order
 */
orderCollection::offsetGet()

Xác thực hình dạng mảng

Sử dụng Valinor ở chế độ nghiêm ngặt để dễ dàng khẳng định các hình dạng mảng khi chạy bằng cú pháp hình dạng mảng thánh vịnh (thay vì xác nhận thủ công các phím với ISSET):

Valinor cung cấp cả thời gian chạy và các xác nhận thánh vịnh tĩnh với hỗ trợ cú pháp thánh vịnh đầy đủ và nhiều tính năng khác, hãy xem tài liệu Valinor để biết thêm thông tin!

class orderCollection implements RecursiveArrayIterator

Danh sách hình dạng

Bắt đầu trong Thi thiên 5, Thi -thiên cũng hỗ trợ một định dạng đặc biệt cho các mảng danh sách nơi biết các độ lệch chính.

class orderCollection implements RecursiveArrayIterator

non-empty-array

Đưa ra một mảng danh sách