PHPBU Manual – Chapter 10. Logging

JSON

You can create a simple json logfile with PHPBU's json logger.

Example 10.1: json XML example

<!-- create a json logfile -->
<log type="json" target="backup/log.json"/>

Example 10.2: json JSON example

{"type": "json", "target": "backup/log.json"}

E-Mail

PHPBU uses SwiftMailer to send backup reports to one or more configured E-Mail-Addresses. If you just want to get notified if something went wrong, you can use the sendOnlyOnError option to not send any E-Mail on a successful backup.

Table 10.1. Mail-Options

Name	Value	Required	Default	Description
recipients	string	yes	-	List of emails separated by semicolon.
sendOnlyOnError	string	no	false	Sending reports only if something goes wrong.
subject	string	no	PHPBU Backup Report from $HOSTNAME	E-Mail subject of the backup report.
transport	string	yes	-	SwiftMailer Transport that's used to send the E-Mail (mail, sendmail, smtp, null).
sender.mail	string	phpbu@hostname	-	The sender E-Mail-Address
sender.name	string	no	OS-User	The sender name.
sender.name	string	no	OS-User	The sender name.
sendmail options
sendmail.path	string	no	-	Path to local sendmail binary.
sendmail.options	string	no	-	Sendmail options (e.g. -bs).
SMTP options
smtp.port	string	no	587	Port to use to connect to SMTP server.
smtp.host	string	no	-	SMTP hostname.
smtp.username	string	no	-	The SMTP login.
smtp.password	string	no	-	The SMTP password.
smtp.encryption	string	no	-	Type of encryption (e.g. ssl).

Example 10.3: mail XML example

<!-- use mail to keep up to date with you backup creation -->
<log type="mail">
  <option name="transport" value="mail"/>
  <option name="recipients" value="user.name@example.com"/>
</log>

Example 10.4: mail JSON example

{
  "type": "mail",
  "options": {
     "transport": "mail",
     "recipients": "user.name@example.com"
   }
}