Add a lot of docs

This commit is contained in:
Shikiryu 2016-07-01 21:59:39 +02:00
parent ffdf0b8476
commit dd2a6bd7d7
9 changed files with 83 additions and 10 deletions

View File

@ -157,6 +157,11 @@ class Email extends TransportAbstract
$this->encoding = $this->config['encoding'];
}
/**
* @param array $files
*
* @return $this
*/
private function setFiles($files = array())
{
if (is_array($files) && !empty($files)) {
@ -165,6 +170,11 @@ class Email extends TransportAbstract
return $this;
}
/**
* @param array $streams
*
* @return $this
*/
private function setStreams($streams = array())
{
if (is_array($streams) && !empty($streams)) {
@ -240,5 +250,3 @@ Content-Disposition: attachment; filename=" . $name . "
}
}
?>

View File

@ -51,6 +51,9 @@ class Ftp extends TransportAbstract
return $this;
}
/**
* @return bool
*/
public function send()
{
$sent = true;
@ -82,6 +85,8 @@ class Ftp extends TransportAbstract
if (!$sent) {
throw new \Exception('At least an upload didnt work.');
}
return $sent;
}
public function __destruct()

View File

@ -7,7 +7,7 @@ use Shikiryu\Backup\Backup\BackupAbstract;
class Folder extends TransportAbstract
{
/** @var string */
protected $folder;
public function __construct(BackupAbstract $backup, array $config = array())
@ -21,6 +21,7 @@ class Folder extends TransportAbstract
/**
* @return bool
*
* @throws \Exception
*/
public function send()

View File

@ -6,13 +6,17 @@ use phpseclib\Net\SFTP as LibSFTP;
class Sftp extends TransportAbstract
{
/** @var string */
protected $host;
/** @var int */
protected $port = 22;
/** @var string */
protected $login;
/** @var string */
protected $password;
/** @var string */
protected $folder;
/** @var LibSFTP */
private $connection;
/**
@ -32,6 +36,7 @@ class Sftp extends TransportAbstract
/**
* @return bool
*
* @throws \Exception
*/
public function send()

View File

@ -7,7 +7,9 @@ use Shikiryu\Backup\Backup\BackupAbstract;
abstract class TransportAbstract
{
/** @var BackupAbstract */
protected $backup;
/** @var array */
protected $config;
public function __construct(BackupAbstract $backup, array $config)

View File

@ -4,7 +4,7 @@ namespace Shikiryu\Backup\Backup;
abstract class BackupAbstract
{
/** @var array */
protected $options;
/** @var string[] */
protected $_filesToBackup = [];
@ -75,6 +75,9 @@ abstract class BackupAbstract
return true;
}
/**
* Initialize everything
*/
protected function init()
{
$this->preBuild();
@ -82,10 +85,24 @@ abstract class BackupAbstract
$this->postBuild();
$this->applyOptions();
}
/**
* Function that can be used to initialize the backup
*/
abstract protected function preBuild();
/**
* Function that can be used after the backup
*/
abstract protected function postBuild();
/**
* Mandatory function doing the backup
*/
abstract protected function build();
/**
* Check if the backup is valid
*
* @return bool
*/
abstract public function isValid();
/**
@ -204,7 +221,10 @@ abstract class BackupAbstract
/**
* @param $name
*
* @throws \Exception
*
* @SuppressWarnings("unused")
*/
protected function setOptionName($name)
{
@ -214,5 +234,3 @@ abstract class BackupAbstract
}
}
?>

View File

@ -21,6 +21,13 @@ class Files extends BackupAbstract
parent::__construct($config);
}
/**
* Check if the backup is valid
*
* @return bool
*
* @SuppressWarnings("unused")
*/
public function isValid()
{
$result = true;
@ -32,17 +39,26 @@ class Files extends BackupAbstract
}
return $result;
}
/**
* Function that can be used to initialize the backup
*/
protected function preBuild()
{
// TODO: Implement preBuild() method.
}
/**
* Function that can be used after the backup
*/
protected function postBuild()
{
// TODO: Implement postBuild() method.
}
/**
* Mandatory function doing the backup
*/
protected function build()
{
// TODO: Implement build() method.

View File

@ -18,16 +18,25 @@ class Folder extends BackupAbstract
// TODO: Implement isValid() method.
}
/**
* Function that can be used to initialize the backup
*/
protected function preBuild()
{
// TODO: Implement preBuild() method.
}
/**
* Function that can be used after the backup
*/
protected function postBuild()
{
// TODO: Implement postBuild() method.
}
/**
* Mandatory function doing the backup
*/
protected function build()
{
// TODO: Implement build() method.

View File

@ -100,16 +100,25 @@ class Mysql extends BackupAbstract
return !empty($this->_streamsToBackup);
}
/**
* Function that can be used to initialize the backup
*/
protected function preBuild()
{
$this->pdo = new \PDO('mysql:host='.$this->host.';dbname='.$this->database, $this->login, $this->pwd);
}
/**
* Function that can be used after the backup
*/
protected function postBuild()
{
// TODO: Implement postBuild() method.
}
/**
* Mandatory function doing the backup
*/
protected function build()
{
empty($this->tables) || $this->tables == '*' ? $this->everything() : $this->fromTables($this->tables);