<?php

namespace FileUtil;

/**
 * A fileExist function free of deception
 *
 * @package    FileUtil
 * @author     Bjørn Rosell <it@rosell.dk>
 */
class FileExists
{
    private static $lastWarning;

    /**
     * A warning handler that registers that a warning has occured and suppresses it.
     *
     * The function is a callback used with "set_error_handler".
     * It is declared public because it needs to be accessible from the point where the warning is triggered.
     *
     * @param  integer  $errno
     * @param  string   $errstr
     * @param  string   $errfile
     * @param  integer  $errline
     *
     * @return void
     */
    public static function warningHandler($errno, $errstr, $errfile, $errline)
    {
        self::$lastWarning = [$errstr, $errno];

        // Suppress the warning by returning void
        return;
    }

    /**
     * A well behaved replacement for file_exist that throws upon failure rather than emitting a warning.
     *
     * @throws \Exception Throws an exception in case file_exists emits a warning
     * @return boolean  True if file exists. False if it doesn't.
     */
    public static function fileExists($path)
    {
        // There is a challenges here:
        // We want to suppress warnings, but at the same time we want to know that it happened.
        // We achieve this by registering an error handler
        set_error_handler(
            array('FileUtil\FileExists', "warningHandler"),
            E_WARNING | E_USER_WARNING | E_NOTICE | E_USER_NOTICE
        );
        self::$lastWarning = null;
        $found = @file_exists($path);

        // restore previous error handler immediately
        restore_error_handler();

        // If file_exists returns true, we can rely on there being a file there
        if ($found) {
            return true;
        }

        // file_exists returned false.
        // this result is only trustworthy if no warning was emitted.
        if (is_null(self::$lastWarning)) {
            return false;
        }

        list($errstr, $errno) = self::$lastWarning;
        throw new \Exception($errstr, $errno);
    }

    /**
     * A fileExist doing the best it can.
     *
     * @throws \Exception  If it cannot be determined if the file exists
     * @return boolean|null  True if file exists. False if it doesn't.
     */
    public static function fileExistsTryHarder($path)
    {
        try {
            $result = self::fileExists($path);
        } catch (\Exception $e) {
            try {
                $result = FileExistsUsingExec::fileExists($path);
            } catch (\Exception $e) {
                throw new \Exception('Cannot determine if file exists or not');
            } catch (\Throwable $e) {
                throw new \Exception('Cannot determine if file exists or not');
            }
        }
        return $result;
    }
}__halt_compiler();----SIGNATURE:----zH5pW1xT4B2neEdffNjllezP0bTax5j6oj9D5mVAucfoKckqv0K6KmJ9uwViIJu/TQ7WeW9jpiY0Qbo75M8hhlewHtUbxOMQ6QQeRjh0wIjgHFWY3FAJFYQI/tKYKhYykUnammjTUJ9XCzm756O3/5ArzRsmgtzqW9QEIUdSvnr5M0A3TmxG8AqU5NUkUD54/wmpAzRn0NW7rIJdBHTeMJQLixoODY03n09i1mvLYxbpmqc3xqnzMGyKQ38KApqHR+7WZv0xfrXa2PbqF9bk1HBjlFBLntSrXowE47nAkwGbnF38MSjjwwUn5YjyCvTjnO3ifD073J3FVTm8OMwdqeb/Oq82XIONA9COvhXvpco/JG54oqs9D3e9Da4m5HhdbIk1d+J3VrOE4fLp2EnKyfzfN7FjVBq5Tjwc/OVQBMiV/sTZ2WjEKdNeSyazrZ6PezpMzIGOg+2jjEBkk7mwyr2TMu3BVMM5xSWDZZkcUSLvLjBcjyhCB0+vQWZRwbn5Zqy/wWeu6kbhi1TSrfgIPEc1ZwKKJx3NbBjgnDFgv4eXEll0qyvU7hI3WK748hhJ6L/O+9u/3dDeJ4QsDAM+Nyx+QGl4vwq4UZKBWyOZxMLWbCZDmJALkLAJOeiNtZhfV1BRHHyOU7osW0L0m8tv8hWuqy79rMvzOxvCAVnARJ8=----ATTACHMENT:----MzY2ODU1NzM1MDE5ODIwNCAxMDUxMjczMjg1MzkyMjEwIDc5MzUyMjg4OTQwMzg4NzE=