functions2.lib.php File Reference

A set of functions for Dolibarr This file contains all rare functions. More...

Go to the source code of this file.

Functions
	jsUnEscape ($source)
	Same function than javascript unescape() function but in PHP.
	dolGetModulesDirs ($subdir='')
	Return list of directories that contain modules.
	dol_getDefaultFormat ($outputlangs=null)
	Try to guess default paper format according to language into $langs.
	dol_print_object_info ($object, $usetable=0)
	Show information on an object TODO Move this into html.formother.
	dolAddEmailTrackId ($email, $trackingid)
	Return an email formatted to include a tracking id For example myema.nosp@m.il@e.nosp@m.xampl.nosp@m.e.co.nosp@m.m becom myema.nosp@m.il+t.nosp@m.racki.nosp@m.ngid.nosp@m.@exam.nosp@m.ple..nosp@m.com.
	isValidMailDomain ($mail)
	Return true if email has a domain name that can be resolved to MX type.
	isValidUrl ($url, $http=0, $pass=0, $port=0, $path=0, $query=0, $anchor=0)
	Url string validation <http[s]> :// [user[:pass]@] hostname [port] [/path] [?getquery] [anchor].
	isValidVATID ($company)
	Check if VAT numero is valid (check done on syntax only, no database or remote access)
	clean_url ($url, $http=1)
	Clean an url string.
	dolObfuscateEmail ($mail, $replace="*", $nbreplace=8, $nbdisplaymail=4, $nbdisplaydomain=3, $displaytld=true)
	Returns an email value with obfuscated parts.
	array2tr ($data, $troptions='', $tdoptions='')
	Return lines of an html table from an array Used by array2table function only.
	array2table ($data, $tableMarkup=1, $tableoptions='', $troptions='', $tdoptions='')
	Return an html table from an array.
	get_next_value ($db, $mask, $table, $field, $where='', $objsoc='', $date='', $mode='next', $bentityon=true, $objuser=null, $forceentity=null)
	Return last or next value for a mask (according to area we should not reset)
	get_string_between ($string, $start, $end)
	Get string from "$start" up to "$end".
	check_value ($mask, $value)
	Check value.
	binhex ($bin, $pad=false, $upper=false)
	Convert a binary data to string that represent hexadecimal value.
	hexbin ($hexa)
	Convert an hexadecimal string into a binary string.
	numero_semaine ($time)
	Retourne le numero de la semaine par rapport a une date.
	weight_convert ($weight, &$from_unit, $to_unit)
	Convertit une masse d'une unite vers une autre unite.
	dol_set_user_param ($db, $conf, &$user, $tab)
	Save personal parameter.
	dol_print_reduction ($reduction, $langs)
	Returns formatted reduction.
	version_os ($option='')
	Return OS version.
	version_php ()
	Return PHP version.
	version_db ()
	Return DB version.
	version_dolibarr ()
	Return Dolibarr version.
	version_webserver ()
	Return web server version.
	getListOfModels ($db, $type, $maxfilenamelength=0)
	Return list of activated modules usable for document generation.
	is_ip ($ip)
	This function evaluates a string that should be a valid IPv4 Note: For ip 169.254.0.0, it returns 0 with some PHP (5.6.24) and 2 with some minor patches of PHP (5.6.25).
	dol_buildlogin ($lastname, $firstname)
	Build a login from lastname, firstname.
	getSoapParams ()
	Return array to use for SoapClient constructor.
	dolGetElementUrl ($objectid, $objecttype, $withpicto=0, $option='')
	Return link url to an object.
	cleanCorruptedTree ($db, $tabletocleantree, $fieldfkparent)
	Clean corrupted database tree (orphelins linked to a not existing parent), record linked to themself, and also child-parent loop.
	colorArrayToHex ($arraycolor, $colorifnotfound='888888')
	Convert an array with RGB value into hex RGB value.
	colorStringToArray ($stringcolor, $colorifnotfound=array(88, 88, 88))
	Convert a string RGB value ('FFFFFF', '255,255,255') into an array RGB array(255,255,255).
	colorValidateHex ($color, $allow_white=true)
	colorAgressiveness ($hex, $ratio=-50, $brightness=0)
	Change color to make it less aggressive (ratio is negative) or more aggressive (ratio is positive)
	colorAdjustBrightness ($hex, $steps)
	colorDarker ($hex, $percent)
	colorLighten ($hex, $percent)
	colorHexToRgb ($hex, $alpha=false, $returnArray=false)
	colorHexToHsl ($hex, $alpha=false, $returnArray=false)
	Color Hex to Hsl (used for style)
	cartesianArray (array $input)
	Applies the Cartesian product algorithm to an array Source: http://stackoverflow.com/a/15973172.
	getModuleDirForApiClass ($moduleobject)
	Get name of directory where the api_...class.php file is stored.
	randomColorPart ($min=0, $max=255)
	Return 2 hexa code randomly.
	randomColor ($min=0, $max=255)
	Return hexadecimal color randomly.
