Code Coverage
 
Classes and Traits
Functions and Methods
Lines
Total
100.00% covered (success)
0 / 0
100.00% covered (success)
100.00%
0 / 0
CRAP
0.00% covered (danger)
0.00%
0 / 1764
dec
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
inc
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
is_positive
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
not
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
str_to_bool
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 4
is_empty
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
str_to_primary_group
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 20
is_item_locked
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
days_to_seconds
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
is_user_anonymous
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
auto_id
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 8
set_user_type
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
minutes_to_hours
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
get_group_id
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 25
gen_email_hash
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
is_topic_locked
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
make_uid
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 9
validate_website
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 11
null_to_zero
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
null_to_str
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
get_config_value
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 12
decode_ip
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 12
decode_ban_ip
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
mimetype
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 57
remote_avatar_dims
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 22
import_avatar_gallery
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 52
import_attachment_files
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 18
attachment_forum_perms
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 7
base64_unpack
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 15
_import_check
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 27
import_attachment
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 31
import_rank
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 13
import_smiley
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 13
import_avatar
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 17
get_image_dim
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 14
get_smiley_width
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
get_smiley_height
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
get_smiley_dim
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 28
get_avatar_width
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
get_avatar_height
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 3
get_avatar_dim
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 36
get_upload_avatar_dim
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 33
get_gallery_avatar_dim
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 29
get_remote_avatar_dim
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 62
set_user_options
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 27
make_unique_filename
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 19
words_unique
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 11
add_user_group
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 9
user_group_auth
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 36
get_config
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 69
restore_config
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 33
update_folder_pm_count
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 14
path
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 19
extract_variables_from_file
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 6
get_path
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 66
compare_table
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 20
mass_auth
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 167
update_unread_count
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 15
add_default_groups
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 39
add_groups_to_teampage
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 26
sync_post_count
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 15
add_bots
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 106
update_dynamic_config
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 53
update_topics_posted
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 59
fix_empty_primary_groups
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 44
remove_invalid_users
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 17
convert_bbcode
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 95
copy_file
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 43
copy_dir
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 95
relative_base
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 14
get_smiley_display
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 5
fill_dateformat
0.00% covered (danger)
0.00%
0 / 1
0
0.00% covered (danger)
0.00%
0 / 4
<?php
/**
*
* This file is part of the phpBB Forum Software package.
*
* @copyright (c) phpBB Limited <https://www.phpbb.com>
* @license GNU General Public License, version 2 (GPL-2.0)
*
* For full copyright and license information, please see
* the docs/CREDITS.txt file.
*
*/
/**
* @ignore
*/
if (!defined('IN_PHPBB'))
{
    exit;
}
/**
* Default avatar width/height
* @ignore
*/
define('DEFAULT_AVATAR_X', 80);
define('DEFAULT_AVATAR_Y', 80);
// Global functions - all functions can be used by convertors
// SIMPLE FUNCTIONS
/**
* Return the preceding value
*/
function dec($var)
{
    return --$var;
}
/**
* Return the next value
*/
function inc($var)
{
    return ++$var;
}
/**
* Return whether the value is positive
*/
function is_positive($n)
{
    return ($n > 0) ? 1 : 0;
}
/**
* Boolean inverse of the value
*/
function not($var)
{
    return ($var) ? 0 : 1;
}
/**
* Convert a textual value to it's equivalent boolean value
*
* @param string $str String to convert (converts yes, on, y, 1 and true to boolean true)
* @return boolean The equivalent value
*/
function str_to_bool($str)
{
    $str = strtolower($str);
    return ($str == 'yes' || $str == 'on' || $str == 'y' || $str == 'true' || $str == '1') ? true : false;
}
/**
* Function to mimic php's empty() function (it is the same)
*/
function is_empty($mixed)
{
    return empty($mixed);
}
/**
* Convert the name of a user's primary group to the appropriate equivalent phpBB group id
*
* @param string $status The name of the group
* @return int The group_id corresponding to the equivalent group
*/
function str_to_primary_group($status)
{
    switch (ucfirst(strtolower($status)))
    {
        case 'Administrator':
            return get_group_id('administrators');
        break;
        case 'Super moderator':
        case 'Global moderator':
        case 'Moderator':
            return get_group_id('global_moderators');
        break;
        case 'Guest':
        case 'Anonymous':
            return get_group_id('guests');
        break;
        default:
            return get_group_id('registered');
        break;
    }
}
/**
* Convert a boolean into the appropriate phpBB constant indicating whether the item is locked
*/
function is_item_locked($bool)
{
    return ($bool) ? ITEM_LOCKED : ITEM_UNLOCKED;
}
/**
* Convert a value from days to seconds
*/
function days_to_seconds($days)
{
    return ($days * 86400);
}
/**
* Determine whether a user is anonymous and return the appropriate new user_id
*/
function is_user_anonymous($user_id)
{
    return ($user_id > ANONYMOUS) ? $user_id : ANONYMOUS;
}
/**
* Generate a key value based on existing values
*
* @param int $pad Amount to add to the maximum value
* @return int Key value
*/
function auto_id($pad = 0)
{
    global $auto_id, $convert_row;
    if (!empty($convert_row['max_id']))
    {
        return $convert_row['max_id'] + $pad;
    }
    return $auto_id + $pad;
}
/**
* Convert a boolean into the appropriate phpBB constant indicating whether the user is active
*/
function set_user_type($user_active)
{
    return ($user_active) ? USER_NORMAL : USER_INACTIVE;
}
/**
* Convert a value from minutes to hours
*/
function minutes_to_hours($minutes)
{
    return ($minutes / 3600);
}
/**
* Return the group_id for a given group name
*/
function get_group_id($group_name)
{
    global $db, $group_mapping;
    if (empty($group_mapping))
    {
        $sql = 'SELECT group_name, group_id
            FROM ' . GROUPS_TABLE;
        $result = $db->sql_query($sql);
        $group_mapping = array();
        while ($row = $db->sql_fetchrow($result))
        {
            $group_mapping[strtoupper($row['group_name'])] = (int) $row['group_id'];
        }
        $db->sql_freeresult($result);
    }
    if (!count($group_mapping))
    {
        add_default_groups();
        return get_group_id($group_name);
    }
    if (isset($group_mapping[strtoupper($group_name)]))
    {
        return $group_mapping[strtoupper($group_name)];
    }
    return $group_mapping['REGISTERED'];
}
/**
* Generate the email hash stored in the users table
*
* Note: Deprecated, calls should directly go to phpbb_email_hash()
*/
function gen_email_hash($email)
{
    return phpbb_email_hash($email);
}
/**
* Convert a boolean into the appropriate phpBB constant indicating whether the topic is locked
*/
function is_topic_locked($bool)
{
    return (!empty($bool)) ? ITEM_LOCKED : ITEM_UNLOCKED;
}
/**
* Generate a bbcode_uid value
*/
function make_uid($timestamp)
{
    static $last_timestamp, $last_uid;
    if (empty($last_timestamp) || $timestamp != $last_timestamp)
    {
        $last_uid = substr(base_convert(unique_id(), 16, 36), 0, BBCODE_UID_LEN);
    }
    $last_timestamp = $timestamp;
    return $last_uid;
}
/**
* Validate a website address
*/
function validate_website($url)
{
    if ($url === 'http://')
    {
        return '';
    }
    else if (!preg_match('#^http[s]?://#i', $url) && strlen($url) > 0)
    {
        return 'http://' . $url;
    }
    return $url;
}
/**
* Convert nulls to zeros for fields which allowed a NULL value in the source but not the destination
*/
function null_to_zero($value)
{
    return ($value === NULL) ? 0 : $value;
}
/**
* Convert nulls to empty strings for fields which allowed a NULL value in the source but not the destination
*/
function null_to_str($value)
{
    return ($value === NULL) ? '' : $value;
}
// EXTENDED FUNCTIONS
/**
* Get old config value
*/
function get_config_value($config_name)
{
    static $convert_config;
    if (!isset($convert_config))
    {
        $convert_config = get_config();
    }
    if (!isset($convert_config[$config_name]))
    {
        return false;
    }
    return (empty($convert_config[$config_name])) ? '' : $convert_config[$config_name];
}
/**
* Convert an IP address from the hexadecimal notation to normal dotted-quad notation
*/
function decode_ip($int_ip)
{
    if (!$int_ip)
    {
        return $int_ip;
    }
    $hexipbang = explode('.', chunk_split($int_ip, 2, '.'));
    // Any mod changing the way ips are stored? Then we are not able to convert and enter the ip "as is" to not "destroy" anything...
    if (count($hexipbang) < 4)
    {
        return $int_ip;
    }
    return hexdec($hexipbang[0]) . '.' . hexdec($hexipbang[1]) . '.' . hexdec($hexipbang[2]) . '.' . hexdec($hexipbang[3]);
}
/**
* Reverse the encoding of wild-carded bans
*/
function decode_ban_ip($int_ip)
{
    return str_replace('255', '*', decode_ip($int_ip));
}
/**
* Determine the MIME-type of a specified filename
* This does not actually inspect the file, but simply uses the file extension
*/
function mimetype($filename)
{
    if (!preg_match('/\.([a-z0-9]+)$/i', $filename, $m))
    {
        return 'application/octet-stream';
    }
    switch (strtolower($m[1]))
    {
        case 'zip':        return 'application/zip';
        case 'jpeg':    return 'image/jpeg';
        case 'jpg':        return 'image/jpeg';
        case 'jpe':        return 'image/jpeg';
        case 'png':        return 'image/png';
        case 'gif':        return 'image/gif';
        case 'htm':
        case 'html':    return 'text/html';
        case 'tif':        return 'image/tiff';
        case 'tiff':    return 'image/tiff';
        case 'ras':        return 'image/x-cmu-raster';
        case 'pnm':        return 'image/x-portable-anymap';
        case 'pbm':        return 'image/x-portable-bitmap';
        case 'pgm':        return 'image/x-portable-graymap';
        case 'ppm':        return 'image/x-portable-pixmap';
        case 'rgb':        return 'image/x-rgb';
        case 'xbm':        return 'image/x-xbitmap';
        case 'xpm':        return 'image/x-xpixmap';
        case 'xwd':        return 'image/x-xwindowdump';
        case 'z':        return 'application/x-compress';
        case 'gtar':    return 'application/x-gtar';
        case 'tgz':        return 'application/x-gtar';
        case 'gz':        return 'application/x-gzip';
        case 'tar':        return 'application/x-tar';
        case 'xls':        return 'application/excel';
        case 'pdf':        return 'application/pdf';
        case 'ppt':        return 'application/powerpoint';
        case 'rm':        return 'application/vnd.rn-realmedia';
        case 'wma':        return 'audio/x-ms-wma';
        case 'swf':        return 'application/x-shockwave-flash';
        case 'ief':        return 'image/ief';
        case 'doc':
        case 'dot':
        case 'wrd':        return 'application/msword';
        case 'ai':
        case 'eps':
        case 'ps':        return 'application/postscript';
        case 'asc':
        case 'txt':
        case 'c':
        case 'cc':
        case 'h':
        case 'hh':
        case 'cpp':
        case 'hpp':
        case 'php':
        case 'php3':    return 'text/plain';
        default:         return 'application/octet-stream';
    }
}
/**
* Obtain the dimensions of all remotely hosted avatars
* This should only be called from execute_last
* There can be significant network overhead if there are a large number of remote avatars
* @todo Look at the option of allowing the user to decide whether this is called or to force the dimensions
*/
function remote_avatar_dims()
{
    global $db;
    $sql = 'SELECT user_id, user_avatar
        FROM ' . USERS_TABLE . '
        WHERE user_avatar_type = ' . AVATAR_REMOTE;
    $result = $db->sql_query($sql);
    $remote_avatars = array();
    while ($row = $db->sql_fetchrow($result))
    {
        $remote_avatars[(int) $row['user_id']] = $row['user_avatar'];
    }
    $db->sql_freeresult($result);
    foreach ($remote_avatars as $user_id => $avatar)
    {
        $width = (int) get_remote_avatar_dim($avatar, 0);
        $height = (int) get_remote_avatar_dim($avatar, 1);
        $sql = 'UPDATE ' . USERS_TABLE . '
            SET user_avatar_width = ' . (int) $width . ', user_avatar_height = ' . (int) $height . '
            WHERE user_id = ' . $user_id;
        $db->sql_query($sql);
    }
}
function import_avatar_gallery($gallery_name = '', $subdirs_as_galleries = false)
{
    global $config, $convert, $user;
    $relative_path = empty($convert->convertor['source_path_absolute']);
    // check for trailing slash
    if (rtrim($convert->convertor['avatar_gallery_path'], '/') === '')
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_GALLERY_PATH'], 'import_avatar_gallery()'), __LINE__, __FILE__);
    }
    $src_path = relative_base(path($convert->convertor['avatar_gallery_path'], $relative_path), $relative_path);
    if (is_dir($src_path))
    {
        // Do not die on failure... safe mode restrictions may be in effect.
        copy_dir($convert->convertor['avatar_gallery_path'], path($config['avatar_gallery_path']) . $gallery_name, !$subdirs_as_galleries, false, false, $relative_path);
        // only doing 1 level deep. (ibf 1.x)
        // notes: ibf has 2 tiers: directly in the avatar directory for base gallery (handled in the above statement), plus subdirs(handled below).
        // recursive subdirs ignored. -- i don't know if other forums support recursive galleries. if they do, this following code could be upgraded to be recursive.
        if ($subdirs_as_galleries)
        {
            $dirlist = array();
            if ($handle = @opendir($src_path))
            {
                while ($entry = readdir($handle))
                {
                    if ($entry[0] == '.' || $entry == 'CVS' || $entry == 'index.htm')
                    {
                        continue;
                    }
                    if (is_dir($src_path . $entry))
                    {
                        $dirlist[] = $entry;
                    }
                }
                closedir($handle);
            }
            else if ($dir = @dir($src_path))
            {
                while ($entry = $dir->read())
                {
                    if ($entry[0] == '.' || $entry == 'CVS' || $entry == 'index.htm')
                    {
                        continue;
                    }
                    if (is_dir($src_path . $entry))
                    {
                        $dirlist[] = $entry;
                    }
                }
                $dir->close();
            }
            for ($i = 0, $end = count($dirlist); $i < $end; ++$i)
            {
                $dir = $dirlist[$i];
                // Do not die on failure... safe mode restrictions may be in effect.
                copy_dir(path($convert->convertor['avatar_gallery_path'], $relative_path) . $dir, path($config['avatar_gallery_path']) . $dir, true, false, false, $relative_path);
            }
        }
    }
}
function import_attachment_files($category_name = '')
{
    global $config, $convert, $db, $user;
    $sql = 'SELECT config_value AS upload_path
        FROM ' . CONFIG_TABLE . "
        WHERE config_name = 'upload_path'";
    $result = $db->sql_query($sql);
    $config['upload_path'] = $db->sql_fetchfield('upload_path');
    $db->sql_freeresult($result);
    $relative_path = empty($convert->convertor['source_path_absolute']);
    if (empty($convert->convertor['upload_path']))
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_UPLOAD_DIR'], 'import_attachment_files()'), __LINE__, __FILE__);
    }
    if (is_dir(relative_base(path($convert->convertor['upload_path'], $relative_path), $relative_path)))
    {
        copy_dir($convert->convertor['upload_path'], path($config['upload_path']) . $category_name, true, false, true, $relative_path);
    }
}
function attachment_forum_perms($forum_id)
{
    if (!is_array($forum_id))
    {
        $forum_id = array($forum_id);
    }
    return serialize($forum_id);
}
// base64todec function
// -> from php manual?
function base64_unpack($string)
{
    $chars = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ+-';
    $base = strlen($chars);
    $length = strlen($string);
    $number = 0;
    for ($i = 1; $i <= $length; $i++)
    {
        $pos = $length - $i;
        $operand = strpos($chars, substr($string, $pos, 1));
        $exponent = pow($base, $i-1);
        $dec_value = $operand * $exponent;
        $number += $dec_value;
    }
    return $number;
}
function _import_check($config_var, $source, $use_target)
{
    global $convert, $config;
    $result = array(
        'orig_source'    => $source,
        'copied'        => false,
        'relative_path'    => (empty($convert->convertor['source_path_absolute'])) ? true : false,
    );
    // copy file will prepend $phpBB_root_path
    $target = $config[$config_var] . '/' . utf8_basename(($use_target === false) ? $source : $use_target);
    if (!empty($convert->convertor[$config_var]) && strpos($source, $convert->convertor[$config_var]) !== 0)
    {
        $source = $convert->convertor[$config_var] . $source;
    }
    $result['source'] = $source;
    if (file_exists(relative_base($source, $result['relative_path'], __LINE__, __FILE__)))
    {
        $result['copied'] = copy_file($source, $target, false, false, $result['relative_path']);
    }
    if ($result['copied'])
    {
        $result['target'] = utf8_basename($target);
    }
    else
    {
        $result['target'] = ($use_target !== false) ? $result['orig_source'] : utf8_basename($target);
    }
    return $result;
}
function import_attachment($source, $use_target = false)
{
    if (empty($source))
    {
        return '';
    }
    global $convert, $config, $user;
    // check for trailing slash
    if (rtrim($convert->convertor['upload_path'], '/') === '')
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_UPLOAD_DIR'], 'import_attachment()'), __LINE__, __FILE__);
    }
    $result = _import_check('upload_path', $source, $use_target);
    if ($result['copied'])
    {
        // Thumbnails?
        if (is_array($convert->convertor['thumbnails']))
        {
            $thumb_dir = $convert->convertor['thumbnails'][0];
            $thumb_prefix = $convert->convertor['thumbnails'][1];
            $thumb_source = $thumb_dir . $thumb_prefix . utf8_basename($result['source']);
            if (strpos($thumb_source, $convert->convertor['upload_path']) !== 0)
            {
                $thumb_source = $convert->convertor['upload_path'] . $thumb_source;
            }
            $thumb_target = $config['upload_path'] . '/thumb_' . $result['target'];
            if (file_exists(relative_base($thumb_source, $result['relative_path'], __LINE__, __FILE__)))
            {
                copy_file($thumb_source, $thumb_target, false, false, $result['relative_path']);
            }
        }
    }
    return $result['target'];
}
function import_rank($source, $use_target = false)
{
    if (empty($source))
    {
        return '';
    }
    global $convert, $user;
    if (!isset($convert->convertor['ranks_path']))
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_RANKS_PATH'], 'import_rank()'), __LINE__, __FILE__);
    }
    $result = _import_check('ranks_path', $source, $use_target);
    return $result['target'];
}
function import_smiley($source, $use_target = false)
{
    if (empty($source))
    {
        return '';
    }
    global $convert, $user;
    // check for trailing slash
    if (rtrim($convert->convertor['smilies_path'], '/') === '')
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_SMILIES_PATH'], 'import_smiley()'), __LINE__, __FILE__);
    }
    $result = _import_check('smilies_path', $source, $use_target);
    return $result['target'];
}
/*
*/
function import_avatar($source, $use_target = false, $user_id = false)
{
    if (empty($source) || preg_match('#^https?:#i', $source) || preg_match('#blank\.(gif|png)$#i', $source))
    {
        return;
    }
    global $convert, $config, $user;
    // check for trailing slash
    if (rtrim($convert->convertor['avatar_path'], '/') === '')
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_AVATAR_PATH'], 'import_avatar()'), __LINE__, __FILE__);
    }
    if ($use_target === false && $user_id !== false)
    {
        $use_target = $config['avatar_salt'] . '_' . $user_id . '.' . substr(strrchr($source, '.'), 1);
    }
    _import_check('avatar_path', $source, $use_target);
    return ((!empty($user_id)) ? $user_id : $use_target) . '.' . substr(strrchr($source, '.'), 1);
}
/**
* @todo all image dimension functions below (there are a *lot*) should get revisited and converted to one or two functions (no more needed, really).
*/
/**
* Calculate the size of the specified image
* Called from the following functions for calculating the size of specific image types
*/
function get_image_dim($source)
{
    if (empty($source))
    {
        return array(0, 0);
    }
    global $convert;
    $relative_path = empty($convert->convertor['source_path_absolute']);
    if (file_exists(relative_base($source, $relative_path)))
    {
        $image = relative_base($source, $relative_path);
        return @getimagesize($image);
    }
    return false;
}
/**
* Obtain the width of the specified smilie
*/
function get_smiley_width($src)
{
    return get_smiley_dim($src, 0);
}
/**
* Obtain the height of the specified smilie
*/
function get_smiley_height($src)
{
    return get_smiley_dim($src, 1);
}
/**
* Obtain the size of the specified smilie (using the cache if possible) and cache the value
*/
function get_smiley_dim($source, $axis)
{
    if (empty($source))
    {
        return 15;
    }
    static $smiley_cache = array();
    if (isset($smiley_cache[$source]))
    {
        return $smiley_cache[$source][$axis];
    }
    global $convert, $user;
    $orig_source = $source;
    if (!isset($convert->convertor['smilies_path']))
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_SMILIES_PATH'], 'get_smiley_dim()'), __LINE__, __FILE__);
    }
    if (!empty($convert->convertor['smilies_path']) && strpos($source, $convert->convertor['smilies_path']) !== 0)
    {
        $source = $convert->convertor['smilies_path'] . $source;
    }
    $smiley_cache[$orig_source] = get_image_dim($source);
    if (empty($smiley_cache[$orig_source]) || empty($smiley_cache[$orig_source][0]) || empty($smiley_cache[$orig_source][1]))
    {
        $smiley_cache[$orig_source] = array(15, 15);
        return 15;
    }
    return $smiley_cache[$orig_source][$axis];
}
/**
* Obtain the width of the specified avatar
*/
function get_avatar_width($src, $func = false, $arg1 = false, $arg2 = false)
{
    return get_avatar_dim($src, 0, $func, $arg1, $arg2);
}
/**
* Obtain the height of the specified avatar
*/
function get_avatar_height($src, $func = false, $arg1 = false, $arg2 = false)
{
    return get_avatar_dim($src, 1, $func, $arg1, $arg2);
}
/**
*/
function get_avatar_dim($src, $axis, $func = false, $arg1 = false, $arg2 = false)
{
    $avatar_type = AVATAR_UPLOAD;
    if ($func)
    {
        if ($arg1 || $arg2)
        {
            $ary = array($arg1);
            if ($arg2)
            {
                $ary[] = $arg2;
            }
            $avatar_type = call_user_func_array($func, $ary);
        }
        else
        {
            $avatar_type = call_user_func($func);
        }
    }
    switch ($avatar_type)
    {
        case AVATAR_UPLOAD:
            return get_upload_avatar_dim($src, $axis);
        break;
        case AVATAR_GALLERY:
            return get_gallery_avatar_dim($src, $axis);
        break;
        case AVATAR_REMOTE:
            // see notes on this functions usage and (hopefully) model $func to avoid this accordingly
            return get_remote_avatar_dim($src, $axis);
        break;
        default:
            $default_x = (defined('DEFAULT_AVATAR_X_CUSTOM')) ? DEFAULT_AVATAR_X_CUSTOM : DEFAULT_AVATAR_X;
            $default_y = (defined('DEFAULT_AVATAR_Y_CUSTOM')) ? DEFAULT_AVATAR_Y_CUSTOM : DEFAULT_AVATAR_Y;
            return $axis ? $default_y : $default_x;
        break;
    }
}
/**
* Obtain the size of the specified uploaded avatar (using the cache if possible) and cache the value
*/
function get_upload_avatar_dim($source, $axis)
{
    static $cachedims = false;
    static $cachekey = false;
    if (empty($source))
    {
        return 0;
    }
    if ($cachekey == $source)
    {
        return $cachedims[$axis];
    }
    if (substr($source, 0, 7) == 'upload:')
    {
        $source = substr($source, 7);
    }
    global $convert, $user;
    if (!isset($convert->convertor['avatar_path']))
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_AVATAR_PATH'], 'get_upload_avatar_dim()'), __LINE__, __FILE__);
    }
    if (!empty($convert->convertor['avatar_path']) && strpos($source, $convert->convertor['avatar_path']) !== 0)
    {
        $source = path($convert->convertor['avatar_path'], empty($convert->convertor['source_path_absolute'])) . $source;
    }
    $cachedims = get_image_dim($source);
    if (empty($cachedims) || empty($cachedims[0]) || empty($cachedims[1]))
    {
        $default_x = (defined('DEFAULT_AVATAR_X_CUSTOM')) ? DEFAULT_AVATAR_X_CUSTOM : DEFAULT_AVATAR_X;
        $default_y = (defined('DEFAULT_AVATAR_Y_CUSTOM')) ? DEFAULT_AVATAR_Y_CUSTOM : DEFAULT_AVATAR_Y;
        $cachedims = array($default_x, $default_y);
    }
    return $cachedims[$axis];
}
/**
* Obtain the size of the specified gallery avatar (using the cache if possible) and cache the value
*/
function get_gallery_avatar_dim($source, $axis)
{
    if (empty($source))
    {
        return 0;
    }
    static $avatar_cache = array();
    if (isset($avatar_cache[$source]))
    {
        return $avatar_cache[$source][$axis];
    }
    global $convert, $user;
    $orig_source = $source;
    if (!isset($convert->convertor['avatar_gallery_path']))
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_GALLERY_PATH'], 'get_gallery_avatar_dim()'), __LINE__, __FILE__);
    }
    if (!empty($convert->convertor['avatar_gallery_path']) && strpos($source, $convert->convertor['avatar_gallery_path']) !== 0)
    {
        $source = path($convert->convertor['avatar_gallery_path'], empty($convert->convertor['source_path_absolute'])) . $source;
    }
    $avatar_cache[$orig_source] = get_image_dim($source);
    if (empty($avatar_cache[$orig_source]) || empty($avatar_cache[$orig_source][0]) || empty($avatar_cache[$orig_source][1]))
    {
        $default_x = (defined('DEFAULT_AVATAR_X_CUSTOM')) ? DEFAULT_AVATAR_X_CUSTOM : DEFAULT_AVATAR_X;
        $default_y = (defined('DEFAULT_AVATAR_Y_CUSTOM')) ? DEFAULT_AVATAR_Y_CUSTOM : DEFAULT_AVATAR_Y;
        $avatar_cache[$orig_source] = array($default_x, $default_y);
    }
    return $avatar_cache[$orig_source][$axis];
}
/**
* Obtain the size of the specified remote avatar (using the cache if possible) and cache the value
* Whilst it's unlikely that remote avatars will be duplicated, it is possible so caching seems the best option
* This should only be called from a post processing step due to the possibility of network timeouts
*/
function get_remote_avatar_dim($src, $axis)
{
    if (empty($src))
    {
        return 0;
    }
    static $remote_avatar_cache = array();
    // an ugly hack: we assume that the dimensions of each remote avatar are accessed exactly twice (x and y)
    if (isset($remote_avatar_cache[$src]))
    {
        $retval = $remote_avatar_cache[$src][$axis];
        unset($remote_avatar_cache);
        return $retval;
    }
    $url_info = @parse_url($src);
    if (empty($url_info['host']))
    {
        return 0;
    }
    $host = $url_info['host'];
    $port = (isset($url_info['port'])) ? $url_info['port'] : 0;
    $protocol = (isset($url_info['scheme'])) ? $url_info['scheme'] : 'http';
    if (empty($port))
    {
        switch (strtolower($protocol))
        {
            case 'ftp':
                $port = 21;
                break;
            case 'https':
                $port = 443;
                break;
            default:
                $port = 80;
        }
    }
    $timeout = @ini_get('default_socket_timeout');
    @ini_set('default_socket_timeout', 2);
    // We're just trying to reach the server to avoid timeouts
    $fp = @fsockopen($host, $port, $errno, $errstr, 1);
    if ($fp)
    {
        $remote_avatar_cache[$src] = @getimagesize($src);
        fclose($fp);
    }
    $default_x     = (defined('DEFAULT_AVATAR_X_CUSTOM')) ? DEFAULT_AVATAR_X_CUSTOM : DEFAULT_AVATAR_X;
    $default_y     = (defined('DEFAULT_AVATAR_Y_CUSTOM')) ? DEFAULT_AVATAR_Y_CUSTOM : DEFAULT_AVATAR_Y;
    $default     = array($default_x, $default_y);
    if (empty($remote_avatar_cache[$src]) || empty($remote_avatar_cache[$src][0]) || empty($remote_avatar_cache[$src][1]))
    {
        $remote_avatar_cache[$src] = $default;
    }
    else
    {
        // We trust gallery and uploaded avatars to conform to the size settings; we might have to adjust here
        if ($remote_avatar_cache[$src][0] > $default_x || $remote_avatar_cache[$src][1] > $default_y)
        {
            $bigger = ($remote_avatar_cache[$src][0] > $remote_avatar_cache[$src][1]) ? 0 : 1;
            $ratio = $default[$bigger] / $remote_avatar_cache[$src][$bigger];
            $remote_avatar_cache[$src][0] = (int) ($remote_avatar_cache[$src][0] * $ratio);
            $remote_avatar_cache[$src][1] = (int) ($remote_avatar_cache[$src][1] * $ratio);
        }
    }
    @ini_set('default_socket_timeout', $timeout);
    return $remote_avatar_cache[$src][$axis];
}
function set_user_options()
{
    global $convert_row;
    // Key need to be set in row, else default value is chosen
    $keyoptions = array(
        'viewimg'        => array('bit' => 0, 'default' => 1),
        'viewflash'        => array('bit' => 1, 'default' => 1),
        'viewsmilies'    => array('bit' => 2, 'default' => 1),
        'viewsigs'        => array('bit' => 3, 'default' => 1),
        'viewavatars'    => array('bit' => 4, 'default' => 1),
        'viewcensors'    => array('bit' => 5, 'default' => 1),
        'attachsig'        => array('bit' => 6, 'default' => 0),
        'bbcode'        => array('bit' => 8, 'default' => 1),
        'smilies'        => array('bit' => 9, 'default' => 1),
        'sig_bbcode'    => array('bit' => 15, 'default' => 1),
        'sig_smilies'    => array('bit' => 16, 'default' => 1),
        'sig_links'        => array('bit' => 17, 'default' => 1),
    );
    $option_field = 0;
    foreach ($keyoptions as $key => $key_ary)
    {
        $value = (isset($convert_row[$key])) ? (int) $convert_row[$key] : $key_ary['default'];
        if ($value && !($option_field & 1 << $key_ary['bit']))
        {
            $option_field += 1 << $key_ary['bit'];
        }
    }
    return $option_field;
}
/**
* Index messages on the fly as we convert them
* @todo naderman, can you check that this works with the new search plugins as it's use is currently disabled (and thus untested)
function search_indexing($message = '')
{
    global $fulltext_search, $convert_row;
    if (!isset($convert_row['post_id']))
    {
        return;
    }
    if (!$message)
    {
        if (!isset($convert_row['message']))
        {
            return;
        }
        $message = $convert_row['message'];
    }
    $title = (isset($convert_row['title'])) ? $convert_row['title'] : '';
    $fulltext_search->index('post', $convert_row['post_id'], $message, $title, $convert_row['poster_id'], $convert_row['forum_id']);
}
*/
function make_unique_filename($filename)
{
    if (!strlen($filename))
    {
        $filename = md5(unique_id()) . '.dat';
    }
    else if ($filename[0] == '.')
    {
        $filename = md5(unique_id()) . $filename;
    }
    else if (preg_match('/\.([a-z]+)$/i', $filename, $m))
    {
        $filename = preg_replace('/\.([a-z]+)$/i', '_' . md5(unique_id()) . '.\1', $filename);
    }
    else
    {
        $filename .= '_' . md5(unique_id()) . '.dat';
    }
    return $filename;
}
function words_unique(&$words)
{
    reset($words);
    $return_array = array();
    $word = current($words);
    do
    {
        $return_array[$word] = $word;
    }
    while ($word = next($words));
    return $return_array;
}
/**
* Adds a user to the specified group and optionally makes them a group leader
* This function does not create the group if it does not exist and so should only be called after the groups have been created
*/
function add_user_group($group_id, $user_id, $group_leader = false)
{
    global $db;
    $sql = 'INSERT INTO ' . USER_GROUP_TABLE . ' ' . $db->sql_build_array('INSERT', array(
        'group_id'        => $group_id,
        'user_id'        => $user_id,
        'group_leader'    => ($group_leader) ? 1 : 0,
        'user_pending'    => 0));
    $db->sql_query($sql);
}
// STANDALONE FUNCTIONS
/**
* Add users to the pre-defined "special" groups
*
* @param string $group The name of the special group to add to
* @param string $select_query An SQL query to retrieve the user(s) to add to the group
*/
function user_group_auth($group, $select_query, $use_src_db)
{
    global $convert, $user, $db, $src_db, $same_db;
    if (!in_array($group, array('guests', 'registered', 'registered_coppa', 'global_moderators', 'administrators', 'bots')))
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_WRONG_GROUP'], $group, 'user_group_auth()'), __LINE__, __FILE__, true);
        return;
    }
    $sql = 'SELECT group_id
        FROM ' . GROUPS_TABLE . "
        WHERE group_name = '" . $db->sql_escape(strtoupper($group)) . "'";
    $result = $db->sql_query($sql);
    $group_id = (int) $db->sql_fetchfield('group_id');
    $db->sql_freeresult($result);
    if (!$group_id)
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_NO_GROUP'], $group, 'user_group_auth()'), __LINE__, __FILE__, true);
        return;
    }
    if ($same_db || !$use_src_db)
    {
        $sql = 'INSERT INTO ' . USER_GROUP_TABLE . ' (user_id, group_id, user_pending)
            ' . str_replace('{' . strtoupper($group) . '}', $group_id . ', 0', $select_query);
        $db->sql_query($sql);
    }
    else
    {
        $result = $src_db->sql_query(str_replace('{' . strtoupper($group) . '}', $group_id . ' ', $select_query));
        while ($row = $src_db->sql_fetchrow($result))
        {
            // this might become quite a lot of INSERTS unfortunately
            $sql = 'INSERT INTO ' . USER_GROUP_TABLE . " (user_id, group_id, user_pending)
                VALUES ({$row['user_id']}$group_id, 0)";
            $db->sql_query($sql);
        }
        $src_db->sql_freeresult($result);
    }
}
/**
* Retrieves configuration information from the source forum and caches it as an array
* Both database and file driven configuration formats can be handled
* (the type used is specified in $config_schema, see convert_phpbb20.php for more details)
*/
function get_config()
{
    static $convert_config;
    global $user;
    if (isset($convert_config))
    {
        return $convert_config;
    }
    global $src_db, $same_db;
    global $convert;
    if ($convert->config_schema['table_format'] != 'file')
    {
        if ($convert->mysql_convert && $same_db)
        {
            $src_db->sql_query("SET NAMES 'binary'");
        }
        $sql = 'SELECT * FROM ' . $convert->src_table_prefix . $convert->config_schema['table_name'];
        $result = $src_db->sql_query($sql);
        $row = $src_db->sql_fetchrow($result);
        if (!$row)
        {
            $convert->p_master->error($user->lang['CONV_ERROR_GET_CONFIG'], __LINE__, __FILE__);
        }
    }
    if (is_array($convert->config_schema['table_format']))
    {
        $convert_config = array();
        list($key, $val) = each($convert->config_schema['table_format']);
        do
        {
            $convert_config[$row[$key]] = $row[$val];
        }
        while ($row = $src_db->sql_fetchrow($result));
        $src_db->sql_freeresult($result);
        if ($convert->mysql_convert && $same_db)
        {
            $src_db->sql_query("SET NAMES 'utf8'");
        }
    }
    else if ($convert->config_schema['table_format'] == 'file')
    {
        $filename = $convert->options['forum_path'] . '/' . $convert->config_schema['filename'];
        if (!file_exists($filename))
        {
            $convert->p_master->error($user->lang('FILE_NOT_FOUND', $filename), __LINE__, __FILE__);
        }
        if (isset($convert->config_schema['array_name']))
        {
            unset($convert->config_schema['array_name']);
        }
        $convert_config = extract_variables_from_file($filename);
        if (!empty($convert->config_schema['array_name']))
        {
            $convert_config = $convert_config[$convert->config_schema['array_name']];
        }
    }
    else
    {
        $convert_config = $row;
        if ($convert->mysql_convert && $same_db)
        {
            $src_db->sql_query("SET NAMES 'utf8'");
        }
    }
    if (!count($convert_config))
    {
        $convert->p_master->error($user->lang['CONV_ERROR_CONFIG_EMPTY'], __LINE__, __FILE__);
    }
    return $convert_config;
}
/**
* Transfers the relevant configuration information from the source forum
* The mapping of fields is specified in $config_schema, see convert_phpbb20.php for more details
*/
function restore_config($schema)
{
    global $config;
    $convert_config = get_config();
    foreach ($schema['settings'] as $config_name => $src)
    {
        if (preg_match('/(.*)\((.*)\)/', $src, $m))
        {
            $var = (empty($m[2]) || empty($convert_config[$m[2]])) ? "''" : "'" . addslashes($convert_config[$m[2]]) . "'";
            $exec = '$config_value = ' . $m[1] . '(' . $var . ');';
            // @codingStandardsIgnoreStart
            eval($exec);
            // @codingStandardsIgnoreEnd
        }
        else
        {
            if ($schema['table_format'] != 'file' || empty($schema['array_name']))
            {
                $config_value = (isset($convert_config[$src])) ? $convert_config[$src] : '';
            }
            else if (!empty($schema['array_name']))
            {
                $src_ary = $schema['array_name'];
                $config_value = (isset($convert_config[$src_ary][$src])) ? $convert_config[$src_ary][$src] : '';
            }
        }
        if ($config_value !== '')
        {
            // Most are...
            if (is_string($config_value))
            {
                $config_value = truncate_string(utf8_htmlspecialchars($config_value), 255, 255, false);
            }
            $config->set($config_name, $config_value);
        }
    }
}
/**
* Update the count of PM's in custom folders for all users
*/
function update_folder_pm_count()
{
    global $db;
    $sql = 'SELECT user_id, folder_id, COUNT(msg_id) as num_messages
        FROM ' . PRIVMSGS_TO_TABLE . '
        WHERE folder_id NOT IN (' . PRIVMSGS_NO_BOX . ', ' . PRIVMSGS_HOLD_BOX . ', ' . PRIVMSGS_INBOX . ', ' . PRIVMSGS_OUTBOX . ', ' . PRIVMSGS_SENTBOX . ')
        GROUP BY folder_id, user_id';
    $result = $db->sql_query($sql);
    while ($row = $db->sql_fetchrow($result))
    {
        $db->sql_query('UPDATE ' . PRIVMSGS_FOLDER_TABLE . ' SET pm_count = ' . $row['num_messages'] . '
            WHERE user_id = ' . $row['user_id'] . ' AND folder_id = ' . $row['folder_id']);
    }
    $db->sql_freeresult($result);
}
// Functions mainly used by the main convertor script
function path($path, $path_relative = true)
{
    if ($path === false)
    {
        return '';
    }
    if (substr($path, -1) != '/')
    {
        $path .= '/';
    }
    if (!$path_relative)
    {
        return $path;
    }
    if (substr($path, 0, 1) == '/')
    {
        $path = substr($path, 1);
    }
    return $path;
}
/**
* Extract the variables defined in a configuration file
* @todo As noted by Xore we need to look at this from a security perspective
*/
function extract_variables_from_file($_filename)
{
    include($_filename);
    $vars = get_defined_vars();
    unset($vars['_filename']);
    return $vars;
}
function get_path($src_path, $src_url, $test_file)
{
    global $phpbb_root_path, $phpEx;
    $board_config = get_config();
    $test_file = preg_replace('/\.php$/i', ".$phpEx", $test_file);
    $src_path = path($src_path);
    if (@file_exists($phpbb_root_path . $src_path . $test_file))
    {
        return $src_path;
    }
    if (!empty($src_url) && !empty($board_config['server_name']))
    {
        if (!preg_match('#https?://([^/]+)(.*)#i', $src_url, $m))
        {
            return false;
        }
        if ($m[1] != $board_config['server_name'])
        {
            return false;
        }
        $url_parts = explode('/', $m[2]);
        if (substr($src_url, -1) != '/')
        {
            if (preg_match('/.*\.([a-z0-9]{3,4})$/i', $url_parts[count($url_parts) - 1]))
            {
                $url_parts[count($url_parts) - 1] = '';
            }
            else
            {
                $url_parts[] = '';
            }
        }
        $script_path = $board_config['script_path'];
        if (substr($script_path, -1) == '/')
        {
            $script_path = substr($script_path, 0, -1);
        }
        $path_array = array();
        $phpbb_parts = explode('/', $script_path);
        for ($i = 0, $end = count($url_parts); $i < $end; ++$i)
        {
            if ($i < count($phpbb_parts[$i]) && $url_parts[$i] == $phpbb_parts[$i])
            {
                $path_array[] = $url_parts[$i];
                unset($url_parts[$i]);
            }
            else
            {
                $path = '';
                for ($j = $i, $end2 = count($phpbb_parts); $j < $end2; ++$j)
                {
                    $path .= '../';
                }
                $path .= implode('/', $url_parts);
                break;
            }
        }
        if (!empty($path))
        {
            if (@file_exists($phpbb_root_path . $path . $test_file))
            {
                return $path;
            }
        }
    }
    return false;
}
function compare_table($tables, $tablename, &$prefixes)
{
    for ($i = 0, $table_size = count($tables); $i < $table_size; ++$i)
    {
        if (preg_match('/(.*)' . $tables[$i] . '$/', $tablename, $m))
        {
            if (empty($m[1]))
            {
                $m[1] = '*';
            }
            if (isset($prefixes[$m[1]]))
            {
                $prefixes[$m[1]]++;
            }
            else
            {
                $prefixes[$m[1]] = 1;
            }
        }
    }
}
/**
* Grant permissions to a specified user or group
*
* @param string $ug_type user|group|user_role|group_role
* @param mixed $forum_id forum ids (array|int|0) -> 0 == all forums
* @param mixed $ug_id [int] user_id|group_id : [string] usergroup name
* @param mixed $acl_list [string] acl entry : [array] acl entries : [string] role entry
* @param int $setting ACL_YES|ACL_NO|ACL_NEVER
*/
function mass_auth($ug_type, $forum_id, $ug_id, $acl_list, $setting = ACL_NO)
{
    global $db;
    static $acl_option_ids, $group_ids;
    if (($ug_type == 'group' || $ug_type == 'group_role') && is_string($ug_id))
    {
        if (!isset($group_ids[$ug_id]))
        {
            $sql = 'SELECT group_id
                FROM ' . GROUPS_TABLE . "
                WHERE group_name = '" . $db->sql_escape(strtoupper($ug_id)) . "'";
            $result = $db->sql_query_limit($sql, 1);
            $id = (int) $db->sql_fetchfield('group_id');
            $db->sql_freeresult($result);
            if (!$id)
            {
                return;
            }
            $group_ids[$ug_id] = $id;
        }
        $ug_id = (int) $group_ids[$ug_id];
    }
    $table = ($ug_type == 'user' || $ug_type == 'user_role') ? ACL_USERS_TABLE : ACL_GROUPS_TABLE;
    $id_field = ($ug_type == 'user' || $ug_type == 'user_role') ? 'user_id' : 'group_id';
    // Role based permissions are the simplest to handle so check for them first
    if ($ug_type == 'user_role' || $ug_type == 'group_role')
    {
        if (is_numeric($forum_id))
        {
            $sql = 'SELECT role_id
                FROM ' . ACL_ROLES_TABLE . "
                WHERE role_name = 'ROLE_" . $db->sql_escape($acl_list) . "'";
            $result = $db->sql_query_limit($sql, 1);
            $row = $db->sql_fetchrow($result);
            $db->sql_freeresult($result);
            // If we have no role id there is something wrong here
            if ($row)
            {
                $sql = "INSERT INTO $table ($id_field, forum_id, auth_role_id) VALUES ($ug_id$forum_id" . $row['role_id'] . ')';
                $db->sql_query($sql);
            }
        }
        return;
    }
    // Build correct parameters
    $auth = array();
    if (!is_array($acl_list))
    {
        $auth = array($acl_list => $setting);
    }
    else
    {
        foreach ($acl_list as $auth_option)
        {
            $auth[$auth_option] = $setting;
        }
    }
    unset($acl_list);
    if (!is_array($forum_id))
    {
        $forum_id = array($forum_id);
    }
    // Set any flags as required
    foreach ($auth as $auth_option => $acl_setting)
    {
        $flag = substr($auth_option, 0, strpos($auth_option, '_') + 1);
        if (empty($auth[$flag]))
        {
            $auth[$flag] = $acl_setting;
        }
    }
    if (!is_array($acl_option_ids) || empty($acl_option_ids))
    {
        $sql = 'SELECT auth_option_id, auth_option
            FROM ' . ACL_OPTIONS_TABLE;
        $result = $db->sql_query($sql);
        while ($row = $db->sql_fetchrow($result))
        {
            $acl_option_ids[$row['auth_option']] = $row['auth_option_id'];
        }
        $db->sql_freeresult($result);
    }
    $sql_forum = 'AND ' . $db->sql_in_set('a.forum_id', array_map('intval', $forum_id), false, true);
    $sql = ($ug_type == 'user') ? 'SELECT o.auth_option_id, o.auth_option, a.forum_id, a.auth_setting FROM ' . ACL_USERS_TABLE . ' a, ' . ACL_OPTIONS_TABLE . " o WHERE a.auth_option_id = o.auth_option_id $sql_forum AND a.user_id = $ug_id" : 'SELECT o.auth_option_id, o.auth_option, a.forum_id, a.auth_setting FROM ' . ACL_GROUPS_TABLE . ' a, ' . ACL_OPTIONS_TABLE . " o WHERE a.auth_option_id = o.auth_option_id $sql_forum AND a.group_id = $ug_id";
    $result = $db->sql_query($sql);
    $cur_auth = array();
    while ($row = $db->sql_fetchrow($result))
    {
        $cur_auth[$row['forum_id']][$row['auth_option_id']] = $row['auth_setting'];
    }
    $db->sql_freeresult($result);
    $sql_ary = array();
    foreach ($forum_id as $forum)
    {
        foreach ($auth as $auth_option => $setting)
        {
            $auth_option_id = $acl_option_ids[$auth_option];
            if (!$auth_option_id)
            {
                continue;
            }
            switch ($setting)
            {
                case ACL_NO:
                    if (isset($cur_auth[$forum][$auth_option_id]))
                    {
                        $sql_ary['delete'][] = "DELETE FROM $table
                            WHERE forum_id = $forum
                                AND auth_option_id = $auth_option_id
                                AND $id_field = $ug_id";
                    }
                break;
                default:
                    if (!isset($cur_auth[$forum][$auth_option_id]))
                    {
                        $sql_ary['insert'][] = "$ug_id$forum$auth_option_id$setting";
                    }
                    else if ($cur_auth[$forum][$auth_option_id] != $setting)
                    {
                        $sql_ary['update'][] = "UPDATE " . $table . "
                            SET auth_setting = $setting
                            WHERE $id_field = $ug_id
                                AND forum_id = $forum
                                AND auth_option_id = $auth_option_id";
                    }
            }
        }
    }
    unset($cur_auth);
    $sql = '';
    foreach ($sql_ary as $sql_type => $sql_subary)
    {
        switch ($sql_type)
        {
            case 'insert':
                switch ($db->get_sql_layer())
                {
                    case 'mysql':
                    case 'mysql4':
                        $sql = 'VALUES ' . implode(', ', preg_replace('#^(.*?)$#', '(\1)', $sql_subary));
                    break;
                    case 'sqlite3':
                    case 'mssqlnative':
                        $sql = implode(' UNION ALL ', preg_replace('#^(.*?)$#', 'SELECT \1', $sql_subary));
                    break;
                    default:
                        foreach ($sql_subary as $sql)
                        {
                            $sql = "INSERT INTO $table ($id_field, forum_id, auth_option_id, auth_setting) VALUES ($sql)";
                            $db->sql_query($sql);
                            $sql = '';
                        }
                }
                if ($sql != '')
                {
                    $sql = "INSERT INTO $table ($id_field, forum_id, auth_option_id, auth_setting) $sql";
                    $db->sql_query($sql);
                }
            break;
            case 'update':
            case 'delete':
                foreach ($sql_subary as $sql)
                {
                    $db->sql_query($sql);
                    $sql = '';
                }
            break;
        }
        unset($sql_ary[$sql_type]);
    }
    unset($sql_ary);
}
/**
* Update the count of unread private messages for all users
*/
function update_unread_count()
{
    global $db;
    $sql = 'SELECT user_id, COUNT(msg_id) as num_messages
        FROM ' . PRIVMSGS_TO_TABLE . '
        WHERE pm_unread = 1
            AND folder_id <> ' . PRIVMSGS_OUTBOX . '
        GROUP BY user_id';
    $result = $db->sql_query($sql);
    while ($row = $db->sql_fetchrow($result))
    {
        $db->sql_query('UPDATE ' . USERS_TABLE . ' SET user_unread_privmsg = ' . $row['num_messages'] . '
            WHERE user_id = ' . $row['user_id']);
    }
    $db->sql_freeresult($result);
}
/**
* Add any of the pre-defined "special" groups which are missing from the database
*/
function add_default_groups()
{
    global $db;
    $default_groups = array(
        'GUESTS'            => array('', 0, 0),
        'REGISTERED'        => array('', 0, 0),
        'REGISTERED_COPPA'    => array('', 0, 0),
        'GLOBAL_MODERATORS'    => array('00AA00', 2, 0),
        'ADMINISTRATORS'    => array('AA0000', 1, 1),
        'BOTS'                => array('9E8DA7', 0, 0),
        'NEWLY_REGISTERED'        => array('', 0, 0),
    );
    $sql = 'SELECT *
        FROM ' . GROUPS_TABLE . '
        WHERE ' . $db->sql_in_set('group_name', array_keys($default_groups));
    $result = $db->sql_query($sql);
    while ($row = $db->sql_fetchrow($result))
    {
        unset($default_groups[strtoupper($row['group_name'])]);
    }
    $db->sql_freeresult($result);
    $sql_ary = array();
    foreach ($default_groups as $name => $data)
    {
        $sql_ary[] = array(
            'group_name'            => (string) $name,
            'group_desc'            => '',
            'group_desc_uid'        => '',
            'group_desc_bitfield'    => '',
            'group_type'            => GROUP_SPECIAL,
            'group_colour'            => (string) $data[0],
            'group_legend'            => (int) $data[1],
            'group_founder_manage'    => (int) $data[2],
        );
    }
    if (count($sql_ary))
    {
        $db->sql_multi_insert(GROUPS_TABLE, $sql_ary);
    }
}
function add_groups_to_teampage()
{
    global $db;
    $teampage_groups = array(
        'ADMINISTRATORS'    => 1,
        'GLOBAL_MODERATORS'    => 2,
    );
    $sql = 'SELECT *
        FROM ' . GROUPS_TABLE . '
        WHERE ' . $db->sql_in_set('group_name', array_keys($teampage_groups));
    $result = $db->sql_query($sql);
    $teampage_ary = array();
    while ($row = $db->sql_fetchrow($result))
    {
        $teampage_ary[] = array(
            'group_id'                => (int) $row['group_id'],
            'teampage_name'            => '',
            'teampage_position'        => (int) $teampage_groups[$row['group_name']],
            'teampage_parent'        => 0,
        );
    }
    $db->sql_freeresult($result);
    if (count($teampage_ary))
    {
        $db->sql_multi_insert(TEAMPAGE_TABLE, $teampage_ary);
    }
}
/**
* Sync post count. We might need to do this in batches.
*/
function sync_post_count($offset, $limit)
{
    global $db;
    $sql = 'SELECT COUNT(post_id) AS num_posts, poster_id
            FROM ' . POSTS_TABLE . '
            WHERE post_postcount = 1
                AND post_visibility = ' . ITEM_APPROVED . '
            GROUP BY poster_id
            ORDER BY poster_id';
    $result = $db->sql_query_limit($sql, $limit, $offset);
    while ($row = $db->sql_fetchrow($result))
    {
        $db->sql_query('UPDATE ' . USERS_TABLE . " SET user_posts = {$row['num_posts']} WHERE user_id = {$row['poster_id']}");
    }
    $db->sql_freeresult($result);
}
/**
* Add the search bots into the database
* This code should be used in execute_last if the source database did not have bots
* If you are converting bots this function should not be called
* @todo We might want to look at sharing the bot list between the install code and this code for consistancy
*/
function add_bots()
{
    global $db, $convert, $user, $config, $phpbb_root_path, $phpEx;
    $db->sql_query($convert->truncate_statement . BOTS_TABLE);
    $sql = 'SELECT group_id FROM ' . GROUPS_TABLE . " WHERE group_name = 'BOTS'";
    $result = $db->sql_query($sql);
    $group_id = (int) $db->sql_fetchfield('group_id', false, $result);
    $db->sql_freeresult($result);
    if (!$group_id)
    {
        add_default_groups();
        $sql = 'SELECT group_id FROM ' . GROUPS_TABLE . " WHERE group_name = 'BOTS'";
        $result = $db->sql_query($sql);
        $group_id = (int) $db->sql_fetchfield('group_id', false, $result);
        $db->sql_freeresult($result);
        if (!$group_id)
        {
            global $install;
            $install->error($user->lang['CONV_ERROR_INCONSISTENT_GROUPS'], __LINE__, __FILE__);
        }
    }
    $bots = array(
        'AdsBot [Google]'            => array('AdsBot-Google', ''),
        'Alexa [Bot]'                => array('ia_archiver', ''),
        'Alta Vista [Bot]'            => array('Scooter/', ''),
        'Ask Jeeves [Bot]'            => array('Ask Jeeves', ''),
        'Baidu [Spider]'            => array('Baiduspider+(', ''),
        'Bing [Bot]'                => array('bingbot/', ''),
        'Exabot [Bot]'                => array('Exabot/', ''),
        'FAST Enterprise [Crawler]'    => array('FAST Enterprise Crawler', ''),
        'FAST WebCrawler [Crawler]'    => array('FAST-WebCrawler/', ''),
        'Francis [Bot]'                => array('http://www.neomo.de/', ''),
        'Gigabot [Bot]'                => array('Gigabot/', ''),
        'Google Adsense [Bot]'        => array('Mediapartners-Google', ''),
        'Google Desktop'            => array('Google Desktop', ''),
        'Google Feedfetcher'        => array('Feedfetcher-Google', ''),
        'Google [Bot]'                => array('Googlebot', ''),
        'Heise IT-Markt [Crawler]'    => array('heise-IT-Markt-Crawler', ''),
        'Heritrix [Crawler]'        => array('heritrix/1.', ''),
        'IBM Research [Bot]'        => array('ibm.com/cs/crawler', ''),
        'ICCrawler - ICjobs'        => array('ICCrawler - ICjobs', ''),
        'ichiro [Crawler]'            => array('ichiro/2', ''),
        'Majestic-12 [Bot]'            => array('MJ12bot/', ''),
        'Metager [Bot]'                => array('MetagerBot/', ''),
        'MSN NewsBlogs'                => array('msnbot-NewsBlogs/', ''),
        'MSN [Bot]'                    => array('msnbot/', ''),
        'MSNbot Media'                => array('msnbot-media/', ''),
        'NG-Search [Bot]'            => array('NG-Search/', ''),
        'Nutch [Bot]'                => array('http://lucene.apache.org/nutch/', ''),
        'Nutch/CVS [Bot]'            => array('NutchCVS/', ''),
        'OmniExplorer [Bot]'        => array('OmniExplorer_Bot/', ''),
        'Online link [Validator]'    => array('online link validator', ''),
        'psbot [Picsearch]'            => array('psbot/0', ''),
        'Seekport [Bot]'            => array('Seekbot/', ''),
        'Sensis [Crawler]'            => array('Sensis Web Crawler', ''),
        'SEO Crawler'                => array('SEO search Crawler/', ''),
        'Seoma [Crawler]'            => array('Seoma [SEO Crawler]', ''),
        'SEOSearch [Crawler]'        => array('SEOsearch/', ''),
        'Snappy [Bot]'                => array('Snappy/1.1 ( http://www.urltrends.com/ )', ''),
        'Steeler [Crawler]'            => array('http://www.tkl.iis.u-tokyo.ac.jp/~crawler/', ''),
        'Synoo [Bot]'                => array('SynooBot/', ''),
        'Telekom [Bot]'                => array('crawleradmin.t-info@telekom.de', ''),
        'TurnitinBot [Bot]'            => array('TurnitinBot/', ''),
        'Voyager [Bot]'                => array('voyager/1.0', ''),
        'W3 [Sitesearch]'            => array('W3 SiteSearch Crawler', ''),
        'W3C [Linkcheck]'            => array('W3C-checklink/', ''),
        'W3C [Validator]'            => array('W3C_*Validator', ''),
        'WiseNut [Bot]'                => array('http://www.WISEnutbot.com', ''),
        'YaCy [Bot]'                => array('yacybot', ''),
        'Yahoo MMCrawler [Bot]'        => array('Yahoo-MMCrawler/', ''),
        'Yahoo Slurp [Bot]'            => array('Yahoo! DE Slurp', ''),
        'Yahoo [Bot]'                => array('Yahoo! Slurp', ''),
        'YahooSeeker [Bot]'            => array('YahooSeeker/', ''),
    );
    if (!function_exists('user_add'))
    {
        include($phpbb_root_path . 'includes/functions_user.' . $phpEx);
    }
    foreach ($bots as $bot_name => $bot_ary)
    {
        $user_row = array(
            'user_type'                => USER_IGNORE,
            'group_id'                => $group_id,
            'username'                => $bot_name,
            'user_regdate'            => time(),
            'user_password'            => '',
            'user_colour'            => '9E8DA7',
            'user_email'            => '',
            'user_lang'                => $config['default_lang'],
            'user_style'            => 1,
            'user_timezone'            => 'UTC',
            'user_allow_massemail'    => 0,
        );
        $user_id = user_add($user_row);
        if ($user_id)
        {
            $sql = 'INSERT INTO ' . BOTS_TABLE . ' ' . $db->sql_build_array('INSERT', array(
                'bot_active'    => 1,
                'bot_name'        => $bot_name,
                'user_id'        => $user_id,
                'bot_agent'        => $bot_ary[0],
                'bot_ip'        => $bot_ary[1])
            );
            $db->sql_query($sql);
        }
    }
}
/**
* Update any dynamic configuration variables after the conversion is finished
* @todo Confirm that this updates all relevant values since it has not necessarily been kept in sync with all changes
*/
function update_dynamic_config()
{
    global $db, $config;
    // Get latest username
    $sql = 'SELECT user_id, username, user_colour
        FROM ' . USERS_TABLE . '
        WHERE user_type IN (' . USER_NORMAL . ', ' . USER_FOUNDER . ')';
    if (!empty($config['increment_user_id']))
    {
        $sql .= ' AND user_id <> ' . $config['increment_user_id'];
    }
    $sql .= ' ORDER BY user_id DESC';
    $result = $db->sql_query_limit($sql, 1);
    $row = $db->sql_fetchrow($result);
    $db->sql_freeresult($result);
    if ($row)
    {
        $config->set('newest_user_id', $row['user_id'], false);
        $config->set('newest_username', $row['username'], false);
        $config->set('newest_user_colour', $row['user_colour'], false);
    }
//    Also do not reset record online user/date. There will be old data or the fresh data from the schema.
//    set_config('record_online_users', 1, true);
//    set_config('record_online_date', time(), true);
    $sql = 'SELECT COUNT(post_id) AS stat
        FROM ' . POSTS_TABLE . '
        WHERE post_visibility = ' . ITEM_APPROVED;
    $result = $db->sql_query($sql);
    $row = $db->sql_fetchrow($result);
    $db->sql_freeresult($result);
    $config->set('num_posts', (int) $row['stat'], false);
    $sql = 'SELECT COUNT(topic_id) AS stat
        FROM ' . TOPICS_TABLE . '
        WHERE topic_visibility = ' . ITEM_APPROVED;
    $result = $db->sql_query($sql);
    $row = $db->sql_fetchrow($result);
    $db->sql_freeresult($result);
    $config->set('num_topics', (int) $row['stat'], false);
    $sql = 'SELECT COUNT(user_id) AS stat
        FROM ' . USERS_TABLE . '
        WHERE user_type IN (' . USER_NORMAL . ',' . USER_FOUNDER . ')';
    $result = $db->sql_query($sql);
    $row = $db->sql_fetchrow($result);
    $db->sql_freeresult($result);
    $config->set('num_users', (int) $row['stat'], false);
    $sql = 'SELECT COUNT(attach_id) as stat
        FROM ' . ATTACHMENTS_TABLE . '
        WHERE is_orphan = 0';
    $result = $db->sql_query($sql);
    $config->set('num_files', (int) $db->sql_fetchfield('stat'), false);
    $db->sql_freeresult($result);
    $sql = 'SELECT SUM(filesize) as stat
        FROM ' . ATTACHMENTS_TABLE . '
        WHERE is_orphan = 0';
    $result = $db->sql_query($sql);
    $config->set('upload_dir_size', (float) $db->sql_fetchfield('stat'), false);
    $db->sql_freeresult($result);
    /**
    * We do not resync users post counts - this can be done by the admin after conversion if wanted.
    $sql = 'SELECT COUNT(post_id) AS num_posts, poster_id
        FROM ' . POSTS_TABLE . '
        WHERE post_postcount = 1
        GROUP BY poster_id';
    $result = $db->sql_query($sql);
    while ($row = $db->sql_fetchrow($result))
    {
        $db->sql_query('UPDATE ' . USERS_TABLE . " SET user_posts = {$row['num_posts']} WHERE user_id = {$row['poster_id']}");
    }
    $db->sql_freeresult($result);
    */
}
/**
* Updates topics_posted entries
*/
function update_topics_posted()
{
    global $db;
    switch ($db->get_sql_layer())
    {
        case 'sqlite3':
            $db->sql_query('DELETE FROM ' . TOPICS_POSTED_TABLE);
        break;
        default:
            $db->sql_query('TRUNCATE TABLE ' . TOPICS_POSTED_TABLE);
        break;
    }
    // This can get really nasty... therefore we only do the last six months
    $get_from_time = time() - (6 * 4 * 7 * 24 * 60 * 60);
    // Select forum ids, do not include categories
    $sql = 'SELECT forum_id
        FROM ' . FORUMS_TABLE . '
        WHERE forum_type <> ' . FORUM_CAT;
    $result = $db->sql_query($sql);
    $forum_ids = array();
    while ($row = $db->sql_fetchrow($result))
    {
        $forum_ids[] = $row['forum_id'];
    }
    $db->sql_freeresult($result);
    // Any global announcements? ;)
    $forum_ids[] = 0;
    // Now go through the forums and get us some topics...
    foreach ($forum_ids as $forum_id)
    {
        $sql = 'SELECT p.poster_id, p.topic_id
            FROM ' . POSTS_TABLE . ' p, ' . TOPICS_TABLE . ' t
            WHERE t.forum_id = ' . $forum_id . '
                AND t.topic_moved_id = 0
                AND t.topic_last_post_time > ' . $get_from_time . '
                AND t.topic_id = p.topic_id
                AND p.poster_id <> ' . ANONYMOUS . '
            GROUP BY p.poster_id, p.topic_id';
        $result = $db->sql_query($sql);
        $posted = array();
        while ($row = $db->sql_fetchrow($result))
        {
            $posted[$row['poster_id']][] = $row['topic_id'];
        }
        $db->sql_freeresult($result);
        $sql_ary = array();
        foreach ($posted as $user_id => $topic_row)
        {
            foreach ($topic_row as $topic_id)
            {
                $sql_ary[] = array(
                    'user_id'        => (int) $user_id,
                    'topic_id'        => (int) $topic_id,
                    'topic_posted'    => 1,
                );
            }
        }
        unset($posted);
        if (count($sql_ary))
        {
            $db->sql_multi_insert(TOPICS_POSTED_TABLE, $sql_ary);
        }
    }
}
/**
* Ensure that all users have a default group specified and update related information such as their colour
*/
function fix_empty_primary_groups()
{
    global $db;
    // Set group ids for users not already having it
    $sql = 'UPDATE ' . USERS_TABLE . ' SET group_id = ' . get_group_id('registered') . '
        WHERE group_id = 0 AND user_type = ' . USER_INACTIVE;
    $db->sql_query($sql);
    $sql = 'UPDATE ' . USERS_TABLE . ' SET group_id = ' . get_group_id('registered') . '
        WHERE group_id = 0 AND user_type = ' . USER_NORMAL;
    $db->sql_query($sql);
    $db->sql_query('UPDATE ' . USERS_TABLE . ' SET group_id = ' . get_group_id('guests') . ' WHERE user_id = ' . ANONYMOUS);
    $sql = 'SELECT user_id FROM ' . USER_GROUP_TABLE . ' WHERE group_id = ' . get_group_id('administrators');
    $result = $db->sql_query($sql);
    $user_ids = array();
    while ($row = $db->sql_fetchrow($result))
    {
        $user_ids[] = $row['user_id'];
    }
    $db->sql_freeresult($result);
    if (count($user_ids))
    {
        $db->sql_query('UPDATE ' . USERS_TABLE . ' SET group_id = ' . get_group_id('administrators') . '
            WHERE group_id = 0 AND ' . $db->sql_in_set('user_id', $user_ids));
    }
    $sql = 'SELECT user_id FROM ' . USER_GROUP_TABLE . ' WHERE group_id = ' . get_group_id('global_moderators');
    $result = $db->sql_query($sql);
    $user_ids = array();
    while ($row = $db->sql_fetchrow($result))
    {
        $user_ids[] = $row['user_id'];
    }
    $db->sql_freeresult($result);
    if (count($user_ids))
    {
        $db->sql_query('UPDATE ' . USERS_TABLE . ' SET group_id = ' . get_group_id('global_moderators') . '
            WHERE group_id = 0 AND ' . $db->sql_in_set('user_id', $user_ids));
    }
    // Set user colour
    $sql = 'SELECT group_id, group_colour FROM ' . GROUPS_TABLE . "
        WHERE group_colour <> ''";
    $result = $db->sql_query($sql);
    while ($row = $db->sql_fetchrow($result))
    {
        $db->sql_query('UPDATE ' . USERS_TABLE . " SET user_colour = '{$row['group_colour']}' WHERE group_id = {$row['group_id']}");
    }
    $db->sql_freeresult($result);
}
/**
* Cleanly remove invalid user entries after converting the users table...
*/
function remove_invalid_users()
{
    global $db, $phpEx, $phpbb_root_path;
    // username_clean is UNIQUE
    $sql = 'SELECT user_id
        FROM ' . USERS_TABLE . "
        WHERE username_clean = ''";
    $result = $db->sql_query($sql);
    $row = $db->sql_fetchrow($result);
    $db->sql_freeresult($result);
    if ($row)
    {
        if (!function_exists('user_delete'))
        {
            include($phpbb_root_path . 'includes/functions_user.' . $phpEx);
        }
        user_delete('remove', $row['user_id']);
    }
}
function convert_bbcode($message, $convert_size = true, $extended_bbcodes = false)
{
    static $orig, $repl, $origx, $replx, $str_from, $str_to;
    if (empty($orig))
    {
        $orig = $repl = array();
        $orig[] = '#\[(php|sql)\](.*?)\[/(php|sql)\]#is';
        $repl[] = '[code]\2[/code]';
        $orig[] = '#\[font=[^\]]+\](.*?)\[/font\]#is';
        $repl[] = '\1';
        $orig[] = '#\[align=[a-z]+\](.*?)\[/align\]#is';
        $repl[] = '\1';
        $orig[] = '#\[/list=.*?\]#is';
        $repl[] = '[/list]';
        $origx = array(
            '#\[glow[^\]]+\](.*?)\[/glow\]#is',
            '#\[shadow[^\]]+\](.*?)\[/shadow\]#is',
            '#\[flash[^\]]+\](.*?)\[/flash\]#is'
        );
        $replx = array(
            '\1',
            '\1',
            '[url=\1]Flash[/url]'
        );
        $str_from = array(
            '[ftp]',    '[/ftp]',
            '[ftp=',    '[/ftp]',
            '[pre]',    '[/pre]',
            '[table]',    '[/table]',
            '[td]',        '[/td]',
            '[tr]',        '[/tr]',
            '[s]',        '[/s]',
            '[left]',    '[/left]',
            '[right]',    '[/right]',
            '[center]',    '[/center]',
            '[sub]',    '[/sub]',
            '[sup]',    '[/sup]',
            '[tt]',        '[/tt]',
            '[move]',    '[/move]',
            '[hr]'
        );
        $str_to = array(
            '[url]',    '[/url]',
            '[url=',    '[/url]',
            '[code]',    '[/code]',
            "\n",        '',
            '',            '',
            "\n",        '',
            '',            '',
            '',            '',
            '',            '',
            '',            '',
            '',            '',
            '',            '',
            '',            '',
            '',            '',
            "\n\n"
        );
        for ($i = 0, $end = count($str_from); $i < $end; ++$i)
        {
            $origx[] = '#\\' . str_replace(']', '\\]', $str_from[$i]) . '#is';
            $replx[] = $str_to[$i];
        }
    }
    if (preg_match_all('#\[email=([^\]]+)\](.*?)\[/email\]#i', $message, $m))
    {
        for ($i = 0, $end = count($m[1]); $i < $end; ++$i)
        {
            if ($m[1][$i] == $m[2][$i])
            {
                $message = str_replace($m[0][$i], '[email]' . $m[1][$i] . '[/email]', $message);
            }
            else
            {
                $message = str_replace($m[0][$i], $m[2][$i] . ' ([email]' . $m[1][$i] . '[/email])', $message);
            }
        }
    }
    if ($convert_size && preg_match('#\[size=[0-9]+\].*?\[/size\]#i', $message))
    {
        $size = array(9, 9, 12, 15, 18, 24, 29, 29, 29, 29);
        $message = preg_replace('#\[size=([0-9]+)\](.*?)\[/size\]#i', '[size=\1]\2[/size]', $message);
        $message = preg_replace('#\[size=[0-9]{2,}\](.*?)\[/size\]#i', '[size=29]\1[/size]', $message);
        for ($i = count($size); $i;)
        {
            $i--;
            $message = str_replace('[size=' . $i . ']', '[size=' . $size[$i] . ']', $message);
        }
    }
    if ($extended_bbcodes)
    {
        $message = preg_replace($origx, $replx, $message);
    }
    $message = preg_replace($orig, $repl, $message);
    return $message;
}
function copy_file($src, $trg, $overwrite = false, $die_on_failure = true, $source_relative_path = true)
{
    global $convert, $phpbb_root_path, $user, $phpbb_filesystem;
    /** @var \phpbb\filesystem\filesystem_interface $filesystem */
    $filesystem = $phpbb_filesystem;
    if (substr($trg, -1) == '/')
    {
        $trg .= utf8_basename($src);
    }
    $src_path = relative_base($src, $source_relative_path, __LINE__, __FILE__);
    $trg_path = $trg;
    if (!$overwrite && @file_exists($trg_path))
    {
        return true;
    }
    if (!@file_exists($src_path))
    {
        return;
    }
    $path = $phpbb_root_path;
    $parts = explode('/', $trg);
    unset($parts[count($parts) - 1]);
    for ($i = 0, $end = count($parts); $i < $end; ++$i)
    {
        $path .= $parts[$i] . '/';
        if (!is_dir($path))
        {
            @mkdir($path, 0777);
        }
    }
    if (!$filesystem->is_writable($path))
    {
        @chmod($path, 0777);
    }
    if (!@copy($src_path, $phpbb_root_path . $trg_path))
    {
        $convert->p_master->error(sprintf($user->lang['COULD_NOT_COPY'], $src_path, $phpbb_root_path . $trg_path), __LINE__, __FILE__, !$die_on_failure);
        return;
    }
    if ($perm = @fileperms($src_path))
    {
        @chmod($phpbb_root_path . $trg_path, $perm);
    }
    return true;
}
function copy_dir($src, $trg, $copy_subdirs = true, $overwrite = false, $die_on_failure = true, $source_relative_path = true)
{
    global $convert, $phpbb_root_path, $config, $user, $phpbb_filesystem;
    /** @var \phpbb\filesystem\filesystem_interface $filesystem */
    $filesystem = $phpbb_filesystem;
    $dirlist = $filelist = $bad_dirs = array();
    $src = path($src, $source_relative_path);
    $trg = path($trg);
    $src_path = relative_base($src, $source_relative_path, __LINE__, __FILE__);
    $trg_path = $phpbb_root_path . $trg;
    if (!is_dir($trg_path))
    {
        @mkdir($trg_path, 0777);
        @chmod($trg_path, 0777);
    }
    if (!$filesystem->is_writable($trg_path))
    {
        $bad_dirs[] = path($config['script_path']) . $trg;
    }
    if ($handle = @opendir($src_path))
    {
        while ($entry = readdir($handle))
        {
            if ($entry[0] == '.' || $entry == 'CVS' || $entry == 'index.htm')
            {
                continue;
            }
            if (is_dir($src_path . $entry))
            {
                $dirlist[] = $entry;
            }
            else
            {
                $filelist[] = $entry;
            }
        }
        closedir($handle);
    }
    else if ($dir = @dir($src_path))
    {
        while ($entry = $dir->read())
        {
            if ($entry[0] == '.' || $entry == 'CVS' || $entry == 'index.htm')
            {
                continue;
            }
            if (is_dir($src_path . $entry))
            {
                $dirlist[] = $entry;
            }
            else
            {
                $filelist[] = $entry;
            }
        }
        $dir->close();
    }
    else
    {
        $convert->p_master->error(sprintf($user->lang['CONV_ERROR_COULD_NOT_READ'], relative_base($src, $source_relative_path)), __LINE__, __FILE__);
    }
    if ($copy_subdirs)
    {
        for ($i = 0, $end = count($dirlist); $i < $end; ++$i)
        {
            $dir = $dirlist[$i];
            if ($dir == 'CVS')
            {
                continue;
            }
            if (!is_dir($trg_path . $dir))
            {
                @mkdir($trg_path . $dir, 0777);
                @chmod($trg_path . $dir, 0777);
            }
            if (!$filesystem->is_writable($trg_path . $dir))
            {
                $bad_dirs[] = $trg . $dir;
                $bad_dirs[] = $trg_path . $dir;
            }
            if (!count($bad_dirs))
            {
                copy_dir($src . $dir, $trg . $dir, true, $overwrite, $die_on_failure, $source_relative_path);
            }
        }
    }
    if (count($bad_dirs))
    {
        $str = (count($bad_dirs) == 1) ? $user->lang['MAKE_FOLDER_WRITABLE'] : $user->lang['MAKE_FOLDERS_WRITABLE'];
        sort($bad_dirs);
        $convert->p_master->error(sprintf($str, implode('<br />', $bad_dirs)), __LINE__, __FILE__);
    }
    for ($i = 0, $end = count($filelist); $i < $end; ++$i)
    {
        copy_file($src . $filelist[$i], $trg . $filelist[$i], $overwrite, $die_on_failure, $source_relative_path);
    }
}
function relative_base($path, $is_relative = true, $line = false, $file = false)
{
    global $convert, $user;
    if (!$is_relative)
    {
        return $path;
    }
    if (empty($convert->options['forum_path']) && $is_relative)
    {
        $line = $line ? $line : __LINE__;
        $file = $file ? $file : __FILE__;
        $convert->p_master->error($user->lang['CONV_ERROR_NO_FORUM_PATH'], $line, $file);
    }
    return $convert->options['forum_path'] . '/' . $path;
}
function get_smiley_display()
{
    static $smiley_count = 0;
    $smiley_count++;
    return ($smiley_count < 50) ? 1 : 0;
}
function fill_dateformat($user_dateformat)
{
    global $config;
    return ((empty($user_dateformat)) ? $config['default_dateformat'] : $user_dateformat);
}