PHPackages google/cloud-debugger - 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. [Debugging & Profiling](/categories/debugging) 4. / 5. google/cloud-debugger AbandonedArchivedLibrary[Debugging & Profiling](/categories/debugging) google/cloud-debugger ===================== Stackdriver Debugger Client for PHP v1.9.5(1y ago)672.5k↑166.7%3Apache-2.0PHPPHP ^8.0CI passing Since Dec 29Pushed 1y ago51 watchersCompare [ Source](https://github.com/googleapis/google-cloud-php-debugger)[ Packagist](https://packagist.org/packages/google/cloud-debugger)[ RSS](/packages/google-cloud-debugger/feed)WikiDiscussions main Synced 2w ago READMEChangelog (10)Dependencies (13)Versions (92)Used By (0) Google PHP Stackdriver Debugger =============================== [](#google-php-stackdriver-debugger) > Idiomatic PHP client for [Stackdriver Debugger](https://cloud.google.com/debugger/). [![Latest Stable Version](https://camo.githubusercontent.com/5426b09aba358f0d7c1492d70773db70056591b13605f9ee659b456b3543ea71/68747470733a2f2f706f7365722e707567782e6f72672f676f6f676c652f636c6f75642d64656275676765722f762f737461626c65)](https://packagist.org/packages/google/cloud-debugger) [![Packagist](https://camo.githubusercontent.com/d7ef26fc2ef47fcd43aded1b492ca9241139f9f197dad1384ac27b336dff396b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f676f6f676c652f636c6f75642d64656275676765722e737667)](https://packagist.org/packages/google/cloud-debugger) - [API documentation](https://cloud.google.com/php/docs/reference/cloud-debugger/latest) **IMPORTANT**: This library has been deprecated. See [Cloud Debugger Deprecation](https://cloud.google.com/stackdriver/docs/deprecations/debugger-deprecation) **NOTE:** This repository is part of [Google Cloud PHP](https://github.com/googleapis/google-cloud-php). Any support requests, bug reports, or development contributions should be directed to that project. A feature of Google Cloud Platform that lets you inspect the state of an application, at any code location, without stopping or slowing down the running app. Stackdriver Debugger makes it easier to view the application state without adding logging statements. ### Installation [](#installation) 1. Install the PHP extension from PECL. ``` $ pecl install stackdriver_debugger-alpha ``` On Windows, you can download pre-built .dll files [from PECL](https://pecl.php.net/package/stackdriver_debugger). You may also need to enable the extension in your `php.ini` file: ``` # on Unix extension=stackdriver_debugger.so # on Windows extension=php_stackdriver_debugger.dll ``` 2. Install with `composer` or add to your `composer.json`. ``` $ composer require google/cloud-debugger ``` 3. Run the batch daemon script in the background. On Unix-based systems that have [semaphore extensions](http://php.net/manual/en/book.sem.php) installed, run the [BatchDaemon](https://github.com/googleapis/google-cloud-php/blob/main/Core/src/Batch/BatchDaemon.php): ``` $ vendor/bin/google-cloud-batch daemon ``` On Windows or systems that do not have [semaphore extensions](http://php.net/manual/en/book.sem.php) installed, run the Debugger [Daemon](https://cloud.google.com/php/docs/reference/debugger/latest/Daemon): ``` $ vendor/bin/google-cloud-debugger -s ``` The `SOURCE_ROOT` is the base location of your deployed application. Alternatively, you can provide a configuration script: ``` $ vendor/bin/google-cloud-debugger -c ``` 4. Include and start the debugger `Agent` as the first action in your application: ``` $agent = new Google\Cloud\Debugger\Agent(); ``` If this file is not in your source root, you will need to provide the path to your application's source root as an optional parameter: ``` $agent = new Google\Cloud\Debugger\Agent([ 'sourceRoot' => '/path/to/source/root' ]); ``` This component supports both REST over HTTP/1.1 and gRPC. In order to take advantage of the benefits offered by gRPC (such as streaming methods) please see our [gRPC installation guide](https://cloud.google.com/php/grpc). ### Authentication [](#authentication) Please see our [Authentication guide](https://github.com/googleapis/google-cloud-php/blob/main/AUTHENTICATION.md) for more information on authenticating your client. Once authenticated, you'll be ready to start making requests. ### Sample [](#sample) ``` use Google\Cloud\Debugger\DebuggerClient; $debugger = new DebuggerClient(); $debuggee = $debugger->debugee(); $debuggee->register(); ``` ### Configuration [](#configuration) #### Snapshots [](#snapshots) Debugger snapshots allow you to capture and inspect the call stack and local variables in your application without stopping or slowing it down. In general, you will set breakpoints via the Stackdriver Debugger UI in the [Cloud Platform Console](https://console.cloud.google.com/debug). See [Using Debug Snapshots](https://cloud.google.com/debugger/docs/debugging) for more information on snapshots. #### Logpoints [](#logpoints) Debugger logpoints allow you to inject logging into running services without restarting or interfering with the normal function of the service. This can be useful for debugging production issues without having to add log statements and redeploy. By default, we will send all log messages to Stackdriver Logging, but you can customize this by providing any PSR-3 compatible logger. For example, to use `monolog`: ``` $agent = new Google\Cloud\Debugger\Agent([ 'logger' => new Monolog\Logger('name') ]); ``` See [Using Debug Logpoints](https://cloud.google.com/debugger/docs/logpoints) for more information on logpoints. ### Debugging [](#debugging) Please see our [Debugging guide](https://github.com/googleapis/google-cloud-php/blob/main/DEBUG.md)for more information about the debugging tools. ### Version [](#version) This component is considered GA (generally available). As such, it will not introduce backwards-incompatible changes in any minor or patch releases. We will address issues and requests with the highest priority. ### Next Steps [](#next-steps) 1. Understand the [official documentation](https://cloud.google.com/debugger/docs/). 2. Take a look at [in-depth usage samples](https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/debugger). ### Health Score 50 — FairBetter than 95% of packages Maintenance41 Moderate activity, may be stable Popularity35 Limited adoption so far Community28 Small or concentrated contributor base Maturity84 Battle-tested with a long release history Bus Factor3 3 contributors hold 50%+ of commits 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 ~28 days Total 91 Last Release 489d ago Major Versions v0.21.2 → v1.0.02020-04-07 PHP version history (2 changes)v1.4.15PHP >=7.4 v1.8.4PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/a8713415b20b4be4cec8f8b22741e3cd05f76eee9e38de1de5bf32727349b7c5?d=identicon)[bshaffer](/maintainers/bshaffer) ![](https://www.gravatar.com/avatar/3901206952845568d7557a60855b097f6d1bafaa7a24020cfcf5bb8de74f9d28?d=identicon)[google-cloud](/maintainers/google-cloud) --- Top Contributors [![release-please[bot]](https://avatars.githubusercontent.com/in/40688?v=4)](https://github.com/release-please[bot] "release-please[bot] (44 commits)")[![jdpedrie](https://avatars.githubusercontent.com/u/89034?v=4)](https://github.com/jdpedrie "jdpedrie (42 commits)")[![yoshi-automation](https://avatars.githubusercontent.com/u/44816363?v=4)](https://github.com/yoshi-automation "yoshi-automation (32 commits)")[![bshaffer](https://avatars.githubusercontent.com/u/103941?v=4)](https://github.com/bshaffer "bshaffer (30 commits)")[![dwsupplee](https://avatars.githubusercontent.com/u/2079879?v=4)](https://github.com/dwsupplee "dwsupplee (23 commits)")[![gcf-owl-bot[bot]](https://avatars.githubusercontent.com/in/99011?v=4)](https://github.com/gcf-owl-bot[bot] "gcf-owl-bot[bot] (17 commits)")[![chingor13](https://avatars.githubusercontent.com/u/32483?v=4)](https://github.com/chingor13 "chingor13 (10 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (9 commits)")[![michaelbausor](https://avatars.githubusercontent.com/u/14846209?v=4)](https://github.com/michaelbausor "michaelbausor (6 commits)")[![dpebot](https://avatars.githubusercontent.com/u/19979279?v=4)](https://github.com/dpebot "dpebot (4 commits)")[![vishwarajanand](https://avatars.githubusercontent.com/u/7369612?v=4)](https://github.com/vishwarajanand "vishwarajanand (4 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")[![carlos-granados](https://avatars.githubusercontent.com/u/1383106?v=4)](https://github.com/carlos-granados "carlos-granados (2 commits)")[![jeromegamez](https://avatars.githubusercontent.com/u/67554?v=4)](https://github.com/jeromegamez "jeromegamez (2 commits)")[![WeiranFang](https://avatars.githubusercontent.com/u/8175562?v=4)](https://github.com/WeiranFang "WeiranFang (2 commits)")[![Hectorhammett](https://avatars.githubusercontent.com/u/9062626?v=4)](https://github.com/Hectorhammett "Hectorhammett (1 commits)")[![danielgsims](https://avatars.githubusercontent.com/u/695933?v=4)](https://github.com/danielgsims "danielgsims (1 commits)")[![emmanuel-ferdman](https://avatars.githubusercontent.com/u/35470921?v=4)](https://github.com/emmanuel-ferdman "emmanuel-ferdman (1 commits)")[![gabidavila](https://avatars.githubusercontent.com/u/340055?v=4)](https://github.com/gabidavila "gabidavila (1 commits)")[![ajupazhamayil](https://avatars.githubusercontent.com/u/14087896?v=4)](https://github.com/ajupazhamayil "ajupazhamayil (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/google-cloud-debugger/health.svg) ``` [![Health](https://phpackages.com/badges/google-cloud-debugger/health.svg)](https://phpackages.com/packages/google-cloud-debugger) ``` ### Alternatives [symfony/error-handler Provides tools to manage errors and ease debugging PHP code 2.7k682.0M762](/packages/symfony-error-handler)[php-debugbar/php-debugbar Debug bar in the browser for php application 4.4k26.7M61](/packages/php-debugbar-php-debugbar)[matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.6k38.2k](/packages/matomo-matomo)[google/cloud-translate Cloud Translation Client for PHP 20316.9M100](/packages/google-cloud-translate)[tempest/framework The PHP framework that gets out of your way. 2.2k31.1k12](/packages/tempest-framework)[google/cloud-pubsub Cloud PubSub Client for PHP 9018.2M72](/packages/google-cloud-pubsub) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)