我什么时候应该创建服务或实用程序功能？

在过去的整个星期中，我一直在想这个问题：什么时候应该创建服务或实用程序功能？

在Drupal Core中，我们同时具有服务功能和实用程序功能，但是我找不到它们之间的区别（当我需要创建服务或需要创建实用程序功能时）。

我将以其中具有InternalFunctions类的Modules Weight模块为例。

<?php

namespace Drupal\modules_weight\Utility;

class InternalFunctions {

  public static function prepareDelta($weight) {
    $delta = 100;

    $weight = (int) $weight;

    if ($weight > $delta) {
      return $weight;
    }

    if ($weight < -100) {
      return $weight * -1;
    }

    return $delta;
  }


  public static function modulesList($force = FALSE) {
    $modules = [];
    $installed_modules = system_get_info('module');

    $config_factory = \Drupal::service('config.factory');

    if ($force) {
      $show_system_modules = TRUE;
    }
    else {
modules.
      $show_system_modules = $config_factory->get('modules_weight.settings')->get('show_system_modules');
    }

    $modules_weight = $config_factory->get('core.extension')->get('module');

    foreach ($installed_modules as $filename => $module_info) {
      if (!isset($module_info['hidden']) && ($show_system_modules || $module_info['package'] != 'Core')) {
        $modules[$filename]['name'] = $module_info['name'];
        $modules[$filename]['description'] = $module_info['description'];
        $modules[$filename]['weight'] = $modules_weight[$filename];
        $modules[$filename]['package'] = $module_info['package'];
      }
    }
    uasort($modules, ['Drupal\Component\Utility\SortArray', 'sortByWeightElement']);

    return $modules;
  }

}

在此类中，我有两个静态函数，但它们都是实用程序函数还是prepareDelta()实用程序函数，modulesList()应该在另一个类中并具有服务？

我这次发现的唯一区别是，在名称空间Drupal \ Component \ Utility（您将在其中看到很多实用程序功能）中，它们都不在服务内部使用，通常一个服务在内部使用另一个服务（我不已审查所有服务以验证这一点）。

那么，什么时候应该创建服务或实用程序功能？

一般使用服务。如果可以使用静态实用程序功能，请参见以下博客文章：

所以永远不要使用静态？

好吧，没有有效的用例。一个是如果您有一个预定义的项目列表，则static可以帮助减少内存，因为它将位于类级别，而不是在任何实例中。

其他情况是不需要外部依赖项的实用程序方法，例如Slugify方法。

<?php
class Util
{
    public static function slug($string)
    {
        return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', '_', $string)));
    }
}

slug方法仅能很好地定义行为。在单元测试中很容易考虑到该行为，当我看到此调用时，我不会太担心。

这些方法甚至不需要进行初始化，因此甚至可以进行单元测试。

资料来源：https : //stovepipe.systems/post/avoiding-static-in-your-code

（Drupal中现在的静态代码量是由于从过程D7代码过渡而来的，因此请勿在当前状态下使用Drupal作为示例。）

关于问题中的示例，实用程序类的其余部分（问题中未显示）

<?php

namespace Drupal\modules_weight\Utility;

/**
 * Provides module internal helper methods.
 *
 * @ingroup utility
 */
class InternalFunctions {

...

  /**
   * Return the modules list ordered by the modules weight.
   *
   * @param bool $force
   *   Force to show the core modules.
   *
   * @return array
   *   The modules list.
   */
  public static function modulesList($force = FALSE) {
    // If we don't force we need to check the configuration variable.
    if (!$force) {
      // Getting the config to know if we should show or not the core modules.
      $force = \Drupal::service('config.factory')->get('modules_weight.settings')->get('show_system_modules');
    }
    // Getting the modules list.
    $modules = \Drupal::service('modules_weight')->getModulesList($force);

    return $modules;
  }

}

在静态包装器中调用模块自身的服务：

\Drupal::service('modules_weight')

这可能是因为实用程序类在旧式过程代码中使用。在OOP代码中，这不是必需的，在这里您应该直接注入服务。

来自Slack Drupal #contribute频道的Ken Rickard说：“如果您希望其他模块（或其他开发人员）与该代码进行交互，那么我将创建一个服务。实用程序方法只是您自己的私有快捷方式。”

是的，关于服务的一个很酷的事情是任何人都可以覆盖它们。因此，如果您想让其他人可以自定义特定的代码。请参阅更改现有服务，提供动态服务。

另外，如果需要对PHP单元测试进行Mock测试，则应将其作为服务。请参阅Drupal 8中的服务和依赖项注入，请参阅对更复杂的Drupal类进行单元测试。

问与答：

服务单元测试

编写单元测试以查找从另一个类调用静态方法的方法