1. <?php
  3. /**
  4. * Backup files for maintenance tasks with fallback logic.
  5. *
  6. * @param string $sourceDir The directory to backup.
  7. * @param string $backupDir The directory to store the backup.
  8. * @param int $numBackups The number of backups to keep.
  9. * @return bool True on success, false on failure.
  10. */
  11. function backupFiles(string $sourceDir, string $backupDir, int $numBackups): bool
  12. {
  13. // Ensure source directory exists
  14. if (!is_dir($sourceDir)) {
  15. error_log("Source directory '$sourceDir' does not exist.");
  16. return false;
  17. }
  19. // Ensure backup directory exists, create if not
  20. if (!is_dir($backupDir)) {
  21. if (!mkdir($backupDir, 0777, true)) {
  22. error_log("Failed to create backup directory '$backupDir'.");
  23. return false;
  24. }
  25. }
  27. $timestamp = date('Y-m-d_H-i-s');
  28. $backupFilename = $backupDir . '/' . $timestamp;
  30. // Copy files to backup directory
  31. if (!copyDir($sourceDir, $backupFilename, true)) { // recursive copy
  32. error_log("Failed to copy files from '$sourceDir' to '$backupFilename'.");
  33. return false;
  34. }
  36. // Cleanup old backups
  37. cleanupOldBackups($backupDir, $numBackups);
  39. return true;
  41. }
  43. /**
  44. * Copies directory recursively.
  45. *
  46. * @param string $source The source directory.
  47. * @param string $destination The destination directory.
  48. * @param bool $recursive Whether to copy recursively.
  49. * @return bool True on success, false on failure.
  50. */
  51. function copyDir(string $source, string $destination, bool $recursive = true): bool {
  52. if (is_dir($source)) {
  53. if (!copyDirRecursive($source, $destination)) {
  54. return false;
  55. }
  56. } else {
  57. copyFile($source, $destination);
  58. }
  59. return true;
  60. }
  62. /**
  63. * Copies directory recursively.
  64. *
  65. * @param string $source The source directory.
  66. * @param string $destination The destination directory.
  67. * @return bool True on success, false on failure.
  68. */
  69. function copyDirRecursive(string $source, string $destination): bool {
  70. $items = scandir($source);
  71. if ($items === false) {
  72. error_log("Failed to read directory '$source'.");
  73. return false;
  74. }
  76. foreach ($items as $item) {
  77. if ($item == '.' || $item == '..') {
  78. continue;
  79. }
  81. $sourcePath = $source . '/' . $item;
  82. $destinationPath = $destination . '/' . $item;
  84. if (is_dir($sourcePath)) {
  85. if (!copyDirRecursive($sourcePath, $destinationPath)) {
  86. return false;
  87. }
  88. } else {
  89. copyFile($sourcePath, $destinationPath);
  90. }
  91. }
  93. return true;
  94. }
  96. /**
  97. * Copies a file.
  98. *
  99. * @param string $source The source file.
  100. * @param string $destination The destination file.
  101. * @return bool True on success, false on failure.
  102. */
  103. function copyFile(string $source, string $destination): bool
  104. {
  105. if (!file_exists($source)) {
  106. error_log("Source file '$source' does not exist.");
  107. return false;
  108. }
  110. if (copy($source, $destination)) {
  111. return true;
  112. } else {
  113. error_log("Failed to copy file from '$source' to '$destination'.");
  114. return false;
  115. }
  116. }
  118. /**
  119. * Cleans up old backups.
  120. *
  121. * @param string $backupDir The backup directory.
  122. * @param int $numBackups The number of backups to keep.
  123. * @return bool True on success, false on failure.
  124. */
  125. function cleanupOldBackups(string $backupDir, int $numBackups): bool
  126. {
  127. $files = glob($backupDir . '/*');
  128. if ($files === false) {
  129. error_log("Failed to list files in '$backupDir'.");
  130. return false;
  131. }
  133. $files = array_reverse($files);
  135. if (count($files) > $numBackups) {

Add your comment