<?php

/**

 * WordPress Direct Filesystem.

 *

 * @package WordPress

 * @subpackage Filesystem

 */

/**

 * WordPress Filesystem Class for direct PHP file and folder manipulation.

 *

 * @since 2.5.0

 *

 * @see WP_Filesystem_Base

 */

class WP_Filesystem_Direct extends WP_Filesystem_Base {

	/**

	 * Constructor.

	 *

	 * @since 2.5.0

	 *

	 * @param mixed $arg Not used.

	 */

	public function __construct( $arg ) {

		$this->method = 'direct';

		$this->errors = new WP_Error();

	}

	/**

	 * Reads entire file into a string.

	 *

	 * @since 2.5.0

	 *

	 * @param string $file Name of the file to read.

	 * @return string|false Read data on success, false on failure.

	 */

	public function get_contents( $file ) {

		return @file_get_contents( $file );

	}

	/**

	 * Reads entire file into an array.

	 *

	 * @since 2.5.0

	 *

	 * @param string $file Path to the file.

	 * @return array|false File contents in an array on success, false on failure.

	 */

	public function get_contents_array( $file ) {

		return @file( $file );

	}

	/**

	 * Writes a string to a file.

	 *

	 * @since 2.5.0

	 *

	 * @param string    $file     Remote path to the file where to write the data.

	 * @param string    $contents The data to write.

	 * @param int|false $mode     Optional. The file permissions as octal number, usually 0644.

	 *                            Default false.

	 * @return bool True on success, false on failure.

	 */

	public function put_contents( $file, $contents, $mode = false ) {

		$fp = @fopen( $file, 'wb' );

		if ( ! $fp ) {

			return false;

		}

		mbstring_binary_safe_encoding();

		$data_length = strlen( $contents );

		$bytes_written = fwrite( $fp, $contents );

		reset_mbstring_encoding();

		fclose( $fp );

		if ( $data_length !== $bytes_written ) {

			return false;

		}

		$this->chmod( $file, $mode );

		return true;

	}

	/**

	 * Gets the current working directory.

	 *

	 * @since 2.5.0

	 *

	 * @return string|false The current working directory on success, false on failure.

	 */

	public function cwd() {

		return getcwd();

	}

	/**

	 * Changes current directory.

	 *

	 * @since 2.5.0

	 *

	 * @param string $dir The new current directory.

	 * @return bool True on success, false on failure.

	 */

	public function chdir( $dir ) {

		return @chdir( $dir );

	}

	/**

	 * Changes the file group.

	 *

	 * @since 2.5.0

	 *

	 * @param string     $file      Path to the file.

	 * @param string|int $group     A group name or number.

	 * @param bool       $recursive Optional. If set to true, changes file group recursively.

	 *                              Default false.

	 * @return bool True on success, false on failure.

	 */

	public function chgrp( $file, $group, $recursive = false ) {

		if ( ! $this->exists( $file ) ) {

			return false;

		}

		if ( ! $recursive ) {

			return chgrp( $file, $group );

		}

		if ( ! $this->is_dir( $file ) ) {

			return chgrp( $file, $group );

		}

		// Is a directory, and we want recursive.

		$file     = trailingslashit( $file );

		$filelist = $this->dirlist( $file );

		foreach ( $filelist as $filename ) {

			$this->chgrp( $file . $filename, $group, $recursive );

		}

		return true;

	}

	/**

	 * Changes filesystem permissions.

	 *

	 * @since 2.5.0

	 *

	 * @param string    $file      Path to the file.

	 * @param int|false $mode      Optional. The permissions as octal number, usually 0644 for files,

	 *                             0755 for directories. Default false.

	 * @param bool      $recursive Optional. If set to true, changes file permissions recursively.

	 *                             Default false.

	 * @return bool True on success, false on failure.

	 */

	public function chmod( $file, $mode = false, $recursive = false ) {

		if ( ! $mode ) {

			if ( $this->is_file( $file ) ) {

				$mode = FS_CHMOD_FILE;

			} elseif ( $this->is_dir( $file ) ) {

				$mode = FS_CHMOD_DIR;

			} else {

				return false;

			}

		}

		if ( ! $recursive || ! $this->is_dir( $file ) ) {

			return chmod( $file, $mode );

		}

		// Is a directory, and we want recursive.

		$file     = trailingslashit( $file );

		$filelist = $this->dirlist( $file );

		foreach ( (array) $filelist as $filename => $filemeta ) {

			$this->chmod( $file . $filename, $mode, $recursive );

		}

		return true;

	}

	/**

	 * Changes the owner of a file or directory.

	 *

	 * @since 2.5.0

	 *

	 * @param string     $file      Path to the file or directory.

	 * @param string|int $owner     A user name or number.

	 * @param bool       $recursive Optional. If set to true, changes file owner recursively.

	 *                              Default false.

	 * @return bool True on success, false on failure.

	 */

