пытается понять: извлекает результаты из базы данных с каждой строкой в ​​соответствии с предпочтением

Question

/** 
    * Fetches results from the database with each row keyed according to preference. 
    * The 'key' parameter provides the column name with which to key the result. 
    * For example, calling fetchAllKeyed('SELECT item_id, title, date FROM table', 'item_id') 
    * would result in an array keyed by item_id: 
    * [$itemId] => array('item_id' => $itemId, 'title' => $title, 'date' => $date) 
    * 
    * Note that the specified key must exist in the query result, or it will be ignored. 
    * 
    * @param string SQL to execute 
    * @param string Column with which to key the results array 
    * @param mixed Parameters for the SQL 
    * 
    * @return array 
    */ 
    public function fetchAllKeyed($sql, $key, $bind = array()) 
    { 
     $results = array(); 
     $i = 0; 

     $stmt = $this->_getDb()->query($sql, $bind, Zend_Db::FETCH_ASSOC); 
     while ($row = $stmt->fetch()) 
     { 
      $i++; 
      $results[(isset($row[$key]) ? $row[$key] : $i)] = $row; 
     } 

     return $results; 
    } 

Над фрагментом кода взят из системы xenforo.

Вопрос:

Хотя есть комментарии по этой функции, до сих пор не понимаю, каким образом «ключ» параметров работы? В комментариях сказано:

* For example, calling fetchAllKeyed('SELECT item_id, title, date FROM table', 'item_id') 
* would result in an array keyed by item_id: 
* [$itemId] => array('item_id' => $itemId, 'title' => $title, 'date' => $date) 

so if the table looks like this: 
item_id title  date 
1   book  2000 
2   car  2000 
3   laptop 2001 
... 

так, что результат будет?

Answer 1

Результирующий массив представляет собой ассоциативный массив с индексом, соответствующий его item_id.

Таким образом, результат будет

[1]=>array('item_id' => 1, 'title' => 'book', 'date' => '2000'), 
[2]=>array('item_id' => 2, 'title' => 'car', 'date' => '2000'), 
[3]=>array('item_id' => 3, 'title' => 'laptop', 'date' => '2001'), 
...... 

Answer 2

В основном, ключ() возвращает индекс элемента в текущей позиции массива. Еще глубже функция key() просто возвращает ключ элемента массива, на который в данный момент указывается внутренний указатель. Он не перемещает указатель. Если внутренний указатель указывает на конец списка элементов или массив пуст, key() возвращает NULL.

Более подробную информацию о здесь http://php.net/manual/en/function.key.php