Magento 2. Monolog या लॉग लिखने के लिए कैसे

सामग्री की तालिका

एकलाप
Magento 2 में अनुप्रयोग सुविधाएँ
कार्यान्वयन
मानक लकड़हारा का उपयोग कर लॉगिंग
एक कस्टम चैनल के साथ एक मानक लकड़हारा का उपयोग कर लॉगिंग
अपने हैंडलर का उपयोग करके एक कस्टम फ़ाइल में लिखना
VirtualType का उपयोग करके कस्टम फ़ाइल में लिखना
फास्ट डेटा लॉगिंग
निष्कर्ष

एकलाप

use Monolog\Logger; use Monolog\Handler\StreamHandler; use Monolog\Formatter\HtmlFormatter; //     "name" $log = new Logger('name'); //  ,      "path/to/your1.log"       "WARNING"   (notice, info  debug   ). $log->pushHandler(new StreamHandler('path/to/your1.log', Logger::WARNING)); //  ,      "path/to/your2.log"       "ALERT"   (..        alert  emergency).    ,    .         html   HtmlFormatter. $log->pushHandler(new StreamHandler('path/to/your2.log', Logger::ALERT,false) ->setFormatter(new HtmlFormatter)); //  ,       . $log->pushProcessor(function ($record) { $record['extra']['dummy'] = 'Hello world!'; return $record; }); //   $log->warning('Foo'); $log->error('Bar',['test']); $log->info('Test'); //   ,    1     INFO //your1.log // [2019-08-12 02:57:52] name.WARNING: Foo [] ['extra'=>['dummy'=>'Hello world!']] // [2019-08-12 02:57:53] name.ERROR: BAR ['test'] ['extra'=>['dummy'=>'Hello world!']] //your2.log // , .    ALERT  EMERGENCY 

• लकड़हारा एक वस्तु है जिसे हम लॉग को रिकॉर्ड करने के लिए उपयोग करते हैं। लकड़हारा खुद को रिकॉर्ड नहीं करता है, लेकिन हैंडलर का प्रबंधन करता है। कोई भी नंबर बनाया जा सकता है।
• हैंडलर - एक ऐसी वस्तु जो सीधे डेटा को संसाधित करती है। आप जितना चाहे लकड़हारे को उतने हैंडलर जोड़ सकते हैं। उन सभी को बदले में बुलाया जाएगा, भले ही दिए गए हैंडलर त्रुटि को संसाधित करने में सक्षम थे या नहीं। IsHandling विधि निर्धारित करती है कि यह हैंडलर प्राप्त त्रुटि को संभालने में सक्षम होगा या नहीं।
  
  

   public function isHandling(array $record) { return $record['level'] >= $this->level; } 

  
  हैंडलर के सबसे करीबी सादृश्य, मेरी राय में, इवेंट ऑब्जर्वर है।
  
• प्रोसेसर - किसी भी इकाई (कॉल करने योग्य)। शायद कुछ। उन्हें विश्व स्तर पर सौंपा जा सकता है और हैंडलर के लिए स्थापित किया जा सकता है। सबसे पहले, वैश्विक प्रोसेसर लॉन्च किए जाते हैं। प्रोसेसर का मुख्य कार्य लॉग में अतिरिक्त डेटा जोड़ना है (उदाहरण के लिए, आईपी जिसमें से कनेक्शन था, वैश्विक चर का मूल्य, जानकारी जिस पर कोड शाखा स्थित है, और इसी तरह)।
• फ़ॉर्मेटर - संदेश आउटपुट को लिखने से पहले परिवर्तित करता है। केवल 1 प्रति हैंडलर हो सकता है। उदाहरण के लिए, संदेश के मुख्य भाग को बदलना आवश्यक है, उदाहरण के लिए टेक्स्ट को html या json में बदलना।
• चैनल - लकड़हारे का नाम। लॉग रिकॉर्ड करते समय यह लिखा जाएगा। चूँकि 1 हैंडलर का उपयोग 2 अलग-अलग लॉगर में किया जा सकता है (यह लॉग को 1 उसी फ़ाइल में लिखेगा), यह निर्धारित करेगा कि त्रुटि कहाँ से आई है।
• स्तर - त्रुटि स्तर। हैंडलर के लिए इस पैरामीटर का मतलब न्यूनतम स्तर की त्रुटि है जिसे वह संभाल लेगा।
• बबल - संदेश पॉपअप। हैंडलर द्वारा संदेश को संसाधित करने के बाद, लकड़हारा संदेश को अगले हैंडलर को भेजता है। बबल प्रॉपर्टी के इस्तेमाल से इस प्रक्रिया को रोका जा सकता है। यदि हैंडलर के पास इस संपत्ति का मूल्य गलत है (डिफ़ॉल्ट हमेशा सच है), तो इसके बाद हैंडलर अपना काम करता है (इस त्रुटि को संसाधित करने में सक्षम था), अन्य हैंडलर शुरू नहीं होंगे।
• क्रम क्रम - निष्पादन क्रम। अंतिम जोड़ा हैंडलर हमेशा बहुत पहले लॉन्च किया जाता है। यह यह सुविधा है जो आपको लकड़हारे को पूरी तरह से निष्क्रिय करने के लिए एक तंत्र को लागू करने की अनुमति देता है (झूठे के माध्यम से)। कंस्ट्रक्टर के माध्यम से जोड़े गए हैंडलर्स, कंस्ट्रक्टर में निर्दिष्ट क्रम में चलते हैं।

