ntwb / wordpress

tests/phpunit/includes/object-cache.php

Doc Comments +3 added lines, -3 removed lines

@@ -592,7 +592,7 @@ 
  * @link http://www.php.net/manual/en/memcached.replace.php
  *
  * @param string    $key        The key under which to store the value.
- * @param mixed     $value      The value to store.
+ * @param string     $value      The value to store.
  * @param string    $group      The group value appended to the $key.
  * @param int       $expiration The expiration time, defaults to 0.
  * @return bool                 Returns TRUE on success or FALSE on failure.
@@ -1169,7 +1169,7 @@ 
 	 *
 	 * @param   string      $key        The key under which to store the value.
 	 * @param   string      $group      The group value appended to the $key.
-	 * @param   int         $time       The amount of time the server will wait to delete the item in seconds.
+	 * @param   boolean         $time       The amount of time the server will wait to delete the item in seconds.
 	 * @param   string      $server_key The key identifying the server to store the value on.
 	 * @param   bool        $byKey      True to store in internal cache by key; false to not store by key
 	 * @return  bool                    Returns TRUE on success or FALSE on failure.
@@ -1272,7 +1272,7 @@ 
 	 *
 	 * @param   string          $key        The key under which to store the value.
 	 * @param   string          $group      The group value appended to the $key.
-	 * @param   bool            $force      Whether or not to force a cache invalidation.
+	 * @param   false|string            $force      Whether or not to force a cache invalidation.
 	 * @param   null|bool       $found      Variable passed by reference to determine if the value was found or not.
 	 * @param   string          $server_key The key identifying the server to store the value on.
 	 * @param   bool            $byKey      True to store in internal cache by key; false to not store by key

tests/phpunit/includes/testcase-xmlrpc.php

Doc Comments +3 added lines

@@ -22,6 +22,9 @@
 		parent::tearDown();
 	}
 
