Monolog: Perpustakaan Log PHP yang kuat yang membantu anda meningkatkan kecekapan pembangunan aplikasi dan penyelenggaraan

Rakaman log adalah bahagian yang sangat diperlukan dari kitaran pembangunan dan penyelenggaraan aplikasi, dan ia tidak hanya bergantung pada data yang direkodkan, tetapi juga dalam cara ia direkodkan. Artikel ini akan menyelam ke dalam pakej monolog untuk menunjukkan bagaimana ia dapat membantu anda memanfaatkan sepenuhnya log anda.

Kelebihan teras:

• Diintegrasikan secara meluas: Monolog adalah perpustakaan log popular yang mengintegrasikan dengan kebanyakan rangka kerja arus perdana untuk memudahkan pemaju untuk memanfaatkan keupayaan pembalakannya. Ia mengikuti standard PHP-FIG, menjadikannya mudah untuk beralih kepada pelaksanaan lain.
Pemprosesan fleksibel: Monolog menyokong pelbagai pemproses dan mekanisme menggelegak, yang membolehkan pemaju mencatatkan pelbagai jenis mesej ke output yang berbeza. Ia juga menyokong menghantar mesej log ke perkhidmatan luaran, seperti Slack, untuk memberitahu pasukan apabila berlaku ralat.
• Kaya yang berfungsi:
Monolog menyediakan pelbagai preprocessors praktikal untuk mengandungi maklumat terperinci seperti puncak memori, ID pengguna, dan membolehkan format mesej log tersuai. Ini menjadikannya alat yang berkuasa untuk pembalakan dan debug semasa kitaran pembangunan/penyelenggaraan aplikasi.
Pemasangan:

Monolog boleh didapati di Packagist dan boleh dipasang melalui Komposer:

Jika anda menggunakan rangka kerja, monolog biasanya menyediakan penyelesaian integrasi. Contoh berikut tidak menggunakan integrasi rangka kerja dan menunjukkan cara mengkonfigurasi monolog dalam sebarang permohonan.

composer require 'monolog/monolog:1.13.*'

logger login:

Apabila membuat logger, anda harus menentukan nama saluran untuk membezakan pembalak yang berbeza. Contoh berikut mengikat logger ke bekas aplikasi:

Monolog mengikuti standard PSR-3, menjadikannya mudah untuk beralih kepada pelaksanaan lain. Anda boleh menggunakan kaedah berikut untuk pembalakan (log, debug, maklumat, amaran, kesilapan, kritikal, amaran, kecemasan):

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');
$app->container->logger = $logger;

$app->container->logger->info("一條INFO消息。");

Mesej log akan melalui senarai pemproses berdaftar. Pemproses perlu menentukan tahap log dan keadaan gelembung proses (sama ada mesej terus disebarkan). Secara lalai, Monolog menggunakan untuk log log ke output ralat standard. Pemproses yang ada disenaraikan dalam dokumentasi.

Contoh berikut menunjukkan cara menggunakan pelbagai pemproses dan mekanisme menggelegak: mesej maklumat log ke konsol penyemak imbas dan mesej ralat ke output terminal. MonologHandlerStreamHandler

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');

$browserHanlder = new \Monolog\Handler\BrowserConsoleHandler(\Monolog\Logger::INFO);
$streamHandler = new \Monolog\Handler\StreamHandler('php://stderr', \Monolog\Logger::ERROR);

$logger->pushHandler($browserHanlder);
$logger->pushHandler($streamHandler);

$app->container->logger = $logger;

// app/routes.php

$app->get('/admin/users', function () use ($app) {
    $app->container->logger->info("另一條INFO消息");
    $app->container->logger->error("另一條ERROR消息");
    // ...
});

Mesej ralat direkodkan ke terminal seperti yang diharapkan, tetapi mengapa mereka juga muncul dalam konsol penyemak imbas? Ini adalah mekanisme menggelegak monolog. Mesej ralat pertama kali dilog masuk ke terminal dan jika pilihan gelembung ditetapkan kepada benar, ia terus menyebarkan ke bahagian atas giliran pemproses. Tetapkan pilihan menggelegak kepada palsu:

composer require 'monolog/monolog:1.13.*'

Log ralat kini tidak dipaparkan dalam konsol penyemak imbas, iaitu cara memisahkan tahap log.

pemproses slack:

Sebelum menggunakan pemproses Slack, anda perlu mendapatkan token untuk membenarkannya untuk menerbitkan ke saluran Slack.

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');
$app->container->logger = $logger;

Anda hanya perlu menentukan nama token dan saluran Slack, parameter pilihan ketiga adalah nama robot. Tahap log Slack adalah kritikal, tetapi anda boleh mengubahnya menggunakan kaedah setLevel.

$app->container->logger->info("一條INFO消息。");

Selepas menghantar mesej log, anda boleh mengakses saluran anda untuk melihat mesej ralat yang direkodkan.

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');

$browserHanlder = new \Monolog\Handler\BrowserConsoleHandler(\Monolog\Logger::INFO);
$streamHandler = new \Monolog\Handler\StreamHandler('php://stderr', \Monolog\Logger::ERROR);

$logger->pushHandler($browserHanlder);
$logger->pushHandler($streamHandler);

$app->container->logger = $logger;

// app/routes.php

$app->get('/admin/users', function () use ($app) {
    $app->container->logger->info("另一條INFO消息");
    $app->container->logger->error("另一條ERROR消息");
    // ...
});

// app/bootstrap/container.php

// ...
$streamHandler = new \Monolog\Handler\StreamHandler('php://stderr', \Monolog\Logger::ERROR, false);
// ...

// app/bootstrap/container.php

// ...
$slackHandler = new \Monolog\Handler\SlackHandler('xoxp-5156076911-5156636951-6084570483-7b4fb8', '#general', 'ChhiwatBot');
$logger->pushHandler($slackHandler);

// ...

$slackHandler->setLevel(\Monolog\Logger::ERROR);