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
* 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);
@ -40,6 +41,8 @@ interface adapter_interface
*
* @throws \phpbb\storage\exception\exception When the file dont exists
* When cannot read file contents
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*
* @return string Returns file contents
*
*/
@ -50,6 +53,8 @@ interface adapter_interface
*
* @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
*/
public function exists($path);
@ -60,6 +65,7 @@ interface adapter_interface
* @param string $path file/directory to remove
*
* @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);
@ -71,6 +77,7 @@ interface adapter_interface
*
* @throws \phpbb\storage\exception\exception When target exists
* 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);
@ -82,6 +89,7 @@ interface adapter_interface
*
* @throws \phpbb\storage\exception\exception When target exists
* 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);
@ -91,6 +99,7 @@ interface adapter_interface
* @param string $path File to read
*
* @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
*/
@ -104,6 +113,7 @@ interface adapter_interface
*
* @throws \phpbb\storage\exception\exception When target file exists
* 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);
}

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

@ -68,6 +68,7 @@ class storage
*
* @throws \phpbb\storage\exception\exception When the file already exists
* 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)
{
@ -81,6 +82,8 @@ class storage
*
* @throws \phpbb\storage\exception\exception When the file dont exists
* When cannot read file contents
* @throws \phpbb\storage\exception\not_implemented When the adapter doesnt implement the method
*
* @return string Returns file contents
*
*/
@ -94,6 +97,8 @@ class storage
*
* @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
*/
public function exists($path)
@ -107,6 +112,7 @@ class storage
* @param string $path file/directory to remove
*
* @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)
{
@ -121,6 +127,7 @@ class storage
*
* @throws \phpbb\storage\exception\exception When target exists
* 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)
{
@ -135,6 +142,7 @@ class storage
*
* @throws \phpbb\storage\exception\exception When target exists
* 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)
{
@ -147,6 +155,7 @@ class storage
* @param string $path File to read
*
* @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
*/
@ -163,6 +172,7 @@ class storage
*
* @throws \phpbb\storage\exception\exception When target file exists
* 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)
{