PHP क्लाइंट लाइब्रेरी, लॉगिंग के लिए PSR-3 का पालन करती है. साथ ही, gRPC कॉल के लिए लॉगर उपलब्ध कराती है.
मैसेज किस PSR-3 लॉग लेवल पर लॉग किए जाते हैं, यह इस बात पर निर्भर करता है कि इवेंट सफल हुआ या नहीं:
| लॉग मैसेज | सफलता की स्थिति | काम पूरा न होने की स्थिति |
|---|---|---|
| एक लाइन में खास जानकारी | जानकारी | चेतावनी |
| डीबग मैसेज (जैसे, कॉल क्वेरी) | डीबग करें | नोटिस |
लॉगिंग कॉन्फ़िगर करना
डिफ़ॉल्ट रूप से, हर लाइब्रेरी लॉगर STDERR में लिखता है. इसके लिए, वह MonologStreamHandler का इस्तेमाल करके, GoogleAdsClientBuilder में बताए गए डिफ़ॉल्ट नाम वाले चैनल का इस्तेमाल करता है.
अपनी google_ads_php.ini फ़ाइल में, डिफ़ॉल्ट लॉगर के लिए विकल्प कॉन्फ़िगर किए जा सकते हैं:
[LOGGING]
; Optional logging settings.
logFilePath = "path/to/your/file.log"
logLevel = "INFO"
पक्का करें कि रनटाइम PHP प्रोसेस के पास, logFilePath में बताई गई डायरेक्ट्री और फ़ाइल में बदलाव करने की अनुमतियां हों.
अगर आपको लॉगिंग को और ज़्यादा पसंद के मुताबिक बनाना है, तो GoogleAdsClientBuilder में LoggerInterface को लागू करने वाला लॉगर इंस्टेंस देकर, अपना कस्टम लॉगर तय किया जा सकता है:
$googleAdsClient = (new GoogleAdsClientBuilder())
// ...
->withLogger(new MyCustomLogger())
->build();