mirror of
https://github.com/phpbb/phpbb.git
synced 2025-04-07 17:33:32 +02:00
[ticket/15342] Update comments
PHPBB3-15342
This commit is contained in:
parent
af7e3662b8
commit
e40daea4bd
@ -23,7 +23,7 @@ interface adapter_interface
|
||||
public function configure($options);
|
||||
|
||||
/**
|
||||
* Dumps content into a file.
|
||||
* Dumps content into a file
|
||||
*
|
||||
* @param string path The file to be written to.
|
||||
* @param string content The data to write into the file.
|
||||
@ -47,7 +47,7 @@ interface adapter_interface
|
||||
public function get_contents($path);
|
||||
|
||||
/**
|
||||
* Checks the existence of files or directories.
|
||||
* Checks the existence of files or directories
|
||||
*
|
||||
* @param string $path file/directory to check
|
||||
*
|
||||
@ -56,7 +56,7 @@ interface adapter_interface
|
||||
public function exists($path);
|
||||
|
||||
/**
|
||||
* Removes files or directories.
|
||||
* Removes files or directories
|
||||
*
|
||||
* @param string $path file/directory to remove
|
||||
*
|
||||
@ -65,7 +65,7 @@ interface adapter_interface
|
||||
public function delete($path);
|
||||
|
||||
/**
|
||||
* Rename a file or a directory.
|
||||
* Rename a file or a directory
|
||||
*
|
||||
* @param string $path_orig The original file/direcotry
|
||||
* @param string $path_dest The target file/directory
|
||||
@ -76,7 +76,7 @@ interface adapter_interface
|
||||
public function rename($path_orig, $path_dest);
|
||||
|
||||
/**
|
||||
* Copies a file.
|
||||
* Copies a file
|
||||
*
|
||||
* @param string $path_orig The original filename
|
||||
* @param string $path_dest The target filename
|
||||
@ -87,7 +87,7 @@ interface adapter_interface
|
||||
public function copy($path_orig, $path_dest);
|
||||
|
||||
/**
|
||||
* Get direct link.
|
||||
* Get direct link
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
@ -97,7 +97,7 @@ interface adapter_interface
|
||||
public function get_link($path);
|
||||
|
||||
/*
|
||||
* Get space available in bytes.
|
||||
* Get space available in bytes
|
||||
*
|
||||
* @throws \phpbb\storage\exception\exception When unable to retrieve available storage space
|
||||
*
|
||||
|
@ -340,7 +340,7 @@ class local implements adapter_interface, stream_interface
|
||||
}
|
||||
|
||||
/**
|
||||
* Get file size.
|
||||
* Get file size
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
@ -361,7 +361,7 @@ class local implements adapter_interface, stream_interface
|
||||
}
|
||||
|
||||
/**
|
||||
* Get file mimetype.
|
||||
* Get file mimetype
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
@ -373,7 +373,7 @@ class local implements adapter_interface, stream_interface
|
||||
}
|
||||
|
||||
/**
|
||||
* Get image dimensions.
|
||||
* Get image dimensions
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
@ -394,7 +394,7 @@ class local implements adapter_interface, stream_interface
|
||||
}
|
||||
|
||||
/**
|
||||
* Get image width.
|
||||
* Get image width
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
@ -406,7 +406,7 @@ class local implements adapter_interface, stream_interface
|
||||
}
|
||||
|
||||
/**
|
||||
* Get image height.
|
||||
* Get image height
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
|
@ -20,11 +20,11 @@ class exception extends runtime_exception
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param string $message The Exception message to throw (must be a language variable).
|
||||
* @param string $filename The file that caused the error.
|
||||
* @param array $parameters The parameters to use with the language var.
|
||||
* @param \Exception $previous The previous runtime_exception used for the runtime_exception chaining.
|
||||
* @param integer $code The Exception code.
|
||||
* @param string $message The Exception message to throw (must be a language variable)
|
||||
* @param string $filename The file that caused the error
|
||||
* @param array $parameters The parameters to use with the language var
|
||||
* @param \Exception $previous The previous runtime_exception used for the runtime_exception chaining
|
||||
* @param integer $code The Exception code
|
||||
*/
|
||||
public function __construct($message = '', $filename = '', $parameters = [], \Exception $previous = null, $code = 0)
|
||||
{
|
||||
|
@ -34,7 +34,7 @@ class file_info
|
||||
* Stores the properties of $path file, so dont have to be consulted multiple times.
|
||||
* For example, when you need the width of an image, using getimagesize() you get
|
||||
* both dimensions, so you store both here, and when you get the height, you dont have
|
||||
* to call getimagesize() again.
|
||||
* to call getimagesize() again
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
@ -54,7 +54,7 @@ class file_info
|
||||
}
|
||||
|
||||
/**
|
||||
* Load propertys lazily.
|
||||
* Load propertys lazily
|
||||
*
|
||||
* @param string name The property name.
|
||||
*
|
||||
|
@ -16,28 +16,28 @@ namespace phpbb\storage\provider;
|
||||
interface provider_interface
|
||||
{
|
||||
/**
|
||||
* Gets adapter name.
|
||||
* Gets adapter name
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_name();
|
||||
|
||||
/**
|
||||
* Gets adapter class.
|
||||
* Gets adapter class
|
||||
*
|
||||
* @return \phpbb\storage\adapter\adapter_interface
|
||||
*/
|
||||
public function get_adapter_class();
|
||||
|
||||
/**
|
||||
* Gets adapter options.
|
||||
* Gets adapter options
|
||||
*
|
||||
* @return array Configuration keys
|
||||
*/
|
||||
public function get_options();
|
||||
|
||||
/**
|
||||
* Return true if the adapter is available.
|
||||
* Return true if the adapter is available
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
|
@ -96,7 +96,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Dumps content into a file.
|
||||
* Dumps content into a file
|
||||
*
|
||||
* @param string path The file to be written to.
|
||||
* @param string content The data to write into the file.
|
||||
@ -127,7 +127,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks the existence of files or directories.
|
||||
* Checks the existence of files or directories
|
||||
*
|
||||
* @param string $path file/directory to check
|
||||
*
|
||||
@ -139,7 +139,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Removes files or directories.
|
||||
* Removes files or directories
|
||||
*
|
||||
* @param string $path file/directory to remove
|
||||
*
|
||||
@ -152,7 +152,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Rename a file or a directory.
|
||||
* Rename a file or a directory
|
||||
*
|
||||
* @param string $path_orig The original file/direcotry
|
||||
* @param string $path_dest The target file/directory
|
||||
@ -167,7 +167,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Copies a file.
|
||||
* Copies a file
|
||||
*
|
||||
* @param string $path_orig The original filename
|
||||
* @param string $path_dest The target filename
|
||||
@ -182,7 +182,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Reads a file as a stream.
|
||||
* Reads a file as a stream
|
||||
*
|
||||
* @param string $path File to read
|
||||
*
|
||||
@ -211,8 +211,8 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Writes a new file using a stream.
|
||||
* You have to track file after use this method
|
||||
* Writes a new file using a stream
|
||||
* The file needs to be tracked after using this method
|
||||
*
|
||||
* @param string $path The target file
|
||||
* @param resource $resource The resource
|
||||
@ -235,7 +235,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Track file into database.
|
||||
* Track file in database
|
||||
*
|
||||
* @param string $path The target file
|
||||
* @param bool $update Update file size when already tracked
|
||||
@ -276,7 +276,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Untrack file.
|
||||
* Untrack file
|
||||
*
|
||||
* @param string $path The target file
|
||||
*/
|
||||
@ -296,7 +296,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Rename tracked file.
|
||||
* Rename tracked file
|
||||
*
|
||||
* @param string $path_orig The original file/direcotry
|
||||
* @param string $path_dest The target file/directory
|
||||
@ -311,7 +311,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Get file info.
|
||||
* Get file info
|
||||
*
|
||||
* @param string $path The file
|
||||
*
|
||||
@ -338,7 +338,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Get total storage size.
|
||||
* Get total storage size
|
||||
*
|
||||
* @return int Size in bytes
|
||||
*/
|
||||
@ -363,7 +363,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Get number of storage files.
|
||||
* Get number of storage files
|
||||
*
|
||||
* @return int Number of files
|
||||
*/
|
||||
@ -388,7 +388,7 @@ class storage
|
||||
}
|
||||
|
||||
/**
|
||||
* Get space available in bytes.
|
||||
* Get space available in bytes
|
||||
*
|
||||
* @throws \phpbb\storage\exception\exception When unable to retrieve available storage space
|
||||
*
|
||||
|
@ -16,7 +16,7 @@ namespace phpbb\storage;
|
||||
interface stream_interface
|
||||
{
|
||||
/**
|
||||
* Reads a file as a stream.
|
||||
* Reads a file as a stream
|
||||
*
|
||||
* @param string $path File to read
|
||||
*
|
||||
@ -27,7 +27,7 @@ interface stream_interface
|
||||
public function read_stream($path);
|
||||
|
||||
/**
|
||||
* Writes a new file using a stream.
|
||||
* Writes a new file using a stream
|
||||
*
|
||||
* @param string $path The target file
|
||||
* @param resource $resource The resource
|
||||
|
Loading…
x
Reference in New Issue
Block a user