MyXTSQLBackup

the simple way to backup MySQL databases. Automates the backup of MySQL databases.

The PHP scripts export your database (data and structures), compresses it into gzip format and emails it to you.

Download

Note will now only run once per hour by default; when testing please see “debugging” section

in the run.php file to ensure the backup will run more than just once per hour for testing purposes.

To upgrade an existing installation:

  1. BACKUP your original files.
  2. Follow the install details below (note: you can use your original run.php file, but you must add the new variables detailed below).You can use the details within your existing /myxtsqlbackup/run.php file to complete section 2 below.

To install:

  1. Unzip the files and upload to your server.

    You should upload the files and folders retaining the original names

  2. To configure your installation, add your details to the following variables within file /myxtsqlbackup/run.php:
    1. $db_server“localhost” is normally fine – if not then please contract your web host
    2. $dbset to your MySQL database name
    3. $mysql_usernameset to your MySQL username
    4. $mysql_passwordset to your MySQL password
    5. $to_emailaddress set to your email address to send backup files to
    6. $report_emailaddress set to your email address to send reports (not the actual backups)
    7. $from_emailaddress set to a different email address than above – else some spam detectors will bin the email
    8. $send_email_backup set to 1 to send the backup via email to the address above
    9. $send_email_report set to 1 to send the report via email to the address above
    10. $time_interval – interval between backups – stops malicious attempts at bringing down your server by making multiple requests to run the backup. By default this is set to one hour (3600 seconds), will only allow the backup to run once each hour. If DEBUG is set to 1 (see below) then $time_interval is also set to 1.
    11. DEBUG – SET this to 0 (zero) when you are happy it is working set to 1 to print output to screen, displays any errors, and shows report
    12. FTP – push the backup file to a remote server. PHP CURL is required and ensure the local and remote backups folders are writeable.

      The correct format is:

      $ftp_username=”your-ftp-username”;

      $ftp_password=”yoursecure-pass”;

      $ftp_server=”ftp.your–domain.com”;

      $ftp_path=”/public_html/secure-folder/”;

      Uncomment the variables, add the correct ftp details and it will copy the backup to the remote server.

      The remote folder you are uploading to should be secure and already exist. Ensure your backups are not uploaded to a folder open for public access.

    13. $save_backup_zip_file_to_server If you set the variable $save_backup_zip_file_to_server to 1 then the backup files will be saved in the folder: /myxtsqlbackup/backups/(ensure you chmod [777] the backups folder for write access to allow for file creation)——It is likely that the settings below will only be used by the more advanced user—–
    14. $newlinefix for email attachment issue (the backup file is included within email body). If your backup emails arrive in your mailbox with no attachment but loads of strange characters within the body of the email try setting $newline to: “\r\n”
    15. $table_select – leave commented out if you need to backup the whole database. If you uncomment the variable $table_select then only the specified named tables will be selected for backup.  The table names must be correct else the backup will not select any tables.

      The correct format is:

      $table_select[0]=”MyFirstTableName”;

      $table_select[1]=”MySecondTableName”;

      $table_select[2]=”MyThirdTableName”;

      $table_select[x]=”MylastTableName”;

      You can add any number of table names.

      If you specify distinct tables names, as above, then ONLY those tables will be included in your backup.

    16. $table_exclude – leave commented out if you need to backup the whole database. If you uncomment the variable $table_exclude then the specified named tables will be excluded from the backup.

      The correct format is:

      $table_exclude[0]=”FirstTableName”;

      $table_exclude[1]=”SecondTableName”;

      $table_exclude[2]=”ThirdTableName”;

      $table_exclude[x]=”lastTableName”;

      You can add any number of table names.

      Should not be used in conjunction with $table_select.

    17. $limit_from record number to start from, use this if you have a large table to backup.  Should be used with a single table setting like:$table_select[0]=”MyFirstTableName”;
    18. $limit_tototal rows to exportThe two variables above are used in the SQL query:SELECT * FROM tablename LIMIT $limit_from , $limit_to These variables have been added to allow for the backup of just a section of a very large table with millions of records.

    TIP: If you need to backup several different databases or tables at different backup times you can copy the run.php file, and rename it appropriately.

  3. To run the backup:

    Enter in your address bar the url:

    http://www.[Your–domain].com/myxtsqlbackup/run.php

    (runs silently [no output] when DEBUG is set to zero, unless there are errors, OHhh no.)

    If you have entered the above details correctly this will export your database, compress it into gzip format and email it to you.

    When run correctly for the first time it will create a new table within your database called: MyXTSQLBackup, which contains a single record to monitor the last time it was run (used to stop abuse), and MyXTSQLBackup_log which holds the reports.

Common errors or issues:

If you experience problems then the most common error is the script is timing-out; usually the error messages are:

Fatal error: Maximum execution time of 50 seconds exceeded in, or

Fatal error: allowed memory size of bytes exhausted (tried to allocate bytes), or

Internal Server Error, this is an error with your script, or other similar message

Then you need to either:

  • Specify specific table names to backup to reduce the time taken to create the backup, see table_select above, or
  • Set the upper and lower export limits see limit_to and limit_from above.
    • If you make these settings:
      • $limit_to=1000; //total rows to export
      • $limit_from=0; //record number to start fromThis will backup all records from the first row and upto 1000 rows.
    • If you make these settings:
      • $limit_to=1000; //total rows to export
      • $limit_from=1001; //record number to start fromThis will backup all records from row 1001 and upto 1000 rows.If you copy the run.php file, and rename it appropriately then you can run the several backups of the data starting at different rows.

I do hope you find it useful, and if you use it let me know.

Facebook Comments

Leave a Reply

Your email address will not be published. Required fields are marked *