Change record status: 
Project: 
Introduced in branch: 
8.x
Description: 

In Drupal 7, entity_load() returned an array of results, despite its name. For consistency with other load functions, the existing function has now been renamed to entity_load_multiple().

Additionally, a new entity_load() function has been added that does load and return a single entity.

Examples

Drupal 7

<?php
// Load multiple entities.
$entities = entity_load('entity_type', array(1, 2));
// Load a single entity.
$entities = entity_load('entity_type', array(1));
$entity = reset($entities);
?>

Drupal 8

<?php
// Load multiple entities.
$entities = entity_load_multiple('entity_type', array(1, 2));
// Load a single entity.
$entity = entity_load('entity_type', 1);
?>

A simple rename might not be enough: entity_load('entity_type', FALSE) loaded all entities. Use entity_load_multiple('entity_type') instead or entity_load_multiple('entity_type', NULL). Passing FALSE to entity_load_multiple leads to a fatal error.

Impacts: 
Module developers
Updates Done (doc team, etc.)
Online documentation: 
Not done
Theming guide: 
Not done
Module developer documentation: 
Not done
Examples project: 
Not done
Coder Review: 
Not done
Coder Upgrade: 
Not done
Other: 
Other updates done