PHP agent release notes | New Relic Documentation

December 15, 2025

PHP agent v12.3.0.28

뉴렐릭 PHP 에이전트 v12.3.0.28

새로운 기능

AWS-sdk-php Kinesis Data Streams 측정, 리소스 추가됨

보안

Go 언어 버전을 1.25.5로 업데이트합니다.

버그 수정

데몬이 재시작 시 패키지 캐시를 지우지 않던 문제를 수정했습니다.

지원 성명

향후 릴리스에서는 모범 사례와 보안을 위해 RPM 서명 키가 순환됩니다. 해당 릴리스에 가까워지면 구체적인 날짜와 RPM 사용자를 위한 필요한 조치가 제공될 것입니다.
2026년 2월 28일 이후 모든 PHP 에이전트 릴리스에서 다음 라이브러리 및 프레임워크 버전에 대한 PHP 에이전트 지원이 중단됩니다.
- 다음 라이브러리 & 프레임워크 버전의 경우 뉴렐릭은 지원되는 최신 버전으로 업그레이드할 것을 권장합니다.
  - Symfony 4.x
  - 라라벨 7.x, 9.x, 10.x
  - Slim 3.x
- 다음 라이브러리 및 프레임워크에 대한 지원이 모든 버전에서 중단됩니다.
  - 미디어위키
  - 젠드 프레임워크
  - 루멘
뉴렐릭은 에이전트를 정기적으로, 그리고 최소 3개월마다 업그레이드할 것을 권장합니다. 지원되는 에이전트 버전 및 EOL 타임라인에 대한 자세한 내용은 뉴렐릭 PHP 에이전트 EOL 정책 을 확인하세요.
지원되는 PHP 버전 및 플랫폼에 대한 최신 정보는 PHP 에이전트 호환성 및 요구 사항 페이지를 참조하세요.

중요

지원되지 않는 PHP 버전이나 플랫폼을 사용하여 설치하는 경우, PHP 에이전트 패키지의 자동 업데이트 메커니즘을 비활성화하는 것이 좋습니다. 패키지 업그레이드를 위한 제외 목록에 PHP 에이전트 패키지를 추가하면 됩니다. 또는 PHP 에이전트 패키지를 오래되고 지원되지 않는 기능을 지원하는 에이전트 버전으로 고정할 수도 있습니다. 업그레이드를 막지 못하면 최신 에이전트 릴리스가 설치되고 필수이지만 지원되지 않는 기능에 대한 지원이 중단될 수 있습니다. 이로 인해 APM 데이터 수집이 중단됩니다.

영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.

newrelic-php5
newrelic-php5-common
newrelic 데몬

November 19, 2025

PHP agent v12.2.0.27

뉴렐릭 PHP 에이전트 v12.2.0.27

새로운 기능

라라벨 12 검증 및 지원됨.
라라벨 Horizon은 이제 라라벨 10.x 이상 및 PHP 8.1 이상에서 지원됩니다.

보안

#1129 - Bump golang 버전 1.25.3 - #1130

버그 수정

fix(agent): 라라벨 대기열 작업 예외 처리 수정 - #1122

지원 성명

향후 릴리스에서는 모범 사례와 보안을 위해 RPM 서명 키가 순환됩니다. 해당 릴리스에 가까워지면 구체적인 날짜와 RPM 사용자를 위한 필요한 조치가 제공될 것입니다.
이전에 발표된 바와 같이, 다음 라이브러리/프레임워크 버전에 대한 PHP 에이전트 지원은 2025년 9월 30일부로 공식적으로 종료되었습니다.
- 워드프레스 5.9
- 드루팔 8.x
- 라라벨 6.x, 8.x
- PHPUnit(모든 버전)
2026년 2월 28일 이후 모든 PHP 에이전트 릴리스에서 다음 라이브러리 및 프레임워크 버전에 대한 PHP 에이전트 지원이 중단됩니다.
- 다음 라이브러리 & 프레임워크 버전의 경우 뉴렐릭은 지원되는 최신 버전으로 업그레이드할 것을 권장합니다.
  - Symfony 4.x
  - 라라벨 7.x, 9.x, 10.x
  - Slim 3.x
- 다음 라이브러리 및 프레임워크에 대한 지원이 모든 버전에서 중단됩니다.
  - 미디어위키
  - 젠드 프레임워크
  - 루멘
