|
dolibarr 21.0.0-alpha
|
Class to manage utility methods. More...
Public Member Functions | |
| __construct ($db) | |
| Constructor. | |
| purgeFiles ($choices='tempfilesold+logfiles', $nbsecondsold=86400) | |
| Purge files into directory of data files. | |
| dumpDatabase ($compression='none', $type='auto', $usedefault=1, $file='auto', $keeplastnfiles=0, $execmethod=0, $lowmemorydump=0) | |
| Make a backup of database CAN BE A CRON TASK. | |
| executeCLI ($command, $outputfile, $execmethod=0, $redirectionfile=null, $noescapecommand=0, $redirectionfileerr=null) | |
| Execute a CLI command. | |
| generateDoc ($module) | |
| Generate documentation of a Module. | |
| compressSyslogs () | |
| This saves syslog files and compresses older ones. | |
| sendBackup ($sendto='', $from='', $subject='', $message='', $filename='', $filter='', $sizelimit=100000000) | |
| Make a send last backup of database or fil in param CAN BE A CRON TASK. | |
| cleanUnfinishedCronjob () | |
| Clean unfinished cronjob in processing when pid is no longer present in the system CAN BE A CRON TASK. | |
Public Attributes | |
| $db | |
Class to manage utility methods.
Definition at line 33 of file utils.class.php.
| Utils::__construct | ( | $db | ) |
| Utils::cleanUnfinishedCronjob | ( | ) |
Clean unfinished cronjob in processing when pid is no longer present in the system CAN BE A CRON TASK.
| Exception |
Definition at line 1415 of file utils.class.php.
References $db, and dol_syslog().
| Utils::compressSyslogs | ( | ) |
This saves syslog files and compresses older ones.
Nb of archive to keep is defined into $conf->global->SYSLOG_FILE_SAVES CAN BE A CRON TASK
Definition at line 998 of file utils.class.php.
References dol_delete_file(), dol_dir_list(), dol_filesize(), dol_is_file(), dol_move(), dolChmod(), and getDolGlobalString().
| Utils::dumpDatabase | ( | $compression = 'none', | |
| $type = 'auto', | |||
| $usedefault = 1, | |||
| $file = 'auto', | |||
| $keeplastnfiles = 0, | |||
| $execmethod = 0, | |||
| $lowmemorydump = 0 ) |
Make a backup of database CAN BE A CRON TASK.
| string | $compression | 'gz' or 'bz' or 'none' |
| string | $type | 'mysql', 'postgresql', ... |
| int | $usedefault | 1=Use default backup profile (Set this to 1 when used as cron) |
| string | $file | 'auto' or filename to build |
| int | $keeplastnfiles | Keep only last n files (not used yet) |
| int | $execmethod | 0=Use default method (that is 1 by default), 1=Use the PHP 'exec' - need size of dump in memory, but low memory method is used if GETPOST('lowmemorydump') is set, 2=Use the 'popen' method (low memory method) |
| int | $lowmemorydump | 1=Use the low memory method. If $lowmemorydump is set, it means we want to make the compression using an external pipe instead retrieving the content of the dump in PHP memory array $output_arr and then print it into the PHP pipe open with xopen(). |
Definition at line 246 of file utils.class.php.
References $db, dol_delete_file(), dol_dir_list(), dol_mkdir(), dol_move(), dol_now(), dol_print_date(), dol_sanitizeFileName(), dol_syslog(), dolChmod(), getDolGlobalString(), and GETPOST().
| Utils::executeCLI | ( | $command, | |
| $outputfile, | |||
| $execmethod = 0, | |||
| $redirectionfile = null, | |||
| $noescapecommand = 0, | |||
| $redirectionfileerr = null ) |
Execute a CLI command.
| string | $command | Command line to execute. Warning: The command line is sanitize by escapeshellcmd(), except if $noescapecommand set, so can't contains any redirection char '>'. Use param $redirectionfile if you need it. |
| string | $outputfile | A path for an output file (used only when method is 2). For example: $conf->admin->dir_temp.'/out.tmp'; |
| int<0,2> | $execmethod 0=Use default method (that is 1 by default), 1=Use the PHP 'exec', 2=Use the 'popen' method | |
| ?string | $redirectionfile | If defined, a redirection of output to this file is added. |
| int<0,1> | $noescapecommand 1=Do not escape command. Warning: Using this parameter needs you already have sanitized the $command parameter. If not, it will lead to security vulnerability. This parameter is provided for backward compatibility with external modules. Always use 0 in core. | |
| ?string | $redirectionfileerr | If defined, a redirection of error is added to this file instead of to channel 1. |
Definition at line 719 of file utils.class.php.
References dol_syslog(), dolChmod(), and getDolGlobalString().
| Utils::generateDoc | ( | $module | ) |
Generate documentation of a Module.
| string | $module | Module name |
Definition at line 796 of file utils.class.php.
References dol_buildpath(), dol_copy(), dol_dir_list(), dol_include_once(), dol_is_dir(), dol_mkdir(), dol_now(), dol_print_date(), dol_print_error(), dolMd2Asciidoc(), dolReplaceInFile(), and getDolGlobalString().
| Utils::purgeFiles | ( | $choices = 'tempfilesold+logfiles', | |
| $nbsecondsold = 86400 ) |
Purge files into directory of data files.
CAN BE A CRON TASK
| string | $choices | Choice of purge mode ('tempfiles', 'tempfilesold' to purge temp older than $nbsecondsold seconds, 'logfiles', or mix of this). Note that 'allfiles' is also possible but very dangerous. |
| int | $nbsecondsold | Nb of seconds old to accept deletion of a directory if $choice is 'tempfilesold', or deletion of file if $choice is 'allfiles' |
Definition at line 80 of file utils.class.php.
References dol_delete_dir_recursive(), dol_delete_file(), dol_dir_list(), dol_mkdir(), dol_now(), dol_syslog(), and getDolGlobalString().
| Utils::sendBackup | ( | $sendto = '', | |
| $from = '', | |||
| $subject = '', | |||
| $message = '', | |||
| $filename = '', | |||
| $filter = '', | |||
| $sizelimit = 100000000 ) |
Make a send last backup of database or fil in param CAN BE A CRON TASK.
| string | $sendto | Recipients emails |
| string | $from | Sender email |
| string | $subject | Topic/Subject of mail |
| string | $message | Message |
| string | $filename | List of files to attach (full path of filename on file system) |
| string | $filter | Filter file send |
| int | $sizelimit | Limit size to send file |
Definition at line 1301 of file utils.class.php.
References dol_escape_htmltag(), dol_filesize(), dol_is_file(), dol_most_recent_file(), dol_syslog(), and getDolGlobalString().
| Utils::$db |
Definition at line 38 of file utils.class.php.
Referenced by __construct(), cleanUnfinishedCronjob(), and dumpDatabase().