directory_helper.php 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. <?php
  2. /**
  3. * CodeIgniter
  4. *
  5. * An open source application development framework for PHP
  6. *
  7. * This content is released under the MIT License (MIT)
  8. *
  9. * Copyright (c) 2014 - 2019, British Columbia Institute of Technology
  10. *
  11. * Permission is hereby granted, free of charge, to any person obtaining a copy
  12. * of this software and associated documentation files (the "Software"), to deal
  13. * in the Software without restriction, including without limitation the rights
  14. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  15. * copies of the Software, and to permit persons to whom the Software is
  16. * furnished to do so, subject to the following conditions:
  17. *
  18. * The above copyright notice and this permission notice shall be included in
  19. * all copies or substantial portions of the Software.
  20. *
  21. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  22. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  23. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  24. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  25. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  26. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  27. * THE SOFTWARE.
  28. *
  29. * @package CodeIgniter
  30. * @author EllisLab Dev Team
  31. * @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
  32. * @copyright Copyright (c) 2014 - 2019, British Columbia Institute of Technology (https://bcit.ca/)
  33. * @license https://opensource.org/licenses/MIT MIT License
  34. * @link https://codeigniter.com
  35. * @since Version 1.0.0
  36. * @filesource
  37. */
  38. defined('BASEPATH') OR exit('No direct script access allowed');
  39. /**
  40. * CodeIgniter Directory Helpers
  41. *
  42. * @package CodeIgniter
  43. * @subpackage Helpers
  44. * @category Helpers
  45. * @author EllisLab Dev Team
  46. * @link https://codeigniter.com/user_guide/helpers/directory_helper.html
  47. */
  48. // ------------------------------------------------------------------------
  49. if ( ! function_exists('directory_map'))
  50. {
  51. /**
  52. * Create a Directory Map
  53. *
  54. * Reads the specified directory and builds an array
  55. * representation of it. Sub-folders contained with the
  56. * directory will be mapped as well.
  57. *
  58. * @param string $source_dir Path to source
  59. * @param int $directory_depth Depth of directories to traverse
  60. * (0 = fully recursive, 1 = current dir, etc)
  61. * @param bool $hidden Whether to show hidden files
  62. * @return array
  63. */
  64. function directory_map($source_dir, $directory_depth = 0, $hidden = FALSE)
  65. {
  66. if ($fp = @opendir($source_dir))
  67. {
  68. $filedata = array();
  69. $new_depth = $directory_depth - 1;
  70. $source_dir = rtrim($source_dir, DIRECTORY_SEPARATOR).DIRECTORY_SEPARATOR;
  71. while (FALSE !== ($file = readdir($fp)))
  72. {
  73. // Remove '.', '..', and hidden files [optional]
  74. if ($file === '.' OR $file === '..' OR ($hidden === FALSE && $file[0] === '.'))
  75. {
  76. continue;
  77. }
  78. is_dir($source_dir.$file) && $file .= DIRECTORY_SEPARATOR;
  79. if (($directory_depth < 1 OR $new_depth > 0) && is_dir($source_dir.$file))
  80. {
  81. $filedata[$file] = directory_map($source_dir.$file, $new_depth, $hidden);
  82. }
  83. else
  84. {
  85. $filedata[] = $file;
  86. }
  87. }
  88. closedir($fp);
  89. return $filedata;
  90. }
  91. return FALSE;
  92. }
  93. }