scratch – Blame information for rev 122
?pathlinks?
Rev | Author | Line No. | Line |
---|---|---|---|
120 | office | 1 | # Extending Monolog |
2 | |||
3 | Monolog is fully extensible, allowing you to adapt your logger to your needs. |
||
4 | |||
5 | ## Writing your own handler |
||
6 | |||
7 | Monolog provides many built-in handlers. But if the one you need does not |
||
8 | exist, you can write it and use it in your logger. The only requirement is |
||
9 | to implement `Monolog\Handler\HandlerInterface`. |
||
10 | |||
11 | Let's write a PDOHandler to log records to a database. We will extend the |
||
12 | abstract class provided by Monolog to keep things DRY. |
||
13 | |||
14 | ```php |
||
15 | <?php |
||
16 | |||
17 | use Monolog\Logger; |
||
18 | use Monolog\Handler\AbstractProcessingHandler; |
||
19 | |||
20 | class PDOHandler extends AbstractProcessingHandler |
||
21 | { |
||
22 | private $initialized = false; |
||
23 | private $pdo; |
||
24 | private $statement; |
||
25 | |||
26 | public function __construct(PDO $pdo, $level = Logger::DEBUG, $bubble = true) |
||
27 | { |
||
28 | $this->pdo = $pdo; |
||
29 | parent::__construct($level, $bubble); |
||
30 | } |
||
31 | |||
32 | protected function write(array $record) |
||
33 | { |
||
34 | if (!$this->initialized) { |
||
35 | $this->initialize(); |
||
36 | } |
||
37 | |||
38 | $this->statement->execute(array( |
||
39 | 'channel' => $record['channel'], |
||
40 | 'level' => $record['level'], |
||
41 | 'message' => $record['formatted'], |
||
42 | 'time' => $record['datetime']->format('U'), |
||
43 | )); |
||
44 | } |
||
45 | |||
46 | private function initialize() |
||
47 | { |
||
48 | $this->pdo->exec( |
||
49 | 'CREATE TABLE IF NOT EXISTS monolog ' |
||
50 | .'(channel VARCHAR(255), level INTEGER, message LONGTEXT, time INTEGER UNSIGNED)' |
||
51 | ); |
||
52 | $this->statement = $this->pdo->prepare( |
||
53 | 'INSERT INTO monolog (channel, level, message, time) VALUES (:channel, :level, :message, :time)' |
||
54 | ); |
||
55 | |||
56 | $this->initialized = true; |
||
57 | } |
||
58 | } |
||
59 | ``` |
||
60 | |||
61 | You can now use this handler in your logger: |
||
62 | |||
63 | ```php |
||
64 | <?php |
||
65 | |||
66 | $logger->pushHandler(new PDOHandler(new PDO('sqlite:logs.sqlite'))); |
||
67 | |||
68 | // You can now use your logger |
||
69 | $logger->addInfo('My logger is now ready'); |
||
70 | ``` |
||
71 | |||
72 | The `Monolog\Handler\AbstractProcessingHandler` class provides most of the |
||
73 | logic needed for the handler, including the use of processors and the formatting |
||
74 | of the record (which is why we use ``$record['formatted']`` instead of ``$record['message']``). |
||
75 | |||
76 | ← [Utility classes](03-utilities.md) |