﻿---
title: Elastic APM PHP Agent release notes
description: Review the changes, fixes, and more in each version of Elastic APM PHP Agent. To check for security updates, go to Security announcements for the Elastic...
url: https://www.elastic.co/elastic/docs-builder/docs/4622/release-notes/apm/agents/php
products:
  - APM Agent
  - APM PHP Agent
applies_to:
  - Serverless Observability projects: Generally available
  - Elastic Stack: Generally available
  - Application Performance Monitoring Agent for PHP: Generally available
---

# Elastic APM PHP Agent release notes
Review the changes, fixes, and more in each version of Elastic APM PHP Agent.
To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31).

## 1.17.1


### Fixes

- Fix crash (SIGSEGV) at the end of a request on PHP versions containing the "Avoid state corruption via bailout" security fix (for example PHP 8.3.36). PHP objects held by the agent are now released before the PHP executor shutdown [#1510](https://github.com/elastic/apm-agent-php/pull/1510)


## 1.17.0


### Features and enhancements

- Add experimental PHP 8.5 compatibility [#1397](https://github.com/elastic/apm-agent-php/pull/1397)


### Fixes

- bump guzzlehttp/guzzle to fix security vulnerability in tests (non-production) [#1484](https://github.com/elastic/apm-agent-php/pull/1484)


## 1.16.0

**Release date:** March 11, 2026

### Features and enhancements

- Added configuration option to switch error capture from native to PHP [#1415](https://github.com/elastic/apm-agent-php/pull/1415)


## 1.15.1

**Release date:** June 27, 2025

### Fixes

- Cleaned up background sending cURL handle after forking [#1328](https://github.com/elastic/apm-agent-php/pull/1328)


## 1.15.0

**Release date:** January 17, 2025

### Features and enhancements

- Add php 8.4 compatibility #1255
- Added warning log for Xdebug incompatibility [#1256](https://github.com/elastic/apm-agent-php/pull/1256) and [#1257](https://github.com/elastic/apm-agent-php/pull/1257)


## 1.14.1

**Release date:** January 5, 2025

### Fixes

- Fixed calling post hook if instrumented functions throws [#1223](https://github.com/elastic/apm-agent-php/pull/1223)


## 1.14.0

**Release date:** August 28, 2024

### Features and enhancements

- Experimental support for ARM64 architecture


### Fixes

- Fixed issue causing forked process to hang or crash [#1213](https://github.com/elastic/apm-agent-php/pull/1213)


## 1.13.2

**Release date:** August 20, 2024

### Fixes

- FSet various PHP engine hooks only when the relevant feature is enabled [#1211](https://github.com/elastic/apm-agent-php/pull/1211)


## 1.13.1

**Release date:** July 23, 2024

### Features and enhancements

- Fixed memory leak in exception handling [#1174](https://github.com/elastic/apm-agent-php/pull/1174)
- Changed exprerimental part of WordPress instrumentation that is measuring latency impact by plugin to be disabled by default [#1181](https://github.com/elastic/apm-agent-php/pull/1181)


## 1.13.0

**Release date:** January 31, 2024

### Features and enhancements

- Added support for PHP 8.3 [#1127](https://github.com/elastic/apm-agent-php/pull/1127)


### Fixes

- Fixed resetting state for forks [#1125](https://github.com/elastic/apm-agent-php/pull/1125)


## 1.12.0

**Release date:** January 15, 2024

### Features and enhancements

- Removed limitation that required to reinstall the agent after PHP upgrade [#1115](https://github.com/elastic/apm-agent-php/pull/#1115)
- Fixed "malformed UTF-8 characters" issue [#1120](https://github.com/elastic/apm-agent-php/pull/#1120)


## 1.11.0

**Release date:** January 4, 2024

### Features and enhancements

- Debug option to collect diagnostic information from PHP worker process [#1065](https://github.com/elastic/apm-agent-php/pull/#1065)
- Enable background (non-blocking) communication with APM Server for any SAPI by default [#1079](https://github.com/elastic/apm-agent-php/pull/#1079)
- Sending metadata.system.architecture and platform [#1083](https://github.com/elastic/apm-agent-php/pull/#1083)


### Fixes

- Improved packaging script to support other architectures and fixed package naming for x86-64 architecture  [#1067](https://github.com/elastic/apm-agent-php/pull/#1067)
- Fixed exception handling by improving memory allocation and proper exception object copy [#1076](https://github.com/elastic/apm-agent-php/pull/#1076)
- Fixed building of APM server connection string [#1080](https://github.com/elastic/apm-agent-php/pull/#1080)
- Allow using environment variables passed via FastCGI for agent configuration [#1113](https://github.com/elastic/apm-agent-php/pull/#1113)


## 1.10.0

**Release date:** September 12, 2023

### Features and enhancements

- Preview of inferred spans feature. It needs to be enabled manually, please refer to documentation [`profiling_inferred_spans_enabled`](/elastic/docs-builder/docs/4622/reference/apm/agents/php/configuration-reference#config-profiling-inferred-spans-enabled) [#1038](https://github.com/elastic/apm-agent-php/pull/#1038)


### Fixes

- Detection and logging if agent source code doesn’t comply open_basedir limitation [#1044](https://github.com/elastic/apm-agent-php/pull/#1044)


## 1.9.1

**Release date:** July 6, 2023

### Features and enhancements

- Added configuration option: GLOBAL_LABELS [#1007](https://github.com/elastic/apm-agent-php/pull/#1007)
- Introduced new C++ build environment [#985](https://github.com/elastic/apm-agent-php/pull/#985)


### Fixes

- Suppress errors and warnings when internally calling opcache_get_status [#1013](https://github.com/elastic/apm-agent-php/pull/#1013)


## 1.9.0

**Release date:** June 22, 2023

### Features and enhancements

- Added container ID detection [#966](https://github.com/elastic/apm-agent-php/pull/966)
- Extended span compression support to spans without service target [#944](https://github.com/elastic/apm-agent-php/pull/944)
- Added auto-instrumentation for capturing WordPress filters/actions callbacks and the active theme [#948](https://github.com/elastic/apm-agent-php/pull/948)
- Added configuration option STACK_TRACE_LIMIT [#995](https://github.com/elastic/apm-agent-php/pull/995)
- Added SPAN_STACK_TRACE_MIN_DURATION configuration option [#996](https://github.com/elastic/apm-agent-php/pull/996)
- Implemented backoff on failure in communication to APM Server [#999](https://github.com/elastic/apm-agent-php/pull/999)


### Fixes

- Fixed not cleaning up connection data in sync backend comm. mode [#957](https://github.com/elastic/apm-agent-php/pull/957)
- Fixed crash when [`opcache_reset()`](https://www.php.net/manual/en/function.opcache-reset.php) is used [#1000](https://github.com/elastic/apm-agent-php/pull/1000)


## 1.8.4

**Release date:** May 17, 2023

### Fixes

- Fixed deadlock caused by use of pthread_atfork [#964](https://github.com/elastic/apm-agent-php/pull/964)
- Fixed verify_server_cert=false not disabling all the checks related to HTTPS certificate [#965](https://github.com/elastic/apm-agent-php/pull/965)
- Fixed not joining background sender thread if there was fork after module init [#959](https://github.com/elastic/apm-agent-php/pull/959)


## 1.8.3

**Release date:** April 21, 2023

### Fixes

- Fixed issue with missing transaction details on some setups [#916](https://github.com/elastic/apm-agent-php/pull/916)


## 1.8.2

**Release date:** April 12, 2023

### Fixes

- Fixed agent issue causing PHP to crash when opcache preload feature was enabled [#913](https://github.com/elastic/apm-agent-php/pull/913)


## 1.8.1

**Release date:** March 9, 2023

### Fixes

- Fix for the agent causing very high CPU usage because it’s creating frequent connections to Elastic APM Server [#877](https://github.com/elastic/apm-agent-php/pull/877)


## 1.8.0

**Release date:** February 27, 2023

### Features and enhancements

- Added support for PHP 8.2 [#868](https://github.com/elastic/apm-agent-php/pull/868)


## 1.7.2

**Release date:** February 24, 2023

### Fixes

- Fixed: case when process fork happens during request processing [#857](https://github.com/elastic/apm-agent-php/pull/857)


## 1.7.1

**Release date:** January 16, 2023

### Fixes

- Fixed: php apm segfaults on a zend error/php warning [#834](https://github.com/elastic/apm-agent-php/pull/834)


## 1.7.0

**Release date:** October 13, 2022

### Features and enhancements

- Added support for automatically capturing MySQLi: [#688](https://github.com/elastic/apm-agent-php/pull/688)


### Fixes

- Fixed: Inferred spans when used with Laravel: [#796](https://github.com/elastic/apm-agent-php/pull/796)
- Fixed: CustomErrorData not found issue: [#797](https://github.com/elastic/apm-agent-php/pull/797)


## 1.6.2

**Release date:** November 17, 2022

### Features and enhancements

- Backported support for automatically capturing MySQLi: [#688](https://github.com/elastic/apm-agent-php/pull/688)


## 1.6.1

**Release date:** September 12, 2022

### Fixes

- Fixed: Current implementation for Improved Granularity for SQL Databases doesn’t account for SQL USE statement: [#759](https://github.com/elastic/apm-agent-php/pull/759)


## 1.6.0

**Release date:** August 22, 2022

### Features and enhancements

- Added inferred spans to automatically detect slow functions (as an experimental feature disabled by default): [#731](https://github.com/elastic/apm-agent-php/pull/731)
- Improved granularity for SQL databases: [#732](https://github.com/elastic/apm-agent-php/pull/732)
- Implemented default type for transactions and spans: [#733](https://github.com/elastic/apm-agent-php/pull/733)
- Implemented support for Dependencies table: [#748](https://github.com/elastic/apm-agent-php/pull/748)
- Improved transaction name for Laravel’s `artisan` command - now includes the first argument: [#714](https://github.com/elastic/apm-agent-php/pull/714)


## 1.5.2

**Release date:** June 20, 2022

### Fixes

- Fixed bug: Agent destroys error code for curl calls: [#707](https://github.com/elastic/apm-agent-php/pull/707)


## 1.5.1

**Release date:** May 30, 2022

### Fixes

- Fixed bug: Forked process runs indefinitely: [#691](https://github.com/elastic/apm-agent-php/pull/691)


## 1.5.0

**Release date:** March 29, 2022

### Features and enhancements

- Added support for PHP 8.1: [#604](https://github.com/elastic/apm-agent-php/pull/604)


## 1.4.2

**Release date:** February 17, 2022

### Features and enhancements

- Create error events only for PHP error types included in [`error_reporting()`](https://www.php.net/manual/en/function.error-reporting.php): [#625](https://github.com/elastic/apm-agent-php/pull/625)


## 1.4.1

**Release date:** February 14, 2022

### Fixes

- Fixed error events not being created for PHP errors: [#619](https://github.com/elastic/apm-agent-php/pull/619)


## 1.4.0

**Release date:** January 10, 2022

### Features and enhancements

- Background (non-blocking) communication with APM Server: [#584](https://github.com/elastic/apm-agent-php/pull/584)


## 1.3.1

**Release date:** October 18, 2021

### Features and enhancements

- DISABLE_SEND configuration option: [#559](https://github.com/elastic/apm-agent-php/pull/559)
- DISABLE_INSTRUMENTATIONS configuration option: [#565](https://github.com/elastic/apm-agent-php/pull/565)
- DEV_INTERNAL configuration option: [#566](https://github.com/elastic/apm-agent-php/pull/566)


## 1.3.0

**Release date:** September 1, 2021

### Features and enhancements

- SERVICE_NODE_NAME configuration option: [#458](https://github.com/elastic/apm-agent-php/pull/458)
- URL_GROUPS configuration option: [#537](https://github.com/elastic/apm-agent-php/pull/537)


## 1.2.0

**Release date:** June 29, 2021

### Features and enhancements

- Collecting data for `Error rate` chart: [#441](https://github.com/elastic/apm-agent-php/pull/441)
- HOSTNAME configuration option: [#440](https://github.com/elastic/apm-agent-php/pull/440)
- Collecting data for `Time spent by span type` chart: [#436](https://github.com/elastic/apm-agent-php/pull/436)
- `ensureParentId()` API: [#431](https://github.com/elastic/apm-agent-php/pull/431)


### Fixes

- Fixed missing subtype and action for DB spans and DB not showing on `Service Map`: [#443](https://github.com/elastic/apm-agent-php/pull/443)


## 1.1.0

**Release date:** June 1, 2021

### Features and enhancements

- Support for PHP 8.0: [#365](https://github.com/elastic/apm-agent-php/pull/365)
- Support for Central (AKA Remote) Agents Configuration [#134](https://github.com/elastic/apm-agent-php/pull/134)


## 1.0.1

**Release date:** April 1, 2021

### Fixes

- Fixed missing query string: [#390](https://github.com/elastic/apm-agent-php/pull/390)
- Fixed $_SERVER not set when auto_globals_jit = On: [#392](https://github.com/elastic/apm-agent-php/pull/392)


## 1.0.0

**Release date:** March 23, 2021

### Features and enhancements

- Added support for distributed tracing: [#283](https://github.com/elastic/apm-agent-php/pull/283)
- Added Error events: [#282](https://github.com/elastic/apm-agent-php/pull/282)
- Add support for TRANSACTION_MAX_SPANS configuration option : [#260](https://github.com/elastic/apm-agent-php/pull/260)
- Added SERVER_TIMEOUT configuration option: [#245](https://github.com/elastic/apm-agent-php/pull/245)
- Automatically capture stack trace for spans: [#232](https://github.com/elastic/apm-agent-php/pull/232)
- Added VERIFY_SERVER_CERT configuration option: [#225](https://github.com/elastic/apm-agent-php/pull/225)
- Implemented sampling (TRANSACTION_SAMPLE_RATE): [#216](https://github.com/elastic/apm-agent-php/pull/216)


### Fixes

- Small fixes to examples in docs: [#355](https://github.com/elastic/apm-agent-php/pull/355)
- Exclude query string from a transaction name: [#285](https://github.com/elastic/apm-agent-php/pull/285)
- Added check that the corresponding extension is loaded before instrumenting it: [#228](https://github.com/elastic/apm-agent-php/pull/228)