* @git Joomla Component Builder * @copyright Copyright (C) 2015 Vast Development Method. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE.txt */ namespace VDM\Joomla\Utilities; use Joomla\CMS\Uri\Uri; use Joomla\CMS\Factory; use Joomla\CMS\Language\Text; use Joomla\CMS\Filesystem\Path; use Joomla\CMS\Filesystem\File; use Joomla\CMS\Filesystem\Folder; use Joomla\Archive\Archive; use VDM\Joomla\Utilities\Component\Helper; /** * File helper * * @since 3.0.9 */ abstract class FileHelper { /** * Trigger error notice only once * * @var bool * * @since 3.0.9 */ protected static $curlError = false; /** * The zipper method * * @param string $workingDirectory The directory where the items must be zipped * @param string $filepath The path to where the zip file must be placed * * @return bool true On success * * @since 3.0.9 */ public static function zip($workingDirectory, &$filepath): bool { // store the current joomla working directory $joomla = getcwd(); // we are changing the working directory to the component temp folder chdir($workingDirectory); // the full file path of the zip file $filepath = Path::clean($filepath); // delete an existing zip file (or use an exclusion parameter in Folder::files() File::delete($filepath); // get a list of files in the current directory tree (also the hidden files) $files = Folder::files('.', '', true, true, array('.svn', 'CVS', '.DS_Store', '__MACOSX'), array('.*~')); $zipArray = []; // setup the zip array foreach ($files as $file) { $tmp = []; $tmp['name'] = str_replace('./', '', (string) $file); $tmp['data'] = self::getContent($file); $tmp['time'] = filemtime($file); $zipArray[] = $tmp; } // change back to joomla working directory chdir($joomla); // get the zip adapter $zip = (new Archive())->getAdapter('zip'); //create the zip file return (bool) $zip->create($filepath, $zipArray); } /** * get the content of a file * * @param string $path The path to the file * @param mixed $none The return value if no content was found * * @return string On success * * @since 3.0.9 */ public static function getContent($path, $none = '') { if (StringHelper::check($path)) { // use basic file get content for now if (($content = @file_get_contents($path)) !== FALSE) { return $content; } // use curl if available elseif (function_exists('curl_version')) { // start curl $ch = curl_init(); // set the options $options = []; $options[CURLOPT_URL] = $path; $options[CURLOPT_USERAGENT] = 'Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.12) Gecko/20101026 Firefox/3.6.12'; $options[CURLOPT_RETURNTRANSFER] = TRUE; $options[CURLOPT_SSL_VERIFYPEER] = FALSE; // load the options curl_setopt_array($ch, $options); // get the content $content = curl_exec($ch); // close the connection curl_close($ch); // return if found if (StringHelper::check($content)) { return $content; } } elseif (!self::$curlError) { // set the notice Factory::getApplication()->enqueueMessage('

Curl Not Found!

Please setup curl on your system, or the Joomla Component will not function correctly!

', 'Error'); // load this notice only once self::$curlError = true; } } return $none; } /** * Write a file to the server * * @param string $path The path and file name where to safe the data * @param string $data The data to safe * * @return bool true On success * * @since 3.0.9 */ public static function write($path, $data): bool { $klaar = false; if (StringHelper::check($data)) { // open the file $fh = fopen($path, "w"); if (!is_resource($fh)) { return $klaar; } // write to the file if (fwrite($fh, $data)) { // has been done $klaar = true; } // close file. fclose($fh); } return $klaar; } /** * get all the file paths in folder and sub folders * * @param string $folder The local path to parse * @param array $fileTypes The type of files to get * * @return array|null * * @since 3.0.9 */ public static function getPaths($folder, $fileTypes = array('\.php', '\.js', '\.css', '\.less'), $recurse = true, $full = true): ?array { if (Folder::exists($folder)) { // we must first store the current woking directory $joomla = getcwd(); // we are changing the working directory to the component path chdir($folder); // make sure we have file type filter if (ArrayHelper::check($fileTypes)) { // get the files foreach ($fileTypes as $type) { // get a list of files in the current directory tree $files[] = Folder::files('.', $type, $recurse, $full); } } elseif (StringHelper::check($fileTypes)) { // get a list of files in the current directory tree $files[] = Folder::files('.', $fileTypes, $recurse, $full); } else { // get a list of files in the current directory tree $files[] = Folder::files('.', '.', $recurse, $full); } // change back to Joomla working directory chdir($joomla); // return array of files return array_map( fn($file) => str_replace('./', '/', (string) $file), (array) ArrayHelper::merge($files)); } return null; } /** * Get the file path or url * * @param string $type The (url/path) type to return * @param string $target The Params Target name (if set) * @param string $fileType The kind of filename to generate (if not set no file name is generated) * @param string $key The key to adjust the filename (if not set ignored) * @param string $default The default path if not set in Params (fallback path) * @param bool $createIfNotSet The switch to create the folder if not found * * @return string On success the path or url is returned based on the type requested * * @since 3.0.9 */ public static function getPath($type = 'path', $target = 'filepath', $fileType = null, $key = '', $default = '', $createIfNotSet = true): string { // make sure to always have a string/path if(!StringHelper::check($default)) { $default = JPATH_SITE . '/images/'; } // get the global settings $filePath = Helper::getParams()->get($target, $default); // check the file path (revert to default only of not a hidden file path) if ('hiddenfilepath' !== $target && strpos((string) $filePath, (string) JPATH_SITE) === false) { $filePath = $default; } // create the folder if it does not exist if ($createIfNotSet && !Folder::exists($filePath)) { Folder::create($filePath); } // setup the file name $fileName = ''; // Get basic key $basickey = 'Th!s_iS_n0t_sAfe_buT_b3tter_then_n0thiug'; // get the component helper $helper = Helper::get(); // check if method exist in helper class if ($helper && Helper::methodExists('getCryptKey')) { $basickey = $helper::getCryptKey('basic', $basickey); } // check the key if (!StringHelper::check($key)) { $key = 'vDm'; } // set the file name if (StringHelper::check($fileType)) { // set the name $fileName = trim( md5($type . $target . $basickey . $key) . '.' . trim($fileType, '.')); } else { $fileName = trim( md5($type . $target . $basickey . $key)) . '.txt'; } // return the url if ('url' === $type) { if (\strpos((string) $filePath, (string) JPATH_SITE) !== false) { $filePath = trim( str_replace( JPATH_SITE, '', (string) $filePath), '/'); return Uri::root() . $filePath . '/' . $fileName; } // since the path is behind the root folder of the site, return only the root url (may be used to build the link) return Uri::root(); } // sanitize the path return '/' . trim((string) $filePath, '/' ) . '/' . $fileName; } /** * Check if file exist * * @param string $path The url/path to check * * @return bool If exist true * * @since 3.0.9 */ public static function exists($path): bool { $exists = false; // if this is a local path if (strpos($path, 'http:') === false && strpos($path, 'https:') === false) { if (file_exists($path)) { $exists = true; } } // check if we can use curl elseif (function_exists('curl_version')) { // initiate curl $ch = curl_init($path); // CURLOPT_NOBODY (do not return body) curl_setopt($ch, CURLOPT_NOBODY, true); // make call $result = curl_exec($ch); // check return value if ($result !== false) { // get the http CODE $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($statusCode !== 404) { $exists = true; } } // close the connection curl_close($ch); } elseif ($headers = @get_headers($path)) { if(isset($headers[0]) && is_string($headers[0]) && strpos($headers[0],'404') === false) { $exists = true; } } return $exists; } }