चूंकि PSR-3 डेवलपर्स को पाठ में स्वत: सुधार मूल्यों को लागू करने के लिए बाध्य नहीं करता है, इसलिए मोनोलॉग डिफ़ॉल्ट रूप से ऐसा नहीं करता है। यदि आप लिखते हैं -> एमर्ज ('टेस्ट 1111 {प्लेसहोल्डर}', ['प्लेसहोल्डर' => 'फू']] आप निम्नलिखित प्राप्त करेंगे
[2019-08-12 02:57:52] main.EMERGENCY: टेस्ट 1111 {प्लेसहोल्डर} {"प्लेसहोल्डर": "फू"} []

काम पर प्रतिस्थापन के लिए, आपको एक अतिरिक्त प्रोसेसर - \ Monolog \ Processor \ PsrLogMessageProcessor कनेक्ट करना होगा।

Magento 2 में अनुप्रयोग सुविधाएँ

 2019-08-12T01:00:27+00:00 DEBUG (7): ALARM! 

 [2019-08-12 02:56:43] main.INFO: ALARM! [] [] 

यदि ऑब्जेक्ट में ऐसी संपत्ति (_logger या logger) नहीं है, तो हमें सबसे पहले अपनी कक्षा में निर्भरता \ Psr \ Log \ LoggerInterface को जोड़ना होगा और परिणामी ऑब्जेक्ट को $ लकड़हारा संपत्ति ( PSR-2 खंड 4.2 के अनुसार और Magento वेबसाइट पर प्रस्तुत उदाहरण के अनुसार) लिखना होगा। ।

 $this->_logger->{level}($message, $context = []); //$this->_logger->log('{level}', $message, $context = []); 

 public function commit() { $this->getConnection()->commit(); if ($this->getConnection()->getTransactionLevel() === 0) { $callbacks = CallbackPool::get(spl_object_hash($this->getConnection())); try { foreach ($callbacks as $callback) { call_user_func($callback); } } catch (\Exception $e) { $this->getLogger()->critical($e); } } return $this; } … private function getLogger() { if (null === $this->_logger) { $this->_logger = ObjectManager::getInstance()->get(\Psr\Log\LoggerInterface::class); } return $this->_logger; } 

 … <preference for="Psr\Log\LoggerInterface" type="Magento\Framework\Logger\Monolog" /> ... <type name="Magento\Framework\Logger\Monolog"> <arguments> <argument name="name" xsi:type="string">main</argument> <argument name="handlers" xsi:type="array"> <item name="system" xsi:type="object">Magento\Framework\Logger\Handler\System</item> <item name="debug" xsi:type="object">Magento\Framework\Logger\Handler\Debug</item> <item name="syslog" xsi:type="object">Magento\Framework\Logger\Handler\Syslog</item> </argument> </arguments> </type> ... 

 ... public function write(array $record) { if (isset($record['context']['exception'])) { $this->exceptionHandler->handle($record); return; } $record['formatted'] = $this->getFormatter()->format($record); parent::write($record); } ... 

मैगेंटो 2 से 2.2 में लकड़हारा के साथ एक समस्या थी जो पहले एक के बाद दूसरे हैंडलर के लिए कूदने में असमर्थ थी। यह समस्या इस तथ्य के कारण थी कि मोनोलॉग को उम्मीद थी कि सभी हैंडलर डिजिटल कुंजियों के साथ एक सरणी में आते हैं, और अल्फाबेटिक कीज़ (['सिस्टम' =>, 'डीबग' =>, ...]) के साथ आते हैं। मैगनेटो डेवलपर्स ने बाद में स्थिति को ठीक किया - उन्होंने मॉनोल को पास करने से पहले हैश को डिजिटल कुंजी के साथ एक नियमित सरणी में बदल दिया। मोनोलॉग ने अब हैंडलर एन्यूमरेशन एल्गोरिदम को भी बदल दिया है और अगली () विधि का उपयोग करता है।

कार्यान्वयन