	public function chown( $file, $owner, $recursive = false ) {

		if ( ! $this->exists( $file ) ) {

			return false;

		}

		if ( ! $recursive ) {

			return chown( $file, $owner );

		}

		if ( ! $this->is_dir( $file ) ) {

			return chown( $file, $owner );

		}

		// Is a directory, and we want recursive.

		$filelist = $this->dirlist( $file );

		foreach ( $filelist as $filename ) {

			$this->chown( $file . '/' . $filename, $owner, $recursive );

		}

		return true;

	}

	/**

	 * Gets the file owner.

	 *

	 * @since 2.5.0

	 *

	 * @param string $file Path to the file.

	 * @return string|false Username of the owner on success, false on failure.

	 */

	public function owner( $file ) {

		$owneruid = @fileowner( $file );

		if ( ! $owneruid ) {

			return false;

		}

		if ( ! function_exists( 'posix_getpwuid' ) ) {

			return $owneruid;

		}

		$ownerarray = posix_getpwuid( $owneruid );

		if ( ! $ownerarray ) {

			return false;

		}

		return $ownerarray['name'];

	}

	/**

	 * Gets the permissions of the specified file or filepath in their octal format.

	 *

	 * FIXME does not handle errors in fileperms()

	 *

	 * @since 2.5.0

	 *

	 * @param string $file Path to the file.

	 * @return string Mode of the file (the last 3 digits).

	 */

	public function getchmod( $file ) {

		return substr( decoct( @fileperms( $file ) ), -3 );

	}

	/**

	 * Gets the file's group.

	 *

	 * @since 2.5.0

	 *

	 * @param string $file Path to the file.

	 * @return string|false The group on success, false on failure.

	 */

	public function group( $file ) {

		$gid = @filegroup( $file );

		if ( ! $gid ) {

			return false;

		}

		if ( ! function_exists( 'posix_getgrgid' ) ) {

			return $gid;

		}

		$grouparray = posix_getgrgid( $gid );

		if ( ! $grouparray ) {

			return false;

		}

		return $grouparray['name'];

	}

	/**

	 * Copies a file.

	 *

	 * @since 2.5.0

	 *

	 * @param string    $source      Path to the source file.

	 * @param string    $destination Path to the destination file.

	 * @param bool      $overwrite   Optional. Whether to overwrite the destination file if it exists.

	 *                               Default false.

	 * @param int|false $mode        Optional. The permissions as octal number, usually 0644 for files,

	 *                               0755 for dirs. Default false.

	 * @return bool True on success, false on failure.

	 */

	public function copy( $source, $destination, $overwrite = false, $mode = false ) {

		if ( ! $overwrite && $this->exists( $destination ) ) {

			return false;

		}

		$rtval = copy( $source, $destination );

		if ( $mode ) {

			$this->chmod( $destination, $mode );

		}

		return $rtval;

	}

	/**

	 *

	 * @since 2.5.0

	 *

	 * @param string $source      Path to the source file.

	 * @param string $destination Path to the destination file.

	 * @param bool   $overwrite   Optional. Whether to overwrite the destination file if it exists.

	 *                            Default false.

	 * @return bool True on success, false on failure.

	 */

	public function move( $source, $destination, $overwrite = false ) {

		if ( ! $overwrite && $this->exists( $destination ) ) {

			return false;

		}

		// Try using rename first. if that fails (for example, source is read only) try copy.

		if ( @rename( $source, $destination ) ) {

			return true;

		}

			$this->delete( $source );

			return true;

		} else {

			return false;

		}

	}

	/**

	 * Deletes a file or directory.

	 *

	 * @since 2.5.0

	 *

	 * @param string       $file      Path to the file or directory.

	 * @param bool         $recursive Optional. If set to true, deletes files and folders recursively.

	 *                                Default false.

	 * @param string|false $type      Type of resource. 'f' for file, 'd' for directory.

	 *                                Default false.

	 * @return bool True on success, false on failure.

	 */

	public function delete( $file, $recursive = false, $type = false ) {

		if ( empty( $file ) ) {

			// Some filesystems report this as /, which can cause non-expected recursive deletion of all files in the filesystem.

			return false;

		}

		$file = str_replace( '\\', '/', $file ); // For Win32, occasional problems deleting files otherwise.

		if ( 'f' === $type || $this->is_file( $file ) ) {

			return @unlink( $file );

		}

		if ( ! $recursive && $this->is_dir( $file ) ) {

			return @rmdir( $file );

		}

		// At this point it's a folder, and we're in recursive mode.

		$file     = trailingslashit( $file );

		$filelist = $this->dirlist( $file, true );

		$retval = true;

		if ( is_array( $filelist ) ) {

			foreach ( $filelist as $filename => $fileinfo ) {

				if ( ! $this->delete( $file . $filename, $recursive, $fileinfo['type'] ) ) {

					$retval = false;

				}

			}

		}

		if ( file_exists( $file ) && ! @rmdir( $file ) ) {

			$retval = false;

		}

		return $retval;

	}

	/**

	 * Checks if a file or directory exists.

	 *

	 * @since 2.5.0

	 *

	 */