The OpenTelemetry PHP Library
Go to file
Brett McBride a1f2ba09a8 adding stubs for deptrac
there are some things in our code that deptrac doesn't understand or are missing
for some php versions. stub them to quieten all those violation warnings
2025-07-17 11:55:35 +10:00
.github build base image from debian (#1662) 2025-07-11 07:11:46 -04:00
.phan more fixes 2025-07-17 09:45:08 +10:00
deptrac/stubs adding stubs for deptrac 2025-07-17 11:55:35 +10:00
docker fixing more psalm complaints 2025-07-16 17:02:47 +10:00
docs Remove JaegerExporter and update interface (#908) 2023-01-10 09:25:34 +11:00
examples fixing more psalm complaints 2025-07-16 17:02:47 +10:00
files/collector fix: update references to logging exporter (#1383) 2024-09-22 17:42:55 +10:00
proto/otel generate proto 1.5.0 (#1478) 2025-01-16 10:07:07 +11:00
script adding metrics semconv (#1633) 2025-06-23 22:32:27 -04:00
src more fixes 2025-07-17 09:45:08 +10:00
tests fixing more psalm complaints 2025-07-16 17:02:47 +10:00
var/metrics Add PhpMetrics (#554) 2022-01-23 22:54:13 +01:00
vendor-bin fixing more psalm complaints 2025-07-16 17:02:47 +10:00
.dockerignore interfaces improvements (#36) 2019-12-23 13:07:20 -05:00
.editorconfig Set indent size for all yaml files to 2 (#737) 2022-06-29 20:51:21 -04:00
.env.dist dotenv file plus rector (#983) 2023-05-02 19:53:04 +10:00
.gitattributes chore: .editorconfig, .gitattributes (#207) 2020-11-03 11:11:10 -05:00
.gitignore add phpDocumentor instructions to Makefile (#1385) 2024-09-25 14:39:36 -04:00
.gitsplit.yml File configuration (#1249) 2024-04-01 18:13:01 +11:00
.php-cs-fixer.php remove blank lines after class opening (#1468) 2025-01-07 21:18:52 +11:00
.phpcs.xml TracerFactory implementation (#38) 2020-01-07 08:39:14 -05:00
.scrutinizer.yml add scrutinizer config (#40) 2020-01-07 08:39:25 -05:00
CODEOWNERS Update CODEOWNERS to use the @open-telemetry/php-approvers (#814) 2022-09-07 22:42:09 +10:00
CONTRIBUTING.md Sort contributor listings and remove affiliation from emeriti (#1665) 2025-07-10 09:43:36 +10:00
LICENSE Initial commit 2019-09-27 11:08:24 -07:00
Makefile adding stubs for deptrac 2025-07-17 11:55:35 +10:00
README.md Update development guide to contributing guide (#1513) 2025-02-25 15:59:05 +11:00
code-of-conduct.md Adding Code of Conduct (#123) 2020-06-06 11:24:02 -04:00
codecov.yml updating codecov.yml and README.md (#338) 2021-05-21 13:30:28 -04:00
composer.json fixing psalm complaints 2025-07-16 15:17:44 +10:00
deptrac.baseline.yaml Allows API packages to specify file-based and env-based config (#1621) 2025-06-16 10:24:51 +10:00
deptrac.yaml adding stubs for deptrac 2025-07-17 11:55:35 +10:00
docker-compose.collector.yaml Update docker compose default php version to 8.1 (#1259) 2024-03-16 10:50:25 +11:00
docker-compose.fiber-ffi.yaml Add FFI Fiber support preload example (#524) 2021-12-25 10:47:56 -05:00
docker-compose.phpDocumentor.yaml add phpDocumentor instructions to Makefile (#1385) 2024-09-25 14:39:36 -04:00
docker-compose.prometheus.yaml Drop PHP 7.4 support (#1244) 2024-03-03 20:21:16 -05:00
docker-compose.w3cTraceContext.yaml Update docker compose default php version to 8.1 (#1259) 2024-03-16 10:50:25 +11:00
docker-compose.yaml fixing warnings from local build (#1277) 2024-04-19 09:04:57 +10:00
infection.json5 Add infection test tool (#1306) 2024-05-15 20:46:42 +10:00
phpbench.json.dist benchmark (#486) 2021-11-23 21:50:22 -05:00
phpdoc.dist.xml add phpDocumentor instructions to Makefile (#1385) 2024-09-25 14:39:36 -04:00
phpmetrics.json removing jaeger exporters (#890) 2022-12-09 14:25:42 +11:00
phpstan.neon.dist fixing psalm+phpstan protobuf complaints (#1636) 2025-06-16 21:11:54 +10:00
phpunit.xml.dist Add infection test tool (#1306) 2024-05-15 20:46:42 +10:00
psalm.xml.dist more fixes 2025-07-17 09:45:08 +10:00
rector.php fixing psalm complaints 2025-07-16 15:17:44 +10:00

README.md

OpenTelemetry for PHP

CI Build codecov Slack

This is the monorepo for the main components of OpenTelemetry for PHP.

Documentation

Please read the official documentation: https://opentelemetry.io/docs/instrumentation/php/

API Documentation is available here: https://open-telemetry.github.io/opentelemetry-php/

Packages and versions

Package Latest
API Latest Stable Version Latest Unstable Version
SDK Latest Stable Version Latest Unstable Version
Context Latest Stable Version Latest Unstable Version
Semantic Conventions Latest Stable Version Latest Unstable Version
OTLP Exporter Latest Stable Version Latest Unstable Version
gRPC Transport Latest Stable Version Latest Unstable Version
OTLP Protobuf Files Latest Stable Version Latest Unstable Version
B3 Propagator Latest Stable Version Latest Unstable Version

Releases for both this repository and contrib are based on read-only git subtree splits from our monorepo. You should refer to packagist.org for all packages, their versions and details.

You can also look at the read-only repositories, which live in the opentelemetry-php organization.

Contributing

GitHub repo Good Issues for newbies GitHub Help Wanted issues GitHub Help Wanted PRs GitHub repo Issues

We would love to have you on board, please see our Contributing README

Specification conformance

We attempt to keep the OpenTelemetry Specification Matrix up to date in order to show which features are available and which have not yet been implemented.

If you find an inconsistency in the data in the matrix, please let us know in our slack channel and we'll get it rectified.

Backwards compatibility

See compatibility readme.

Versioning

OpenTelemetry for PHP aims to support all officially supported PHP versions according to https://www.php.net/supported-versions.php, and support will be dropped for PHP versions within 12 months of that version going End of life.

Versioning rationale can be found in the Versioning Documentation