{"id":20540561,"url":"https://github.com/utopia-php/logger","last_synced_at":"2026-05-05T08:01:02.768Z","repository":{"id":43064115,"uuid":"426167594","full_name":"utopia-php/logger","owner":"utopia-php","description":"Lite \u0026 fast micro PHP logging library that is **easy to use**.","archived":false,"fork":false,"pushed_at":"2026-02-22T09:40:33.000Z","size":191,"stargazers_count":11,"open_issues_count":12,"forks_count":18,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-02-22T15:31:10.934Z","etag":null,"topics":["hacktoberfest","php","utopia","utopia-php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/utopia-php.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-11-09T09:31:27.000Z","updated_at":"2026-01-23T04:31:33.000Z","dependencies_parsed_at":"2023-10-16T18:33:31.038Z","dependency_job_id":"28f8c4e6-2ae3-4c8b-a4da-90a48c5cacc2","html_url":"https://github.com/utopia-php/logger","commit_stats":{"total_commits":62,"total_committers":10,"mean_commits":6.2,"dds":0.4032258064516129,"last_synced_commit":"bfc5eb48df908898329198addf328f75f04fd018"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/utopia-php/logger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utopia-php%2Flogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utopia-php%2Flogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utopia-php%2Flogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utopia-php%2Flogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/utopia-php","download_url":"https://codeload.github.com/utopia-php/logger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/utopia-php%2Flogger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32640538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"online","status_checked_at":"2026-05-05T02:00:06.033Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","php","utopia","utopia-php"],"created_at":"2024-11-16T01:16:13.535Z","updated_at":"2026-05-05T08:01:02.751Z","avatar_url":"https://github.com/utopia-php.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Utopia Logger\n\n[![Build Status](https://app.travis-ci.com/utopia-php/logger.svg?branch=main)](https://app.travis-ci.com/github/utopia-php/logger)\n![Total Downloads](https://img.shields.io/packagist/dt/utopia-php/logger.svg)\n[![Discord](https://img.shields.io/discord/564160730845151244)](https://appwrite.io/discord)\n\nUtopia Logger library is simple and lite library for logging information, such as errors or warnings. This library aims to be as simple and easy to learn and use as possible. This library is maintained by the [Appwrite team](https://appwrite.io).\n\nAlthough the library was built for the [Utopia Framework](https://github.com/utopia-php/framework) project, it is completely independent, **dependency-free** and can be used with any other PHP project or framework.\n\n## Getting Started\n\nInstall using composer:\n```bash\ncomposer require utopia-php/logger\n```\n\n```php\n\u003c?php\n\nrequire_once '../vendor/autoload.php';\n\nuse Utopia\\Logger\\Adapter\\AppSignal;\nuse Utopia\\Logger\\Adapter\\Raygun;\nuse Utopia\\Logger\\Adapter\\Sentry;\nuse Utopia\\Logger\\Adapter\\LogOwl;\nuse Utopia\\Logger\\Log;\nuse Utopia\\Logger\\Log\\Breadcrumb;\nuse Utopia\\Logger\\Log\\User;\nuse Utopia\\Logger\\Logger;\n\n// Prepare log\n$log = new Log();\n$log-\u003esetAction(\"controller.database.deleteDocument\");\n$log-\u003esetEnvironment(\"production\");\n$log-\u003esetNamespace(\"api\");\n$log-\u003esetServer(\"digitalocean-us-001\");\n$log-\u003esetType(Log::TYPE_WARNING);\n$log-\u003esetVersion(\"0.11.5\");\n$log-\u003esetMessage(\"Document efgh5678 not found\");\n$log-\u003esetUser(new User(\"efgh5678\"));\n$log-\u003eaddBreadcrumb(new Breadcrumb(Log::TYPE_DEBUG, \"http\", \"DELETE /api/v1/database/abcd1234/efgh5678\", \\microtime(true) - 500));\n$log-\u003eaddBreadcrumb(new Breadcrumb(Log::TYPE_DEBUG, \"auth\", \"Using API key\", \\microtime(true) - 400));\n$log-\u003eaddBreadcrumb(new Breadcrumb(Log::TYPE_INFO, \"auth\", \"Authenticated with * Using API Key\", \\microtime(true) - 350));\n$log-\u003eaddBreadcrumb(new Breadcrumb(Log::TYPE_INFO, \"database\", \"Found collection abcd1234\", \\microtime(true) - 300));\n$log-\u003eaddBreadcrumb(new Breadcrumb(Log::TYPE_DEBUG, \"database\", \"Permission for collection abcd1234 met\", \\microtime(true) - 200));\n$log-\u003eaddBreadcrumb(new Breadcrumb(Log::TYPE_ERROR, \"database\", \"Missing document when searching by ID!\", \\microtime(true)));\n$log-\u003eaddTag('sdk', 'Flutter');\n$log-\u003eaddTag('sdkVersion', '0.0.1');\n$log-\u003eaddTag('authMode', 'default');\n$log-\u003eaddTag('authMethod', 'cookie');\n$log-\u003eaddTag('authProvider', 'MagicLink');\n$log-\u003eaddExtra('urgent', false);\n$log-\u003eaddExtra('isExpected', true);\n\n// Sentry\n$adapter = new Sentry(\"[YOUR_SENTRY_DSN]\");\n$logger = new Logger($adapter);\n$logger-\u003eaddLog($log);\n\n// AppSignal\n$adapter = new AppSignal(\"[YOUR_APPSIGNAL_KEY]\");\n$logger = new Logger($adapter);\n$logger-\u003eaddLog($log);\n\n// Raygun\n$adapter = new Raygun(\"[YOUR_RAYGUN_KEY]\");\n$logger = new Logger($adapter);\n$logger-\u003eaddLog($log);\n\n// Log Owl\n$adapter = new LogOwl(\"[YOUR_SERVICE_TICKET]\");\n$logger = new Logger($adapter);\n$logger-\u003eaddLog($log);\n\n```\n\n### Adapters\n\nBelow is a list of supported adapters, and thier compatibly tested versions alongside a list of supported features and relevant limits.\n\n| Adapter | Status |\n|---------|---------|\n| Sentry | ✅ |\n| AppSignal | ✅ |\n| Raygun | ✅ |\n| Log Owl | ✅ |\n\n` ✅  - supported, 🛠  - work in progress`\n\n## Tests\n\nIf you need to install dependencies, run:\n\n```bash\ndocker run --rm --interactive --tty \\\n  --volume $PWD:/app \\\n  composer update --ignore-platform-reqs --optimize-autoloader --no-plugins --no-scripts --prefer-dist\n```\n\nTo run all unit tests, prepare the `.env` file using `.env.example` as a template. Then, run:\n\n```bash\ndocker run --rm --interactive --tty --env-file .env \\\n  --volume $PWD:/app \\\n  composer test\n```\n\n\u003e Make sure to replace `TEST_SENTRY_DSN` with actual keys from Sentry. \n\n\u003e Make sure to replace `TEST_APPSIGNAL_KEY` with key found in Appsignal -\u003e Project -\u003e App Settings -\u003e Push \u0026 deploy -\u003e Push Key\n\n\u003e Make sure to replace `TEST_RAYGUN_KEY` with key found in Raygun -\u003e Project -\u003e Application Settings -\u003e Api Key\n\nTo run static code analysis, use the following Psalm command:\n\n```bash\ndocker run --rm --interactive --tty \\\n  --volume $PWD:/app \\\n  composer check\n```\n\n## System Requirements\n\nUtopia Framework requires PHP 8.0 or later. We recommend using the latest PHP version whenever possible.\n\n## Copyright and license\n\nThe MIT License (MIT) [http://www.opensource.org/licenses/mit-license.php](http://www.opensource.org/licenses/mit-license.php)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futopia-php%2Flogger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Futopia-php%2Flogger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futopia-php%2Flogger/lists"}