Hey Brian,

I ran into an issue with the file driver when I was trying to use {exp:speedy:clear} tag.

I created this simple template to test it:

{if segment_3 == 'clear'}
{exp:speedy:clear items="local/quizzes/test_clear"}
cleared
{if:else}
{exp:speedy:fragment
    ttl="{global:ttl_1_week}"
    driver="{global:env_speedy_driver}"
}
Test the thing!
{/exp:speedy:fragment}
{/if}

Visiting /quizzes/test_clear generates the fragment properly, but when I add the ‘/clear’ segment, nothing happens and the fragment is not cleared.
I checked the mod code and traced it to the /speedy/Service/Drivers/FilesystemDriver.php file.

In the ‘deleteItem()’ function this was not working properly. I thought it was permissions, checked thoroughly, but couldn’t find any issues in my tests.

Original function code line ~33 in FilesystemDriver.php

public function deleteItem($key)
    {
        $file = $this->getFilename($key);

        try {
            return @unlink($file) || !file_exists($file);
        } catch (\Exception $exception) {
            // Fail silently. @ isn't enough for PHP 8.
        }

        return false;
    }

Here is my revised function which appears to be working for me in my test case, also lots of comments.

/**
     * Attempts to delete an item, which could be a file or a directory, based on the provided key.
     *
     * If the target is a file, it will try to delete the file directly.
     * If the target is a directory and has a known structure (e.g., containing an 'item' file),
     * it will attempt to delete the specific content first and then the directory.
     * If any deletion operation fails or encounters an exception, the function will return false.
     *
     * @param string $key The key to determine the item (file or directory) to be deleted.
     *
     * @return bool True if the deletion was successful, false otherwise.
     */
    public function deleteItem($key)
    {
        $file = $this->getFilename($key);  // Get the filename or directory path based on the key.


        if (is_file($file)) {
            // target is a file.
            try {
                // Attempt to delete the file. Return true if successful, false otherwise.
                return @unlink($file) || !file_exists($file);
            } catch (\Exception $exception) {
                // Fail silently if an exception occurs.
                // This catch block is necessary as the "@" suppression operator is not sufficient for PHP 8.
            }
        } elseif (is_dir($file)) {
            // target is a directory.
            try {
                // If there's a known structure within the directory (e.g., an 'item' file),
                // try to delete that specific content first.
                if (file_exists($file . '/item')) {
                    @unlink($file . '/item');
                }
                // Attempt to remove the directory. Return true if successful, false otherwise.
                // Note: rmdir can only delete empty directories.
                return @rmdir($file) || !file_exists($file);
            } catch (\Exception $exception) {
                // Fail silently if an exception occurs.
                // This catch block is necessary as the "@" suppression operator is not sufficient for PHP 8.
            }
        }

        // If neither file nor directory deletion was successful, return false.
        return false;
    }

I haven’t thoroughly tested other drives or static, but it seems like this helps solves the bug I ran into.

Let me know if you have any comments or questions.

Rowan