+	/**
+	 * @param string $role
+	 */
 	protected function make_user_by_role( $role ) {
 		return self::factory()->user->create( array(
 			'user_login' => $role,

tests/phpunit/includes/testcase.php

Doc Comments +3 added lines, -4 removed lines

@@ -436,8 +436,7 @@ 
 	 *
 	 * @since 4.2.0
 	 *
-	 * @param string $deprecated Name of the function, method, or class that appears in the first argument of the
-	 *                           source `_doing_it_wrong()` call.
+	 * @param string $doing_it_wrong
 	 */
 	public function setExpectedIncorrectUsage( $doing_it_wrong ) {
 		array_push( $this->expected_doing_it_wrong, $doing_it_wrong );
@@ -446,7 +445,7 @@ 
 	/**
 	 * PHPUnit 6+ compatibility shim.
 	 *
-	 * @param mixed      $exception
+	 * @param string      $exception
 	 * @param string     $message
 	 * @param int|string $code
 	 */
@@ -693,7 +692,6 @@ 
 	 * expected to be false. For example, assertQueryTrue('is_single', 'is_feed') means is_single()
 	 * and is_feed() must be true and everything else must be false to pass.
 	 *
-	 * @param string $prop,... Any number of WP_Query properties that are expected to be true for the current request.
 	 */
 	function assertQueryTrue(/* ... */) {
 		global $wp_query;
@@ -892,6 +890,7 @@ 
 
 	/**
 	 * There's no way to change post_modified through WP functions.
+	 * @param string $date
 	 */
 	protected function update_post_modified( $post_id, $date ) {
 		global $wpdb;

tests/phpunit/includes/utils.php

Doc Comments +11 added lines

@@ -6,6 +6,9 @@ 
 	return substr(md5(uniqid(rand())), 0, $len);
 }
 
+/**
+ * @param integer $length
+ */
 function rand_long_str( $length ) {
 	$chars = 'abcdefghijklmnopqrstuvwxyz';
 	$string = '';
@@ -187,6 +190,9 @@ 
 	}
 }
 
+/**
+ * @param string $in
+ */
 function xml_to_array($in) {
 	$p = new testXMLParser($in);
 	return $p->data;
@@ -316,6 +322,9 @@ 
 }
 
 // mask out any input fields matching the given name
+/**
+ * @param string $in
+ */
 function mask_input_value($in, $name='_wpnonce') {
 	return preg_replace('@<input([^>]*) name="'.preg_quote($name).'"([^>]*) value="[^>]*" />@', '<input$1 name="'.preg_quote($name).'"$2 value="***" />', $in);
 }
@@ -404,6 +413,8 @@ 
 /**
  * Determine approximate backtrack count when running PCRE.
  *
+ * @param string $pattern
+ * @param string $strategy
  * @return int The backtrack count.
  */
 function benchmark_pcre_backtracking( $pattern, $subject, $strategy ) {

tests/phpunit/tests/admin/includesPlugin.php

Doc Comments +1 added lines, -1 removed lines

@@ -346,7 +346,7 @@
 	 * @param string $data     Optional. Data for the plugin file. Default is a dummy plugin header.
 	 * @param string $filename Optional. Filename for the plugin file. Default is a random string.
 	 * @param string $dir_path Optional. Path for directory where the plugin should live.
-	 * @return array Two-membered array of filename and full plugin path.
+	 * @return string[] Two-membered array of filename and full plugin path.
 	 */
 	private function _create_plugin( $data = "<?php\n/*\nPlugin Name: Test\n*/", $filename = false, $dir_path = false ) {
 		if ( false === $filename ) {

tests/phpunit/tests/ajax/DeleteComment.php

Doc Comments +4 added lines

@@ -55,6 +55,7 @@ 
 	 * Expects test to pass
 	 * @param mixed $comment Comment object
 	 * @param string action trash, untrash, etc.
+	 * @param string $action
 	 * @return void
 	 */
 	public function _test_as_admin( $comment, $action ) {
@@ -113,6 +114,7 @@ 
 	 * Expects test to fail
 	 * @param mixed $comment Comment object
 	 * @param string action trash, untrash, etc.
+	 * @param string $action
 	 * @return void
 	 */
 	public function _test_as_subscriber( $comment, $action ) {
@@ -143,6 +145,7 @@ 
 	 * Expects test to fail
 	 * @param mixed $comment Comment object
 	 * @param string action trash, untrash, etc.
+	 * @param string $action
 	 * @return void
 	 */
 	public function _test_with_bad_nonce( $comment, $action ) {
@@ -208,6 +211,7 @@ 
 	 * Expects test to fail
 	 * @param mixed $comment Comment object
 	 * @param string action trash, untrash, etc.
+	 * @param string $action
 	 * @return void
 	 */
 	public function _test_double_action( $comment, $action ) {

tests/phpunit/tests/basic.php

Doc Comments +3 added lines

@@ -163,6 +163,9 @@
 		$this->assertEquals( 'match', $return );
 	}
 
+	/**
+	 * @param integer $var
+	 */
 	function _switch_order_helper( $var ) {
 		$return = 'no match';
 		switch ( $var ) {

tests/phpunit/tests/customize/manager.php

Doc Comments +4 added lines, -4 removed lines

@@ -1373,7 +1373,7 @@ 
 	 * Callback for customize_allowed_urls filter.
 	 *
 	 * @param array $urls URLs.
-	 * @return array URLs.
+	 * @return string[] URLs.
 	 */
 	function filter_customize_allowed_urls( $urls ) {
 		$urls[] = 'http://headless.example.com/';
@@ -2270,7 +2270,7 @@ 
 	 * @param array                $components         Components.
 	 * @param WP_Customize_Manager $customize_manager  Manager.
 	 *
-	 * @return array Components.
+	 * @return string[] Components.
 	 */
 	function return_array_containing_widgets( $components, $customize_manager ) {
 		$this->assertInternalType( 'array', $components );
@@ -2287,7 +2287,7 @@ 
 	 * @param array                $components         Components.
 	 * @param WP_Customize_Manager $customize_manager  Manager.
 	 *
-	 * @return array Components.
+	 * @return string[] Components.
 	 */
 	function return_array_containing_nav_menus( $components, $customize_manager ) {
 		$this->assertInternalType( 'array', $components );
@@ -2669,7 +2669,7 @@ 
 	/**
 	 * Validates an input.
 	 *
-	 * @param mixed $value Value to validate.
+	 * @param string $value Value to validate.
 	 * @return true|WP_Error True if the input was validated, otherwise WP_Error.
 	 */
 	public function validate( $value ) {

tests/phpunit/tests/file.php

Doc Comments +3 added lines

@@ -61,6 +61,9 @@
 			$this->assertEquals( $expected[ $header ], $value, $header );
 	}
 
+	/**
+	 * @param string $filename
+	 */
 	function is_unique_writable_file($path, $filename) {
 		$fullpath = $path . DIRECTORY_SEPARATOR . $filename;