More precise type hints

Author: ralflang

src/Domhtml.php

@@ -44,7 +44,7 @@ class Domhtml implements Iterator
     /**
      * Iterator status.
      *
-     * @var array
+     * @var iterable|DOMDocument|null
      */
     protected $_iterator = null;
 

src/Util.php

@@ -170,15 +170,15 @@ public static function getPost($var, $default = null)
      * @param boolean $secure  If deleting the file, should we securely delete
      *                         the file by overwriting it with random data?
      *
-     * @return string   Returns the full path-name to the temporary file.
+     * @return string|false   Returns the full path-name to the temporary file.
      *                  Returns false if a temp file could not be created.
      */
     public static function getTempFile(
         $prefix = '',
         $delete = true,
         $dir = '',
         $secure = false
-    )
+    ): string|false
     {
         $tempDir = (empty($dir) || !is_dir($dir))
             ? sys_get_temp_dir()
@@ -211,16 +211,16 @@ public static function getTempFile(
      * @param boolean $secure    If deleting file, should we securely delete
      *                           the file by overwriting it with random data?
      *
-     * @return string   Returns the full path-name to the temporary file.
-     *                  Returns false if a temporary file could not be created.
+     * @return string|false   Returns the full path-name to the temporary file.
+     *                        Returns false if a temporary file could not be created.
      */
     public static function getTempFileWithExtension(
         $extension = '.tmp',
         $prefix = '',
         $delete = true,
         $dir = '',
         $secure = false
-    )
+    ): string|false
     {
         $tempDir = (empty($dir) || !is_dir($dir))
             ? sys_get_temp_dir()
@@ -275,10 +275,10 @@ public static function getTempFileWithExtension(
      * @param string $temp_dir  Use this temporary directory as the directory
      *                          where the temporary directory will be created.
      *
-     * @return string  The pathname to the new temporary directory.
+     * @return string|false  The pathname to the new temporary directory.
      *                 Returns false if directory not created.
      */
-    public static function createTempDir($delete = true, $temp_dir = null)
+    public static function createTempDir($delete = true, $temp_dir = null): string|false
     {
         if (is_null($temp_dir)) {
             $temp_dir = sys_get_temp_dir();

src/Variables.php

@@ -75,7 +75,7 @@ public static function getDefaultVariables($sanitize = false): Variables
     /**
      * Constructor.
      *
-     * @param array $vars       The list of form variables (if null, defaults
+     * @param array|null $vars       The list of form variables (if null, defaults
      *                          to PHP's $_REQUEST value). If '_formvars'
      *                          exists, it must be a JSON encoded array that
      *                          contains the list of allowed form variables.