makary/phpbb
1
0
Fork 0
mirror of https://github.com/phpbb/phpbb.git synced 2025-06-29 14:48:53 +00:00
Code Issues Projects Releases Packages Wiki Activity

[ticket/15305] Update PHPDoc

Browse source 
PHPBB3-15305
This commit is contained in:
Rubén Calvo 2017-08-07 12:05:58 +02:00
parent 8ffb14b305
commit dedd7648cd
2 changed files with 44 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
phpBB/phpbb/storage/adapter/adapter_interface.php
View file

@ -30,6 +30,7 @@ interface adapter_interface
* *
* @throws \phpbb\storage\exception\exception When the file already exists * @throws \phpbb\storage\exception\exception When the file already exists
* When the file cannot be written * When the file cannot be written
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function put_contents($path, $content); public function put_contents($path, $content);
@ -40,6 +41,8 @@ interface adapter_interface
* *
* @throws \phpbb\storage\exception\exception When the file dont exists * @throws \phpbb\storage\exception\exception When the file dont exists
* When cannot read file contents * When cannot read file contents
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*
* @return string Returns file contents * @return string Returns file contents
* *
*/ */
@ -50,6 +53,8 @@ interface adapter_interface
* *
* @param string $path file/directory to check * @param string $path file/directory to check
* *
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*
* @return bool Returns true if all files/directories exist, false otherwise * @return bool Returns true if all files/directories exist, false otherwise
*/ */
public function exists($path); public function exists($path);
@ -60,6 +65,7 @@ interface adapter_interface
* @param string $path file/directory to remove * @param string $path file/directory to remove
* *
* @throws \phpbb\storage\exception\exception When removal fails. * @throws \phpbb\storage\exception\exception When removal fails.
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function delete($path); public function delete($path);
@ -71,6 +77,7 @@ interface adapter_interface
* *
* @throws \phpbb\storage\exception\exception When target exists * @throws \phpbb\storage\exception\exception When target exists
* When file/directory cannot be renamed * When file/directory cannot be renamed
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function rename($path_orig, $path_dest); public function rename($path_orig, $path_dest);
@ -82,6 +89,7 @@ interface adapter_interface
* *
* @throws \phpbb\storage\exception\exception When target exists * @throws \phpbb\storage\exception\exception When target exists
* When the file cannot be copied * When the file cannot be copied
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function copy($path_orig, $path_dest); public function copy($path_orig, $path_dest);
@ -91,6 +99,7 @@ interface adapter_interface
* @param string $path File to read * @param string $path File to read
* *
* @throws \phpbb\storage\exception\exception When cannot open file * @throws \phpbb\storage\exception\exception When cannot open file
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
* *
* @return resource Returns a file pointer * @return resource Returns a file pointer
*/ */
@ -104,6 +113,7 @@ interface adapter_interface
* *
* @throws \phpbb\storage\exception\exception When target file exists * @throws \phpbb\storage\exception\exception When target file exists
* When target file cannot be created * When target file cannot be created
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function write_stream($path, $resource); public function write_stream($path, $resource);
} }

10
phpBB/phpbb/storage/storage.php
View file

@ -68,6 +68,7 @@ class storage
* *
* @throws \phpbb\storage\exception\exception When the file already exists * @throws \phpbb\storage\exception\exception When the file already exists
* When the file cannot be written * When the file cannot be written
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function put_contents($path, $content) public function put_contents($path, $content)
{ {
@ -81,6 +82,8 @@ class storage
* *
* @throws \phpbb\storage\exception\exception When the file dont exists * @throws \phpbb\storage\exception\exception When the file dont exists
* When cannot read file contents * When cannot read file contents
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*
* @return string Returns file contents * @return string Returns file contents
* *
*/ */
@ -94,6 +97,8 @@ class storage
* *
* @param string $path file/directory to check * @param string $path file/directory to check
* *
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*
* @return bool Returns true if all files/directories exist, false otherwise * @return bool Returns true if all files/directories exist, false otherwise
*/ */
public function exists($path) public function exists($path)
@ -107,6 +112,7 @@ class storage
* @param string $path file/directory to remove * @param string $path file/directory to remove
* *
* @throws \phpbb\storage\exception\exception When removal fails. * @throws \phpbb\storage\exception\exception When removal fails.
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function delete($path) public function delete($path)
{ {
@ -121,6 +127,7 @@ class storage
* *
* @throws \phpbb\storage\exception\exception When target exists * @throws \phpbb\storage\exception\exception When target exists
* When file/directory cannot be renamed * When file/directory cannot be renamed
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function rename($path_orig, $path_dest) public function rename($path_orig, $path_dest)
{ {
@ -135,6 +142,7 @@ class storage
* *
* @throws \phpbb\storage\exception\exception When target exists * @throws \phpbb\storage\exception\exception When target exists
* When the file cannot be copied * When the file cannot be copied
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function copy($path_orig, $path_dest) public function copy($path_orig, $path_dest)
{ {
@ -147,6 +155,7 @@ class storage
* @param string $path File to read * @param string $path File to read
* *
* @throws \phpbb\storage\exception\exception When cannot open file * @throws \phpbb\storage\exception\exception When cannot open file
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
* *
* @return resource Returns a file pointer * @return resource Returns a file pointer
*/ */
@ -163,6 +172,7 @@ class storage
* *
* @throws \phpbb\storage\exception\exception When target file exists * @throws \phpbb\storage\exception\exception When target file exists
* When target file cannot be created * When target file cannot be created
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*/ */
public function write_stream($path, $resource) public function write_stream($path, $resource)
{ {