namespace WPForms\Helpers;
use WP_Filesystem_Base; // phpcs:ignore WPForms.PHP.UseStatement.UnusedUseStatement
* Remove UTF-8 BOM signature if it presents.
* @param string $str String to process.
* @noinspection SpellCheckingInspection
public static function remove_utf8_bom( $str ): string {
if ( strpos( bin2hex( $str ), 'efbbbf' ) === 0 ) {
$str = substr( $str, 3 );
* Get current filesystem.
* @return WP_Filesystem_Base|null
public static function get_filesystem(): ?WP_Filesystem_Base {
static $is_filesystem_setup;
if ( $is_filesystem_setup ) {
// We have to start the buffer to prevent output
// when the file system is ssh/FTP but not configured.
if ( ! function_exists( 'request_filesystem_credentials' ) ) {
require_once ABSPATH . 'wp-admin/includes/file.php';
$url = home_url( esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ?? '' ) ) );
$credentials = request_filesystem_credentials( $url, '', false, false );
if ( $credentials === false || ! WP_Filesystem( $credentials ) ) {
'File system isn\'t configured.',
[ 'type' => [ 'error' ] ]
$is_filesystem_setup = true;
* @param string $file File path.
public static function get_contents( $file ) {
$filesystem = self::get_filesystem();
|| ! $filesystem->is_readable( $file )
|| $filesystem->is_dir( $file )
return $filesystem->size( $file ) > 0 ? $filesystem->get_contents( $file ) : '';
* @param string $file File path.
* @param string $content File content.
public static function put_contents( $file, $content ): bool {
$filesystem = self::get_filesystem();
return $filesystem->put_contents( $file, $content );
* Determine whether a file or directory exists.
* @param string $path Path to a file or directory.
* @return bool Whether $path exists or not.
public static function exists( string $path ): bool {
$filesystem = self::get_filesystem();
return $filesystem->exists( $path );
* @param string $source Path to the source file.
* @param string $destination Path to the destination file.
* @param bool $overwrite Optional. Whether to overwrite the destination file if it exists.
* @return bool True on success, false on failure.
public static function copy( string $source, string $destination, bool $overwrite = false ): bool {
$filesystem = self::get_filesystem();
return $filesystem->copy( $source, $destination, $overwrite );
* Move a file or files from source to destination.
* @param string $source Source file or glob pattern.
* @param string $destination Destination file or directory.
public static function move( string $source, string $destination ): bool {
$filesystem = self::get_filesystem();
foreach ( glob( $source ) as $filename ) {
$move = $filesystem->move( $filename, $destination . basename( $filename ), true );
* Delete a file or directory.
* @param string $file Path to the file or directory.
public static function delete( string $file ): bool {
$filesystem = self::get_filesystem();
return $filesystem->delete( $file, true );
* @param string $dir Path directory.
* @return bool True on success, false on failure. If the directory already exists, this method will return true.
public static function mkdir( string $dir ): bool {
$filesystem = self::get_filesystem();
if ( $filesystem->is_dir( $dir ) ) {
return $filesystem->mkdir( $dir );
* Gets details for files in a directory or a specific file.
* @param string $dir Path directory.
public static function dirlist( string $dir ) {
$filesystem = self::get_filesystem();
if ( ! $filesystem || ! $filesystem->is_dir( $dir ) ) {
return $filesystem->dirlist( $dir, false );
* Get the upload directory path.
public static function get_upload_dir(): string {
* Since wpforms_upload_dir() relies on hooks, and hooks can be added unpredictably,
* we need to cache the result of this method.
* Otherwise, it is a risk to save a cache file to one dir and try to get from another.
$wpforms_upload_dir = wpforms_upload_dir();
$wpforms_upload_path = ! empty( $wpforms_upload_dir['path'] )
? $wpforms_upload_dir['path']
: WP_CONTENT_DIR . '/uploads/wpforms';
$upload_dir = trailingslashit( wp_normalize_path( $wpforms_upload_path ) );
* Get the upload directory URL.
public static function get_upload_url(): string {
* Since wpforms_upload_dir() relies on hooks, and hooks can be added unpredictably,
* we need to cache the result of this method.
* Otherwise, it is a risk to save a cache file to one dir and try to get from another.
$wpforms_upload_dir = wpforms_upload_dir();
return ! empty( $wpforms_upload_dir['url'] )
? $wpforms_upload_dir['url']
: WP_CONTENT_URL . '/uploads/wpforms';
* Get the cache directory path.
public static function get_cache_dir(): string {
* Since wpforms_upload_dir() relies on hooks, and hooks can be added unpredictably,
* we need to cache the result of this method.
* Otherwise, it is a risk to save a cache file to one dir and try to get from another.
$cache_dir = self::get_upload_dir() . 'cache/';
* Check whether the file is already updated.
* @param string $filename Filename.
* @param string $cache_key Cache key.
public static function is_file_updated( string $filename, string $cache_key = '' ): bool {
$filename = wp_normalize_path( $filename );
$cache_key = $cache_key ? $cache_key : 'wpforms_' . $filename . '_file';
if ( ! is_file( $filename ) ) {
$cached_stat = Transient::get( $cache_key );
$stat = array_intersect_key(
if ( $cached_stat === $stat ) {
// phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged, WordPress.WP.AlternativeFunctions.unlink_unlink
* Save file updated stat.
* @param string $filename Filename.
* @param string $cache_key Cache key.
public static function save_file_updated_stat( string $filename, string $cache_key = '' ): void {
$filename = wp_normalize_path( $filename );
$cache_key = $cache_key ? $cache_key : 'wpforms_' . $filename . '_file';
clearstatcache( true, $filename );
$stat = array_intersect_key(
Transient::set( $cache_key, $stat );
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