뉴렐릭은 에이전트를 정기적으로, 그리고 최소 3개월마다 업그레이드할 것을 권장합니다. 지원되는 에이전트 버전 및 EOL 타임라인에 대한 자세한 내용은 뉴렐릭 PHP 에이전트 EOL 정책 을 확인하세요.
지원되는 PHP 버전 및 플랫폼에 대한 최신 정보는 PHP 에이전트 호환성 및 요구 사항 페이지를 참조하세요.

중요

영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.

newrelic-php5
newrelic-php5-common
newrelic 데몬

September 9, 2025

PHP agent v12.1.0.26

뉴렐릭 PHP 에이전트 v12.1.0.26

새로운 기능

업스트림 w3c 트레이스 전혀 결정에 따라 샘플링 제어를 추가합니다 - #1104
- 여기에서새로운 ini 값을 확인하세요
측정을 건너뛰기 위한 설정 옵션 추가, 프레임워크 예외 처리기의 구현 - #1113
- 여기에서새로운 ini 값을 확인하세요

보안

Golang 버전을 1.25.1로 올립니다.

버그 수정

newrelic_end_transaction(true) 호출 시 잠재적인 memleak 문제 해결 - #1072
녹음하지 않을 때는 측정을 시도하지 마세요. - #1112

지지 성명

다음 라이브러리/프레임워크 버전에 대한 PHP 에이전트 지원은 2025년 9월 30일에 종료됩니다.
- 워드프레스 5.9
- 드루팔 8.x
- 라라벨 6.x, 8.x
- PHPUnit 8.x
뉴렐릭은 에이전트를 정기적으로, 그리고 최소 3개월마다 업그레이드할 것을 권장합니다. 지원되는 에이전트 버전 및 EOL 타임라인에 대한 자세한 내용은 뉴렐릭 PHP 에이전트 EOL 정책 을 확인하세요.
지원되는 PHP 버전 및 플랫폼에 대한 최신 정보는 PHP 에이전트 호환성 및 요구 사항 페이지를 참조하세요.

중요

영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.

newrelic-php5
newrelic-php5-common
newrelic 데몬

August 11, 2025

PHP agent v12.0.0.25

뉴렐릭 PHP 에이전트 v12.0.0.25

버그 수정

Drupal Hook Map 오류 로깅을 개선합니다.
시큐리티 RX 의 구형 패키지 감지 문제를 수정합니다.

알아채다

이 릴리스에서는 `newrelic.code_level_metrics.enabled` INI의 기본값이 변경되었습니다.

이전에 알려드린 대로, 이번 릴리스 에서는 IDE 설정의 기본 코드 레벨 메트릭 옵저버빌리티가 활성화에서 비활성화로 변경됩니다. 코드 레벨 지표를 사용하지 않으면 아무런 영향도 보이지 않으며 아무런 조치를 취할 필요가 없습니다. 코드 레벨 지표를 사용하는 경우 newrelic.ini 설정 파일의 newrelic.code_level_metrics.enabled INI 설정이 주석 처리되지 않고 true로 설정되어 있는지 확인하세요. 예를 들어:

newrelic.code_level_metrics.enabled = true

이 변경 사항은 기본 설정 값에만 영향을 미칩니다. 수동으로 설정한 구성 값은 그대로 유지되며, CLM의 핵심 동작에는 영향을 미치지 않습니다.

지지 성명

이전에 전달한 대로, PHP 에이전트에서 더 이상 지원되지 않던 다음 프레임워크/라이브러리는 이번 릴리스에서 제거됩니다.
- Guzzle 3.x
- 코하나
- 실렉스
- 심포니 1.x-3.x
- 젠드 1.x-2.x
다음 라이브러리/프레임워크 버전에 대한 PHP 에이전트 지원은 2025년 9월 30일에 종료됩니다.
- 워드프레스 5.9
- 드루팔 8.x
- 라라벨 6.x, 8.x
- PHPUnit 8.x
뉴렐릭은 에이전트를 정기적으로, 그리고 최소 3개월마다 업그레이드할 것을 권장합니다. 지원되는 에이전트 버전 및 EOL 타임라인에 대한 자세한 내용은 뉴렐릭 PHP 에이전트 EOL 정책 을 확인하세요.
지원되는 PHP 버전 및 플랫폼에 대한 최신 정보는 PHP 에이전트 호환성 및 요구 사항 페이지를 참조하세요.

