PHPackages                             taildev/php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. taildev/php

ActiveLibrary[Logging & Monitoring](/categories/logging)

taildev/php
===========

PHP integration for tail.dev

v0.6.3(4y ago)01.6k[1 PRs](https://github.com/taildev/php/pulls)1MITPHPCI failing

Since Sep 11Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/taildev/php)[ Packagist](https://packagist.org/packages/taildev/php)[ RSS](/packages/taildev-php/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (9)Versions (31)Used By (1)

[![](icon.svg)](icon.svg) PHP Integration for tail.dev
======================================================

[](#-php-integration-for-taildev)

[![PHP tests](https://github.com/taildev/php/workflows/PHP%20tests/badge.svg)](https://github.com/taildev/php/workflows/PHP%20tests/badge.svg)

[![](php-logo.svg)](php-logo.svg)

For Laravel integration, see [taildev/laravel](https://github.com/taildev/laravel)

Docs
----

[](#docs)

See full documentation at [tail.dev/documentation/php/get-started](https://tail.dev/documentation/php/get-started)

Quickstart
----------

[](#quickstart)

Install the `taildev/php` package using Composer

```
composer require taildev/php
```

Make sure that the composer autoloader is being required somewhere in your project:

```
require __DIR__ . '/vendor/autoload.php';
```

#### APM

[](#apm)

Initialize APM with your [auth token](https://tail.dev/documentation/quickstart) and service name (any name you'd like to identify this service)

```
use Tail\Apm;

Apm::init('secret_token', 'service-name');
Apm::startRequest();

register_shutdown_function(function () {
    Apm::finish();
});
```

Alternatively you can use `startJob($name)` for background jobs, CLI commands, etc. or `startCustom($name)`

To add spans to the transaction

```
$span = Apm::newDatabaseSpan('fetch-config');
// ... code fetching config
$span->finish();
```

Span "types" are used to categorize operations.

```
Apm::newSpan(string $type, string $name); // to use your own custom type
Apm::newCustomSpan($name); // type = "custom"
Apm::newDatabaseSpan($name); // type = "database"
Apm::newCacheSpan($name); // type = "cache"
Apm::newFilesystemSpan($name); // type = "filesystem"
```

#### Logs

[](#logs)

Initialize logging with your [auth token](https://tail.dev/documentation/quickstart). You may optionally provide a service name and environment if you wish

```
use Tail\Log;

Log::init('secret_token', 'optional-service-name', 'optional-environment');
```

You can now use the logger anywhere to log a message

```
use Tail\Log;

Log::get()->debug('my debug message');

Log::get()->alert('something went wrong', ['custom_tag' => 'some-value']);
```

#### More

[](#more)

For full documentation see [tail.dev/documentation/php/get-started](https://tail.dev/documentation/php/get-started)

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance55

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~15 days

Recently: every ~4 days

Total

28

Last Release

1686d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/00ecfc3405548aab669dc6966e8a3a55af93dfb4bfe7095ce318a763a323eeeb?d=identicon)[kylegferg](/maintainers/kylegferg)

---

Top Contributors

[![kyleferguson](https://avatars.githubusercontent.com/u/4224075?v=4)](https://github.com/kyleferguson "kyleferguson (65 commits)")[![TylerButh](https://avatars.githubusercontent.com/u/5452396?v=4)](https://github.com/TylerButh "TylerButh (6 commits)")

---

Tags

laravelloggingmonitoringperformanceerrorsexceptionsapmtracingtail.dev

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/taildev-php/health.svg)

```
[![Health](https://phpackages.com/badges/taildev-php/health.svg)](https://phpackages.com/packages/taildev-php)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k532.1M19.4k](/packages/laravel-framework)[rollbar/rollbar

Monitors errors and exceptions and reports them to Rollbar

33724.4M84](/packages/rollbar-rollbar)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[bugsnag/bugsnag-laravel

Official Bugsnag notifier for Laravel applications.

90335.7M37](/packages/bugsnag-bugsnag-laravel)[laravel/nightwatch

The official Laravel Nightwatch package.

3588.7M31](/packages/laravel-nightwatch)[honeybadger-io/honeybadger-laravel

Honeybadger Laravel integration

431.3M](/packages/honeybadger-io-honeybadger-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)