add patch for PHP 8.3 from ammendedHEADmaster

  https://github.com/cataphract/php-rar/pull/18
build out of sources tree

1 files changed, 85 insertions, 40 deletions

diff --git a/REFLECTION b/REFLECTION
index ba9be69..c8cc94d 100644
--- a/REFLECTION
+++ b/REFLECTION
@@ -1,4 +1,4 @@
-Extension [ <persistent> extension #117 rar version 4.2.0 ] {
+Extension [ <persistent> extension #125 rar version 4.2.0 ] {
 
   - Constants [6] {
     Constant [ int RAR_HOST_MSDOS ] { 0 }
@@ -14,8 +14,8 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
 
       - Parameters [3] {
         Parameter #0 [ <required> $filename ]
-        Parameter #1 [ <optional> $password ]
-        Parameter #2 [ <optional> $volume_callback ]
+        Parameter #1 [ <optional> $password = <default> ]
+        Parameter #2 [ <optional> $volume_callback = <default> ]
       }
     }
     Function [ <internal:rar> function rar_list ] {
@@ -70,7 +70,7 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
   }
 
   - Classes [3] {
-    Class [ <internal:rar> <iterateable> final class RarArchive implements Traversable ] {
+    Class [ <internal:rar> <iterateable> final class RarArchive implements Stringable, IteratorAggregate, Traversable ] {
 
       - Constants [0] {
       }
@@ -83,8 +83,8 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
 
           - Parameters [3] {
             Parameter #0 [ <required> $filename ]
-            Parameter #1 [ <optional> $password ]
-            Parameter #2 [ <optional> $volume_callback ]
+            Parameter #1 [ <optional> $password = <default> ]
+            Parameter #2 [ <optional> $volume_callback = <default> ]
           }
         }
       }
@@ -92,7 +92,7 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
       - Properties [0] {
       }
 
-      - Methods [9] {
+      - Methods [10] {
         Method [ <internal:rar> public method getEntries ] {
 
           - Parameters [0] {
@@ -137,10 +137,11 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
           }
         }
 
-        Method [ <internal:rar> public method __toString ] {
+        Method [ <internal:rar, prototype Stringable> public method __toString ] {
 
           - Parameters [0] {
           }
+          - Return [ string ]
         }
 
         Method [ <internal:rar, ctor> private method __construct ] {
@@ -148,10 +149,17 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
           - Parameters [0] {
           }
         }
+
+        Method [ <internal:rar, prototype IteratorAggregate> public method getIterator ] {
+
+          - Parameters [0] {
+          }
+          - Return [ Traversable ]
+        }
       }
     }
 
-    Class [ <internal:rar> final class RarEntry ] {
+    Class [ <internal:rar> final class RarEntry implements Stringable ] {
 
       - Constants [46] {
         Constant [ public int HOST_MSDOS ] { 0 }
@@ -209,32 +217,33 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
       }
 
       - Properties [15] {
-        Property [ <default> private $rarfile ]
-        Property [ <default> private $position ]
-        Property [ <default> private $name ]
-        Property [ <default> private $unpacked_size ]
-        Property [ <default> private $packed_size ]
-        Property [ <default> private $host_os ]
-        Property [ <default> private $file_time ]
-        Property [ <default> private $crc ]
-        Property [ <default> private $attr ]
-        Property [ <default> private $version ]
-        Property [ <default> private $method ]
-        Property [ <default> private $flags ]
-        Property [ <default> private $redir_type ]
-        Property [ <default> private $redir_to_directory ]
-        Property [ <default> private $redir_target ]
+        Property [ private $rarfile = NULL ]
+        Property [ private $position = NULL ]
+        Property [ private $name = NULL ]
+        Property [ private $unpacked_size = NULL ]
+        Property [ private $packed_size = NULL ]
+        Property [ private $host_os = NULL ]
+        Property [ private $file_time = NULL ]
+        Property [ private $crc = NULL ]
+        Property [ private $attr = NULL ]
+        Property [ private $version = NULL ]
+        Property [ private $method = NULL ]
+        Property [ private $flags = NULL ]
+        Property [ private $redir_type = NULL ]
+        Property [ private $redir_to_directory = NULL ]
+        Property [ private $redir_target = NULL ]
       }
 
       - Methods [19] {
         Method [ <internal:rar> public method extract ] {
 
           - Parameters [4] {
-            Parameter #0 [ <required> $path ]
-            Parameter #1 [ <optional> $filename ]
-            Parameter #2 [ <optional> $password ]
-            Parameter #3 [ <optional> $extended_data ]
+            Parameter #0 [ <required> ?string $dir ]
+            Parameter #1 [ <optional> ?string $filepath = '' ]
+            Parameter #2 [ <optional> ?string $password = null ]
+            Parameter #3 [ <optional> bool $extended_data = false ]
           }
+          - Return [ bool ]
         }
 
         Method [ <internal:rar> public method getPosition ] {
@@ -300,7 +309,7 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
         Method [ <internal:rar> public method getStream ] {
 
           - Parameters [1] {
-            Parameter #0 [ <optional> $password ]
+            Parameter #0 [ <optional> $password = <default> ]
           }
         }
 
@@ -334,10 +343,11 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
           }
         }
 
-        Method [ <internal:rar> public method __toString ] {
+        Method [ <internal:rar, prototype Stringable> public method __toString ] {
 
           - Parameters [0] {
           }
+          - Return [ string ]
         }
 
         Method [ <internal:rar, ctor> private method __construct ] {
@@ -348,13 +358,13 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
       }
     }
 
-    Class [ <internal:rar> final class RarException extends Exception implements Throwable ] {
+    Class [ <internal:rar> final class RarException extends Exception implements Throwable, Stringable ] {
 
       - Constants [0] {
       }
 
       - Static properties [1] {
-        Property [ public static $usingExceptions ]
+        Property [ public static $usingExceptions = false ]
       }
 
       - Static methods [2] {
@@ -373,47 +383,82 @@ Extension [ <persistent> extension #117 rar version 4.2.0 ] {
       }
 
       - Properties [4] {
-        Property [ <default> protected $message ]
-        Property [ <default> protected $code ]
-        Property [ <default> protected $file ]
-        Property [ <default> protected $line ]
+        Property [ protected $message = '' ]
+        Property [ protected $code = 0 ]
+        Property [ protected string $file = '' ]
+        Property [ protected int $line = 0 ]
       }
 
       - Methods [10] {
         Method [ <internal:Core, inherits Exception, ctor> public method __construct ] {
 
           - Parameters [3] {
-            Parameter #0 [ <optional> $message ]
-            Parameter #1 [ <optional> $code ]
-            Parameter #2 [ <optional> $previous ]
+            Parameter #0 [ <optional> string $message = "" ]
+            Parameter #1 [ <optional> int $code = 0 ]
+            Parameter #2 [ <optional> ?Throwable $previous = null ]
           }
         }
 
         Method [ <internal:Core, inherits Exception> public method __wakeup ] {
+
+          - Parameters [0] {
+          }
+          - Tentative return [ void ]
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getMessage ] {
+
+          - Parameters [0] {
+          }
+          - Return [ string ]
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getCode ] {
+
+          - Parameters [0] {
+          }
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getFile ] {
+
+          - Parameters [0] {
+          }
+          - Return [ string ]
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getLine ] {
+
+          - Parameters [0] {
+          }
+          - Return [ int ]
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getTrace ] {
+
+          - Parameters [0] {
+          }
+          - Return [ array ]
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getPrevious ] {
+
+          - Parameters [0] {
+          }
+          - Return [ ?Throwable ]
         }
 
         Method [ <internal:Core, inherits Exception, prototype Throwable> final public method getTraceAsString ] {
+
+          - Parameters [0] {
+          }
+          - Return [ string ]
         }
 
-        Method [ <internal:Core, inherits Exception, prototype Throwable> public method __toString ] {
+        Method [ <internal:Core, inherits Exception, prototype Stringable> public method __toString ] {
+
+          - Parameters [0] {
+          }
+          - Return [ string ]
         }
       }
     }