*/ function open(string $path, string $mode): Promise { return filesystem()->open($path, $mode); } /** * Execute a file stat operation. * * If the requested path does not exist the resulting Promise will resolve to NULL. * The returned Promise whould never resolve as a failure. * * @param string $path An absolute file system path * @return \Amp\Promise */ function stat(string $path): Promise { return filesystem()->stat($path); } /** * Does the specified path exist? * * This function should never resolve as a failure -- only a successfull bool value * indicating the existence of the specified path. * * @param string $path An absolute file system path * @return \Amp\Promise */ function exists(string $path): Promise { return filesystem()->exists($path); } /** * Retrieve the size in bytes of the file at the specified path. * * If the path does not exist or is not a regular file this * function's returned Promise WILL resolve as a failure. * * @param string $path An absolute file system path * @fails \Amp\Files\FilesystemException If the path does not exist or is not a file * @return \Amp\Promise */ function size(string $path): Promise { return filesystem()->size($path); } /** * Does the specified path exist and is it a directory? * * If the path does not exist the returned Promise will resolve * to FALSE and will not reject with an error. * * @param string $path An absolute file system path * @return \Amp\Promise */ function isdir(string $path): Promise { return filesystem()->isdir($path); } /** * Does the specified path exist and is it a file? * * If the path does not exist the returned Promise will resolve * to FALSE and will not reject with an error. * * @param string $path An absolute file system path * @return \Amp\Promise */ function isfile(string $path): Promise { return filesystem()->isfile($path); } /** * Retrieve the path's last modification time as a unix timestamp. * * @param string $path An absolute file system path * @fails \Amp\Files\FilesystemException If the path does not exist * @return \Amp\Promise */ function mtime(string $path): Promise { return filesystem()->mtime($path); } /** * Retrieve the path's last access time as a unix timestamp. * * @param string $path An absolute file system path * @fails \Amp\Files\FilesystemException If the path does not exist * @return \Amp\Promise */ function atime($path) { return filesystem()->atime($path); } /** * Retrieve the path's creation time as a unix timestamp. * * @param string $path An absolute file system path * @fails \Amp\Files\FilesystemException If the path does not exist * @return \Amp\Promise */ function ctime(string $path): Promise { return filesystem()->ctime($path); } /** * Same as stat() except if the path is a link then the link's data is returned. * * If the requested path does not exist the resulting Promise will resolve to NULL. * The returned Promise whould never resolve as a failure. * * @param string $path An absolute file system path * @return \Amp\Promise */ function lstat(string $path): Promise { return filesystem()->lstat($path); } /** * Create a symlink $link pointing to the file/directory located at $original. * * @param string $original * @param string $link * @fails \Amp\Files\FilesystemException If the operation fails * @return \Amp\Promise */ function symlink(string $original, string $link): Promise { return filesystem()->symlink($original, $link); } /** * Create a hard link $link pointing to the file/directory located at $original. * * @param string $original * @param string $link * @fails \Amp\Files\FilesystemException If the operation fails * @return \Amp\Promise */ function link(string $original, string $link): Promise { return filesystem()->symlink($original, $link); } /** * Read the symlink at $path. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails * @return \Amp\Promise */ function readlink(string $path): Promise { return filesystem()->readlink($path); } /** * Rename a file or directory. * * @param string $from * @param string $to * @fails \Amp\Files\FilesystemException If the operation fails * @return \Amp\Promise */ function rename(string $from, string $to): Promise { return filesystem()->rename($from, $to); } /** * Delete a file. * * @param string $path * @return \Amp\Promise */ function unlink(string $path): Promise { return filesystem()->unlink($path); } /** * Create a director. * * @param string $path * @param int $mode * @param bool $recursive * @return \Amp\Promise */ function mkdir(string $path, int $mode = 0777, bool $recursive = false): Promise { return filesystem()->mkdir($path, $mode, $recursive); } /** * Delete a directory. * * @param string $path * @return \Amp\Promise */ function rmdir(string $path): Promise { return filesystem()->rmdir($path); } /** * Retrieve an array of files and directories inside the specified path. * * Dot entries are not included in the resulting array (i.e. "." and ".."). * * @param string $path * @return \Amp\Promise */ function scandir(string $path): Promise { return filesystem()->scandir($path); } /** * chmod a file or directory. * * @param string $path * @param int $mode * @return \Amp\Promise */ function chmod(string $path, int $mode): Promise { return filesystem()->chmod($path, $mode); } /** * chown a file or directory. * * @param string $path * @param int $uid -1 to ignore * @param int $gid -1 to ignore * @return \Amp\Promise */ function chown(string $path, int $uid, int $gid = -1): Promise { return filesystem()->chown($path, $uid, $gid); } /** * Update the access and modification time of the specified path. * * If the file does not exist it will be created automatically. * * @param string $path * @param int $time The touch time. If $time is not supplied, the current system time is used. * @param int $atime The access time. If $atime is not supplied, value passed to the $time parameter is used. * @return \Amp\Promise */ function touch(string $path, int $time = null, int $atime = null): Promise { return filesystem()->touch($path, $time, $atime); } /** * Buffer the specified file's contents. * * @param string $path The file path from which to buffer contents * @return \Amp\Promise */ function get(string $path): Promise { return filesystem()->get($path); } /** * Write the contents string to the specified path. * * @param string $path The file path to which to $contents should be written * @param string $contents The data to write to the specified $path * @return \Amp\Promise A promise resolving to the integer length written upon success */ function put(string $path, string $contents): Promise { return filesystem()->put($path, $contents); }