1. मानक लकड़हारा का उपयोग कर लॉगिंग

 class RandomClass { private $logger; public function __construct(\Psr\Log\LoggerInterface $logger) { $this->logger = $logger; } public function foo() { $this->logger->info('Something went wrong'); //[...some date...] main.INFO: Something went wrong [] [] } } 

 … $this->_logger->info('Something went wrong'); //    ->debug,   ,      debug.log ... 

2. एक कस्टम चैनल के साथ एक मानक लकड़हारा का उपयोग करके लॉगिंग

 class RandomClass { private $logger; public function __construct(\Psr\Log\LoggerInterface $logger) { $this->logger = $logger->withName('api'); //    } public function foo() { $this->logger->info('Something went wrong'); //[...some date...] api.INFO: Something went wrong [] [] } } 

 grep -rn 'api' var/log/system.log 

3. अपने स्वयं के हैंडलर का उपयोग करके कस्टम फ़ाइल में लिखना

 <?php namespace Oxis\Log\Logger\Handler; use Magento\Framework\Filesystem\DriverInterface; use Magento\Framework\Logger\Handler\Base; use Monolog\Logger; class Test extends Base { protected $fileName = 'var/log/critical.log'; protected $loggerType = Logger::CRITICAL; public function __construct(DriverInterface $filesystem) { parent::__construct($filesystem,null,null); $this->bubble = false; //      setBubble() } } 

Magento 2 में 2.2+ में कंस्ट्रक्टर \ Magento \ Framework \ Logger \ Handler \ Base लॉग फ़ाइल में पथ को संसाधित करने का तरीका बदल गया है

 // BP . $this->fileName // BP. DIRECTORY_SEPARATOR . $this->fileName 

इसलिए, पुराने हैंडलर में आप अभी भी $ फ़ाइलनाम की शुरुआत में पा सकते हैं।

 use Oxis\Log\Logger\Handler\Test; use Psr\Log\LoggerInterface; class RandomClass { private $logger; public function __construct( LoggerInterface $logger, Test $handler ) { $logger->pushHandler($handler); //  setHandlers([$handler]),        . $this->logger = $logger; } public function foo() { $this->logger->critical('Something went wrong'); //      critical.log //[...some date...] main.CRITICAL: Something went wrong [] [] } } 

4. virtualType का उपयोग करके कस्टम फ़ाइल में लिखना

Magento 2 2.2+ में, कंस्ट्रक्टर \ Magento \ Framework \ Logger \ हैंडलर \ Base में एक नया पैरामीटर जोड़ा गया, जो आपको एक वर्चुअल हैंडलर बनाने और लॉग लिखने के लिए फ़ाइल के सापेक्ष पथ di.xml के माध्यम से निर्दिष्ट करने की अनुमति देता है। पहले, यह आवश्यक था कि या तो $ फ़ाइलपाथ के माध्यम से पूर्ण पथ निर्दिष्ट किया जाए, या एक नया हैंडलर बनाया जाए और संरक्षित फ़ाइल $ फ़ाइलनाम संपत्ति के सापेक्ष पथ लिखा जाए।

  <!--      ,     --> <virtualType name="ApiHandler" type="Magento\Framework\Logger\Handler\Base"> <arguments> <argument name="fileName" xsi:type="string">var/log/api.log</argument> </arguments> </virtualType> <!--  ,     --> <virtualType name="ApiLogger" type="Magento\Framework\Logger\Monolog"> <arguments> <argument name="name" xsi:type="string">api</argument> <argument name="handlers" xsi:type="array"> <item name="default" xsi:type="object">ApiHandler</item> </argument> </arguments> </virtualType> <!--       --> <type name="Oxis\Log\Model\A"> <arguments> <argument name="logger" xsi:type="object">ApiLogger</argument> </arguments> </type> 

 namespace Oxis\Log\Model; class A { private $logger; public function __construct(\Psr\Log\LoggerInterface $logger) { $this->logger = $logger; } public function foo() { $this->logger->info('Something went wrong'); } } 

 <virtualType name="ApiHandler" type="Magento\Framework\Logger\Handler\Base"> <arguments> <argument name="fileName" xsi:type="string">var/log/api.log</argument> </arguments> </virtualType> <virtualType name="ApiLogger" type="Magento\Framework\Logger\Monolog"> <arguments> <argument name="name" xsi:type="string">api</argument> <argument name="handlers" xsi:type="array"> <item name="default" xsi:type="object">ApiHandler</item> </argument> </arguments> </virtualType> <!--       logger--> <virtualType name="ApiLogContainingContext" type="Magento\Framework\Model\Context"> <arguments> <argument name="logger" xsi:type="object">ApiLogger</argument> </arguments> </virtualType> <!--    --> <type name="Oxis\Log\Model\A"> <arguments> <argument name="context" xsi:type="object">ApiLogContainingContext</argument> </arguments> </type> 

5. फास्ट डेटा लॉगिंग

 ... $log = new \Monolog\Logger('custom', [new \Monolog\Handler\StreamHandler(BP.'/var/log/custom.log')]); $log->error('test'); ... 

 ... file_put_contents(BP.'/var/log/custom.log', 'test',FILE_APPEND); ... 

निष्कर्ष