¿Cómo decidir entre module_exists y function_exists?

Estoy familiarizado con el uso module_existsen un módulo, y usarlo en situaciones como:

• Habilite alguna funcionalidad adicional en un módulo, siempre que algún otro módulo esté disponible en el sitio también. El módulo Reservas: Correo electrónico contiene un ejemplo (en realidad, hay muchos ejemplos de esto), como se muestra en la fuente de su módulo : para usar tokens (en el cuerpo del correo electrónico) se requiere que el módulo Token esté habilitado.
• Implemente dependencias de módulos en un tema, como se muestra en la respuesta a " ¿Cómo implementar dependencias de módulos en un tema y paquetes de módulos con un tema? ".

Sin embargo, también existe function_exists, como se muestra en la respuesta a " ¿Es posible declarar una dependencia de la biblioteca Javascript en Hook.info? ".

Tengo la impresión de que usar function_existses un enfoque más robusto (seguro) en comparación con module_exists. Especialmente si desea asegurarse de que alguna función (agregada en una versión más nueva de un módulo) esté disponible, mientras que con solo usarla module_exists, corre el riesgo de encontrarse con errores como esos:

• si un sitio está siendo utilizando una vieja versión de un módulo, que no tiene esa función todavía (lo que no debería tratar de usarlo sin embargo ).
• si un sitio está ya utilizando una nueva versión de un módulo, que no tiene esa función más (lo que no debería tratar de usarlo más ).

Mi pregunta : ¿cuáles son los criterios típicos, o pros / contras, para decidir el uso de module_existsversus function_exists?

Siempre debe programar en la API y no en la implementación. Si Drupal proporciona un mecanismo para hacer algo, úselo.

module_exists()casi siempre debe usarse para dependencias suaves de algo provisto por un módulo Drupal. Siempre puede obtener información de la versión y decidir qué hacer usando system_get_info(). Ha habido casos en que las funciones están disponibles cuando los módulos se han deshabilitado (algunos de los módulos de carga automática de clase tienen este problema).

function_exists()debe reservarse para verificar si hay disponible una función o biblioteca de PHP. Core tiene algunos ejemplos de esto en algunos de los drupal_contenedores para la manipulación de cadenas y la conversión de juegos de caracteres.

module_existses una función API de Drupal que se utiliza para determinar si un módulo está instalado , no está diseñado para ofrecer garantías de la funcionalidad que puede contener un módulo, incluidas las funciones que declara.

function_exists es una función central de PHP que literalmente determina si existe una función con un nombre en la solicitud actual.

Como tal, no son realmente comparables entre sí, los usas para diferentes cosas. De hecho, sería fácil, aunque potencialmente redundante, que se complementaran entre sí, por ejemplo

// Do something with a specific module 
if (module_exists('foo')) {
  // Check what's available 
  if (function_exists('foo_bar')) {
    // ...
  }
  elseif (function_exists('foo_baz')) {
    // ...
  }
}

Tiene razón, function_existses una forma más sólida de verificar la existencia de la función API proporcionada por el módulo contrib. Es muy adecuado para usar directamente la API del módulo contrib.

Uso la API de caché de sesión como ejemplo:

if (function_exists('session_cache_set')) {
  session_cache_set($bin, $data)
}

Sin embargo, algunos módulos contrib solo proporcionan algunas propiedades o características adicionales, es muy difícil decir qué función dependiente es. En este caso, debe usarmodule_exists

Yo uso Elements como ejemplo:

if (module_exists('elements')) {
  $form['url'] = array(
    '#type' => 'urlfield',
    // other code
  );
}
else {
  $form['url'] = array(
    '#type' => 'textfield',
    // other code
  );
}

Las 3 respuestas (interesantes) anteriores me parecen de alguna manera confirmando mi "percepción" (como describí en mi pregunta). Curiosamente, esas respuestas se escribieron originalmente de forma independiente entre sí (se publicaron más o menos en el mismo momento, como se ilustra en la línea de tiempo de esta pregunta , use el "formato de alternar" para ver "minutos").

La respuesta de Jimmy Ko (+ comentarios debajo) ilustra algunos ejemplos más de cómo el uso function_existspuede hacer que un módulo sea más robusto con respecto a los posibles cambios en algún otro módulo que un módulo usa (depende de).

La respuesta de Clive muestra que también podrías combinar module_existsy function_exists, mientras que el comentario a continuación resolvió mis dudas sobre mi function_existsejemplo (es decir, debería usarlo module_exists).

La respuesta de mpdonadio (+ comentarios debajo) es, al menos para mí, la más difícil de digerir. Pero después de revisar el comentario de Shawn Conn debajo, encontré algunos enlaces más que proporcionan más detalles sobre todo esto, es decir:

• Programa para una interfaz, no una implementación .
• De SO: ¿Qué significa "programar en una interfaz"? .
• De los programadores. SE : Comprensión de "programación a una interfaz" .

"Mi conclusión" (después de digerir las respuestas anteriores): déjelo al núcleo de Drupal para que lo use function_exists, y los módulos contribuidos / personalizados deberían intentar, en la medida de lo posible, apegarse a module_exists... aunque hay excepciones ...