# APM Insight PHP Agent - Release Notes ## PHP Agent v4.9.1 **Release Date:** 03-04-2025 #### Enhancements - Support for specifying multiple custom PHP installation paths during agent setup. - Option to configure a custom static port as an alternative to dynamic port discovery. - Ability to capture the original client port forwarded by reverse proxies or load balancers. - Support for PHP 8.5. - Automatic detection of LiteSpeed PHP during installation. - Option to download and install a specific version of the agent. #### Issues Fixed - Improved tracking of parameters by fixing issues in custom JSON encoding for HTTP request/response headers, external call headers, input parameters, custom parameters, and application parameters. - Resolved the crash issue on the phpinfo page when user-defined functions are invoked during exceptions. - Fixed an issue where HTTP status codes were incorrectly reported for non-web transactions. - Addressed file permission-related issues. - Fixed crash issues related to folder permissions in Linux environments using the www-data group. --- ## PHP Version 4.8.1 **Release Date:** 25-09-2025 #### Enhancements - Added support to include only specified ports for monitoring. - Support for capturing external call request and response headers. - Support for capturing external call response codes. - Support for capturing OS information (name, architecture, and version). - Support for capturing transaction response headers. - Support for capturing cURL options. - Support for ECS detection. #### Issues Fixed - The issue with detecting Azure Web Apps has been fixed. --- ## PHP Version 4.7.1 **Release Date:** 21-04-2025 #### Enhancements - Support has been extended for PHP versions up to 8.4. - Included alt-php paths for installation. - Enabled traceparent header propagation. --- ## PHP Version 4.6 **Release Date:** 13-01-2025 #### Issues Fixed - PHP Agent is getting detected as virus has been fixed. - PHP Agent Installation got failed if PHP path is getting detected as a symbolic link path. - Application is getting crashed due to strdup PHP package has been fixed. - MYSQL Calls are not getting tracked if optional parameters are provided in the mysqli::real_connect function has been fixed. - Docker environment is not getting detected, if the application is installed in Azure web app has been fixed. #### Enhancements - Automatic detection of Kubernetes environment for auto scaling. --- ## PHP Version 4.5 **Release Date:** 21-06-2024 #### Issues Fixed - Missing shared object file for musl build has been fixed. #### Enhancements - Removed curl dependency from installer script. - Authenticated communication between agent and exporter --- ## PHP Version 4.4 **Release Date:** 29-03-2024 #### Issues Fixed - The issue of configuration not being reset during a fresh install has been fixed. - The installation issue during the repair has been fixed. #### Enhancements - Support for PHP version 8.3 --- ## PHP Version 4.3 **Release Date:** 07-03-2024 #### Issues Fixed - The issue with concurrent requests in a multi-threaded web server has been fixed. - The issue regarding Host identification in a multi-threaded web server has been resolved. - The issue with too many open file descriptors has been resolved. - The libexecinfo dependency has been removed for Musl. - Deprecation warning for MYSQLI has been fixed. #### Enhancements - Support for complete container ID detection for Docker Engine v 20.01 and above. - Support for advanced Windows MSI configurations. - Support for checking supported versions during Linux installation. - Windows installation scope and privileges have been updated. - The publisher's name has been updated to Zoho Corporation Pvt. Ltd. - Windows now supports application names with spaces. - [Support for tracking errors based on severity.](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-enable-or-disable-error-tracking-in-the-php-agent) - Support for automatic detection of Plesk and XAMPP during installation. - Support for pointing to a remote exporter using an IP address. - Support to configure span tracking limit. --- ## PHP Version 4.1 **Release Date:** 06-11-2023 #### Issues Fixed - The issue with the agent installation in the c-panel has been fixed. - The memory leak issue has been fixed. - The PHP agent REMI installation issue has been resolved. - The issue related to size limitations for tracked arguments has been successfully fixed. #### Enhancements - Support for APPMANAGER DataExporter ([Linux](https://www.manageengine.com/products/applications_manager/help/apm-insight-data-exporter-linux.html) and [Windows](https://www.manageengine.com/products/applications_manager/help/apm-insight-data-exporter-windows.html)). - Support for PHP v8.2. - Support for capturing Host IP Address. - Support for capturing Background arguments in trace. - [Configure INI entries](https://www.manageengine.com/products/applications_manager/help/apm-insight-modify-php-agent-configurations.html) after installation (Linux). - Support for preserving INI configuration during update (Linux). - Support for getting INI configurations from the environment and CLI during installation (Linux). - Support for auto-detection of application port. - Support for remote exporter host. - Support for additional configurations: - Support for skipping transactions. - Support for grouping similar transactions. --- ## PHP Version 3.5.1 **Release Date:** 30-06-2023 #### Issues Fixed - The error "TCP socket accept failed" has been resolved (Windows). - The issue with app-parameter values not being updated in the respective app has been resolved. - The issue with the incorrect curl_exec URL when multiple curl resources are present has been resolved. - Distributed tracing issue has been fixed. - The issue with the agent service not being killed has been resolved (Windows). - The crash during curl request issue has been resolved. - The issue with curl and openSSL version checking during upgrade has been resolved. #### Enhancements - Support for PHP 8.1. - Capture memory allocation is supported. - Capturing command-line arguments is supported. - Capturing multiple exceptions and errors is supported. - Individual configurations for instances in multi-monitor setups are supported. - Support for tracking the original URL if the URL is rewritten. - Support for configuring the Log directory. - Support for ARM architecture. - Support for Redis and Memcache. - Support for enabling and disabling [error tracking](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-enable-or-disable-error-tracking-in-the-php-agent). - Support for enabling and disabling [exception tracking](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-enable-or-disable-exception-tracking-in-the-php-agent). - Support for enabling and disabling [method tracking](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-configure-the-number-of-method-calls-to-be-tracked-in-the-trace-details-in-php-applications). - Support for SQL trace threshold. - You can specify a SQL threshold, and if it is exceeded, a trace will be generated and displayed. - Support for tracking the response code and port number of external calls. - Support for tracking failed components. - Support for capturing CPU time. - Support for capturing background transactions. - Support for configuring the [depth of APM traces](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-configure-the-stack-depth-of-traces-in-php-applications). - Support for capturing HTTP parameters. - Support for capturing Network bytes. - Support for [customizing instrumentation](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-customize-instrumentation-in-php-agent) via ini entry. - Symbolic link for zpa.ini during installation is provided in the agent's installation directory (Linux). - Support for [configuring ports](https://pitstop.manageengine.com/portal/en/kb/articles/how-to-modify-the-apm-insight-php-agent-s-communication-port) via ini and conf entry. - Curl requests without transfer protocol are now treated as HTTP. - The download status is now sent to all monitors in multi-monitor. --- ## PHP Version 3.2.2 **Release Date:** 31-05-2022 #### Issues Fixed - Issues in Windows agent support in PHP v8.0. - Empty function names and negative duration issues. - Component name mismatch issue. #### Enhancements - Support for [multi-monitor configuration](https://www.manageengine.com/products/applications_manager/help/apm-insight-multi-monitor-configuration.html). - Support for adding [custom parameters](https://www.manageengine.com/products/applications_manager/help/apm-insight-php-agent-custom-parameters.html) in a transaction via API. - Support for App Parameters to monitor the size of frequency of an operation or variable. - Support for distributed tracing. - Support for viewing the [complete URL of every transaction](https://pitstop.manageengine.com/portal/en/kb/articles/capturing-complete-url-of-the-transactions-being-performed-on-the-app-server). - Support for tracking request headers. - Support to exclude the HTTP error codes from monitoring to reduce noise in the monitoring environment. - Support for displaying the complete URL in the traces. --- ## PHP Version 3.1.1 **Release Date:** 13-10-2021 #### Issues Fixed - SSL errors in agent communication. - Error in grouping similar transaction. #### Enhancements - Support for Oracle database. - Support for MSSQL database. - Support for Cassandra database. - Support for monitoring applications developed in PHP version 8.0 for Linux. - Support for thread safe PHP versions - ZTS/XAMPP (Version 7.0 and above). - CLI Requests can be tracked with their script names. - Domain names can be tracked in transactions. - Application name & Hostname can be passed as an argument. - [Checksum verification](https://www.manageengine.com/products/applications_manager/help/apm-insight-php-agent-checksum-validation.html) to validate the integrity of the downloaded agent. --- ## PHP Version 2.9.3 **Release Date:** 16-07-2020 #### Issues Fixed - 'Segmentation fault core dumped' issue caused agent to crash while using PHP 7.2. - Memory leak issues. #### Enhancements - Support for PHP version 7.4. - Support for PostgreSQL database instrumentation. - Support for instrumenting 'Mysql_real_connect' type of database connection calls.