1. <?php
  3. /**
  4. * Imports data from a text file, performing defensive checks.
  5. *
  6. * @param string $filePath Path to the text file.
  7. * @param string $delimiter Delimiter used in the text file (default: comma).
  8. * @param bool $skipHeader Whether to skip the first line (header) (default: false).
  9. * @return array|false An array of data rows, or false on error.
  10. */
  11. function importTextFile(string $filePath, string $delimiter = ',', bool $skipHeader = false): array|false
  12. {
  13. if (!file_exists($filePath)) {
  14. error_log("File not found: $filePath");
  15. return false; // File does not exist
  16. }
  18. if (!is_readable($filePath)) {
  19. error_log("File not readable: $filePath");
  20. return false; // File is not readable
  21. }
  23. $data = [];
  24. $headerSkipped = false;
  26. if (($handle = fopen($filePath, 'r')) !== false) {
  27. while (($row = fgetcsv($handle, 0, $delimiter)) !== false) {
  28. if (!$headerSkipped) {
  29. $headerSkipped = true;
  30. continue; // Skip the header row
  31. }
  33. // Defensive check: Ensure row has the expected number of columns.
  34. if (count($row) < 1) {
  35. error_log("Skipping row with insufficient columns: " . implode(',', $row));
  36. continue;
  37. }
  40. //Data validation example - check if a required field is not empty
  41. if (empty($row[0])) {
  42. error_log("Skipping row with empty required field (column 0): " . implode(',', $row));
  43. continue;
  44. }
  46. $data[] = $row;
  47. }
  48. fclose($handle);
  49. } else {
  50. error_log("Failed to open file: $filePath");
  51. return false; // File opening failed
  52. }
  54. return $data;
  55. }
  57. //Example Usage:
  58. // $data = importTextFile('data.txt', ',', true);
  59. // if ($data !== false) {
  60. // print_r($data);
  61. // }
  64. ?>

Add your comment