PHPackages petershaw/told-client - 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. petershaw/told-client ActiveLibrary[Logging & Monitoring](/categories/logging) petershaw/told-client ===================== A client to log messages to the told server. 0.0.4(12y ago)0374PHP Since Oct 17Pushed 12y ago1 watchersCompare [ Source](https://github.com/petershaw/told-php-client)[ Packagist](https://packagist.org/packages/petershaw/told-client)[ RSS](/packages/petershaw-told-client/feed)WikiDiscussions master Synced 3d ago READMEChangelog (4)DependenciesVersions (4)Used By (0) told-php-client =============== [](#told-php-client) [![Build Status](https://camo.githubusercontent.com/be10b3cc75c2018797fa33ee5c03716d27b8f8f8a29007e2227b9bdb51bce123/68747470733a2f2f7472617669732d63692e6f72672f7065746572736861772f746f6c642d7068702d636c69656e742e706e67)](https://travis-ci.org/petershaw/told-php-client)[![Latest Stable Version](https://camo.githubusercontent.com/46a89a61519dc87117eb8877ab303a221168f0ac38c7ebc1e428b0d5e8a8a852/68747470733a2f2f706f7365722e707567782e6f72672f7065746572736861772f746f6c642d636c69656e742f762f737461626c652e706e67)](https://packagist.org/packages/petershaw/told-client) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [](#) A client to log messates into a told log recorder. See to lern more about told. Description ----------- [](#description) Sends a message to the server. Noting more, nothing less. Installation ------------ [](#installation) \###Composer ### The easiest way is to use [Composer](http://getcomposer.org). Add ``` "require": { petershaw/told-client } ``` to your composer.json file and run composer install on your project. ### Downlaod [](#downlaod) As an alternative to composer, it is possible to download the latest and greatest version of [ToldClient.php](https://github.com/petershaw/told-php-client/blob/master/src/petershaw/told/ToldClient.php) from github. and require it from within your script. ``` require('/path/to/your/downloaded//libs/ToldClient.php'); ``` Usage ----- [](#usage) \###Configuration### First of all you have to initiate the Client with a few minimal configurations. It is up to you how you set them. It is possible to pass an config array to the init method of the client, or to initiate the client blank and set the config-params later on. #### Example 1: [](#example-1) ``` $conf = Array(); $conf['host'] = "test://told.my-domain.com"; $conf['type'] = "Application Name"; $told = new ToldClient($config); ``` #### Example 2: [](#example-2) ``` $told = new ToldClient(); $told->setHost("test://told.my-domain.com"); $told->setType("Application Name"); ``` The 'host' parameter is **mandatory**.! Optional parameters are: type, tags, defaulttage and debug. tagDescriptiontypeDescribes the type of this log message. Choose the type wisely, because you will group by type at the administration frontend.tagsThese tags will be send ALWAYS right next to the tags that are send by the call it self. It is a good decision to add your application-id and maybe customer-id as tags.defaultagsTo set some default tags that will be overwritten by the call . If no tags are given, than the defaulttags take place.### Send [](#send) After initialisation the client is ready to use. To send a message with the default tags and type, just call ``` $told->tell("This is my little test message"); ``` Each call can have special types and tags. For example: to send a message with a type of 'Testing' and the Tag 'Honigkuchen' call ``` $told->tell("This is my little test message", "Testing", "Honigkuchen"); ``` Or to send multiple tags, like Honigkuchen and Zuckerschlecken it is possible to pass a array: ``` $told->tell("This is my little test message", "Testing", Array("Honigkuchen", "Zuckerschlecken")); ``` Protokoll --------- [](#protokoll) As default, this client use http POST over tcp ip. Limitations ----------- [](#limitations) The current [Told-LogRecorder](https://github.com/petershaw/told-LogRecorder) supports structured messages in schema less format. This feature is not supported by this client, yet. ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~16 days Total 3 Last Release 4559d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f4778cbf206271c84adca9c8f29e4f751ea96ea1a88279a9ed00987e02eb2aa1?d=identicon)[petershaw](/maintainers/petershaw) --- Top Contributors [![petershaw](https://avatars.githubusercontent.com/u/475595?v=4)](https://github.com/petershaw "petershaw (3 commits)") ### Embed Badge ![Health badge](/badges/petershaw-told-client/health.svg) ``` [![Health](https://phpackages.com/badges/petershaw-told-client/health.svg)](https://phpackages.com/packages/petershaw-told-client) ``` ### Alternatives [psr/log Common interface for logging libraries 10.4k1.2B9.2k](/packages/psr-log)[itsgoingd/clockwork php dev tools in your browser 5.9k27.6M94](/packages/itsgoingd-clockwork)[graylog2/gelf-php A php implementation to send log-messages to a GELF compatible backend like Graylog2. 41838.2M138](/packages/graylog2-gelf-php)[bugsnag/bugsnag-psr-logger Official Bugsnag PHP PSR Logger. 32132.5M2](/packages/bugsnag-bugsnag-psr-logger)[consolidation/log Improved Psr-3 / Psr\\Log logger based on Symfony Console components. 15462.2M7](/packages/consolidation-log)[datadog/php-datadogstatsd An extremely simple PHP datadogstatsd client 19124.6M15](/packages/datadog-php-datadogstatsd) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)