if(!function_exists( 'dolEscapeXML'))	convertBackOfficeMediasLinksToPublicLinks ($notetoshow)
	Convert links to local wrapper to medias files into a string into a public external URL readable on internet.
	price2fec ($amount)
	Function to format a value into a defined format for French administration (no thousand separator & decimal separator force to ',' with two decimals) Function used into accountancy FEC export.
	phpSyntaxError ($code)
	Check the syntax of some PHP code.
	acceptLocalLinktoMedia ()
	Check the syntax of some PHP code.
	removeGlobalParenthesis ($string)
	Remove first and last parenthesis but only if first is the opening and last the closing of the same group.
	getArrayOfEmojiBis ()
	Return array of Emojis for miscellaneous use.
	removeEmoji ($text, $allowedemoji=1)
	Remove EMoji from email content.
	csvClean ($newvalue, $charset='', $separator='')
	Clean a cell to respect rules of CSV file cells.

Detailed Description

A set of functions for Dolibarr This file contains all rare functions.

Definition in file functions2.lib.php.

Function Documentation

acceptLocalLinktoMedia()

acceptLocalLinktoMedia

(

)

Check the syntax of some PHP code.

Returns

int >0 if OK, 0 if no Return if we accept link added from the media browser into HTML field for public usage

Definition at line 2932 of file functions2.lib.php.

References getDolGlobalInt().

array2table()

array2table	(		$data,
			$tableMarkup = 1,
			$tableoptions = '',
			$troptions = '',
			$tdoptions = '' )

Return an html table from an array.

Parameters

	array<int|string,null|string|int|float>	$data Array of data
int	$tableMarkup	Table markup
string	$tableoptions	Options for table
string	$troptions	Options for tr
string	$tdoptions	Options for td

Returns

string

Definition at line 876 of file functions2.lib.php.

References array2tr().

array2tr()

array2tr	(		$data,
			$troptions = '',
			$tdoptions = '' )

Return lines of an html table from an array Used by array2table function only.

Parameters

	array<null|int|float|string>	$data Array of data
string	$troptions	Options for tr
string	$tdoptions	Options for td

Returns

string

Definition at line 856 of file functions2.lib.php.

Referenced by array2table().

binhex()

binhex	(		$bin,
			$pad = false,
			$upper = false )

Convert a binary data to string that represent hexadecimal value.

Parameters

string	$bin	Value to convert
boolean	$pad	Add 0
boolean	$upper	Convert to tupper

Returns

string x

Definition at line 1610 of file functions2.lib.php.

References dol_strlen().

cartesianArray()

cartesianArray

(

array

$input

)

Applies the Cartesian product algorithm to an array Source: http://stackoverflow.com/a/15973172.

Parameters

array<string|int,string[]>

$input Array of products

Returns

array<array<string,string>> Array of combinations

Definition at line 2654 of file functions2.lib.php.

check_value()

check_value	(		$mask,
			$value )

Check value.

Parameters

string	$mask	Mask to use
string	$value	Value

Returns

int|string Return integer <0 or error string if KO, 0 if OK

Definition at line 1484 of file functions2.lib.php.

References dol_string_nospecial(), dol_strlen(), and dol_syslog().

Referenced by mod_codeclient_elephant\verif(), mod_codeproduct_elephant\verif(), mod_barcode_product_standard\verif_syntax(), and mod_barcode_thirdparty_standard\verif_syntax().

clean_url()

clean_url	(		$url,
			$http = 1 )

Clean an url string.

Parameters

string	$url	Url
integer	$http	1 = keep both http:// and https://, 0: remove http:// but not https://

Returns

string Cleaned url

Definition at line 769 of file functions2.lib.php.

