LogLevel:MINIMAL, :MAXIMAL

+ Some phpdoc updates.
Trehinos · Mar 21, 2023 · ca0a6aa · ca0a6aa
1 parent 2fea12e
commit ca0a6aa
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 4 deletions.
diff --git a/thor/Database/PdoExtension/PdoRequester.php b/thor/Database/PdoExtension/PdoRequester.php
@@ -60,15 +60,15 @@ public function executeMultiple(string $sql, array $parameters, bool $continueIf
         $result = true;
 
         foreach ($parameters as $pdoRowsArray) {
-            Logger::writeDebug(' -> DB parameters', array_values($pdoRowsArray), LogLevel::INFO);
+            Logger::writeDebug(' -> DB parameters', array_values($pdoRowsArray), LogLevel::MINIMAL);
             try {
                 $result = $result && $stmt->execute(array_values($pdoRowsArray));
             } catch (PDOException $e) {
                 if (!Thor::isDebug()) {
                     Logger::writeDebug(' -> DB parameters', array_values($pdoRowsArray), LogLevel::WARNING);
                 }
-                Logger::logThrowable($e);
                 Logger::writeDebug(' -> DB execution failed : ', array_values($pdoRowsArray), LogLevel::ERROR);
+                Logger::logThrowable($e);
                 if (!$continueIfError) {
                     throw $e;
                 }
@@ -97,13 +97,20 @@ public function request(string $sql, array $parameters = []): PDOStatement
     }
 
     /**
-     * Gets the PdoHandler of this requester.
+     * Returns this instance's PDO connection handler.
      */
     final public function getPdoHandler(): PdoHandler
     {
         return $this->handler;
     }
 
+    /**
+     * Format a string like "(?, ?, ?, ...)" where number of '?' is `count($elements)`
+     *
+     * @param array $elements
+     *
+     * @return string
+     */
     public static function in(array $elements) : string
     {
         return '(' . implode(',', array_fill(0, count($elements), '?')) . ')';

diff --git a/thor/Debug/LogLevel.php b/thor/Debug/LogLevel.php
@@ -27,6 +27,10 @@ enum LogLevel: int
     case ALERT = 6;
     case EMERGENCY = 7;
 
+    public const MINIMAL = self::INFO;
+
+    public const MAXIMAL = self::EMERGENCY;
+
     /**
      * Returns **minimum** LogLevel according to Env :
      *  - DEV --> INFO

diff --git a/thor/Stream/Stream.php b/thor/Stream/Stream.php
@@ -20,7 +20,7 @@ class Stream implements StreamInterface
     private const WRITABLE_MODES = '/a|w|r\+|rb\+|rw|x|c/';
 
     /**
-     * @param resource
+     * @param resource $stream
      * @param array $options
      *
      * @throws InvalidArgumentException