eventespresso / event-espresso-core

            if (! EEH_File::verify_is_writable($parent_folder)) {

                return false;

            }

            if (! $wp_filesystem->mkdir(EEH_File::convert_local_filepath_to_remote_filepath($folder))) {

                if (defined('WP_DEBUG') && WP_DEBUG) {

                    $msg = sprintf(__('"%s" could not be created.', 'event_espresso'), $folder);

                    $msg .= EEH_File::_permissions_error_for_unreadable_filepath($folder);

                    EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);

                }

                return false;

            }

            EEH_File::add_index_file($folder);

        } elseif (! EEH_File::verify_is_writable($folder)) {

            return false;

            if (! EEH_File::ensure_folder_exists_and_is_writable($parent_folder)) {

                return false;

            }

            if (! $wp_filesystem->touch(EEH_File::convert_local_filepath_to_remote_filepath($full_file_path))) {

                if (defined('WP_DEBUG') && WP_DEBUG) {

                    $msg = sprintf(__('The "%s" file could not be created.', 'event_espresso'), $full_file_path);

                    $msg .= EEH_File::_permissions_error_for_unreadable_filepath($full_file_path);

                    EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);

                }

                return false;

            }

        }

        if (! EEH_File::verify_is_writable($full_file_path, 'file')) {

            return false;

        $full_file_path = EEH_File::standardise_directory_separators($full_file_path);

        $file_type      = ! empty($file_type) ? rtrim($file_type, ' ') . ' ' : '';

        $folder         = EEH_File::remove_filename_from_filepath($full_file_path);

        if (! EEH_File::verify_is_writable($folder)) {

            if (defined('WP_DEBUG') && WP_DEBUG) {

                $msg =

                    sprintf(

                        esc_html__('The %1$sfile located at "%2$s" is not writable.', 'event_espresso'),

                        $file_type,

                        $full_file_path

                    );

                $msg .= EEH_File::_permissions_error_for_unreadable_filepath($full_file_path);

                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);

            }

            return false;

        }

        // load WP_Filesystem and set file permissions

        $wp_filesystem = EEH_File::_get_wp_filesystem($full_file_path);

        // write the file

            EEH_File::convert_local_filepath_to_remote_filepath($destination_file),

            $overwrite

        );

        if (! $copied) {

            if (defined('WP_DEBUG') && WP_DEBUG) {

                $msg = sprintf(

                    esc_html__(

                        'Attempted writing to file %1$s, but could not, probably because of permissions issues',

                        'event_espresso'

                    ),

                    $source_file

                );

                $msg .= EEH_File::_permissions_error_for_unreadable_filepath($source_file, 'f');

                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);

            }

            return false;

        }

        return true;

    }

    private static function validateFileForCopyOrMove(string $source_file): string

    {

        $full_source_path = EEH_File::standardise_directory_separators($source_file);

        if (! EEH_File::exists($full_source_path)) {

            if (defined('WP_DEBUG') && WP_DEBUG) {

                $msg =

                    sprintf(

                        esc_html__('The file located at "%2$s" is not readable or doesn\'t exist.', 'event_espresso'),

                        '',

                        $full_source_path

                    );

                $msg .= EEH_File::_permissions_error_for_unreadable_filepath($full_source_path);

                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);

            }

            return '';

        }

        return $full_source_path;

    }

        $full_dest_path = EEH_File::standardise_directory_separators($destination_file);

        $folder         = EEH_File::remove_filename_from_filepath($full_dest_path);

        EEH_File::ensure_folder_exists_and_is_writable($folder);

        if (! EEH_File::verify_is_writable($folder)) {

            if (defined('WP_DEBUG') && WP_DEBUG) {

                $msg = sprintf(

                    esc_html__('The file located at "%2$s" is not writable.', 'event_espresso'),

                    '',

                    $full_dest_path

                );

                $msg .= EEH_File::_permissions_error_for_unreadable_filepath($full_dest_path);

                EE_Error::add_error($msg, __FILE__, __FUNCTION__, __LINE__);

            }

            return '';

        }

        return $full_dest_path;

    }

}