Download the PHP package waffle-commons/log without Composer
On this page you can find all versions of the php package waffle-commons/log. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download waffle-commons/log
More information about waffle-commons/log
Files in waffle-commons/log
Package log
Short Description PSR-3 logging for Waffle Commons: a minimal stream logger with channel separation, safe to hold across FrankenPHP worker requests.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package log
Waffle Log Component
Release:
0.1.0-beta6|CHANGELOG.mdPSR Compliance: PSR-3 (Psr\Log\AbstractLogger)
A strict, container-native logger that emits one JSON line per record onto a stream. Designed for Docker/Kubernetes deployments where stdout/stderr are the log sinks — no buffering, no per-process state, safe across FrankenPHP worker requests.
📦 Installation
🧱 Surface
| Class | Role |
|---|---|
Waffle\Commons\Log\StreamLogger |
PSR-3 AbstractLogger writing JSON-formatted records to any PHP stream (php://stderr, php://stdout, file paths). |
Waffle\Commons\Log\Channel\LogChannel |
Typed-constant container for canonical log-channel names (APP, CORE, HTTP, SECURITY, AUDIT). |
🚀 Usage
StreamLogger exposes its configuration via PHP 8.5 asymmetric visibility (public private(set)) and readonly promoted properties:
The signature, verbatim from src/StreamLogger.php:
🪵 Output format
Every record is a single JSON object emitted with a trailing \n, suitable for Docker's JSON-file driver and for jq/grep pipelines:
RFC 5424 / Monolog level constants (DEBUG=100 … EMERGENCY=600) are interpolated from Psr\Log\LogLevel — no custom level vocabulary.
🧷 Channels
LogChannel is a typed-constant container (intentionally not a backed enum, so it can be used as a property default):
🛡️ Worker-mode safety
- Stream is opened in the constructor and closed in
__destruct(), preventing file-descriptor leaks across long-running workers. - No per-call buffering; each
log()call writes immediately. - No static state. Multiple
StreamLoggerinstances can co-exist (one per channel, for example).
🧭 Architectural boundary (mago guard)
An active dependency perimeter is enforced on every CI run by vendor/bin/mago guard (bundled into composer mago; zero baselines). The rules live in mago.toml under [guard.perimeter] — a forbidden use statement fails the build, not a reviewer.
Production code under Waffle\Commons\Log may depend only on:
Waffle\Commons\Log\**— itselfWaffle\Commons\Contracts\**— the shared contracts package, the only Waffle dependency permittedPsr\**— PSR interfaces (PSR-3)@global+Psl\**— PHP core and the PHP Standard Library
Test code under WaffleTests\Commons\Log is unrestricted (@all). Structural rules are guarded too: interfaces must be named *Interface, Exception\** classes must end in *Exception, and any Enum\** namespace may hold only enum declarations.
Contract-first, component-agnostic by construction: components compose through waffle-commons/contracts, never directly through one another.
🧪 Testing
📚 Documentation
Central framework docs live in the waffle-commons/documentation repository:
- Reference: log
📄 License
MIT — see LICENSE.md.
