1
0
mirror of https://github.com/phpbb/phpbb.git synced 2025-08-01 14:30:32 +02:00

[ticket/16639] Improve phpdoc

PHPBB3-16639
This commit is contained in:
rubencm
2020-12-07 15:28:20 +01:00
parent 3a5a19bd99
commit 2b54e4c93e
2 changed files with 21 additions and 10 deletions

View File

@@ -13,6 +13,8 @@
namespace phpbb\storage\adapter;
use phpbb\storage\exception\exception;
interface adapter_interface
{
/**
@@ -28,7 +30,7 @@ interface adapter_interface
* @param string path The file to be written to.
* @param string content The data to write into the file.
*
* @throws \phpbb\storage\exception\exception When the file cannot be written
* @throws exception When the file cannot be written
*/
public function put_contents($path, $content);
@@ -37,7 +39,7 @@ interface adapter_interface
*
* @param string $path The file to read
*
* @throws \phpbb\storage\exception\exception When cannot read file contents
* @throws exception When cannot read file contents
*
* @return string Returns file contents
*
@@ -58,7 +60,7 @@ interface adapter_interface
*
* @param string $path file/directory to remove
*
* @throws \phpbb\storage\exception\exception When removal fails.
* @throws exception When removal fails.
*/
public function delete($path);
@@ -68,7 +70,7 @@ interface adapter_interface
* @param string $path_orig The original file/direcotry
* @param string $path_dest The target file/directory
*
* @throws \phpbb\storage\exception\exception When file/directory cannot be renamed
* @throws exception When file/directory cannot be renamed
*/
public function rename($path_orig, $path_dest);
@@ -78,7 +80,7 @@ interface adapter_interface
* @param string $path_orig The original filename
* @param string $path_dest The target filename
*
* @throws \phpbb\storage\exception\exception When the file cannot be copied
* @throws exception When the file cannot be copied
*/
public function copy($path_orig, $path_dest);
@@ -92,10 +94,10 @@ interface adapter_interface
*/
public function get_link($path);
/*
/**
* Get space available in bytes
*
* @throws \phpbb\storage\exception\exception When unable to retrieve available storage space
* @throws exception When unable to retrieve available storage space
*
* @return float Returns available space
*/