Add PHP/VerboseLink module with PHP_VERBOSE_LINK option

The output by linker when using flags such as `/VERBOSE` on MSVC or
`--verbose` on some other linkers can be extremely verbose. This module
provides option to enable verbosity at the link step.

Author: petk

cmake/cmake/Flags.cmake

@@ -4,7 +4,6 @@ Check and configure compilation options.
 
 include_guard(GLOBAL)
 
-include(CheckLinkerFlag)
 include(CheckSourceRuns)
 include(CMakePushCheckState)
 include(PHP/CheckCompilerFlag)
@@ -499,21 +498,6 @@ endif()
 # Check linker flags.
 ################################################################################
 
-# Align segments on huge page boundary.
 include(${CMAKE_CURRENT_LIST_DIR}/checks/CheckSegmentsAlignment.cmake)
 
-check_linker_flag(C LINKER:/verbose PHP_HAS_VERBOSE_LINKER_FLAG_C)
-if(PHP_HAS_VERBOSE_LINKER_FLAG_C)
-  target_link_options(
-    php_config
-    INTERFACE $<$<AND:$<CONFIG:Debug>,$<LINK_LANGUAGE:C>>:LINKER:/verbose>
-  )
-endif()
-
-check_linker_flag(CXX LINKER:/verbose PHP_HAS_VERBOSE_LINKER_FLAG_CXX)
-if(PHP_HAS_VERBOSE_LINKER_FLAG_CXX)
-  target_link_options(
-    php_config
-    INTERFACE $<$<AND:$<CONFIG:Debug>,$<LINK_LANGUAGE:CXX>>:LINKER:/verbose>
-  )
-endif()
+include(PHP/VerboseLink)

cmake/cmake/modules/PHP/VerboseLink.cmake

@@ -0,0 +1,65 @@
+#[=============================================================================[
+# PHP/VerboseLink
+
+This module checks whether to enable verbose output by linker:
+
+```cmake
+include(PHP/VerboseLink)
+```
+
+This module provides the `PHP_VERBOSE_LINK` option to control enabling the
+verbose link output. Verbose linker flag is added to the global `php_config`
+target.
+
+## Examples
+
+When configuring project, enable the `PHP_VERBOSE_LINK` option to get verbose
+output at the link step:
+
+```sh
+cmake -B php-build -D PHP_VERBOSE_LINK=ON
+cmake --build php-build -j
+```
+#]=============================================================================]
+
+include_guard(GLOBAL)
+
+include(CheckLinkerFlag)
+
+option(PHP_VERBOSE_LINK "Whether to show additional info at the link step")
+mark_as_advanced(PHP_VERBOSE_LINK)
+
+if(NOT PHP_VERBOSE_LINK)
+  return()
+endif()
+
+block()
+  get_property(enabledLanguages GLOBAL PROPERTY ENABLED_LANGUAGES)
+
+  foreach(lang IN ITEMS C CXX)
+    if(NOT lang IN_LIST enabledLanguages)
+      continue()
+    endif()
+
+    if(CMAKE_${lang}_COMPILER_LINKER_ID STREQUAL "MSVC")
+      set(flags "LINKER:/VERBOSE")
+    elseif(MSVC AND CMAKE_${lang}_COMPILER_LINKER_ID STREQUAL "LLD")
+      set(flags "LINKER:-verbose")
+    elseif(CMAKE_${lang}_COMPILER_LINKER_ID MATCHES "^(GNU|GNUgold|LLD)$")
+      set(flags "LINKER:--verbose")
+    else()
+      set(flags "LINKER:--verbose")
+      check_linker_flag(${lang} "${flags}" PHP_HAS_VERBOSE_LINK_FLAG_${lang})
+      if(NOT PHP_HAS_VERBOSE_LINK_FLAG_${lang})
+        set(flags "")
+      endif()
+    endif()
+
+    if(flags)
+      target_link_options(
+        php_config
+        INTERFACE $<$<LINK_LANGUAGE:${lang}>:${flags}>
+      )
+    endif()
+  endforeach()
+endblock()