fusionpbx/resources/classes/file.php

<?php

/**
 * file class provides an abstracted cache
 */
class file {

	/**
	 *  variables
	 */
	public $recursive;
	public $files;

	/**
	 * Set in the constructor. Must be a database object and cannot be null.
	 *
	 * @var database Database Object
	 */
	private $database;

	/**
	 * Settings object set in the constructor. Must be a settings object and cannot be null.
	 *
	 * @var settings Settings Object
	 */
	private $settings;

	/**
	 * User UUID set in the constructor. This can be passed in through the $settings_array associative array or set in
	 * the session global array
	 *
	 * @var string
	 */
	private $user_uuid;

	/**
	 * Domain UUID set in the constructor. This can be passed in through the $settings_array associative array or set
	 * in the session global array
	 *
	 * @var string
	 */
	private $domain_uuid;

	/**
	 * Constructor for the class.
	 *
	 * This method initializes the object with setting_array and session data.
	 *
	 * @param array $setting_array An optional array of settings to override default values. Defaults to [].
	 */
	public function __construct(array $setting_array = []) {
		//set domain and user UUIDs
		$this->domain_uuid = $setting_array['domain_uuid'] ?? $_SESSION['domain_uuid'] ?? '';
		$this->user_uuid = $setting_array['user_uuid'] ?? $_SESSION['user_uuid'] ?? '';

		//set objects
		$this->database = $setting_array['database'] ?? database::new();
		$this->settings = $setting_array['settings'] ?? new settings(['database' => $this->database, 'domain_uuid' => $this->domain_uuid, 'user_uuid' => $this->user_uuid]);
	}

	/**
	 * Returns an array of sound files.
	 *
	 * This method retrieves a list of sound files based on the provided language,
	 * dialect, and voice settings. If no specific values are provided, default values
	 * will be used.
	 *
	 * @param string $language The desired language (default: 'en').
	 * @param string $dialect  The desired dialect (default: 'us').
	 * @param string $voice    The desired voice (default: 'callie').
	 *
	 * @return array An array of sound files.
	 */
	public function sounds($language = 'en', $dialect = 'us', $voice = 'callie') {
		//define an empty array
		$array = [];

		//set default values
		if (!isset($language)) {
			$language = 'en';
		}
		if (!isset($dialect)) {
			$dialect = 'us';
		}
		if (!isset($voice)) {
			$voice = 'callie';
		}

		//set the variables
		if (!empty($this->settings->get('switch', 'sounds')) && file_exists($this->settings->get('switch', 'sounds'))) {
			$dir = $this->settings->get('switch', 'sounds') . '/' . $language . '/' . $dialect . '/' . $voice;
			$rate = '8000';
			$files = $this->glob($dir . '/*/' . $rate, true);
		}

		//loop through the languages
		if (!empty($files)) {
			foreach ($files as $file) {
				$file = substr($file, strlen($dir) + 1);
				$file = str_replace("/" . $rate, "", $file);
				$array[] = $file;
			}
		}

		//return the list of sounds
		return $array;
	}

	/**
	 * Finds files in the specified directory.
	 *
	 * This method recursively searches for files and directories within the given
	 * directory, returning an array of paths if found. If no recursion is performed,
	 * only the files directly within the directory are returned.
	 *
	 * @param string $dir       The directory path to search.
	 * @param bool   $recursive Whether to recursively traverse subdirectories.
	 *
	 * @return array An array of file paths found in the specified directory.
	 */
	public function glob($dir, $recursive): array {
		$files = [];
		if ($dir != '' || $dir != '/') {
			$tree = glob(rtrim($dir, '/') . '/*');
			if ($recursive) {
				if (is_array($tree)) {
					foreach ($tree as $file) {
						if (is_dir($file)) {
							if ($recursive == true) {
								$files[] = $this->glob($file, $recursive);
							}
						} elseif (is_file($file)) {
							$files[] = $file;
						}
					}
				}
			}
		}
		return $files;
	}

}

/*
//add multi-lingual support
	$file = new file;
	$files = $file->sounds();
	print_r($files);
*/