vanilla / garden

src/Application.php

Doc Comments +1 added lines, -1 removed lines

@@ -60,7 +60,7 @@
     /**
      * Add a new route.
      *
-     * @param string|Route $pathOrRoute The path to the route or the {@link Route} object itself.
+     * @param string $pathOrRoute The path to the route or the {@link Route} object itself.
      * @param callable|string|null $callback Either a callback to map the route to or a string representing
      * a format for {@link sprintf()}.
      * @return Route Returns the route that was added.

src/Db/MySqlDb.php

Doc Comments +1 added lines

@@ -120,6 +120,7 @@
 
     /**
      * {@inheritdoc}
+     * @param string $tablename
      */
     public function getTableDef($tablename) {
         $table = parent::getTableDef($tablename);

src/Password/XenforoPassword.php

Doc Comments +1 added lines, -1 removed lines

@@ -93,7 +93,7 @@
      * Split the hash into its calculated hash and salt.
      *
      * @param string $hash The hash to split.
-     * @return array An array in the form [$hash, $hashFunc, $salt].
+     * @return string[] An array in the form [$hash, $hashFunc, $salt].
      */
     protected function splitHash($hash) {
         $parts = @unserialize($hash);

src/Request.php

Doc Comments +3 added lines, -3 removed lines

@@ -323,7 +323,7 @@ 
      *
      * @param string|null $key The key to get or null to get the entire environment.
      * @param mixed $default The default value if {@link $key} is not found.
-     * @return mixed|array Returns the value at {@link $key}, {$link $default} or the entire environment array.
+     * @return string|null Returns the value at {@link $key}, {$link $default} or the entire environment array.
      * @see Request::setEnv()
      */
     public function getEnv($key = null, $default = null) {
@@ -864,7 +864,7 @@ 
     /**
      * Get the root directory (SCRIPT_NAME) of the request.
      *
-     * @return Returns the root directory of the request as a string.
+     * @return string the root directory of the request as a string.
      * @see Request::setRoot()
      */
     public function getRoot() {
@@ -1013,7 +1013,7 @@ 
      * Split the file extension off a path.
      *
      * @param string $path The path to split.
-     * @return array Returns an array in the form `['path', 'ext']`.
+     * @return string[] Returns an array in the form `['path', 'ext']`.
      */
     protected static function splitPathExt($path) {
         if (substr($path, -1) !== '/' && ($pos = strrpos($path, '.')) !== false) {

src/Schema.php

Doc Comments +1 added lines, -1 removed lines

@@ -259,7 +259,7 @@
      *
      * @param array &$data The data to validate.
      * @param Validation &$validation This argument will be filled with the validation result.
-     * @return bool Returns true if the data is valid, false otherwise.
+     * @return Schema Returns true if the data is valid, false otherwise.
      * @throws ValidationException Throws an exception when the data does not validate against the schema.
      */
     public function validate(array &$data, Validation &$validation = null) {

src/SecureString.php

Doc Comments +1 added lines, -1 removed lines

@@ -405,7 +405,7 @@
      * @param bool $throw Whether or not to throw an exception.
      * @param string $message The exception message.
      * @param int $code The exception code.
-     * @return bool Returns false if {@link $throw} is false.
+     * @return boolean|null Returns false if {@link $throw} is false.
      * @throws \Exception Throws an exception with {@link $message} and {@link $code}.
      */
     protected function exception($throw, $message, $code) {

src/functions/core-functions.php

Doc Comments +6 added lines, -6 removed lines

@@ -98,7 +98,7 @@ 
      * A custom implementation of array_column for older versions of php.
      *
      * @param array $array The dataset to test.
-     * @param int|string $columnKey The column of values to return.
+     * @param string $columnKey The column of values to return.
      * @param int|string|null $indexKey The column to use as the index/keys for the returned array.
      * @return array Returns the columns from the {@link $input} array.
      */
@@ -265,9 +265,9 @@ 
 /**
  * Select the first non-empty value from an array.
  *
- * @param array $keys An array of keys to try.
+ * @param string[] $keys An array of keys to try.
  * @param array $array The array to select from.
- * @param mixed $default The default value if non of the keys exist.
+ * @param string $default The default value if non of the keys exist.
  * @return mixed Returns the first non-empty value of {@link $default} if none are found.
  * @category Array Functions
  */
@@ -283,7 +283,7 @@ 
 /**
  * Make sure that a key exists in an array.
  *
- * @param string|int $key The array key to ensure.
+ * @param string $key The array key to ensure.
  * @param array &$array The array to modify.
  * @param mixed $default The default value to set if key does not exist.
  * @category Array Functions
@@ -715,7 +715,7 @@ 
  * @param callable $callback A callback to the function.
  * @param array $args An array of arguments.
  * @param array $get An optional other array of arguments.
- * @return array The arguments in an associative array, in order ready to be passed to call_user_func_array().
+ * @return callable The arguments in an associative array, in order ready to be passed to call_user_func_array().
  * @throws Exception Throws an exception when {@link callback} isn't a valid callback.
  * @category Type Functions
  */
@@ -916,7 +916,7 @@ 
  *
  * This function differs from val() in that $key can be an array that will be used to walk a nested array.
  *
- * @param array|string $keys The keys or property names of the value. This can be an array or dot-seperated string.
+ * @param string[] $keys The keys or property names of the value. This can be an array or dot-seperated string.
  * @param array|object $array The array or object to search.
  * @param mixed $default The value to return if the key does not exist.
  * @return mixed The value from the array or object.