* $Author:: $ *
* -------------------------------------------------------------------- *
* Copyright (c) 2003 - 2009 by Roland Haeder *
- * Copyright (c) 2009 - 2012 by Mailer Developer Team *
+ * Copyright (c) 2009 - 2013 by Mailer Developer Team *
* For more information visit: http://mxchange.org *
* *
* This program is free software; you can redistribute it and/or modify *
// Add an SQL to the list
function addSql ($sql) {
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, sprintf("sql=%s, count=%d", $sql, countSqls()));
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, sprintf('sql=%s, count=%d', $sql, countSqls()));
array_push($GLOBALS['sqls']['generic'], $sql);
}
if (isSqlsInitialized()) {
// Then count it
$count = count($GLOBALS['sqls']);
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, sprintf("count=%d", $count));
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, sprintf('count=%d', $count));
} // END - if
// Return it
}
// Checks whether the SQLs array is filled
-function isSqlsValid () {
+function ifSqlsRegistered () {
//* DEBUG: */ debugOutput(__FUNCTION__ . ':' . intval(isSqlsInitialized()) . '/' . countSqls() . '/' . getCurrentExtensionName());
return (
(
$SQL .= '`' . $entry . '`=NULL,';
} elseif ((substr($value, -2, 2) == '()') || (substr($value, 0, 1) == '`')) {
// SQL function needs no ticks (')
- $SQL .= '`' . $entry . '`=' . SQL_ESCAPE($value) . ',';
+ $SQL .= '`' . $entry . '`=' . sqlEscapeString($value) . ',';
} elseif ('' . bigintval($value, TRUE, FALSE) . '' == '' . $value . '') {
// No need for ticks (')
$SQL .= '`' . $entry . '`=' . $value . ',';
+ } elseif ('' . (float) $value . '' == '' . $value . '') {
+ // Float number detected
+ $SQL .= '`' . $entry . '`=' . sprintf(getConfig('FLOAT_MASK'), $value) . ',';
} else {
// Strings need ticks (') around them
- $SQL .= '`' . $entry . "`='" . SQL_ESCAPE($value) . "',";
+ $SQL .= '`' . $entry . "`='" . sqlEscapeString($value) . "',";
}
} else {
// Handle multi-dimensional data
$SQL .= '`' . $entry . '`=NULL,';
} elseif ((substr($value[$multiDimId], -2, 2) == '()') || (substr($value[$multiDimId], 0, 1) == '`')) {
// SQL function needs no ticks (')
- $SQL .= '`' . $entry . '`=' . SQL_ESCAPE($value[$multiDimId]) . ',';
+ $SQL .= '`' . $entry . '`=' . sqlEscapeString($value[$multiDimId]) . ',';
} elseif (('' . bigintval($value[$multiDimId], TRUE, FALSE) . '' == '' . $value[$multiDimId] . '')) {
// No need for ticks (')
$SQL .= '`' . $entry . '`=' . $value[$multiDimId] . ',';
+ } elseif ('' . (float) $value[$multiDimId] . '' == '' . $value[$multiDimId] . '') {
+ // Float number detected
+ $SQL .= '`' . $entry . '`=' . sprintf(getConfig('FLOAT_MASK'), $value[$multiDimId]) . ',';
} else {
// Strings need ticks (') around them
- $SQL .= '`' . $entry . "`='" . SQL_ESCAPE($value[$multiDimId]) . "',";
+ $SQL .= '`' . $entry . "`='" . sqlEscapeString($value[$multiDimId]) . "',";
}
}
} // END - foreach
// "Getter" for an "INSERT INTO" SQL query
function getInsertSqlFromArray ($array, $tableName) {
// Init SQL
- $SQL = 'INSERT INTO
-`{?_MYSQL_PREFIX?}_' . $tableName . '`
-(
-`' . implode('`, `', array_keys(postRequestArray())) . '`
-) VALUES (';
+ $SQL = 'INSERT INTO `{?_MYSQL_PREFIX?}_' . $tableName . '` (`' . implode('`, `', array_keys($array)) . '`) VALUES (';
// Walk through all entries
- foreach (postRequestArray() as $key => $value) {
+ foreach ($array as $key => $value) {
// Log debug message
//* NOISY-DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'tableName=' . $tableName . ',key=' . $key . ',value=' . $value);
$SQL .= 'NULL,';
} elseif (substr($value, -2, 2) == '()') {
// SQL function needs no ticks (')
- $SQL .= SQL_ESCAPE($value) . ',';
+ $SQL .= sqlEscapeString($value) . ',';
} elseif ('' . bigintval($value, TRUE, FALSE) . '' == '' . $value . '') {
// Number detected, no need for ticks (')
$SQL .= bigintval($value) . ',';
} elseif ('' . (float) $value . '' == '' . $value . '') {
// Float number detected
- $SQL .= sprintf('%01.5f', $value);
+ $SQL .= sprintf(getConfig('FLOAT_MASK'), $value) . ',';
} else {
// Everything else might be a string, so add ticks around it
- $SQL .= chr(39) . SQL_ESCAPE($value) . chr(39) . ',';
+ $SQL .= chr(39) . sqlEscapeString($value) . chr(39) . ',';
}
} // END - foreach
$SQL = substr($SQL, 0, -1) . ')';
// Return SQL query
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'tableName=' . $tableName . ',sql=' . $SQL);
return $SQL;
}
// Function to unset __is_sql_link_up
-function unsetSqlLinkUp ($F, $L) {
+function unsetSqlLinkUp ($file, $line) {
// Unset it
- //* DEBUG: */ logDebugMessage($F, $L, __FUNCTION__ . ': Called!');
- SQL_SET_LINK($F, $L, NULL);
+ //* DEBUG: */ logDebugMessage($file, $line, __FUNCTION__ . ': Called!');
+ setSqlLink($file, $line, NULL);
}
// Initializes the SQL link by bringing it up if set
// "Unset" the link
unsetSqlLinkUp(__FUNCTION__, __LINE__);
- // Do this only if link is down
- assert(!SQL_IS_LINK_UP());
-
// Is the configuration data set?
if ((!empty($GLOBALS['mysql']['host'])) && (!empty($GLOBALS['mysql']['login'])) && (!empty($GLOBALS['mysql']['dbase']))) {
// Remove cache
unsetSqlLinkUp(__FUNCTION__, __LINE__);
// Connect to DB
- SQL_CONNECT($GLOBALS['mysql']['host'], $GLOBALS['mysql']['login'], $GLOBALS['mysql']['password'], __FUNCTION__, __LINE__);
+ sqlConnectToDatabase($GLOBALS['mysql']['host'], $GLOBALS['mysql']['login'], $GLOBALS['mysql']['password'], __FUNCTION__, __LINE__);
// Is the link valid?
- if (SQL_IS_LINK_UP()) {
+ if (isSqlLinkUp()) {
// Enable exit on error
enableExitOnError();
// Is it a valid resource?
- if (SQL_SELECT_DB($GLOBALS['mysql']['dbase'], __FUNCTION__, __LINE__) === TRUE) {
+ if (sqlSelectDatabase($GLOBALS['mysql']['dbase'], __FUNCTION__, __LINE__) === TRUE) {
// Set database name (required for ext-optimize and ifSqlTableExists())
setConfigEntry('__DB_NAME', $GLOBALS['mysql']['dbase']);
// Is the file readable?
if (!isFileReadable($FQFN)) {
// Not found, which is bad
- reportBug(__FUNCTION__, __LINE__, sprintf("SQL dump %s/%s.sql is not readable.", $path, $dumpName));
+ reportBug(__FUNCTION__, __LINE__, sprintf('SQL dump %s/%s.sql is not readable.', $path, $dumpName));
} // END - if
// Then read it
}
// SQL string escaping
-function SQL_QUERY_ESC ($sqlString, $data, $F, $L, $run = TRUE, $strip = TRUE, $secure = TRUE) {
+function sqlQueryEscaped ($sqlString, $data, $file, $line, $run = TRUE, $strip = TRUE, $secure = TRUE) {
// Link is there?
- if ((!SQL_IS_LINK_UP()) || (!is_array($data))) {
+ if ((!isSqlLinkUp()) || (!is_array($data))) {
// Link is down or data is not an array
- //* DEBUG: */ logDebugMessage($F, $L, 'SQL_IS_LINK_UP()=' . intval(SQL_IS_LINK_UP()) . ',data[]=' . gettype($data) . ',sqlString=' . $sqlString . ': ABORTING!');
+ //* DEBUG: */ logDebugMessage($file, $line, 'isSqlLinkUp()=' . intval(isSqlLinkUp()) . ',data[]=' . gettype($data) . ',sqlString=' . $sqlString . ': ABORTING!');
return FALSE;
} // END - if
// Escape all data
foreach ($data as $key => $value) {
- $dataSecured[$key] = SQL_ESCAPE($value, $secure, $strip);
+ $dataSecured[$key] = sqlEscapeString($value, $secure, $strip);
} // END - foreach
// Generate query
if ($run === TRUE) {
// Run SQL query (default)
- return SQL_QUERY($query, $F, $L);
+ return sqlQuery($query, $file, $line);
} else {
// Return secured string
return $query;
}
// SELECT query string from table, columns and so on... ;-)
-function SQL_RESULT_FROM_ARRAY ($table, $columns, $idRow, $id, $F, $L) {
+function getSqlResultFromArray ($table, $columns, $idRow, $id, $file, $line) {
// Is columns an array?
if (!is_array($columns)) {
// No array
- reportBug(__FUNCTION__, __LINE__, sprintf("columns is not an array. %s != array, file=%s, line=%s",
+ reportBug(__FUNCTION__, __LINE__, sprintf('columns is not an array. %s != array, file=%s, line=%s',
gettype($columns),
- basename($F),
- $L
+ basename($file),
+ $line
));
// Abort here with 'false'
}
// Return the result
- return SQL_QUERY_ESC($sql,
+ return sqlQueryEscaped($sql,
array(
$table,
$idRow,
bigintval($id),
- ), $F, $L
+ ), $file, $line
);
}
// ALTER TABLE wrapper function
-function SQL_ALTER_TABLE ($sql, $F, $L, $enableCodes = TRUE) {
+function sqlQueryAlterTable ($sql, $file, $line, $enableCodes = TRUE) {
// Abort if link is down
- if (!SQL_IS_LINK_UP()) return FALSE;
+ if (!isSqlLinkUp()) return FALSE;
// This is the default result...
$result = FALSE;
if (((!ifSqlTableColumnExists($tableName, $columnName)) && (isInString('ADD', $sql))) || ((ifSqlTableColumnExists($tableName, $columnName)) && ((isInString('DROP', $sql)) || ((isInString('CHANGE', $sql)) && ($idx == 4) && ((!ifSqlTableColumnExists($tableName, $tableArray[5])) || ($columnName == $tableArray[5])))))) {
// Do the query
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Executing: ' . $sql);
- $result = SQL_QUERY($sql, $F, $L, FALSE);
+ $result = sqlQuery($sql, $file, $line, FALSE);
// Skip further attempt(s)
break;
} // END - foreach
} elseif ((getTableType() == 'InnoDB') && (isInString('FULLTEXT', $sql))) {
// Skip this query silently because InnoDB does not understand fulltext indexes
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, sprintf("Skipped FULLTEXT: sql=%s,tableName=%s,hasZeroNums=%d,file=%s,line=%s", $sql, $tableName, intval((is_bool($result)) ? 0 : ifSqlTableColumnExists($columnName)), $F, $L));
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, sprintf('Skipped FULLTEXT: sql=%s,tableName=%s,hasZeroNums=%d,file=%s,line=%s', $sql, $tableName, intval((is_bool($result)) ? 0 : ifSqlTableColumnExists($columnName)), $file, $line));
} elseif ($isAlterIndex === TRUE) {
// And column name as well without backticks
$keyName = str_replace('`', '', $tableArray[5]);
// Shall we run it?
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'tableName=' . $tableName . ', tableArray[3]=' . $tableArray[3] . ',keyName=' . $keyName);
if (($tableArray[3] == 'ADD') && (!ifSqlTableIndexExist($tableName, $keyName))) {
- // Send it to the SQL_QUERY() function to add it
+ // Send it to the sqlQuery() function to add it
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'sql=' . $sql . ' - ADDING!');
- $result = SQL_QUERY($sql, $F, $L, $enableCodes);
+ $result = sqlQuery($sql, $file, $line, $enableCodes);
} elseif (($tableArray[3] == 'DROP') && (ifSqlTableIndexExist($tableName, $keyName))) {
- // Send it to the SQL_QUERY() function to drop it
+ // Send it to the sqlQuery() function to drop it
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'sql=' . $sql . ' - DROPPING!');
- $result = SQL_QUERY($sql, $F, $L, $enableCodes);
+ $result = sqlQuery($sql, $file, $line, $enableCodes);
} else {
// Not executed
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Not executed: ' . $sql);
} else {
// Other ALTER TABLE query
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, $sql);
- $result = SQL_QUERY($sql, $F, $L, $enableCodes);
+ $result = sqlQuery($sql, $file, $line, $enableCodes);
}
// Return result
}
// Getter for SQL link
-function SQL_GET_LINK () {
+function getSqlLink () {
// Init link
$link = NULL;
}
// Setter for link
-function SQL_SET_LINK ($F, $L, $link) {
- //* DEBUG: */ logDebugMessage($F . ':' . __FUNCTION__, $L . ':' . __LINE__, 'link[]=' . gettype($link) . ' - ENTERED!');
+// Do *not* add debug lines here. This will cause and endless loop
+function setSqlLink ($file, $line, $link) {
// Is this a resource or null?
- if ((ifFatalErrorsDetected()) && (isInstallationPhase())) {
+ if ((ifFatalErrorsDetected()) && (isInstaller())) {
// This may happen in installation phase
- //* DEBUG: */ logDebugMessage($F . ':' . __FUNCTION__, $L . ':' . __LINE__, 'Some fatal errors detected in installation phase.');
return;
} elseif ((!is_resource($link)) && (!is_null($link))) {
// This should never happen!
- reportBug($F . ':' . __FUNCTION__, $L . ':' . __LINE__, sprintf("Type of link is not resource or null, type=%s", gettype($link)));
+ reportBug($file . ':' . __FUNCTION__, $line . ':' . __LINE__, sprintf('Type of link is not resource or null, type=%s', gettype($link)));
} // END - if
// Set it
// Re-init cache
$GLOBALS['__is_sql_link_up'] = is_resource($link);
- //* DEBUG: */ logDebugMessage($F . ':' . __FUNCTION__, $L . ':' . __LINE__, '__is_sql_link_up=' . intval($GLOBALS['__is_sql_link_up']) . ' - EXIT!');
}
// Checks if the link is up
-function SQL_IS_LINK_UP () {
+function isSqlLinkUp () {
// Is there cached this?
if (!isset($GLOBALS['__is_sql_link_up'])) {
// Something bad went wrong
- reportBug(__FUNCTION__, __LINE__, 'Called before SQL_SET_LINK() was called!');
+ reportBug(__FUNCTION__, __LINE__, 'Called before setSqlLink() was called!');
} // END - if
// Return the result
}
// Wrapper function to make code more readable
-function SQL_HASZERONUMS ($result) {
+function ifSqlHasZeroNums ($result) {
// Just pass it through
- return (SQL_NUMROWS($result) === 0);
+ return (sqlNumRows($result) === 0);
}
// Wrapper function to make code more readable
-function SQL_HASZEROAFFECTED () {
+function ifSqlHasZeroAffectedRows () {
// Just pass it through
- return (SQL_AFFECTEDROWS() === 0);
+ return (sqlAffectedRows() === 0);
}
// Private function to prepare the SQL query string
-function SQL_PREPARE_SQL_STRING ($sqlString, $enableCodes = TRUE) {
+function sqlPrepareQueryString ($sqlString, $enableCodes = TRUE) {
// Debug message
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'sqlString=' . $sqlString . ',enableCodes=' . intval($enableCodes) . ' - ENTERED!');
}
// Creates a MySQL TIMESTAMP compatible string from given Uni* timestamp
-function SQL_EPOCHE_TO_TIMESTAMP ($timestamp) {
- return generateDateTime($timestamp, 7);
+function getSqlTimestampFromUnix ($timestamp) {
+ return generateDateTime($timestamp, '7');
}
// Check if there is a SQL table created
// Is there cache?
if (!isset($GLOBALS[__FUNCTION__][$tableName])) {
// Check if the table is there
- $result = SQL_QUERY_ESC("SHOW TABLES FROM `{?__DB_NAME?}` WHERE `Tables_in_{?__DB_NAME?}`='{?_MYSQL_PREFIX?}_%s'",
+ $result = sqlQueryEscaped("SHOW TABLES FROM `{?__DB_NAME?}` WHERE `Tables_in_{?__DB_NAME?}`='{?_MYSQL_PREFIX?}_%s'",
array($tableName), __FUNCTION__, __LINE__);
// Is a link there?
if (!is_resource($result)) {
// Is installation phase?
- if (isInstallationPhase()) {
+ if (isInstaller()) {
// Then silently abort here
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'result[]=' . gettype($result) . ',isLinkUp=' . intval(SQL_IS_LINK_UP()) . ',tableName=' . $tableName . ' - Returning FALSE ...');
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'result[]=' . gettype($result) . ',isLinkUp=' . intval(isSqlLinkUp()) . ',tableName=' . $tableName . ' - Returning FALSE ...');
return FALSE;
} else {
// Please report this
} // END - if
// Is there an entry?
- $GLOBALS[__FUNCTION__][$tableName] = (SQL_NUMROWS($result) == 1);
+ $GLOBALS[__FUNCTION__][$tableName] = (sqlNumRows($result) == 1);
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'tableName=' . $tableName . ',numRows=' . intval($GLOBALS[__FUNCTION__][$tableName]));
} // END - if
if (!ifSqlTableExists($tableName)) {
// Then abort here
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Table ' . $tableName . ' does not exist, columnName=' . $columnName . ',forceFound=' . intval($forceFound));
- return (($forceFound === FALSE) && (isInstallationPhase()));
+ return (($forceFound === FALSE) && (isInstaller()));
} // END - if
// Get column information
- $result = SQL_QUERY_ESC("SHOW COLUMNS FROM `%s` LIKE '%s'",
+ $result = sqlQueryEscaped("SHOW COLUMNS FROM `%s` LIKE '%s'",
array(
$tableName,
$columnName
// Is a link there?
if (!is_resource($result)) {
// Is installation phase?
- if (isInstallationPhase()) {
+ if (isInstaller()) {
// Then silently abort here
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'result[]=' . gettype($result) . ',isLinkUp=' . intval(SQL_IS_LINK_UP()) . ',tableName=' . $tableName . ',columnName=' . $columnName . ' - Returning FALSE ...');
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'result[]=' . gettype($result) . ',isLinkUp=' . intval(isSqlLinkUp()) . ',tableName=' . $tableName . ',columnName=' . $columnName . ' - Returning FALSE ...');
return $forceFound;
} else {
// Please report this
} // END - if
// Determine it
- $doesExist = (!SQL_HASZERONUMS($result));
+ $doesExist = (!ifSqlHasZeroNums($result));
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
// Return cache
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'tableName=' . $tableName . ',columnName=' . $columnName . ',doesExist=' . intval($doesExist) . ' - EXIT!');
if (!ifSqlTableExists($tableName)) {
// Then abort here
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Table ' . $tableName . ' does not exist, keyName=' . $keyName . ',forceFound=' . intval($forceFound));
- return (($forceFound === FALSE) && (isInstallationPhase()));
+ return (($forceFound === FALSE) && (isInstaller()));
} // END - if
// Show indexes
- $result = SQL_QUERY_ESC("SHOW INDEX FROM `%s`", array($tableName), __FUNCTION__, __LINE__);
+ $result = sqlQueryEscaped("SHOW INDEX FROM `%s`", array($tableName), __FUNCTION__, __LINE__);
// Is a link there?
if (!is_resource($result)) {
// Is installation phase?
- if (isInstallationPhase()) {
+ if (isInstaller()) {
// Then silently abort here
- //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'result[]=' . gettype($result) . ',isLinkUp=' . intval(SQL_IS_LINK_UP()) . ',tableName=' . $tableName . ',keyName=' . $keyName . ' - Returning FALSE ...');
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'result[]=' . gettype($result) . ',isLinkUp=' . intval(isSqlLinkUp()) . ',tableName=' . $tableName . ',keyName=' . $keyName . ' - Returning FALSE ...');
return $forceFound;
} else {
// Please report this
$doesExist = FALSE;
// Walk through all
- while ($content = SQL_FETCHARRAY($result)) {
+ while ($content = sqlFetchArray($result)) {
// Is it the requested one?
if ($content['Key_name'] == $keyName) {
// Then it is found and exit
} // END - while
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
// Return cache
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'tableName=' . $tableName . ',keyName=' . $keyName . ',doesExist=' . intval($doesExist) . ' - EXIT!');
$engines = array();
// This also worked, now we need to check if the selected database type is supported
- $result = SQL_QUERY('SHOW ENGINES', __FUNCTION__, __LINE__);
+ $result = sqlQuery('SHOW ENGINES', __FUNCTION__, __LINE__);
// Are there entries? (Bad if not)
- if (!SQL_HASZERONUMS($result)) {
+ if (!ifSqlHasZeroNums($result)) {
// Load all and check for active entries
- while ($content = SQL_FETCHARRAY($result)) {
+ while ($content = sqlFetchArray($result)) {
// Debug message
//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'support=' . $requestedEngine . ',Engine=' . $content['Engine'] . ',Support=' . $content['Support']);
}
// Free result
- SQL_FREERESULT($result);
+ sqlFreeResult($result);
// Return result
return $engines;
}
+// "Getter" for result from given table and field/type LIKEs
+function sqlGetResultFromLikeColumnsType ($tableName, $field, $type) {
+ // The table should be there
+ assert(ifSqlTableExists($tableName));
+
+ // Default no field set
+ $fieldSql = '';
+ if (!empty($field)) {
+ // Then use it
+ $fieldSql = "`Field` LIKE '" . $field . "' AND";
+ } // END - if
+
+ // Show them
+ return sqlQueryEscaped("SHOW COLUMNS FROM
+ `{?_MYSQL_PREFIX?}_%s`
+WHERE
+ " . $fieldSql . "
+ `Type` LIKE '%s%%'",
+ array(
+ $tableName,
+ $type
+ ), __FUNCTION__, __LINE__
+ );
+}
+
// [EOF]
?>