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($path) { 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($path) { 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($path) { 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($path) { 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($path) { 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($path) { 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($path) { 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($path) { 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($original, $link) { return filesystem()->symlink($original, $link); } /** * Rename a file or directory * * @param string $from * @param string $to * @fails \Amp\Files\FilesystemException If the operation fails * @return \Amp\Promise */ function rename($from, $to) { return filesystem()->rename($from, $to); } /** * Delete a file * * @param string $path * @return \Amp\Promise */ function unlink($path) { return filesystem()->unlink($path); } /** * Create a director * * @param string $path * @param int $mode * @return \Amp\Promise */ function mkdir($path, $mode = 0644) { return filesystem()->mkdir($path, $mode); } /** * Delete a directory * * @param string $pat * @return \Amp\Promise */ function rmdir($path) { 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($path) { return filesystem()->scandir($path); } /** * chmod a file or directory * * @param string $path * @param int $mode * @return \Amp\Promise */ function chmod($path, $mode) { return filesystem()->chmod($path, $mode); } /** * chown a file or directory * * @param string $path * @param int $uid * @param int $gid * @return \Amp\Promise */ function chown($path, $uid, $gid) { 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 * @return \Amp\Promise */ function touch($path) { return filesystem()->touch($path); } /** * Buffer the specified file's contents * * @param string $path The file path from which to buffer contents * @return \Amp\Promise */ function get($path) { 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($path, $contents) { return filesystem()->put($path, $contents); }