PHP 代理 - 发行说明
版本 4.9.2
2026 年 5 月 21 日
功能增强：
- 支持 curl_multi_exec 插桩，包括单次 API 调用计时、状态追踪、trace-parent 传播和应用程序流程监控。
- 支持使用 zpa.prune_intermediate_spans 配置裁剪中间非分支 Span。
- 使用纯 C 实现增强了 Trace ID 和 Span ID 的生成方式，替代了请求关闭时的用户函数调用。
版本 4.9.1
2026 年 3 月 24 日
功能增强：
- 支持在安装时指定多个自定义 PHP 路径。
- 支持配置自定义静态端口，而无需依赖动态端口发现。
- 支持在请求经过反向代理或负载均衡器时检测原始客户端端口。
问题修复：
- 修复了使用自定义 JSON 编码的参数追踪问题（HTTP 请求/响应头、外部调用头、自定义参数、输入参数和应用程序参数）。
版本 4.9
2026 年 3 月 11 日
功能增强：
- 支持 PHP 8.5。
- 安装代理时自动检测 LiteSpeed PHP。
- 支持下载特定代理版本。
- Go 版本已更新至 1.25。
问题修复：
- 修复了 phpinfo() 页面在异常处理期间崩溃的问题。
- 修复了后台事务 Trace ID 生成的问题。
- 修复了文件权限问题。
- 修复了 Windows DLL 名称不正确的问题。
版本 4.8
2025 年 7 月 22 日
功能增强：
- 支持路径分析。
- 支持仅包含指定端口进行监控。
- 支持捕获外部调用的请求和响应头。
- 支持捕获外部调用的响应状态码。
- 支持捕获操作系统信息（名称、架构和版本）。
- 支持捕获事务响应头。
- 支持捕获 cURL 选项。
- 支持 ECS 检测。
问题修复：
- 修复了 Azure Web Apps 检测问题。
版本 4.7.1
2025 年 4 月 10 日
功能增强：
- 支持 Windows PHP 8.4。
问题修复：
- 修复了 Windows PHP Agent MSI 缺失的问题。
- 修复了基于 FPM 服务器上 traceparent 传播的问题。
版本 4.7
2025 年 3 月 12 日
功能增强：
- 将 PHP 版本支持扩展至 8.4。
- 包含了 alt-php 的安装路径。
- 启用了 traceparent 头传播。
版本 4.6
2024 年 12 月 24 日
功能增强：
- PHP 代理现已作为 Docker 镜像发布至 https://hub.docker.com。
- 支持 Kubernetes 检测。
问题修复：
- 修复了代理被误报为病毒的问题。
- 修复了因符号链接路径导致安装失败的问题。
- 修复了 mysqli::real_connect 函数的问题。
- 修复了 Docker 容器检测问题。
版本 4.5
2024 年 6 月 19 日
功能增强：
- 代理与导出器之间的通信现已通过认证。
- 安装/更新时需要提供许可证密钥。
- 支持新的分布式链路追踪。
- 从一键安装脚本中移除了 curl 依赖。
问题修复：
- 修复了 musl 构建中缺少共享对象文件的问题。
- 修复了时间戳问题（32 位 PHP Windows）。
版本 4.4
2024 年 3 月 18 日
功能增强：
版本 4.3
2024 年 2 月 16 日
功能增强：
- 安装时支持自动检测 Plesk 和 XAMPP。
- 支持通过 IP 地址指向远程导出器。
- 支持配置 Span 追踪限制。
问题修复：
- 修复了多线程 Web 服务器中并发请求的问题。
- 修复了多线程 Web 服务器中主机识别的问题。
- 修复了文件描述符过多的问题。
- 移除了 Musl 对 libexecinfo 的依赖。
- 修复了 MYSQLI 弃用警告。
版本 4.2
2023 年 12 月 1 日
新功能/增强：
- 支持 Docker Engine v 20.01 及以上版本的完整容器 ID 检测。
- 支持高级 Windows MSI 配置。
- 支持在 Linux 安装时检查支持的版本。
- 更新了 Windows 安装范围和权限。
- 发布者名称已更新为 Zoho Corporation Pvt. Ltd。
- 支持设置应用程序组配置。
- Windows 现支持包含空格的应用程序名称。
- 支持按严重程度追踪错误。
问题修复：
- 修复了 PHP 8.2 中后台事务的问题。
版本 4.1
2023 年 9 月 11 日
新功能/增强：
- 支持 PHP 版本 8.2
- 支持主机 IP 检测。
- 支持在链路追踪中捕获后台参数。
- 降低了应用程序响应时间。
- 支持安装后配置 ini 条目。
- 支持基于主机的授权许可。
- 改进了内部和外部组件的区分。
问题修复：
- 修复了 MSI 更新/卸载问题。
- 修复了追踪参数的大小限制问题。
- 修复了 PHP 代理 REMI 安装问题。
- 修复了 Musl 检测问题。
版本 4.0.1
2023 年 7 月 3 日
问题修复：
- 修复了 musl 检测问题。
版本 4.0
2023 年 6 月 27 日
功能增强：
- 支持 S247DataExporter （Linux 和 Windows）。
- 支持在所有可用 PHP 版本中安装 PHP 代理。
- 支持在更新时保留 INI 配置。
- 支持在安装时从环境变量和 CLI 获取 INI 配置。
- 支持自动检测应用程序端口。
- 支持捕获 Session ID。
- 支持远程导出器主机（Sidecar 部署）。
- 支持附加配置项。
- 支持在事务链路追踪中设置 SQL 调用栈阈值。
- 支持跳过事务。
- 支持对相似事务进行分组。
- 支持按前缀对事务进行分组。
- 支持对 HTTP 参数列表进行脱敏。
- 支持追踪后台事务。
问题修复：
- 修复了代理在 cPanel 中安装的问题。
- 修复了 Trace ID/Span ID 的问题。
- 修复了内存泄漏问题。
版本 3.5.1
2023 年 6 月 12 日
问题修复：
- 修复了主监视器配置未生效的问题。
- 修复了 PHP Alpine 配置文件不存在的问题。
- 修复了链路追踪中未发送字节输入/输出的问题。
- 修复了 SQLTraceThreshold 未生效的问题。
- 修复了请求验证的问题。
版本 3.5
2023 年 1 月 31 日
支持的功能/增强：
- 支持 Redis 和 Memcache。
- 支持启用和禁用错误追踪。
- 支持启用和禁用异常追踪。
- 支持启用和禁用方法追踪。
- 支持 SQL 链路追踪阈值。
说明
您可以指定 SQL 阈值，超出阈值时将生成并展示链路追踪记录。
- 支持附加的关键事务配置。
- 支持追踪外部调用的响应状态码。
- 支持追踪外部调用的端口号。
- 支持追踪失败的组件。
版本 3.4
2022 年 11 月 30 日
支持的功能/增强：
- 支持 PHP 8.1。
- 支持捕获内存分配。
- 支持捕获命令行参数。
- 支持捕获多个异常和错误。
- 支持在多监视器设置中对各实例进行单独配置。
- 支持在 URL 被重写时追踪原始 URL。
- 支持配置日志目录。
- 支持配置代理轮询间隔。
版本 3.3.1
2022 年 10 月 3 日
支持的功能：
- 支持 ARM 架构。
版本 3.3
2022 年 7 月 7 日
支持的功能/增强：
- 支持捕获 CPU 时间。
- 支持捕获后台事务。
- 支持配置 APM 链路追踪深度。
- 方法追踪数量现已可配置。
- 支持捕获 HTTP 参数。
- 支持捕获网络字节数。
- 支持通过 ini 条目自定义插桩。
- 安装时在代理安装目录中提供 zpa.ini 的符号链接（Linux）。
- 支持通过 ini 和 conf 条目配置端口。
- 不带传输协议的 curl 请求现在被视为 HTTP。
- 下载状态现在会发送到多监视器中的所有监视器。
问题修复：
- 修复了组件未被标记的问题。
- 修复了代理无法通信的问题。
- 修复了"TCP socket accept failed"错误（Windows）。
- 修复了 app-parameter 值未在对应应用中更新的问题。
- 修复了存在多个 curl 资源时 curl_exec URL 不正确的问题。
- 修复了分布式链路追踪问题。
- 修复了代理服务未被终止的问题（Windows）。
- 修复了 curl 请求时崩溃的问题。
- 修复了升级时 curl 和 openSSL 版本检查的问题。
版本 3.2.1
2022 年 4 月 11 日
问题修复：
- 分布式链路追踪默认已关闭。
- 修复了 Azure 主机类型识别问题。
- 修复了与 Site24x7 APM Insight（plusinsight）服务器的通信问题。
版本 3.2
2022 年 3 月 4 日
功能增强：
- 支持追踪 HTTP 查询。
- 用户可查看每笔事务的完整 URL。
- 支持追踪请求头。
- 支持从监控中排除 HTTP 错误状态码，以减少监控环境中的噪声。
- 链路追踪中现在显示完整 URL。
- PHP Linux 代理现支持 Alpine OS。
- 支持多监视器配置。
- 支持通过 API 在事务中添加自定义参数。
- App 参数支持：使用 App 参数监控操作或变量的大小和频率。
- 支持分布式链路追踪。
- 支持将任意事务设置为关键事务。
问题修复：
- 修复了 PHP v8.0 中 Windows 代理支持问题。
- 修复了 Linux 代理更新问题。
- 修复了函数名为空和时长为负数的问题。
- 修复了组件名称不匹配的问题。
版本 3.1.1
2021 年 10 月 12 日
问题修复：
- 修复了在 Cassandra 中追踪 Simple Statement 查询的问题。
版本 3.1
2021 年 8 月 27 日
功能增强：
- 支持监控基于 PHP 版本 8.0 开发的应用程序
- 支持线程安全的 PHP 版本 - ZTS/XAMPP（7.0 及以上版本）。
- 支持 Oracle 数据库。
- 修复了自动更新问题——在 Windows 环境中，自动更新时安装路径被重置为默认路径而非自定义路径，此问题已修复。
- 修复了代理通信中的 SSL 错误。
版本 3.0.3
2021 年 7 月 13 日
问题修复：
- 修复了因 SSL 版本不匹配导致代理连接失败的问题。
版本 3.0.2
2021 年 6 月 22 日
安全修复：
- 限制了访客用户对 APM 代理配置文件的读写权限。
版本 3.0.1
2021 年 4 月 16 日
功能增强：
- 简化了 APM Insight PHP Linux 代理的安装脚本。
版本 3.0
2021 年 3 月 24 日
功能增强：
- 校验和验证，用于验证下载代理的完整性
- 支持监控 Cassandra
版本 2.9.4
2020 年 8 月 5 日
功能增强：
- 可通过脚本名称追踪 CLI 请求。
- 可在事务中追踪域名。
- 支持将应用程序名称作为参数传递。
- 修复了内存段错误（Segmentation fault）问题。
版本 2.9.3
2020 年 7 月 25 日
问题修复：
- 修复了 Windows PHP 安装程序问题。
版本 2.9.2
2020 年 5 月 7 日
功能增强：
- Linux 和 Windows 代理均可通过服务拓扑图可视化应用程序组件。
版本 2.9.1
2020 年 4 月 16 日
功能增强：
- 在 Windows 环境中支持 PHP 7.2 至 7.4
版本 2.9
2020 年 3 月 6 日
功能增强：
- 在 Linux 环境中支持 PHP 7.4
- 降低对应用程序响应时间的影响
版本 2.8.1
2019 年 11 月 4 日
问题修复：
- 修复了 libssl.so.1.1 缺失错误。
版本 2.8
2019 年 10 月 29 日
功能增强：
- 代理可自动检测在 GCP 环境中运行的应用程序
- 代理将在支持的操作系统上作为 systemd 服务运行
- 支持基于正则表达式模式从监控中排除事务
版本 2.7
2019 年 3 月 28 日
功能增强：
- 支持 PHP 版本 7.3
- 通过 CLI 发起的事务现可在 Web 事务标签页下查看。
版本 2.6
2018 年 12 月 31 日
功能增强：
- 支持通过 API 自定义事务名称——可使用 API 将默认事务名称重命名，以便于识别和符合业务需要。
版本 2.5
2018 年 8 月 24 日
功能增强：
- 支持 WordPress 和 Joomla——基于 WordPress 和 Joomla 构建的 PHP 应用程序可使用 APM Insight PHP 代理版本 2.5 进行监控
- 现在可以捕获并显示没有异常的错误调用栈信息，并在链路追踪中展示。
版本 2.4
2018 年 8 月 6 日
功能增强：
- 自动插桩：从代理版本 2.4 起，用户环境中使用的框架和 CMS 将被自动检测和分析。
- 智能采样：当应用程序 CPU 使用率高于正常水平时，PHP 代理将动态调整发送的监控数据量，不会增加额外负载。
版本 2.3
2018 年 7 月 12 日
新功能：
- 支持 Drupal 框架——可监控基于 Drupal 框架构建的 PHP 应用程序。
- 支持基于 PHP 版本 7.2 开发的 PHP 应用程序（仅限 Linux）
版本 2.2
2018 年 6 月 14 日
新功能：
- 支持 Laravel 框架——现支持监控基于 Laravel 框架构建的 PHP 应用程序。
问题修复：
- 修复了日志层级的内存泄漏问题。
版本 2.1
2018 年 5 月 4 日
功能增强
- 代理密码已加密，并实现了 GDPR 相关变更
版本 2.0
2017 年 4 月 18 日
新功能
- 可视化外部组件拆分——分析 Web 请求在各组件上花费的时间，识别耗时较多的组件，优化应用程序性能。
版本 1.7
2018 年 1 月 5 日
问题修复
- 修复了 request_uri 仅显示 index.php 的问题。（问题描述：在使用 MVC 框架的 PHP 应用中，事务名称始终显示为 index.php）
版本 1.6
2017 年 11 月 13 日
新功能
- 支持 PHP 7.1
- 错误和异常的调用栈追踪
- PHP Windows 自动升级
版本 1.5
2017 年 9 月 15 日
新功能
- Windows 版本
版本 1.4.1
2017 年 8 月 2 日
新功能
- 指标桶大小变更（各代理每分钟指标数量统一）
版本 1.4
2017 年 4 月 12 日
新功能
- 支持 EU 数据中心
问题修复
- 修复了 PDO 预处理语句的数据库查询未被捕获的问题
版本 1.3
2017 年 2 月 23 日
新功能
- 捆绑了 PHP 5.4 代理
- 支持 PHP 5.3
- 一键安装
- 通过端口 80 监控，而非单独监控服务器
问题修复
- 修复了下载代理超过 15 秒即终止的问题
版本 1.2.1
2016 年 10 月 26 日
新功能
- 自动扩缩容
问题修复
- 修复了 class 和 function 名称为 NULL 值时被丢弃的问题
版本 1.2
2016 年 9 月 23 日
新功能
- 支持 PHP 7.0
- 自动升级
- 客户端配置支持（从基于文件的配置迁移至客户端 GUI 配置）
- 统一的 Connect/Delete 响应处理
- 支持多个代理发行包
问题修复
- 修复了因 request_uri 为 NULL 导致内存段错误（segmentation fault）的问题
版本 1.1
2016 年 7 月 15 日
新功能
- 错误指标
- 异常指标
- 全新安装程序
- 支持 Nginx、Lighttpd 或其他基于 PHP-FPM 的服务器
- 性能分析器增强
版本 1.0
2016 年 6 月 2 日
新功能
- 事务时间
- Apdex 指标
- 数据库指标
- 链路追踪指标
- 支持 MVC 框架：CodeIgniter 和 CakePHP
- 支持 Web 服务器：Apache2