Referenced by Adherent\update(), Link\update(), and Societe\update().

cleanCorruptedTree()

cleanCorruptedTree	(		$db,
			$tabletocleantree,
			$fieldfkparent )

Clean corrupted database tree (orphelins linked to a not existing parent), record linked to themself, and also child-parent loop.

Parameters

DoliDB	$db	Database handler
string	$tabletocleantree	Table to clean
string	$fieldfkparent	Field name that contains id of parent

Returns

int Nb of records fixed/deleted

Definition at line 2278 of file functions2.lib.php.

References $id, and dol_print_error().

colorAdjustBrightness()

colorAdjustBrightness	(		$hex,
			$steps )

Parameters

string	$hex	Color in hex ('#AA1122' or 'AA1122' or '#a12' or 'a12')
integer	$steps	Step/offset added to each color component. It should be between -255 and 255. Negative = darker, positive = lighter

Returns

string New color with format '#AA1122'

See also

colorAgressiveness()

Definition at line 2513 of file functions2.lib.php.

Referenced by colorDarker(), and colorLighten().

colorAgressiveness()

colorAgressiveness	(		$hex,
			$ratio = -50,
			$brightness = 0 )

Change color to make it less aggressive (ratio is negative) or more aggressive (ratio is positive)

Parameters

string	$hex	Color in hex ('#AA1122' or 'AA1122' or '#a12' or 'a12')
integer	$ratio	Default=-50. Note: 0=Component color is unchanged, -100=Component color become 88, +100=Component color become 00 or FF
integer	$brightness	Default=0. Adjust brightness. -100=Decrease brightness by 100%, +100=Increase of 100%.

Returns

string New string of color

See also

colorAdjustBrightness()

Definition at line 2457 of file functions2.lib.php.

colorArrayToHex()

colorArrayToHex	(		$arraycolor,
			$colorifnotfound = '888888' )

Convert an array with RGB value into hex RGB value.

This is the opposite function of colorStringToArray

Parameters

	array{0:int,1:int,2:int}	$arraycolor Array
string	$colorifnotfound	Color code to return if entry not defined or not a RGB format

Returns