중요

영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.

newrelic-php5
newrelic-php5-common
newrelic 데몬

June 25, 2025

PHP agent v11.10.0.24

뉴렐릭 PHP 에이전트 v11.10.0.24

새로운 기능

시큐리티 RX: Composer 런타임 API 기본적으로 PHP구성 #1055에서 사용되는 패키지를 감지하는 데 사용됩니다.

보안 업데이트

#1089 - security(데몬): golang을 1.24.4로 업그레이드하세요. #1090
#973 - 보안: http://apt.newrelic.com/debian/ 의 서명을 확인하는 데 사용되는 뉴렐릭의 공개 키 회전 APT 저장소. 자세한 내용은 여기를 참조하세요.

버그 수정

fix(에이전트): Composer 런타임 API 사용할 때 정의되지 않은 동작을 수정합니다 . #1086

알아채다

다음 릴리스에서 `newrelic.code_level_metrics.enabled` INI 변경 사항에 대한 기본값

기본 앱 레벨 지표 설정은 향후 릴리스에서 활성화에서 비활성화로 변경됩니다. 코드 레벨 지표를 사용하지 않으면 아무런 영향도 보이지 않으며 아무런 조치를 취할 필요가 없습니다. 코드 레벨 지표를 사용하는 경우 newrelic.ini 설정 파일에 주석 처리되지 않은 newrelic.code_level_metrics.enabled INI 설정이 있고 true로 설정되어 있는지 확인하세요. 예를 들어:

newrelic.code_level_metrics.enabled = true

이 변경 사항은 기본 설정 값에만 영향을 미칩니다. 수동으로 설정한 구성 값은 그대로 유지되며, CLM의 핵심 동작에는 영향을 미치지 않습니다.

지지 성명

다음 프레임워크/라이브러리는 PHP 에이전트에서 더 이상 지원되지 않으며, 다음 릴리스에서는 제거됩니다.
- Guzzle 3.x
- 코하나
- 실렉스
- 심포니 1.x-3.x
- 젠드 1.x-2.x
다음 라이브러리/프레임워크 버전에 대한 PHP 에이전트 지원은 2025년 9월 30일에 종료됩니다.
- 워드프레스 5.9
- 드루팔 8.x
- 라라벨 6.x, 8.x
- PHPUnit 8.x
뉴렐릭은 에이전트를 정기적으로, 그리고 최소 3개월마다 업그레이드할 것을 권장합니다. 지원되는 에이전트 버전 및 EOL 타임라인에 대한 자세한 내용은 뉴렐릭 PHP 에이전트 EOL 정책 을 확인하세요.
지원되는 PHP 버전 및 플랫폼에 대한 최신 정보는 PHP 에이전트 호환성 및 요구 사항 페이지를 참조하세요.

중요

영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.

newrelic-php5
newrelic-php5-common
newrelic 데몬

뉴렐릭 PHP 에이전트 v12.3.0.28.css-21sua1{background:none;border:none;width:0;padding:0;}

새로운 기능

보안

버그 수정

지원 성명

중요

뉴렐릭 PHP 에이전트 v12.2.0.27

새로운 기능

보안

버그 수정

지원 성명

중요

뉴렐릭 PHP 에이전트 v12.1.0.26

새로운 기능

보안

버그 수정

지지 성명

중요

뉴렐릭 PHP 에이전트 v12.0.0.25

버그 수정

알아채다

이 릴리스에서는 newrelic.code_level_metrics.enabled INI의 기본값이 변경되었습니다.

지지 성명

중요

뉴렐릭 PHP 에이전트 v11.10.0.24

새로운 기능

보안 업데이트

버그 수정

알아채다

다음 릴리스에서 newrelic.code_level_metrics.enabled INI 변경 사항에 대한 기본값

지지 성명

중요

뉴렐릭 PHP 에이전트 v12.3.0.28

이 릴리스에서는 `newrelic.code_level_metrics.enabled` INI의 기본값이 변경되었습니다.

다음 릴리스에서 `newrelic.code_level_metrics.enabled` INI 변경 사항에 대한 기본값