openstamanager/lib/functions.php

502 lines
11 KiB
PHP
Raw Normal View History

<?php
2020-09-07 15:04:06 +02:00
/*
* OpenSTAManager: il software gestionale open source per l'assistenza tecnica e la fatturazione
2021-01-20 15:08:51 +01:00
* Copyright (C) DevCode s.r.l.
2020-09-07 15:04:06 +02:00
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
/*
2018-07-17 12:05:21 +02:00
* Funzioni fondamentali per il corretto funzionamento del nucleo del progetto.
*
* @since 2.3
*/
use HTMLBuilder\HTMLBuilder;
2019-08-28 16:58:47 +02:00
use Models\OperationLog;
use Symfony\Component\Filesystem\Exception\IOException;
use Symfony\Component\Filesystem\Filesystem as SymfonyFilesystem;
use Symfony\Component\Finder\Finder;
use Util\FileSystem;
2019-08-28 16:58:47 +02:00
/**
* Esegue il redirect.
*
* @param string $url
* @param string $type
*
* @return bool
*/
function redirect($url, $type = 'php')
{
switch ($type) {
case 'php':
header('Location: '.$url);
break;
case 'js':
echo '<script type="text/javascript">location.href="'.$url.'";</script>';
break;
}
}
/**
* Verifica e corregge il nome di un file.
*
* @param string $filename
*/
function sanitizeFilename($filename)
{
$filename = str_replace(' ', '-', $filename);
$filename = preg_replace("/[^A-Za-z0-9_\-\.?!]/", '', $filename);
return $filename;
}
2018-07-17 12:05:21 +02:00
/**
* Elimina i file indicati.
*
2020-09-23 11:47:59 +02:00
* @param array|string $files
2018-07-17 12:05:21 +02:00
*
* @return bool
*/
function delete($files)
{
// Filesystem Symfony
$fs = new SymfonyFilesystem();
// Eliminazione
try {
$fs->remove($files);
2024-05-23 11:36:25 +02:00
} catch (IOException) {
return false;
}
return true;
}
2018-07-17 12:05:21 +02:00
/**
* Controlla l'esistenza e i permessi di scrittura sul percorso indicato.
*
* @param string $path
*
* @return bool
*/
function directory($path)
{
2024-01-15 15:30:45 +01:00
return FileSystem::directory($path);
}
/**
* Copy a file, or recursively copy a folder and its contents.
*
2020-05-18 09:33:43 +02:00
* @param array|string $source Source path
2018-07-17 12:05:21 +02:00
* @param array|string $ignores Paths to ingore
*
* @return bool Returns TRUE on success, FALSE on failure
*/
function copyr($source, $destination, $ignores = [])
{
2018-09-19 16:51:37 +02:00
if (!directory($destination)) {
return false;
}
$files = Finder::create()
->files()
->exclude((array) $ignores['dirs'])
2018-09-19 16:51:37 +02:00
->ignoreDotFiles(false)
->ignoreVCS(true)
->in($source);
2017-09-06 12:50:44 +02:00
foreach ((array) $ignores['files'] as $value) {
2018-09-19 16:51:37 +02:00
$files->notName($value);
}
2017-09-06 12:50:44 +02:00
2018-09-19 16:51:37 +02:00
$result = true;
2018-09-19 16:51:37 +02:00
// Filesystem Symfony
$fs = new SymfonyFilesystem();
try {
$fs->chmod($destination, 0777, 0000, true);
2024-05-23 11:36:25 +02:00
} catch (IOException) {
2023-08-04 14:54:28 +02:00
}
2018-09-19 16:51:37 +02:00
foreach ($files as $file) {
2024-05-23 11:36:25 +02:00
$filename = rtrim((string) $destination, DIRECTORY_SEPARATOR).DIRECTORY_SEPARATOR.$file->getRelativePathname();
// Copia effettiva del file
try {
$fs->copy($file, $filename, true);
2024-05-23 11:36:25 +02:00
} catch (IOException) {
2018-09-19 16:51:37 +02:00
$result = false;
}
}
2019-01-02 14:15:16 +01:00
return $result;
}
/**
* Recupera informazioni sistema operativo dell'utente.
*
* @return string
*/
function getOS()
{
$os = [
'Windows NT 6.1' => 'Windows 7',
'Windows NT 6.0' => 'Windows Vista',
'Windows NT 5.1' => 'Windows XP',
'Windows NT 5.0' => 'Windows 2000',
'Windows NT 4.90' => 'Windows ME',
'Win95' => 'Windows 95',
'Win98' => 'Windows 98',
'Windows NT 5.2' => 'Windows NET',
'WinNT4.0' => 'Windows NT',
'Mac' => 'Mac',
'PPC' => 'Mac',
'Linux' => 'Linux',
'FreeBSD' => 'FreeBSD',
'SunOS' => 'SunOS',
'Irix' => 'Irix',
'BeOS' => 'BeOS',
'OS/2' => 'OS/2',
'AIX' => 'AIX',
];
foreach ($os as $key => $value) {
2024-05-23 11:36:25 +02:00
if (strpos((string) $_SERVER['HTTP_USER_AGENT'], $key)) {
return $value;
}
}
return tr('Altro');
}
/**
* Ottiene l'indirizzo IP del client.
*
* @return string
*/
function get_client_ip()
{
$ipaddress = '';
2018-06-26 14:30:26 +02:00
if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
$ipaddress = $_SERVER['HTTP_CLIENT_IP'];
} elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
$ipaddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
} elseif (!empty($_SERVER['HTTP_X_FORWARDED'])) {
$ipaddress = $_SERVER['HTTP_X_FORWARDED'];
} elseif (!empty($_SERVER['HTTP_FORWARDED_FOR'])) {
$ipaddress = $_SERVER['HTTP_FORWARDED_FOR'];
} elseif (!empty($_SERVER['HTTP_FORWARDED'])) {
$ipaddress = $_SERVER['HTTP_FORWARDED'];
2018-06-26 14:30:26 +02:00
} elseif (!empty($_SERVER['REMOTE_ADDR']) and $_SERVER['REMOTE_ADDR'] != '127.0.0.1') {
$ipaddress = $_SERVER['REMOTE_ADDR'];
2018-06-26 14:30:26 +02:00
} elseif (!empty(gethostbyname(gethostname()))) {
$ipaddress = gethostbyname(gethostname());
} else {
$ipaddress = 'UNKNOWN';
}
2024-05-23 11:36:25 +02:00
return strip_tags((string) $ipaddress);
}
/**
* Traduce il template semplificato in componenti HTML.
*
* @since 2.3
*/
function translateTemplate()
{
2023-06-07 17:09:08 +02:00
$id_record = filter('id_record') ?: get('id_record');
$id_parent = filter('id_parent');
2018-09-19 10:44:32 +02:00
$module = Modules::getCurrent();
$plugin = Plugins::getCurrent();
$id_module = $module ? $module['id'] : null;
$id_plugin = $plugin ? $plugin['id'] : null;
2018-09-28 16:17:10 +02:00
$template = ob_get_clean();
2019-08-28 16:58:47 +02:00
$replaces = [
'$id_module$' => $id_module,
'$id_plugin$' => $id_plugin,
'$id_record$' => $id_record,
];
2019-08-28 16:58:47 +02:00
$template = replace($template, $replaces);
2024-04-12 16:59:19 +02:00
$template = $template ? HTMLBuilder::replace($template) : $template;
2019-08-28 16:58:47 +02:00
$template = replace($template, $replaces);
// Informazioni estese sulle azioni dell'utente
2019-08-28 16:58:47 +02:00
$op = post('op');
if (!empty($op) && $op != 'summable-results' && $op != 'avg-results') {
2019-08-28 16:58:47 +02:00
OperationLog::setInfo('id_module', $id_module);
OperationLog::setInfo('id_plugin', $id_plugin);
OperationLog::setInfo('id_record', $id_record);
OperationLog::build($op);
2017-09-15 15:52:40 +02:00
}
2018-07-19 12:47:28 +02:00
// Retrocompatibilità
if (!empty($_SESSION['infos'])) {
foreach ($_SESSION['infos'] as $message) {
2018-07-19 17:29:21 +02:00
flash()->info($message);
2018-07-19 12:47:28 +02:00
}
}
2018-07-19 12:47:28 +02:00
if (!empty($_SESSION['warnings'])) {
foreach ($_SESSION['warnings'] as $message) {
2018-07-19 17:29:21 +02:00
flash()->warning($message);
2018-07-19 12:47:28 +02:00
}
}
2018-07-19 12:47:28 +02:00
if (!empty($_SESSION['errors'])) {
foreach ($_SESSION['errors'] as $message) {
2018-07-19 17:29:21 +02:00
flash()->error($message);
2018-07-19 12:47:28 +02:00
}
}
// Annullo le notifiche (AJAX)
if (isAjaxRequest()) {
2024-01-15 15:30:45 +01:00
// flash()->clearMessage('info');
}
echo $template;
}
/**
2018-04-09 09:42:03 +02:00
* Restituisce il percorso del filesystem in modo indipendente dal sistema operativo.
*
* @param string $string Percorso da correggere
*
* @since 2.3
*
* @return string
*/
function slashes($string)
{
return str_replace(['\\', '/'], DIRECTORY_SEPARATOR, $string);
}
/**
* Controlla se è in corso una richiesta AJAX generata dal progetto.
*
* @since 2.3
*
* @return bool
*/
function isAjaxRequest()
{
2024-04-10 10:32:23 +02:00
return Whoops\Util\Misc::isAjaxRequest() && filter('ajax') !== null && filter('ajax') !== '';
}
/**
* Effettua le operazioni automatiche di redirect tra le pagine.
*
* @param int $id_module
* @param int $id_record
*
* @since 2.3
*/
function redirectOperation($id_module, $id_record)
{
$backto = filter('backto');
2017-09-15 16:37:19 +02:00
// Scelta del redirect dopo un submit
if (!empty($backto)) {
$hash = filter('hash');
$hash = !string_starts_with($hash, '#') ? '#'.$hash : $hash;
2019-07-25 15:48:28 +02:00
$hash = $hash == '#tab_0' ? '' : $hash;
2017-09-15 16:37:19 +02:00
if ($backto == 'record-edit') {
redirect(base_path().'/editor.php?id_module='.$id_module.'&id_record='.$id_record.$hash);
} elseif ($backto == 'record-list') {
redirect(base_path().'/controller.php?id_module='.$id_module.$hash);
}
2017-09-15 16:37:19 +02:00
2024-01-15 15:30:45 +01:00
exit;
}
}
/**
* Predispone un testo per l'inserimento all'interno di un attributo HTML.
*
* @param string $string
*
2018-11-23 15:17:52 +01:00
* @since 2.3
*
* @return string
*/
function prepareToField($string)
{
2024-04-12 16:59:19 +02:00
return $string ? str_replace('"', '&quot;', $string) : $string;
}
2017-09-15 16:52:59 +02:00
/**
* Restituisce se l'user-agent (browser web) è una versione mobile.
*
2018-11-23 15:17:52 +01:00
* @since 2.3
*
* @return bool
*/
function isMobile()
{
2024-05-23 11:36:25 +02:00
return preg_match("/(android|avantgo|blackberry|bolt|boost|cricket|docomo|fone|hiptop|mini|mobi|palm|phone|pie|tablet|up\.browser|up\.link|webos|wos)/i", (string) $_SERVER['HTTP_USER_AGENT']);
}
/**
* Restituisce il percorso derivante dal file in esecuzione.
*
2018-11-23 15:17:52 +01:00
* @since 2.4.1
*
* @return string
*/
function getURLPath()
{
$path = $_SERVER['SCRIPT_FILENAME'];
2024-05-23 11:36:25 +02:00
$prefix = rtrim((string) $_SERVER['DOCUMENT_ROOT'], '/\\');
2024-05-23 11:36:25 +02:00
if (str_starts_with((string) $path, $prefix)) {
$path = substr((string) $path, strlen($prefix));
} else {
$path = str_replace(base_dir(), base_path(), $path);
}
return slashes($path);
}
/**
* Sostituisce i caratteri speciali per la ricerca attraverso le tabelle Datatables.
*
2018-11-23 15:17:52 +01:00
* @since 2.4.2
*
* @param string $field
*
* @return string
*/
function searchFieldName($field)
{
return str_replace([' ', '.'], ['-', ''], $field);
}
2018-11-23 15:17:52 +01:00
/**
* Rimuove spazi e caratteri speciali da una stringa.
*
* @param string $string
* @param string $permitted
*
* @since 2.4.6
*
* @return string
*/
2019-02-09 14:44:30 +01:00
function clean($string, $permitted = '')
{
return preg_replace('/[^A-Za-z0-9'.$permitted.']/', '', $string); // Removes special chars.
}
2019-09-24 10:09:29 +02:00
function check_query($query)
{
2024-05-23 11:36:25 +02:00
$query = mb_strtoupper((string) $query);
2019-09-24 10:09:29 +02:00
$blacklist = ['INSERT', 'UPDATE', 'TRUNCATE', 'DELETE', 'DROP', 'GRANT', 'CREATE', 'REVOKE'];
foreach ($blacklist as $value) {
if (preg_match("/\b".preg_quote($value)."\b/", $query)) {
return false;
}
}
return true;
}
/**
* Restituisce il valore corrente di un parametro della sessione.
*
* @param string $name Nome del parametro in dot-notation
* @param mixed|null $default
*
* @return array|mixed|null
*/
function session_get($name, $default = null)
{
$session = &$_SESSION;
if (empty($name)) {
return $default;
}
$pieces = explode('.', $name);
foreach ($pieces as $piece) {
if (!isset($session[$piece])) {
return $default;
}
$session = &$session[$piece];
}
2024-04-08 15:44:33 +02:00
return $session ?? $default;
}
/**
* Imposta un parametro nella sessione secondo un nome indicato.
*
2024-05-24 09:17:38 +02:00
* @param string $name Nome del parametro in dot-notation
*
* @return void
*/
2024-05-23 11:36:25 +02:00
function session_set($name, mixed $value)
{
$session = &$_SESSION;
if (!empty($name)) {
$pieces = explode('.', $name);
foreach ($pieces as $piece) {
if (!isset($session[$piece])) {
$session[$piece] = [];
}
$session = &$session[$piece];
}
}
$session = $value;
}
/**
* Restituisce l'URL completo per il gestionale.
*
* @return string
*/
function base_url()
{
return App::$baseurl;
}
/**
* Restituisce l'URL parziale per il gestionale.
*
* @return string
*/
function base_path()
{
return App::$rootdir;
}
/**
* Restituisce il percorso per la cartella principale del gestionale.
*
* @return string
*/
function base_dir()
{
return App::$docroot;
}