Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Core\Entity;
Chris@0: 
Chris@0: /**
Chris@0:  * Provides a trait for managing an object's dependencies.
Chris@0:  */
Chris@0: trait DependencyTrait {
Chris@0: 
Chris@0:   /**
Chris@0:    * The object's dependencies.
Chris@0:    *
Chris@0:    * @var array
Chris@0:    */
Chris@0:   protected $dependencies = [];
Chris@0: 
Chris@0:   /**
Chris@0:    * Adds a dependency.
Chris@0:    *
Chris@0:    * @param string $type
Chris@0:    *   Type of dependency being added: 'module', 'theme', 'config', 'content'.
Chris@0:    * @param string $name
Chris@0:    *   If $type is 'module' or 'theme', the name of the module or theme. If
Chris@0:    *   $type is 'config' or 'content', the result of
Chris@0:    *   EntityInterface::getConfigDependencyName().
Chris@0:    *
Chris@0:    * @see \Drupal\Core\Entity\EntityInterface::getConfigDependencyName()
Chris@0:    *
Chris@0:    * @return $this
Chris@0:    */
Chris@0:   protected function addDependency($type, $name) {
Chris@0:     if (empty($this->dependencies[$type])) {
Chris@0:       $this->dependencies[$type] = [$name];
Chris@0:       if (count($this->dependencies) > 1) {
Chris@0:         // Ensure a consistent order of type keys.
Chris@0:         ksort($this->dependencies);
Chris@0:       }
Chris@0:     }
Chris@0:     elseif (!in_array($name, $this->dependencies[$type])) {
Chris@0:       $this->dependencies[$type][] = $name;
Chris@0:       // Ensure a consistent order of dependency names.
Chris@0:       sort($this->dependencies[$type], SORT_FLAG_CASE);
Chris@0:     }
Chris@0:     return $this;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Adds multiple dependencies.
Chris@0:    *
Chris@0:    * @param array $dependencies
Chris@0:    *   An array of dependencies keyed by the type of dependency. One example:
Chris@0:    *   @code
Chris@0:    *   array(
Chris@0:    *     'module' => array(
Chris@0:    *       'node',
Chris@0:    *       'field',
Chris@0:    *       'image',
Chris@0:    *     ),
Chris@0:    *   );
Chris@0:    *   @endcode
Chris@0:    *
Chris@0:    * @see \Drupal\Core\Entity\DependencyTrait::addDependency
Chris@0:    */
Chris@0:   protected function addDependencies(array $dependencies) {
Chris@0:     foreach ($dependencies as $dependency_type => $list) {
Chris@0:       foreach ($list as $name) {
Chris@0:         $this->addDependency($dependency_type, $name);
Chris@0:       }
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0: }