[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/includes/ -> class-wp-filesystem-base.php (summary)

Base WordPress Filesystem

File Size: 864 lines (24 kb)
Included or required: 1 time
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

WP_Filesystem_Base:: (39 methods):
  abspath()
  wp_content_dir()
  wp_plugins_dir()
  wp_themes_dir()
  wp_lang_dir()
  find_base_dir()
  get_base_dir()
  find_folder()
  search_for_folder()
  gethchmod()
  getchmod()
  getnumchmodfromh()
  is_binary()
  chown()
  connect()
  get_contents()
  get_contents_array()
  put_contents()
  cwd()
  chdir()
  chgrp()
  chmod()
  owner()
  group()
  copy()
  move()
  delete()
  exists()
  is_file()
  is_dir()
  is_readable()
  is_writable()
  atime()
  mtime()
  size()
  touch()
  mkdir()
  rmdir()
  dirlist()


Class: WP_Filesystem_Base  - X-Ref

Base WordPress Filesystem class which Filesystem implementations extend.

abspath()   X-Ref
Returns the path on the remote filesystem of ABSPATH.

return: string The location of the remote path.

wp_content_dir()   X-Ref
Returns the path on the remote filesystem of WP_CONTENT_DIR.

return: string The location of the remote path.

wp_plugins_dir()   X-Ref
Returns the path on the remote filesystem of WP_PLUGIN_DIR.

return: string The location of the remote path.

wp_themes_dir( $theme = false )   X-Ref
Returns the path on the remote filesystem of the Themes Directory.

param: string|false $theme Optional. The theme stylesheet or template for the directory.
return: string The location of the remote path.

wp_lang_dir()   X-Ref
Returns the path on the remote filesystem of WP_LANG_DIR.

return: string The location of the remote path.

find_base_dir( $base = '.', $verbose = false )   X-Ref
Locates a folder on the remote filesystem.

param: string $base    Optional. The folder to start searching from. Default '.'.
param: bool   $verbose Optional. True to display debug information. Default false.
return: string The location of the remote path.

get_base_dir( $base = '.', $verbose = false )   X-Ref
Locates a folder on the remote filesystem.

param: string $base    Optional. The folder to start searching from. Default '.'.
param: bool   $verbose Optional. True to display debug information. Default false.
return: string The location of the remote path.

find_folder( $folder )   X-Ref
Locates a folder on the remote filesystem.

Assumes that on Windows systems, Stripping off the Drive
letter is OK Sanitizes \\ to / in Windows filepaths.

param: string $folder the folder to locate.
return: string|false The location of the remote path, false on failure.

search_for_folder( $folder, $base = '.', $loop = false )   X-Ref
Locates a folder on the remote filesystem.

Expects Windows sanitized path.

param: string $folder The folder to locate.
param: string $base   The folder to start searching from.
param: bool   $loop   If the function has recursed. Internal use only.
return: string|false The location of the remote path, false to cease looping.

gethchmod( $file )   X-Ref
Returns the *nix-style file permissions for a file.

From the PHP documentation page for fileperms().

param: string $file String filename.
return: string The *nix-style representation of permissions.

getchmod( $file )   X-Ref
Gets the permissions of the specified file or filepath in their octal format.

param: string $file Path to the file.
return: string Mode of the file (the last 3 digits).

getnumchmodfromh( $mode )   X-Ref
Converts *nix-style file permissions to an octal number.

Converts '-rw-r--r--' to 0644
From "info at rvgate dot nl"'s comment on the PHP documentation for chmod()

param: string $mode string The *nix-style file permissions.
return: string Octal representation of permissions.

is_binary( $text )   X-Ref
Determines if the string provided contains binary characters.

param: string $text String to test against.
return: bool True if string is binary, false otherwise.

chown( $file, $owner, $recursive = false )   X-Ref
Changes the owner of a file or directory.

Default behavior is to do nothing, override this in your subclass, if desired.

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.
return: bool True on success, false on failure.

connect()   X-Ref
Connects filesystem.

return: bool True on success, false on failure (always true for WP_Filesystem_Direct).

get_contents( $file )   X-Ref
Reads entire file into a string.

param: string $file Name of the file to read.
return: string|false Read data on success, false on failure.

get_contents_array( $file )   X-Ref
Reads entire file into an array.

param: string $file Path to the file.
return: array|false File contents in an array on success, false on failure.

put_contents( $file, $contents, $mode = false )   X-Ref
Writes a string to a file.

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.
return: bool True on success, false on failure.

cwd()   X-Ref
Gets the current working directory.

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

chdir( $dir )   X-Ref
Changes current directory.

param: string $dir The new current directory.
return: bool True on success, false on failure.

chgrp( $file, $group, $recursive = false )   X-Ref
Changes the file group.

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.
return: bool True on success, false on failure.

chmod( $file, $mode = false, $recursive = false )   X-Ref
Changes filesystem permissions.

param: string    $file      Path to the file.
param: int|false $mode      Optional. The permissions as octal number, usually 0644 for files,
param: bool      $recursive Optional. If set to true, changes file permissions recursively.
return: bool True on success, false on failure.

owner( $file )   X-Ref
Gets the file owner.

param: string $file Path to the file.
return: string|false Username of the owner on success, false on failure.

group( $file )   X-Ref
Gets the file's group.

param: string $file Path to the file.
return: string|false The group on success, false on failure.

copy( $source, $destination, $overwrite = false, $mode = false )   X-Ref
Copies a file.

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.
param: int|false $mode        Optional. The permissions as octal number, usually 0644 for files,
return: bool True on success, false on failure.

move( $source, $destination, $overwrite = false )   X-Ref
Moves a file.

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.
return: bool True on success, false on failure.

delete( $file, $recursive = false, $type = false )   X-Ref
Deletes a file or directory.

param: string       $file      Path to the file or directory.
param: bool         $recursive Optional. If set to true, deletes files and folders recursively.
param: string|false $type      Type of resource. 'f' for file, 'd' for directory.
return: bool True on success, false on failure.

exists( $path )   X-Ref
Checks if a file or directory exists.

param: string $path Path to file or directory.
return: bool Whether $path exists or not.

is_file( $file )   X-Ref
Checks if resource is a file.

param: string $file File path.
return: bool Whether $file is a file.

is_dir( $path )   X-Ref
Checks if resource is a directory.

param: string $path Directory path.
return: bool Whether $path is a directory.

is_readable( $file )   X-Ref
Checks if a file is readable.

param: string $file Path to file.
return: bool Whether $file is readable.

is_writable( $path )   X-Ref
Checks if a file or directory is writable.

param: string $path Path to file or directory.
return: bool Whether $path is writable.

atime( $file )   X-Ref
Gets the file's last access time.

param: string $file Path to file.
return: int|false Unix timestamp representing last access time, false on failure.

mtime( $file )   X-Ref
Gets the file modification time.

param: string $file Path to file.
return: int|false Unix timestamp representing modification time, false on failure.

size( $file )   X-Ref
Gets the file size (in bytes).

param: string $file Path to file.
return: int|false Size of the file in bytes on success, false on failure.

touch( $file, $time = 0, $atime = 0 )   X-Ref
Sets the access and modification times of a file.

Note: If $file doesn't exist, it will be created.

param: string $file  Path to file.
param: int    $time  Optional. Modified time to set for file.
param: int    $atime Optional. Access time to set for file.
return: bool True on success, false on failure.

mkdir( $path, $chmod = false, $chown = false, $chgrp = false )   X-Ref
Creates a directory.

param: string           $path  Path for new directory.
param: int|false        $chmod Optional. The permissions as octal number (or false to skip chmod).
param: string|int|false $chown Optional. A user name or number (or false to skip chown).
param: string|int|false $chgrp Optional. A group name or number (or false to skip chgrp).
return: bool True on success, false on failure.

rmdir( $path, $recursive = false )   X-Ref
Deletes a directory.

param: string $path      Path to directory.
param: bool   $recursive Optional. Whether to recursively remove files/directories.
return: bool True on success, false on failure.

dirlist( $path, $include_hidden = true, $recursive = false )   X-Ref
Gets details for files in a directory or a specific file.

param: string $path           Path to directory or file.
param: bool   $include_hidden Optional. Whether to include details of hidden ("." prefixed) files.
param: bool   $recursive      Optional. Whether to recursively include file details in nested directories.
return: array|false {



Generated : Thu Nov 21 08:20:01 2024 Cross-referenced by PHPXref