ספרים
PHP
פרק 5. פרקטיקות קידוד טובות
רישום פעולות (לוגים)

PHP:
רישום פעולות (לוגים)

איך לעשות:

ל-PHP יש פונקציה מובנית לתיעוד שגיאות שקל להשתמש בה. פשוט הכנס error_log() לתוך הקוד שלך כדי לשלוח הודעה ללוגים של השרת. אתה יכול גם להתאימו כך שירשום לקובץ מסוים.

<?php
// תיעוד הודעה פשוטה של מידע
error_log("This is an info log entry.");

// תיעוד הודעת שגיאה
error_log("This is an error log entry.", 0);

// תיעוד לקובץ מסוים
file_put_contents('/path/to/your/custom.log', "A custom log entry.\n", FILE_APPEND);

// שימוש ב-Monolog עבור תיעוד מובנה
require 'vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// יצירת המתעד
$logger = new Logger('name');
// עכשיו הוסף כמה מטפלים
$logger->pushHandler(new StreamHandler('/path/to/your/monolog.log', Logger::WARNING));

// עכשיו אתה יכול להשתמש במתעד שלך
$logger->warning('This is a warning log!');
$logger->error('This is an error log!');
?>

זה יוציא את הלוגים שלך ללוג של השרת או לקובץ שבחרת בפורמט טקסט פשוט.

צלילה עמוקה:

בעבר, תכנתי PHP הסתמכו על הפונקציה error_log() או על לוגי Apache/Nginx כדי לתפוס בעיות, אבל זה יכול להיות כאוטי עם הצורך לנתח קבצי טקסט פשוטים ואין דרך קלה לסנן או למיין אותם. כאן נכנסים ספריות תיעוד כמו Monolog, שהביאו את תקופת התיעוד המובנה ב-PHP. פתרונות אלה נותנים לך שליטה טובה יותר על ידי הצעת ערוצי תיעוד מרובים, רמות חומרה, ופלט מעוצב (כמו JSON, שהוא חלום לניתוח תוכניתי).

חלופות ל-Monolog כוללות את Log4php, KLogger, ו-Log4php של Apache. מבחינת היישום, תיעוד אמין דורש לא רק לזרוק נתונים לכל מקום, אלא לשקול דברים כמו סיבוב יומנים, אסטרטגיות ארכיון, ואינטגרציה עם כלי מעקב כדי להיות מועיל באמת.

עליך לקחת בחשבון את ממשק ה-PSR-3 Logger, שמגדיר ממשק נפוץ עבור ספריות תיעוד, מבטיח התאמה ודרך עקבית לגשת למנגנוני תיעוד.

ראה גם:

התחל לרטוב את רגלייך עם הפונקציות המובנות, אבל לגישה יותר ניתנת לתחזוקה ולקנה מידה, שקול להשקיע זמן כדי להתרגל עם ספרייה כמו Monolog. תיעוד מהנה!

טיפול בשגיאותארגון קוד לתוך פונקציות