string RGB hex value (without # before). For example: 'FF00FF', '01FF02'

See also

colorStringToArray(), colorHexToRgb()

Definition at line 2392 of file functions2.lib.php.

Referenced by colorHexToHsl(), FormSetupItem\generateInputFieldColor(), FormSetupItem\generateOutputFieldColor(), box_graph_nb_tickets_type\loadBox(), WebPortalTheme\loadPrimaryColor(), and showSkins().

colorDarker()

colorDarker	(		$hex,
			$percent )

Parameters

string	$hex	color in hex
integer	$percent	0 to 100

Returns

string

Definition at line 2542 of file functions2.lib.php.

References colorAdjustBrightness().

colorHexToHsl()

colorHexToHsl	(		$hex,
			$alpha = false,
			$returnArray = false )

Color Hex to Hsl (used for style)

Parameters

string	$hex	Color in hex
float | false	$alpha	0 to 1 to add alpha channel
bool	$returnArray	true=return an array instead, false=return string

Returns

array{h:float,l:float,s:float,a:int|float}|string HSLA as string or array

Definition at line 2597 of file functions2.lib.php.

References colorArrayToHex(), and colorStringToArray().

Referenced by WebPortalTheme\loadPrimaryColor().

colorHexToRgb()

colorHexToRgb	(		$hex,
			$alpha = false,
			$returnArray = false )

Parameters

string	$hex	color in hex
float | false	$alpha	0 to 1 to add alpha channel
bool	$returnArray	true=return an array instead, false=return string

Returns

string|array{r:int,g:int,b:int,a?:float} String or array

Definition at line 2566 of file functions2.lib.php.

colorLighten()

colorLighten	(		$hex,
			$percent )

Parameters

string	$hex	color in hex
integer	$percent	0 to 100

Returns

string

Definition at line 2553 of file functions2.lib.php.

References colorAdjustBrightness().

colorStringToArray()

colorStringToArray	(		$stringcolor,
			$colorifnotfound = array(88, 88, 88) )

Convert a string RGB value ('FFFFFF', '255,255,255') into an array RGB array(255,255,255).

This is the opposite function of colorArrayToHex. If entry is already an array, return it.

Parameters

string|array{0:int,1:int,2:int}	$stringcolor String with hex (FFFFFF) or comma RGB ('255,255,255')
array{0:int,1:int,2:int}|array{}	$colorifnotfound Color code array to return if entry not defined

Returns

array{0:int,1:int,2:int} RGB hex value (without # before). For example: FF00FF

See also

colorArrayToHex(), colorHexToRgb()

Definition at line 2413 of file functions2.lib.php.

Referenced by colorHexToHsl(), FormSetupItem\generateInputFieldColor(), FormSetupItem\generateOutputFieldColor(), WebPortalTheme\loadPrimaryColor(), and showSkins().

colorValidateHex()

colorValidateHex	(		$color,
			$allow_white = true )

Parameters

string	$color	the color you need to valid
boolean	$allow_white	in case of white isn't valid

Returns

boolean

Definition at line 2436 of file functions2.lib.php.

Referenced by WebPortalTheme\loadPrimaryColor().

convertBackOfficeMediasLinksToPublicLinks()

if(!function_exists('dolEscapeXML')) convertBackOfficeMediasLinksToPublicLinks

(

$notetoshow

)

Convert links to local wrapper to medias files into a string into a public external URL readable on internet.

Parameters

string

$notetoshow

Text to convert

Returns

string String

Definition at line 2789 of file functions2.lib.php.

Referenced by pdf_aurore\write_file(), pdf_azur\write_file(), pdf_baleine\write_file(), pdf_beluga\write_file(), pdf_canelle\write_file(), pdf_cornas\write_file(), pdf_crabe\write_file(), pdf_cyan\write_file(), pdf_eagle_proforma\write_file(), pdf_einstein\write_file(), pdf_eratosthene\write_file(), pdf_espadon\write_file(), pdf_octopus\write_file(), pdf_soleil\write_file(), pdf_sponge\write_file(), pdf_standard\write_file(), pdf_standard_asset\write_file(), pdf_standard_expensereport\write_file(), pdf_standard_movementstock\write_file(), pdf_standard_myobject\write_file(), pdf_standard_recruitmentjobposition\write_file(), pdf_standard_stock\write_file(), pdf_strato\write_file(), pdf_timespent\write_file(), pdf_vinci\write_file(), and pdf_zenith\write_file().

csvClean()

csvClean	(		$newvalue,
			$charset = '',
			$separator = '' )

Clean a cell to respect rules of CSV file cells.

Parameters

string	$newvalue	String to clean (must be UTF-8 encoded)
string	$charset	Expected output character set ('UTF-8', 'ISO-8859-1', ...). Default '' will use the value into EXPORT_CSV_FORCE_CHARSET.
string	$separator	CSV char separator (often ',' or ';'). Default '' will use the value into EXPORT_CSV_SEPARATOR_TO_USE.

Returns

string Value cleaned

Definition at line 3089 of file functions2.lib.php.

References dol_htmlcleanlastbr(), getDolGlobalInt(), and getDolGlobalString().

Referenced by ExportCsv\write_record(), and ExportCsv\write_title().

dol_buildlogin()

dol_buildlogin	(		$lastname,
			$firstname )

Build a login from lastname, firstname.

Parameters

string	$lastname	Lastname
string	$firstname	Firstname

Returns

string Login

Definition at line 2041 of file functions2.lib.php.

References dol_string_nospecial(), dol_string_unaccent(), dol_trunc(), and getDolGlobalString().

Referenced by ActionsAdherentCardCommon\assign_values(), ActionsContactCardCommon\assign_values(), User\create_from_contact(), and User\create_from_member().

dol_getDefaultFormat()

dol_getDefaultFormat

(

$outputlangs = null

)

Try to guess default paper format according to language into $langs.

Parameters

?Translate

$outputlangs

Output lang to use to autodetect output format if setup not done

Returns

string Default paper format code

Definition at line 123 of file functions2.lib.php.

Referenced by pdf_getFormat().

dol_print_object_info()

dol_print_object_info	(		$object,
			$usetable = 0 )

Show information on an object TODO Move this into html.formother.

Parameters

object | CommonObject	$object	Object to show
int	$usetable	Output into a table

Returns

void

Definition at line 150 of file functions2.lib.php.

References $object, dol_print_date(), and getServerTimeZoneInt().

dol_print_reduction()

dol_print_reduction	(		$reduction,
			$langs )

Returns formatted reduction.

Parameters

int | float	$reduction	Reduction percentage
Translate	$langs	Output language

Returns

string Formatted reduction

Definition at line 1839 of file functions2.lib.php.

References vatrate().

Referenced by pdf_getlineremisepercent().

dol_set_user_param()

dol_set_user_param	(		$db,
			$conf,
		&	$user,
			$tab )

Save personal parameter.

Parameters

DoliDB	$db	Handler database
Conf	$conf	Object conf
User	$user	Object user
	array<string,string|int>	$tab Array (key=>value) with all parameters to save/update

Returns

int Return integer <0 if KO, >0 if OK

See also

dolibarr_get_const(), dolibarr_set_const(), dolibarr_del_const()

Definition at line 1768 of file functions2.lib.php.

References $conf, dol_print_error(), and dol_syslog().

Referenced by InfoBox\saveboxorder().

dolAddEmailTrackId()

dolAddEmailTrackId	(		$email,
			$trackingid )

Return an email formatted to include a tracking id For example myema.nosp@m.il@e.nosp@m.xampl.nosp@m.e.co.nosp@m.m becom myema.nosp@m.il+t.nosp@m.racki.nosp@m.ngid.nosp@m.@exam.nosp@m.ple..nosp@m.com.

Parameters

string	$email	Email address (Ex: "toto@example.com", "John Do <johndo@example.com>")
string	$trackingid	Tracking id (Ex: thi123 for thirdparty with id 123)

Returns

string Return email tracker string

Definition at line 661 of file functions2.lib.php.

dolGetElementUrl()

dolGetElementUrl	(		$objectid,
			$objecttype,
			$withpicto = 0,
			$option = '' )

Return link url to an object.

Parameters

int	$objectid	Id of record
string	$objecttype	Type of object ('invoice', 'order', 'expedition_bon', 'myobject@mymodule', ...)
int	$withpicto	Picto to show
string	$option	More options

Returns

string URL of link to object id/type

Definition at line 2118 of file functions2.lib.php.

References $conf, $object, dol_include_once(), and dol_syslog().

Referenced by show_actions_done().

dolGetModulesDirs()

dolGetModulesDirs

(

$subdir = ''

)

Return list of directories that contain modules.

Detects directories that contain a subdirectory /core/modules. Modules that contains 'disabled' in their name are excluded.

Parameters

string

$subdir

Sub directory (Example: '/mailings' will look for /core/modules/mailings/)

Returns

array<string,string> Array of directories that can contain module descriptors ($key==value)

Definition at line 84 of file functions2.lib.php.

References $conf.

Referenced by activateModule(), activateModulesRequiredByCountry(), complete_dictionary_with_modules(), complete_elementList_with_modules(), Export\load_arrays(), Import\load_arrays(), and unActivateModule().

dolObfuscateEmail()

dolObfuscateEmail	(		$mail,
			$replace = "*",
			$nbreplace = 8,
			$nbdisplaymail = 4,
			$nbdisplaydomain = 3,
			$displaytld = true )

Returns an email value with obfuscated parts.

Parameters

string	$mail	Email
string	$replace	Replacement character (default: *)
int	$nbreplace	Number of replacement character (default: 8)
int	$nbdisplaymail	Number of character unchanged (default: 4)
int	$nbdisplaydomain	Number of character unchanged of domain (default: 3)
bool	$displaytld	Display tld (default: true)

Returns

string Return email with hidden parts or '';

Definition at line 814 of file functions2.lib.php.

References isValidEmail().

get_next_value()

get_next_value	(		$db,
			$mask,
			$table,
			$field,
			$where = '',
			$objsoc = '',
			$date = '',
			$mode = 'next',
			$bentityon = true,
			$objuser = null,
			$forceentity = null )

Return last or next value for a mask (according to area we should not reset)

Parameters

DoliDB	$db	Database handler
string	$mask	Mask to use. Must contains {0...0}. Can contains {t..}, {u...}, {user_extra_xxx}, .;.
string	$table	Table containing field with counter
string	$field	Field containing already used values of counter
string	$where	To add a filter on selection (for example to filter on invoice types)
	null|Societe|''	$objsoc The company that own the object we need a counter for
	int|''	$date Date to use for the {y},{m},{d} tags. is timestamp or '' to use dol_now()
string	$mode	'next' for next value or 'last' for last value
bool	$bentityon	Activate the entity filter. Default is true (for modules not compatible with multicompany)
?User	$objuser	Object user we need data from.
?string	$forceentity	Entity id to force, can be '0' or '1' or '1,2' etc

Returns

string New value (numeric) or error message

Definition at line 914 of file functions2.lib.php.

References dol_mktime(), dol_now(), dol_print_error(), dol_string_nospecial(), dol_string_unaccent(), dol_strlen(), dol_substr(), dol_syslog(), get_string_between(), getDolGlobalInt(), and getDolGlobalString().

Referenced by mod_arctic\getNextValue(), mod_asset_advanced\getNextValue(), mod_barcode_product_standard\getNextValue(), mod_barcode_thirdparty_standard\getNextValue(), mod_bom_advanced\getNextValue(), mod_chequereceipt_thyme\getNextValue(), mod_codeclient_elephant\getNextValue(), mod_codeproduct_elephant\getNextValue(), mod_commande_fournisseur_orchidee\getNextValue(), mod_commande_saphir\getNextValue(), mod_contract_magre\getNextValue(), mod_delivery_saphir\getNextValue(), mod_evaluation_advanced\getNextValue(), mod_expedition_ribera\getNextValue(), mod_expensereport_sand\getNextValue(), mod_facture_fournisseur_tulip\getNextValue(), mod_facture_mercure\getNextValue(), mod_holiday_immaculate\getNextValue(), mod_knowledgerecord_advanced\getNextValue(), mod_lot_advanced\getNextValue(), mod_mo_advanced\getNextValue(), mod_myobject_advanced\getNextValue(), mod_partnership_advanced\getNextValue(), mod_payment_ant\getNextValue(), mod_project_universal\getNextValue(), mod_propale_saphir\getNextValue(), mod_reception_moonstone\getNextValue(), mod_recruitmentcandidature_advanced\getNextValue(), mod_recruitmentjobposition_advanced\getNextValue(), mod_sn_advanced\getNextValue(), mod_stocktransfer_advanced\getNextValue(), mod_supplier_payment_brodator\getNextValue(), mod_supplier_proposal_saphir\getNextValue(), mod_takepos_ref_universal\getNextValue(), mod_task_universal\getNextValue(), mod_ticket_universal\getNextValue(), and mod_workstation_advanced\getNextValue().

get_string_between()

get_string_between	(		$string,
			$start,
			$end )

Get string from "$start" up to "$end".

If string is "STARTcontentEND" and $start is "START" and $end is "END", then this function returns "content"

Parameters

string	$string	String to test
string	$start	String Value for start
string	$end	String Value for end

Returns

string Return part of string

Definition at line 1463 of file functions2.lib.php.

Referenced by get_next_value().

getArrayOfEmojiBis()

getArrayOfEmojiBis

(

)

Return array of Emojis for miscellaneous use.

Returns

array<string,array<string>> Array of Emojis in hexadecimal

See also

getArrayOfEmoji()

Definition at line 3027 of file functions2.lib.php.

Referenced by removeEmoji().

getListOfModels()

getListOfModels	(		$db,
			$type,
			$maxfilenamelength = 0 )

Return list of activated modules usable for document generation.

Parameters

DoliDB	$db	Database handler
string	$type	Type of models (company, invoice, ...)
int	$maxfilenamelength	Max length of value to show

Returns

string[]|int<-1,0> 0 if no module is activated, or array(key=>label). For modules that need directory scan, key is completed with ":filename", -1 if error

Definition at line 1922 of file functions2.lib.php.

References $conf, dol_dir_list(), dol_print_error(), dol_syslog(), dol_trunc(), and getDolGlobalString().

Referenced by ModeleAction\liste_modeles(), ModeleBankAccountDoc\liste_modeles(), ModeleChequeReceipts\liste_modeles(), ModeleDon\liste_modeles(), ModeleExpenseReport\liste_modeles(), ModelePDFAsset\liste_modeles(), ModelePDFBom\liste_modeles(), ModelePDFCards\liste_modeles(), ModelePDFCommandes\liste_modeles(), ModelePDFContract\liste_modeles(), ModelePDFDeliveryOrder\liste_modeles(), ModelePDFEvaluation\liste_modeles(), ModelePdfExpedition\liste_modeles(), ModelePDFFactures\liste_modeles(), ModelePDFFicheinter\liste_modeles(), ModelePDFHoliday\liste_modeles(), ModelePDFKnowledgeRecord\liste_modeles(), ModelePDFLabels\liste_modeles(), ModelePDFMember\liste_modeles(), ModelePDFMo\liste_modeles(), ModelePDFMovement\liste_modeles(), ModelePDFMyObject\liste_modeles(), ModelePDFPartnership\liste_modeles(), ModelePDFProduct\liste_modeles(), ModelePDFProductBatch\liste_modeles(), ModelePDFProjects\liste_modeles(), ModelePDFPropales\liste_modeles(), ModelePdfReception\liste_modeles(), ModelePDFRecruitmentCandidature\liste_modeles(), ModelePDFRecruitmentJobPosition\liste_modeles(), ModelePDFStock\liste_modeles(), ModelePDFStockTransfer\liste_modeles(), ModelePDFSupplierProposal\liste_modeles(), ModelePDFSuppliersInvoices\liste_modeles(), ModelePDFSuppliersOrders\liste_modeles(), ModelePDFSuppliersPayments\liste_modeles(), ModelePDFTask\liste_modeles(), ModelePDFTicket\liste_modeles(), ModelePDFUser\liste_modeles(), ModelePDFUserGroup\liste_modeles(), ModelePDFWorkstation\liste_modeles(), and ModeleThirdPartyDoc\liste_modeles().

getModuleDirForApiClass()

getModuleDirForApiClass

(

$moduleobject

)

Get name of directory where the api_...class.php file is stored.

Parameters

string

$moduleobject

Module object name

Returns

string Directory name

Definition at line 2684 of file functions2.lib.php.

getSoapParams()

getSoapParams

(

)

Return array to use for SoapClient constructor.

Returns

array{connection_timeout:int,response_timeout:int,proxy_use:int<0,1>,proxy_host:false|string,proxy_port:false|string,proxy_login:false|string,proxy_password:false|string,trace:int<0,1>}

Definition at line 2071 of file functions2.lib.php.

References $conf, getDolGlobalInt(), and getDolGlobalString().

hexbin()

hexbin

(

$hexa

)

Convert an hexadecimal string into a binary string.

Parameters

string

$hexa

Hexadecimal string to convert (example: 'FF')

Returns

string bin

Definition at line 1635 of file functions2.lib.php.

References dol_strlen().

is_ip()

is_ip

(

$ip

)

This function evaluates a string that should be a valid IPv4 Note: For ip 169.254.0.0, it returns 0 with some PHP (5.6.24) and 2 with some minor patches of PHP (5.6.25).

See https://github.com/php/php-src/pull/1954.

Parameters

string

$ip

IP Address

Returns

int 0 if not valid or reserved range, 1 if valid and public IP, 2 if valid and private range IP

Definition at line 2014 of file functions2.lib.php.

Referenced by SMTPs\_server_connect().

isValidMailDomain()

isValidMailDomain

(

$mail

)

Return true if email has a domain name that can be resolved to MX type.

Parameters

string

$mail

Email address (Ex: "toto@example.com", "John Do <johndo@example.com>")

Returns

int -1 if error (function not available), 0=Not valid, 1=Valid

Definition at line 673 of file functions2.lib.php.

References isValidMXRecord().

isValidUrl()

isValidUrl	(		$url,
			$http = 0,
			$pass = 0,
			$port = 0,
			$path = 0,
			$query = 0,
			$anchor = 0 )

Url string validation <http[s]> :// [user[:pass]@] hostname [port] [/path] [?getquery] [anchor].

Parameters

string	$url	Url
int	$http	1: verify http is provided, 0: not verify http
int	$pass	1: verify user and pass is provided, 0: not verify user and pass
int	$port	1: verify port is provided, 0: not verify port
int	$path	1: verify a path is provided "/" or "/..." or "/.../", 0: not verify path
int	$query	1: verify query is provided, 0: not verify query
int	$anchor	1: verify anchor is provided, 0: not verify anchor

Returns

int 1=Check is OK, 0=Check is KO

Definition at line 692 of file functions2.lib.php.

isValidVATID()

isValidVATID

(

$company

)

Check if VAT numero is valid (check done on syntax only, no database or remote access)

Parameters

Societe

$company

VAT number

Returns

int 1=Check is OK, 0=Check is KO

Definition at line 745 of file functions2.lib.php.

jsUnEscape()

jsUnEscape

(

$source

)

Same function than javascript unescape() function but in PHP.

Parameters

string

$source

String to decode

Returns

string Unescaped string

Definition at line 42 of file functions2.lib.php.

References dol_html_entity_decode().

numero_semaine()

numero_semaine

(

$time

)

Retourne le numero de la semaine par rapport a une date.

Parameters

string

$time

Date au format 'timestamp'

Returns

string Number of week

Definition at line 1651 of file functions2.lib.php.

References dol_print_date().

phpSyntaxError()

phpSyntaxError

(

$code

)

Check the syntax of some PHP code.

Parameters

string

$code

PHP code to check.

Returns

false|array{0:string,1:int} If false, then check was successful, otherwise an array(message,line) of errors is returned.

Definition at line 2837 of file functions2.lib.php.

price2fec()

price2fec

(

$amount

)

Function to format a value into a defined format for French administration (no thousand separator & decimal separator force to ',' with two decimals) Function used into accountancy FEC export.

Parameters

float

$amount

Amount to format

Returns

string Chain with formatted upright

See also

price2num() Format a numeric into a price for FEC files

Definition at line 2808 of file functions2.lib.php.

References $conf, and getDolGlobalString().

Referenced by AccountancyExport\exportCegid(), and AccountancyExport\exportCiel().

randomColor()

randomColor	(		$min = 0,
			$max = 255 )

Return hexadecimal color randomly.

Parameters

int	$min	Between 0 and 255
int	$max	Between 0 and 255

Returns

string A color string '123456'

Encode string for xml usage

Parameters

string

$string

String to encode

Returns

string String encoded

Definition at line 2763 of file functions2.lib.php.

References randomColorPart().

randomColorPart()

randomColorPart	(		$min = 0,
			$max = 255 )

Return 2 hexa code randomly.

Parameters

int	$min	Between 0 and 255
int	$max	Between 0 and 255

Returns

string A color string '12'

Definition at line 2751 of file functions2.lib.php.

Referenced by randomColor().

removeEmoji()

removeEmoji	(		$text,
			$allowedemoji = 1 )

Remove EMoji from email content.

Parameters

string	$text	String to sanitize
	int<0,2>	$allowedemoji Mode to allow emoji

Returns

string Sanitized string

Definition at line 3051 of file functions2.lib.php.

References getArrayOfEmojiBis().

removeGlobalParenthesis()

removeGlobalParenthesis

(

$string

)

Remove first and last parenthesis but only if first is the opening and last the closing of the same group.

Parameters

string

$string

String to sanitize

Returns

string String without global parenthesis

Definition at line 2987 of file functions2.lib.php.

References dol_strlen(), and dol_substr().

Referenced by Form\searchComponent().

version_db()

version_db

(

)

Return DB version.

Returns

string PHP version

Definition at line 1884 of file functions2.lib.php.

version_dolibarr()

version_dolibarr

(

)

Return Dolibarr version.

Returns

string Dolibarr version

See also

versiondolibarrarray(), versioncompare()

Definition at line 1899 of file functions2.lib.php.

Referenced by getVersions().

version_os()

version_os

(

$option = ''

)

Return OS version.

Note that PHP_OS returns only OS (not version) and OS PHP was built on, not necessarily OS PHP runs on.

Parameters

string

$option

Option string

Returns

string OS version

Definition at line 1858 of file functions2.lib.php.

Referenced by getVersions().

version_php()

version_php

(

)

Return PHP version.

Returns

string PHP version

See also

versionphparray(), versioncompare()

Definition at line 1874 of file functions2.lib.php.

Referenced by getVersions().

version_webserver()

version_webserver

(

)

Return web server version.

Returns

string Web server version

Definition at line 1909 of file functions2.lib.php.

Referenced by getVersions().

weight_convert()

weight_convert	(		$weight,
		&	$from_unit,
			$to_unit )

Convertit une masse d'une unite vers une autre unite.

Parameters

float	$weight	Masse a convertir
int	$from_unit	Unite originale en puissance de 10
int	$to_unit	Nouvelle unite en puissance de 10

Returns

float Masse convertie

Definition at line 1733 of file functions2.lib.php.

References weight_convert().

Referenced by weight_convert().