PHPStan: mark current_user_can as impure

Author: justlevine

src/wp-admin/my-sites.php

@@ -138,7 +138,6 @@
 
 		$actions = "<a href='" . esc_url( home_url() ) . "'>" . __( 'Visit' ) . '</a>';
 
-		// @phpstan-ignore if.alwaysTrue (Capabilities are site-specific)
 		if ( current_user_can( 'read' ) ) {
 			$actions .= " | <a href='" . esc_url( admin_url() ) . "'>" . __( 'Dashboard' ) . '</a>';
 		}

src/wp-admin/upload.php

@@ -210,7 +210,6 @@ function () {
 		<h1 class="wp-heading-inline"><?php echo esc_html( $title ); ?></h1>
 
 		<?php
-		// @phpstan-ignore if.alwaysTrue (Confidence check in case the file is required instead of accessed)
 		if ( current_user_can( 'upload_files' ) ) {
 			?>
 			<a href="<?php echo esc_url( admin_url( 'media-new.php' ) ); ?>" class="page-title-action aria-button-if-js"><?php echo esc_html__( 'Add Media File' ); ?></a>
@@ -418,7 +417,6 @@ function () {
 <h1 class="wp-heading-inline"><?php echo esc_html( $title ); ?></h1>
 
 <?php
-// @phpstan-ignore if.alwaysTrue (Confidence check in case the file is required instead of accessed)
 if ( current_user_can( 'upload_files' ) ) {
 	?>
 	<a href="<?php echo esc_url( admin_url( 'media-new.php' ) ); ?>" class="page-title-action"><?php echo esc_html__( 'Add Media File' ); ?></a>

src/wp-includes/capabilities.php

@@ -903,6 +903,8 @@ function map_meta_cap( $cap, $user_id, ...$args ) {
  * @param mixed  ...$args    Optional further parameters, typically starting with an object ID.
  * @return bool Whether the current user has the given capability. If `$capability` is a meta cap and `$object_id` is
  *              passed, whether the current user has the given meta capability for the given object.
+ *
+ * @phpstan-impure
  */
 function current_user_can( $capability, ...$args ) {
 	return user_can( wp_get_current_user(), $capability, ...$args );
@@ -929,6 +931,8 @@ function current_user_can( $capability, ...$args ) {
  * @param string $capability Capability name.
  * @param mixed  ...$args    Optional further parameters, typically starting with an object ID.
  * @return bool Whether the user has the given capability.
+ *
+ * @phpstan-impure
  */
 function current_user_can_for_site( $site_id, $capability, ...$args ) {
 	$switched = is_multisite() ? switch_to_blog( $site_id ) : false;