为IIS上的PHP应用配置Datadog APM时ddtrace扩展加载失败求助

问题重现 #

执行php -m时出现以下错误：

PHP Startup: **Unable to load dynamic library 'ddtrace' (tried: C:\PHP7\ext\ddtrace (The specified module could not be found.), **C:\PHP7\ext\php_ddtrac

已尝试升级PHP至8、赋予ddtrace.dll全权限、添加DLL路径到环境变量，但问题仍存在，且ext目录下确实存在ddtrace.dll文件。

针对性排查与解决步骤 #

• 修正php.ini扩展配置
  报错显示PHP尝试加载无后缀的ddtrace和截断的php_ddtrac，说明配置存在错误：

  1. 打开PHP对应的php.ini文件（注意IIS可能使用单独的php.ini，需确认路径与命令行PHP使用的是否一致）
  2. 确保扩展配置行与ext目录下的文件名完全匹配：extension=ddtrace.dll（不要省略后缀或写错名称）
  3. 检查extension_dir配置，必须设置为绝对路径：extension_dir = "C:\PHP7\ext"（替换为你的实际PHP扩展目录）

• 严格匹配ddtrace扩展版本
  Datadog ddtrace扩展必须与PHP的以下属性完全一致，否则会加载失败：

  1. PHP主版本（8.0/8.1/8.2等）
  2. 线程安全（TS/NTS）：IIS环境下的PHP通常为**TS（线程安全）**版本，需下载对应TS的ddtrace.dll
  3. 位数（x86/x64）：确保扩展与PHP的位数完全匹配
     可从Datadog官方渠道下载完全匹配的版本

• 检查VC++运行库依赖
  ddtrace.dll依赖对应版本的VC++运行库：

  1. PHP 8.x需要VC16（Visual Studio 2019）或VC17（Visual Studio 2022）的运行库
  2. 下载安装对应位数（x86/x64）的VC++ Redistributable包
  3. 可使用Dependency Walker工具扫描ddtrace.dll，确认是否有缺失的依赖库

• 刷新环境与服务

  1. 修改php.ini或环境变量后，必须重启IIS服务（可通过IIS管理器或执行命令iisreset）
  2. 关闭所有已打开的命令行窗口，重新打开后再执行php -m测试（确保读取新的环境变量配置）

• 验证命令行与IIS的PHP版本一致
  执行php -v查看命令行的PHP版本，同时在IIS管理器中查看站点的PHP处理程序版本，确保两者一致，避免因配置文件不匹配导致的加载失败。

内容的提问来源于stack exchange，提问作者Jamal nabi ashrafi