Merge pull request #134 from Kharhamel/parameters

improved parameter generation (both signature and doc-block)

Author: Kharhamel

generated/apc.php

@@ -82,7 +82,7 @@ function apc_compile_file(string $filename, bool $atomic = true)
  *
  * @param string $key The key of the value being decreased.
  * @param int $step The step, or value to decrease.
- * @param bool $success Optionally pass the success or fail boolean value to
+ * @param bool|null $success Optionally pass the success or fail boolean value to
  * this referenced variable.
  * @return int Returns the current value of key's value on success
  * @throws ApcException
@@ -164,7 +164,7 @@ function apc_delete_file($keys)
  * @throws ApcException
  *
  */
-function apc_delete(string $key)
+function apc_delete($key)
 {
     error_clear_last();
     $result = \apc_delete($key);
@@ -180,7 +180,7 @@ function apc_delete(string $key)
  *
  * @param string $key The key of the value being increased.
  * @param int $step The step, or value to increase.
- * @param bool $success Optionally pass the success or fail boolean value to
+ * @param bool|null $success Optionally pass the success or fail boolean value to
  * this referenced variable.
  * @return int Returns the current value of key's value on success
  * @throws ApcException

generated/apcu.php

@@ -51,7 +51,7 @@ function apcu_cas(string $key, int $old, int $new): void
  *
  * @param string $key The key of the value being decreased.
  * @param int $step The step, or value to decrease.
- * @param bool $success Optionally pass the success or fail boolean value to
+ * @param bool|null $success Optionally pass the success or fail boolean value to
  * this referenced variable.
  * @param int $ttl TTL to use if the operation inserts a new value (rather than decrementing an existing one).
  * @return int Returns the current value of key's value on success
@@ -97,7 +97,7 @@ function apcu_delete($key)
  *
  * @param string $key The key of the value being increased.
  * @param int $step The step, or value to increase.
- * @param bool $success Optionally pass the success or fail boolean value to
+ * @param bool|null $success Optionally pass the success or fail boolean value to
  * this referenced variable.
  * @param int $ttl TTL to use if the operation inserts a new value (rather than incrementing an existing one).
  * @return int Returns the current value of key's value on success

generated/array.php

@@ -153,7 +153,7 @@ function array_multisort(array &$array1, $array1_sort_order = SORT_ASC, $array1_
  *
  * @param array $array1 The array in which elements are replaced.
  * @param array $params Optional. Arrays from which elements will be extracted.
- * @return array Returns an array, or NULL if an error occurs.
+ * @return array|null Returns an array, or NULL if an error occurs.
  * @throws ArrayException
  *
  */
@@ -188,7 +188,7 @@ function array_replace_recursive(array $array1, array  ...$params): array
  * @param array $array1 The array in which elements are replaced.
  * @param array $params Arrays from which elements will be extracted.
  * Values from later arrays overwrite the previous values.
- * @return array Returns an array, or NULL if an error occurs.
+ * @return array|null Returns an array, or NULL if an error occurs.
  * @throws ArrayException
  *
  */

generated/bzip2.php

@@ -9,7 +9,6 @@
  *
  * @param resource $bz The file pointer. It must be valid and must point to a file
  * successfully opened by bzopen.
- * @return int Returns TRUE on success.
  * @throws Bzip2Exception
  *
  */
@@ -29,7 +28,6 @@ function bzclose($bz): void
  *
  * @param resource $bz The file pointer. It must be valid and must point to a file
  * successfully opened by bzopen.
- * @return int Returns TRUE on success.
  * @throws Bzip2Exception
  *
  */

generated/com.php

@@ -26,7 +26,7 @@
  * @throws ComException
  *
  */
-function com_event_sink(variant $comobject, object $sinkobject, $sinkinterface = null): void
+function com_event_sink(object $comobject, object $sinkobject, $sinkinterface = null): void
 {
     error_clear_last();
     if ($sinkinterface !== null) {

generated/curl.php

@@ -495,7 +495,7 @@ function curl_multi_errno($mh): int
  *
  * @param resource $mh A cURL multi handle returned by
  * curl_multi_init.
- * @param int $msgs_in_queue Number of messages that are still in the queue
+ * @param int|null $msgs_in_queue Number of messages that are still in the queue
  * @return array On success, returns an associative array for the message, FALSE on failure.
  *
  *
@@ -528,7 +528,7 @@ function curl_multi_errno($mh): int
  * @throws CurlException
  *
  */
-function curl_multi_info_read($mh, int &$msgs_in_queue = null): array
+function curl_multi_info_read($mh, ?int &$msgs_in_queue = null): array
 {
     error_clear_last();
     $result = \curl_multi_info_read($mh, $msgs_in_queue);

generated/filesystem.php

@@ -565,7 +565,7 @@ function filesize(string $filename): int
  * It is also possible to add LOCK_NB as a bitmask to one
  * of the above operations if you don't want flock to
  * block while locking.
- * @param int $wouldblock The optional third argument is set to 1 if the lock would block
+ * @param int|null $wouldblock The optional third argument is set to 1 if the lock would block
  * (EWOULDBLOCK errno condition).
  * @throws FilesystemException
  *

generated/ftp.php

@@ -35,7 +35,7 @@ function ftp_alloc($ftp_stream, int $filesize, string &$result = null): void
  * @throws FtpException
  *
  */
-function ftp_append($ftp, string $remote_file, string $local_file, int $mode = FTP_IMAGE): void
+function ftp_append($ftp, string $remote_file, string $local_file, int $mode = FTP_BINARY): void
 {
     error_clear_last();
     $result = \ftp_append($ftp, $remote_file, $local_file, $mode);
@@ -179,7 +179,7 @@ function ftp_delete($ftp_stream, string $path): void
  * @throws FtpException
  *
  */
-function ftp_fget($ftp_stream, $handle, string $remote_file, int $mode = FTP_IMAGE, int $resumepos = 0): void
+function ftp_fget($ftp_stream, $handle, string $remote_file, int $mode = FTP_BINARY, int $resumepos = 0): void
 {
     error_clear_last();
     $result = \ftp_fget($ftp_stream, $handle, $remote_file, $mode, $resumepos);
@@ -202,7 +202,7 @@ function ftp_fget($ftp_stream, $handle, string $remote_file, int $mode = FTP_IMA
  * @throws FtpException
  *
  */
-function ftp_fput($ftp_stream, string $remote_file, $handle, int $mode = FTP_IMAGE, int $startpos = 0): void
+function ftp_fput($ftp_stream, string $remote_file, $handle, int $mode = FTP_BINARY, int $startpos = 0): void
 {
     error_clear_last();
     $result = \ftp_fput($ftp_stream, $remote_file, $handle, $mode, $startpos);
@@ -353,7 +353,7 @@ function ftp_pasv($ftp_stream, bool $pasv): void
  * @throws FtpException
  *
  */
-function ftp_put($ftp_stream, string $remote_file, string $local_file, int $mode = FTP_IMAGE, int $startpos = 0): void
+function ftp_put($ftp_stream, string $remote_file, string $local_file, int $mode = FTP_BINARY, int $startpos = 0): void
 {
     error_clear_last();
     $result = \ftp_put($ftp_stream, $remote_file, $local_file, $mode, $startpos);

generated/funchand.php

@@ -28,7 +28,7 @@ function create_function(string $args, string $code): string
 /**
  *
  *
- * @param callable $function The function to register.
+ * @param callable(): void $function The function to register.
  * @param mixed $params
  * @throws FunchandException
  *

generated/gmp.php

@@ -7,9 +7,9 @@
 /**
  * Calculates the binomial coefficient C(n, k).
  *
- * @param mixed $n Either a GMP number resource in PHP 5.5 and earlier, a GMP object in PHP 5.6 and later, or a numeric string provided that it is possible to convert the latter to a number.
+ * @param \GMP|string|int $n Either a GMP number resource in PHP 5.5 and earlier, a GMP object in PHP 5.6 and later, or a numeric string provided that it is possible to convert the latter to a number.
  * @param int $k
- * @return \\GMP Returns the binomial coefficient C(n, k).
+ * @return \GMP Returns the binomial coefficient C(n, k).
  * @throws GmpException
  *
  */
@@ -34,7 +34,7 @@ function gmp_binomial($n, int $k): \GMP
  * @throws GmpException
  *
  */
-function gmp_export(\GMP $gmpnumber, int $word_size = 1, int $options = GMP_MSW_FIRST | GMP_NATIVE_ENDIAN): string
+function gmp_export($gmpnumber, int $word_size = 1, int $options = GMP_MSW_FIRST | GMP_NATIVE_ENDIAN): string
 {
     error_clear_last();
     $result = \gmp_export($gmpnumber, $word_size, $options);