Merge pull request #166 from hungthai1401/feature/psr-logger

Integrate psr-logger

Author: butschster

CHANGELOG.md

@@ -8,6 +8,7 @@ The format is based on [Keep a Changelog][keepachangelog] and this project adher
 
 - gRPC client support
 - Added support to set queue options globally or per job [#158]
+- Add PSR-3 compatible logging with RoadRunner integration
 
 ## Unreleased
 

README.md

@@ -17,6 +17,7 @@ This package provides complete Laravel integration with RoadRunner, offering:
 - Support for HTTP and other RoadRunner plugins like gRPC, Queue, KeyValue, and more.
 - [Temporal](https://temporal.io/) integration
 - Full RoadRunner configuration control
+- PSR-3 compatible logging with RoadRunner integration
 
 ![RoadRunner](https://github.com/user-attachments/assets/609d2e29-b6af-478b-b350-1d27b77ed6fb)
 
@@ -36,6 +37,7 @@ This package provides complete Laravel integration with RoadRunner, offering:
   - [gRPC Plugin](#grpc-plugin)
   - [gRPC Client](#grpc-client)
   - [Temporal](#temporal)
+- [Logging](#logging)
 - [Custom Workers](#custom-workers)
 - [Support](#support)
 - [License](#license)
@@ -331,6 +333,56 @@ Start the Temporal dev server:
 - [Code samples](https://github.com/temporalio/samples-php)
 - [Taxi service sample](https://github.com/butschster/podlodka-taxi-service)
 
+## Logging
+
+The RoadRunner PSR Logger provides PSR-3 compatible logging with RoadRunner integration. The logger uses RPC calls to send logs to RoadRunner's centralized logging system, providing proper log level control and structured context support.
+
+### Usage
+
+The RoadRunner PSR Logger is available throughout your application via dependency injection:
+
+#### Dependency Injection (Recommended)
+
+```php
+use Psr\Log\LoggerInterface;
+
+class YourService
+{
+    public function __construct(
+        private LoggerInterface $logger
+    ) {}
+
+    public function doSomething()
+    {
+        $this->logger->info('Operation started');
+
+        try {
+            // Your logic here
+            $this->logger->info('Operation completed');
+        } catch (\Exception $e) {
+            $this->logger->error('Operation failed', [
+                'exception' => $e->getMessage(),
+                'trace' => $e->getTraceAsString()
+            ]);
+        }
+    }
+}
+```
+
+#### Service Container Resolution
+
+```php
+// Get logger from container
+$logger = app(LoggerInterface::class);
+// Or using the alias
+$logger = app('roadrunner.logger');
+
+$logger->info('Message', ['context' => 'data']);
+```
+
+#### Useful Links
+- [RoadRunner PSR Logger](https://github.com/roadrunner-php/psr-logger)
+
 ## Custom Workers
 
 The RoadRunner Laravel Bridge comes with several predefined workers for common plugins,

composer.json

@@ -43,7 +43,8 @@
         "spiral/roadrunner-worker": "^3.0",
         "temporal/sdk": "^2.0",
         "internal/dload": "^1.1",
-        "spiral/grpc-client": "^1.0.0-rc1"
+        "spiral/grpc-client": "^1.0.0-rc1",
+        "roadrunner/psr-logger": "^1.0"
     },
     "require-dev": {
         "laravel/framework": "^12.0",
@@ -93,7 +94,8 @@
                 "Spiral\\RoadRunnerLaravel\\ServiceProvider",
                 "Spiral\\RoadRunnerLaravel\\Queue\\QueueServiceProvider",
                 "Spiral\\RoadRunnerLaravel\\Cache\\CacheServiceProvider",
-                "Spiral\\RoadRunnerLaravel\\Temporal\\TemporalServiceProvider"
+                "Spiral\\RoadRunnerLaravel\\Temporal\\TemporalServiceProvider",
+                "Spiral\\RoadRunnerLaravel\\Logging\\LoggerServiceProvider"
             ]
         }
     },

src/Logging/LoggerServiceProvider.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spiral\RoadRunnerLaravel\Logging;
+
+use Illuminate\Support\ServiceProvider;
+use Psr\Log\LoggerInterface;
+use RoadRunner\Logger\Logger as AppLogger;
+use RoadRunner\PsrLogger\Context\DefaultProcessor;
+use RoadRunner\PsrLogger\RpcLogger;
+use Spiral\Goridge\RPC\Codec\ProtobufCodec;
+use Spiral\Goridge\RPC\RPC;
+use Spiral\RoadRunner\Environment;
+
+final class LoggerServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        $this->app->singleton(LoggerInterface::class, function () {
+            $env = Environment::fromGlobals();
+
+            /** @var non-empty-string $rpcAddress */
+            $rpcAddress = $env->getRPCAddress();
+            $rpc = RPC::create($rpcAddress)->withCodec(new ProtobufCodec());
+
+            $appLogger = new AppLogger($rpc);
+
+            $processor = DefaultProcessor::createDefault();
+
+            return new RpcLogger($appLogger, $processor);
+        });
+
+        $this->app->alias(LoggerInterface::class, 'roadrunner.logger');
+    }
+}