Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
Complex classes like classSupernova often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use classSupernova, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 3 | class classSupernova { |
||
| 4 | /** |
||
| 5 | * ex $sn_mvc |
||
| 6 | * |
||
| 7 | * @var array |
||
| 8 | */ |
||
| 9 | public static $sn_mvc = array(); |
||
| 10 | |||
| 11 | /** |
||
| 12 | * ex $functions |
||
| 13 | * |
||
| 14 | * @var array |
||
| 15 | */ |
||
| 16 | public static $functions = array(); |
||
| 17 | |||
| 18 | /** |
||
| 19 | * @var array[] $design |
||
| 20 | */ |
||
| 21 | public $design = array( |
||
| 22 | 'bbcodes' => array(), |
||
| 23 | 'smiles' => array(), |
||
| 24 | ); |
||
| 25 | |||
| 26 | /** |
||
| 27 | * Основная БД для доступа к данным |
||
| 28 | * |
||
| 29 | * @var db_mysql $db |
||
| 30 | */ |
||
| 31 | public static $db; |
||
| 32 | public static $db_name = ''; |
||
| 33 | |||
| 34 | /** |
||
| 35 | * Настройки из файла конфигурации |
||
| 36 | * |
||
| 37 | * @var string |
||
| 38 | */ |
||
| 39 | public static $cache_prefix = ''; |
||
| 40 | // public static $db_prefix = ''; |
||
|
|
|||
| 41 | public static $sn_secret_word = ''; |
||
| 42 | |||
| 43 | /** |
||
| 44 | * Конфигурация игры |
||
| 45 | * |
||
| 46 | * @var classConfig $config |
||
| 47 | */ |
||
| 48 | public static $config; |
||
| 49 | |||
| 50 | |||
| 51 | /** |
||
| 52 | * Кэш игры |
||
| 53 | * |
||
| 54 | * @var classCache $cache |
||
| 55 | */ |
||
| 56 | public static $cache; |
||
| 57 | |||
| 58 | |||
| 59 | /** |
||
| 60 | * @var core_auth $auth |
||
| 61 | */ |
||
| 62 | public static $auth = null; |
||
| 63 | |||
| 64 | |||
| 65 | public static $db_in_transaction = false; |
||
| 66 | public static $db_records_locked = false; |
||
| 67 | public static $transaction_id = 0; |
||
| 68 | public static $user = array(); |
||
| 69 | /** |
||
| 70 | * @var userOptions |
||
| 71 | */ |
||
| 72 | public static $user_options; |
||
| 73 | |||
| 74 | /** |
||
| 75 | * @var debug $debug |
||
| 76 | */ |
||
| 77 | public static $debug = null; |
||
| 78 | |||
| 79 | public $options = array(); |
||
| 80 | |||
| 81 | /* |
||
| 82 | // protected static $user = null; |
||
| 83 | // protected static $planet = null; |
||
| 84 | // protected static $ally = null; |
||
| 85 | */ |
||
| 86 | |||
| 87 | public static $data = array(); // Кэш данных - юзера, планеты, юниты, очередь, альянсы итд |
||
| 88 | public static $locks = array(); // Информация о блокировках |
||
| 89 | public static $queries = array(); // Кэш запросов |
||
| 90 | |||
| 91 | // Массив $locator - хранит отношения между записями для быстрого доступа по тип_записи:тип_локации:ид_локации:внутренний_ид_записи=>информация |
||
| 92 | // Для LOC_UNIT внутренний ИД - это SNID, а информация - это ссылка на запись `unit` |
||
| 93 | // Для LOC_QUE внутренний ИД - это тип очереди, а информация - массив ссылок на `que` |
||
| 94 | public static $locator = array(); // Кэширует соответствия между расположением объектов - в частности юнитов и очередей |
||
| 95 | |||
| 96 | public static $delayed_changset = array(); // Накопительный массив изменений |
||
| 97 | |||
| 98 | // Кэш индексов - ключ MD5-строка от суммы ключевых строк через | - менять | на что-то другое перед поиском и назад - после поиска |
||
| 99 | // Так же в индексах могут быть двойные вхождения - например, названия планет да и вообще |
||
| 100 | // Придумать спецсимвол для NULL |
||
| 101 | // protected static $indexes = array(); |
||
| 102 | |||
| 103 | /* |
||
| 104 | TODO Кэш: |
||
| 105 | 1. Всегда дешевле использовать процессор, чем локальную память |
||
| 106 | 2. Всегда дешевле использовать локальную память, чем общую память всех процессов |
||
| 107 | 3. Всегда дешевле использовать общую память всех процессов, чем обращаться к БД |
||
| 108 | |||
| 109 | Кэш - многоуровневый: локальная память-общая память-БД |
||
| 110 | БД может быть сверхкэширующей - см. HyperNova. Это реализуется на уровне СН-драйвера БД |
||
| 111 | Предусмотреть вариант, когда уровни кэширования совпадают, например когда нет xcache и используется общая память |
||
| 112 | */ |
||
| 113 | //public static $cache; // Объект-кэшер - либо встроенная память, либо мемкэш с блокировками - находится внутри $db!!!! |
||
| 114 | //public static $db; // Объект-БД - либок кэшер с блокировками, либо БД |
||
| 115 | |||
| 116 | // protected static $info = array(); // Кэш информации - инфо о юнитах, инфо о группах итд |
||
| 117 | |||
| 118 | // TODO Автоматически заполнять эту таблицу. В случае кэша в памяти - делать show table при обращении к таблице |
||
| 119 | public static $location_info = array( |
||
| 120 | LOC_USER => array( |
||
| 121 | P_TABLE_NAME => 'users', |
||
| 122 | P_ID => 'id', |
||
| 123 | P_OWNER_INFO => array(), |
||
| 124 | ), |
||
| 125 | |||
| 126 | LOC_PLANET => array( |
||
| 127 | P_TABLE_NAME => 'planets', |
||
| 128 | P_ID => 'id', |
||
| 129 | P_OWNER_INFO => array( |
||
| 130 | LOC_USER => array( |
||
| 131 | P_LOCATION => LOC_USER, |
||
| 132 | P_OWNER_FIELD => 'id_owner', |
||
| 133 | ), |
||
| 134 | ), |
||
| 135 | ), |
||
| 136 | |||
| 137 | LOC_UNIT => array( |
||
| 138 | P_TABLE_NAME => 'unit', |
||
| 139 | P_ID => 'unit_id', |
||
| 140 | P_OWNER_INFO => array( |
||
| 141 | LOC_USER => array( |
||
| 142 | P_LOCATION => LOC_USER, |
||
| 143 | P_OWNER_FIELD => 'unit_player_id', |
||
| 144 | ), |
||
| 145 | ), |
||
| 146 | ), |
||
| 147 | |||
| 148 | LOC_QUE => array( |
||
| 149 | P_TABLE_NAME => 'que', |
||
| 150 | P_ID => 'que_id', |
||
| 151 | P_OWNER_INFO => array( |
||
| 152 | array( |
||
| 153 | P_LOCATION => LOC_USER, |
||
| 154 | P_OWNER_FIELD => 'que_player_id', |
||
| 155 | ), |
||
| 156 | |||
| 157 | array( |
||
| 158 | P_LOCATION => LOC_PLANET, |
||
| 159 | P_OWNER_FIELD => 'que_planet_id_origin', |
||
| 160 | ), |
||
| 161 | |||
| 162 | array( |
||
| 163 | P_LOCATION => LOC_PLANET, |
||
| 164 | P_OWNER_FIELD => 'que_planet_id', |
||
| 165 | ), |
||
| 166 | ), |
||
| 167 | ), |
||
| 168 | |||
| 169 | LOC_FLEET => array( |
||
| 170 | P_TABLE_NAME => 'fleets', |
||
| 171 | P_ID => 'fleet_id', |
||
| 172 | P_OWNER_INFO => array( |
||
| 173 | array( |
||
| 174 | P_LOCATION => LOC_USER, |
||
| 175 | P_OWNER_FIELD => 'fleet_owner', |
||
| 176 | ), |
||
| 177 | |||
| 178 | array( |
||
| 179 | P_LOCATION => LOC_USER, |
||
| 180 | P_OWNER_FIELD => 'fleet_target_owner', |
||
| 181 | ), |
||
| 182 | |||
| 183 | array( |
||
| 184 | P_LOCATION => LOC_PLANET, |
||
| 185 | P_OWNER_FIELD => 'fleet_start_planet_id', |
||
| 186 | ), |
||
| 187 | |||
| 188 | array( |
||
| 189 | P_LOCATION => LOC_PLANET, |
||
| 190 | P_OWNER_FIELD => 'fleet_end_planet_id', |
||
| 191 | ), |
||
| 192 | ), |
||
| 193 | ), |
||
| 194 | ); |
||
| 195 | |||
| 196 | /** |
||
| 197 | * @param $db db_mysql |
||
| 198 | */ |
||
| 199 | public static function init_main_db($db) { |
||
| 203 | |||
| 204 | |||
| 205 | public static function log_file($message, $spaces = 0) { |
||
| 210 | |||
| 211 | public static function debug_set_handler(&$debug) { |
||
| 212 | self::$debug = $debug; |
||
| 213 | } |
||
| 214 | |||
| 215 | // Перепаковывает массив на заданную глубину, убирая поля с null |
||
| 216 | public static function array_repack(&$array, $level = 0) { |
||
| 217 | // TODO $lock_table не нужна тут |
||
| 218 | if(!is_array($array)) { |
||
| 219 | return; |
||
| 220 | } |
||
| 221 | |||
| 222 | foreach($array as $key => &$value) { |
||
| 223 | if($value === null) { |
||
| 224 | unset($array[$key]); |
||
| 225 | } elseif($level > 0 && is_array($value)) { |
||
| 226 | static::array_repack($value, $level - 1); |
||
| 227 | if(empty($value)) { |
||
| 228 | unset($array[$key]); |
||
| 229 | } |
||
| 230 | } |
||
| 231 | } |
||
| 232 | } |
||
| 233 | |||
| 234 | |||
| 235 | // TODO Вынести в отдельный объект |
||
| 236 | public static function cache_repack($location_type, $record_id = 0) { |
||
| 237 | // Если есть $user_id - проверяем, а надо ли перепаковывать? |
||
| 238 | if($record_id && isset(static::$data[$location_type][$record_id]) && static::$data[$location_type][$record_id] !== null) { |
||
| 239 | return; |
||
| 240 | } |
||
| 241 | |||
| 242 | static::array_repack(static::$data[$location_type]); |
||
| 243 | static::array_repack(static::$locator[$location_type], 3); // TODO У каждого типа локации - своя глубина!!!! Но можно и глубже ??? |
||
| 244 | static::array_repack(static::$queries[$location_type], 1); |
||
| 245 | } |
||
| 246 | |||
| 247 | public static function cache_clear($location_type, $hard = true) { |
||
| 248 | //print("<br />CACHE CLEAR {$cache_id} " . ($hard ? 'HARD' : 'SOFT') . "<br />"); |
||
| 249 | if($hard && !empty(static::$data[$location_type])) { |
||
| 250 | // Здесь нельзя делать unset - надо записывать NULL, что бы это отразилось на зависимых записях |
||
| 251 | array_walk(static::$data[$location_type], function (&$item) { $item = null; }); |
||
| 252 | } |
||
| 253 | static::$locator[$location_type] = array(); |
||
| 254 | static::$queries[$location_type] = array(); |
||
| 255 | static::cache_repack($location_type); // Перепаковываем внутренние структуры, если нужно |
||
| 256 | } |
||
| 257 | |||
| 258 | public static function cache_clear_all($hard = true) { |
||
| 259 | //print('<br />CACHE CLEAR ALL<br />'); |
||
| 260 | if($hard) { |
||
| 261 | static::$data = array(); |
||
| 262 | static::cache_lock_unset_all(); |
||
| 263 | } |
||
| 264 | static::$locator = array(); |
||
| 265 | static::$queries = array(); |
||
| 266 | } |
||
| 267 | |||
| 268 | public static function cache_get($location_type, $record_id) { |
||
| 269 | return isset(static::$data[$location_type][$record_id]) ? static::$data[$location_type][$record_id] : null; |
||
| 270 | } |
||
| 271 | |||
| 272 | public static function cache_isset($location_type, $record_id) { |
||
| 273 | return isset(static::$data[$location_type][$record_id]) && static::$data[$location_type][$record_id] !== null; |
||
| 274 | } |
||
| 275 | |||
| 276 | /* Кэшируем запись в соответствующий кэш |
||
| 277 | |||
| 278 | Писать в кэш: |
||
| 279 | 1. Если записи не существует в кэше |
||
| 280 | 2. Если стоит $force_overwrite |
||
| 281 | 3. Если во время транзакции существующая запись не заблокирована |
||
| 282 | |||
| 283 | Блокировать запись: |
||
| 284 | 1. Если идет транзакция и запись не заблокирована |
||
| 285 | 2. Если не стоит скип-лок |
||
| 286 | */ |
||
| 287 | public static function cache_set($location_type, $record_id, $record, $force_overwrite = false, $skip_lock = false) { |
||
| 288 | // нет идентификатора - выход |
||
| 289 | if(!($record_id = $record[static::$location_info[$location_type][P_ID]])) { |
||
| 290 | return; |
||
| 291 | } |
||
| 292 | |||
| 293 | $in_transaction = static::db_transaction_check(false); |
||
| 294 | if( |
||
| 295 | $force_overwrite |
||
| 296 | || |
||
| 297 | // Не заменяются заблокированные записи во время транзакции |
||
| 298 | ($in_transaction && !static::cache_lock_get($location_type, $record_id)) |
||
| 299 | || |
||
| 300 | // !isset(static::$data[$location_type][$record_id]) || static::$data[$location_type][$record_id] === null |
||
| 301 | !static::cache_isset($location_type, $record_id) |
||
| 302 | ) { |
||
| 303 | static::$data[$location_type][$record_id] = $record; |
||
| 304 | if($in_transaction && !$skip_lock) { |
||
| 305 | static::cache_lock_set($location_type, $record_id); |
||
| 306 | } |
||
| 307 | } |
||
| 308 | } |
||
| 309 | |||
| 310 | public static function cache_unset($cache_id, $safe_record_id) { |
||
| 311 | // $record_id должен быть проверен заранее ! |
||
| 312 | if(isset(static::$data[$cache_id][$safe_record_id]) && static::$data[$cache_id][$safe_record_id] !== null) { |
||
| 313 | // Выставляем запись в null |
||
| 314 | static::$data[$cache_id][$safe_record_id] = null; |
||
| 315 | // Очищаем кэш мягко - что бы удалить очистить связанные данные - кэш локаций и кэш запоросов и всё, что потребуется впредь |
||
| 316 | static::cache_clear($cache_id, false); |
||
| 317 | } |
||
| 318 | } |
||
| 319 | |||
| 320 | public static function cache_lock_get($location_type, $record_id) { |
||
| 321 | return isset(static::$locks[$location_type][$record_id]); |
||
| 322 | } |
||
| 323 | |||
| 324 | public static function cache_lock_set($location_type, $record_id) { |
||
| 325 | return static::$locks[$location_type][$record_id] = true; // Не всегда - от результата |
||
| 326 | } |
||
| 327 | |||
| 328 | public static function cache_lock_unset($location_type, $record_id) { |
||
| 329 | if(isset(static::$locks[$location_type][$record_id])) { |
||
| 330 | unset(static::$locks[$location_type][$record_id]); |
||
| 331 | } |
||
| 332 | |||
| 333 | return true; // Не всегда - от результата |
||
| 334 | } |
||
| 335 | |||
| 336 | public static function cache_lock_unset_all() { |
||
| 337 | // Когда будем работать с xcache - это понадобиться, что бы снимать в xcache блокировки с записей |
||
| 338 | // Пройти по массиву - снять блокировки для кэшера в памяти |
||
| 339 | static::$locks = array(); |
||
| 340 | |||
| 341 | return true; // Не всегда - от результата |
||
| 342 | } |
||
| 343 | |||
| 344 | |||
| 345 | |||
| 346 | |||
| 347 | |||
| 348 | // TODO Вынести в отдельный объект |
||
| 349 | /** |
||
| 350 | * Эта функция проверяет статус транзакции |
||
| 351 | * |
||
| 352 | * Это - низкоуровневая функция. В нормальном состоянии движка её сообщения никогда не будут видны |
||
| 353 | * |
||
| 354 | * @param null|true|false $status Должна ли быть запущена транзакция в момент проверки |
||
| 355 | * <p>null - транзакция НЕ должна быть запущена</p> |
||
| 356 | * <p>true - транзакция должна быть запущена - для совместимости с $for_update</p> |
||
| 357 | * <p>false - всё равно - для совместимости с $for_update</p> |
||
| 358 | * |
||
| 359 | * @return bool Текущий статус транзакции |
||
| 360 | */ |
||
| 361 | public static function db_transaction_check($status = null) { |
||
| 362 | $error_msg = false; |
||
| 363 | if($status && !static::$db_in_transaction) { |
||
| 364 | $error_msg = 'No transaction started for current operation'; |
||
| 365 | } elseif($status === null && static::$db_in_transaction) { |
||
| 366 | $error_msg = 'Transaction is already started'; |
||
| 367 | } |
||
| 368 | |||
| 369 | if($error_msg) { |
||
| 370 | // TODO - Убрать позже |
||
| 371 | print('<h1>СООБЩИТЕ ЭТО АДМИНУ: sn_db_transaction_check() - ' . $error_msg . '</h1>'); |
||
| 372 | $backtrace = debug_backtrace(); |
||
| 373 | array_shift($backtrace); |
||
| 374 | pdump($backtrace); |
||
| 375 | die($error_msg); |
||
| 376 | } |
||
| 377 | |||
| 378 | return static::$db_in_transaction; |
||
| 379 | } |
||
| 380 | |||
| 381 | public static function db_transaction_start($level = '') { |
||
| 382 | static::db_transaction_check(null); |
||
| 383 | |||
| 384 | $level ? doquery('SET TRANSACTION ISOLATION LEVEL ' . $level) : false; |
||
| 385 | |||
| 386 | static::$transaction_id++; |
||
| 387 | doquery('START TRANSACTION'); |
||
| 388 | |||
| 389 | if(classSupernova::$config->db_manual_lock_enabled) { |
||
| 390 | classSupernova::$config->db_loadItem('var_db_manually_locked'); |
||
| 391 | classSupernova::$config->db_saveItem('var_db_manually_locked', SN_TIME_SQL); |
||
| 392 | } |
||
| 393 | |||
| 394 | static::$db_in_transaction = true; |
||
| 395 | static::$locator = array(); |
||
| 396 | static::$queries = array(); |
||
| 397 | |||
| 398 | return static::$transaction_id; |
||
| 399 | } |
||
| 400 | |||
| 401 | public static function db_transaction_commit() { |
||
| 402 | static::db_transaction_check(true); |
||
| 403 | |||
| 404 | if(!empty(static::$delayed_changset)) { |
||
| 405 | static::db_changeset_apply(static::$delayed_changset, true); |
||
| 406 | // pdump(static::$delayed_changset); |
||
| 407 | } |
||
| 408 | doquery('COMMIT'); |
||
| 409 | |||
| 410 | return static::db_transaction_clear(); |
||
| 411 | } |
||
| 412 | |||
| 413 | public static function db_transaction_rollback() { |
||
| 414 | // static::db_transaction_check(true); // TODO - вообще-то тут тоже надо проверять есть ли транзакция |
||
| 415 | |||
| 416 | if(!empty(static::$delayed_changset)) { |
||
| 417 | static::db_changeset_revert(); |
||
| 418 | } |
||
| 419 | doquery('ROLLBACK'); |
||
| 420 | |||
| 421 | return static::db_transaction_clear(); |
||
| 422 | } |
||
| 423 | |||
| 424 | protected static function db_transaction_clear() { |
||
| 425 | static::$delayed_changset = array(); |
||
| 426 | static::cache_lock_unset_all(); |
||
| 427 | |||
| 428 | static::$db_in_transaction = false; |
||
| 429 | static::$db_records_locked = false; |
||
| 430 | static::$transaction_id++; |
||
| 431 | |||
| 432 | return static::$transaction_id; |
||
| 433 | } |
||
| 434 | |||
| 435 | /** |
||
| 436 | * Блокирует указанные таблицу/список таблиц |
||
| 437 | * |
||
| 438 | * @param string|array $tables Таблица/список таблиц для блокировки. Названия таблиц - без префиксов |
||
| 439 | * <p>string - название таблицы для блокировки</p> |
||
| 440 | * <p>array - массив, где ключ - имя таблицы, а значение - условия блокировки элементов</p> |
||
| 441 | */ |
||
| 442 | public static function db_lock_tables($tables) { |
||
| 448 | |||
| 449 | public static function db_query($query, $fetch = false, $skip_lock = false) { |
||
| 459 | |||
| 460 | /** |
||
| 461 | * Возвращает информацию о записи по её ID |
||
| 462 | * |
||
| 463 | * @param int $location_type |
||
| 464 | * @param int|array $record_id_unsafe |
||
| 465 | * <p>int - ID записи</p> |
||
| 466 | * <p>array - запись пользователя с установленным полем P_ID</p> |
||
| 467 | * @param bool $for_update @deprecated |
||
| 468 | * @param string $fields @deprecated список полей или '*'/'' для всех полей |
||
| 469 | * @param bool $skip_lock Указывает на то, что не нужно блокировать запись //TODO и не нужно сохранять в кэше |
||
| 470 | * |
||
| 471 | * @return array|false |
||
| 472 | * <p>false - Нет записи с указанным ID</p> |
||
| 473 | * <p>array - запись</p> |
||
| 474 | */ |
||
| 475 | public static function db_get_record_by_id($location_type, $record_id_unsafe, $for_update = false, $fields = '*', $skip_lock = false) { |
||
| 482 | |||
| 483 | public static function db_get_record_list($location_type, $filter = '', $fetch = false, $no_return = false) { |
||
| 557 | |||
| 558 | /** |
||
| 559 | * @param int $location_type |
||
| 560 | * @param int $record_id |
||
| 561 | * @param string $set - SQL SET structure |
||
| 562 | * |
||
| 563 | * @return array|bool|mysqli_result|null |
||
| 564 | */ |
||
| 565 | public static function db_upd_record_by_id($location_type, $record_id, $set) { |
||
| 590 | |||
| 591 | public static function db_upd_record_list($location_type, $condition, $set) { |
||
| 612 | |||
| 613 | /** |
||
| 614 | * @param int $location_type |
||
| 615 | * @param string $set |
||
| 616 | * |
||
| 617 | * @return array|bool|false|mysqli_result|null |
||
| 618 | */ |
||
| 619 | public static function db_ins_record($location_type, $set) { |
||
| 636 | |||
| 637 | public static function db_ins_field_set($location_type, $field_set, $serialize = false) { |
||
| 659 | |||
| 660 | public static function db_del_record_by_id($location_type, $safe_record_id) { |
||
| 678 | |||
| 679 | public static function db_del_record_list($location_type, $condition) { |
||
| 700 | |||
| 701 | |||
| 702 | |||
| 703 | // Работа с пользователями |
||
| 704 | /** |
||
| 705 | * Возвращает информацию о пользователе по его ID |
||
| 706 | * |
||
| 707 | * @param int|array $user_id_unsafe |
||
| 708 | * <p>int - ID пользователя</p> |
||
| 709 | * <p>array - запись пользователя с установленным полем ['id']</p> |
||
| 710 | * @param bool $for_update @deprecated |
||
| 711 | * @param string $fields @deprecated список полей или '*'/'' для всех полей |
||
| 712 | * @param null $player |
||
| 713 | * @param bool|null $player Признак выбора записи пользователь типа "игрок" |
||
| 714 | * <p>null - Можно выбрать запись любого типа</p> |
||
| 715 | * <p>true - Выбирается только запись типа "игрок"</p> |
||
| 716 | * <p>false - Выбирается только запись типа "альянс"</p> |
||
| 717 | * |
||
| 718 | * @return array|false |
||
| 719 | * <p>false - Нет записи с указанным ID и $player</p> |
||
| 720 | * <p>array - запись типа $user</p> |
||
| 721 | */ |
||
| 722 | public static function db_get_user_by_id($user_id_unsafe, $for_update = false, $fields = '*', $player = null) { |
||
| 734 | |||
| 735 | public static function db_get_user_by_username($username_unsafe, $for_update = false, $fields = '*', $player = null, $like = false) { |
||
| 774 | |||
| 775 | // UNUSED |
||
| 776 | public static function db_get_user_by_email($email_unsafe, $use_both = false, $for_update = false, $fields = '*') { |
||
| 808 | |||
| 809 | public static function db_get_user_by_where($where_safe, $for_update = false, $fields = '*') { |
||
| 823 | |||
| 824 | |||
| 825 | View Code Duplication | public static function db_unit_time_restrictions($date = SN_TIME_NOW) { |
|
| 832 | |||
| 833 | public static function db_get_unit_by_id($unit_id, $for_update = false, $fields = '*') { |
||
| 842 | |||
| 843 | /** |
||
| 844 | * @param int $user_id |
||
| 845 | * @param $location_type |
||
| 846 | * @param $location_id |
||
| 847 | * |
||
| 848 | * @return array|bool |
||
| 849 | */ |
||
| 850 | public static function db_get_unit_list_by_location($user_id = 0, $location_type, $location_id) { |
||
| 876 | |||
| 877 | public static function db_get_unit_by_location($user_id = 0, $location_type, $location_id, $unit_snid = 0, $for_update = false, $fields = '*') { |
||
| 882 | |||
| 883 | |||
| 884 | /* |
||
| 885 | * С $for_update === true эта функция должна вызываться только из транзакции! Все соответствующие записи в users и planets должны быть уже блокированы! |
||
| 886 | * |
||
| 887 | * $que_type |
||
| 888 | * !$que_type - все очереди |
||
| 889 | * QUE_XXXXXX - конкретная очередь по планете |
||
| 890 | * $user_id - ID пользователя |
||
| 891 | * $planet_id |
||
| 892 | * $que_type == QUE_RESEARCH - игнорируется |
||
| 893 | * null - обработка очередей планет не производится |
||
| 894 | * false/0 - обрабатываются очереди всех планет по $user_id |
||
| 895 | * (integer) - обрабатываются локальные очереди для планеты. Нужно, например, в обработчике флотов |
||
| 896 | * иначе - $que_type для указанной планеты |
||
| 897 | * $for_update - true == нужно блокировать записи |
||
| 898 | * |
||
| 899 | * TODO Работа при !$user_id |
||
| 900 | * TODO Переформатировать вывод данных, что бы можно было возвращать данные по всем планетам и юзерам в одном запросе: добавить подмассивы 'que', 'planets', 'players' |
||
| 901 | * |
||
| 902 | */ |
||
| 903 | public static function db_que_list_by_type_location($user_id, $planet_id = null, $que_type = false, $for_update = false) { |
||
| 953 | |||
| 954 | |||
| 955 | View Code Duplication | public static function db_changeset_prepare_unit($unit_id, $unit_value, $user, $planet_id = null) { |
|
| 1018 | |||
| 1019 | |||
| 1020 | public function db_changeset_delay($table_name, $table_data) { |
||
| 1037 | |||
| 1038 | public function db_changeset_revert() { |
||
| 1044 | |||
| 1045 | public function db_changeset_condition_compile(&$conditions, &$table_name = '') { |
||
| 1132 | |||
| 1133 | public static function db_changeset_apply($db_changeset, $flush_delayed = false) { |
||
| 1182 | |||
| 1183 | |||
| 1184 | |||
| 1185 | |||
| 1186 | |||
| 1187 | |||
| 1188 | |||
| 1189 | |||
| 1190 | |||
| 1191 | |||
| 1192 | |||
| 1193 | |||
| 1194 | |||
| 1195 | |||
| 1196 | |||
| 1197 | |||
| 1198 | |||
| 1199 | |||
| 1200 | |||
| 1201 | |||
| 1202 | |||
| 1203 | |||
| 1204 | |||
| 1205 | |||
| 1206 | |||
| 1207 | |||
| 1208 | |||
| 1209 | |||
| 1210 | |||
| 1211 | |||
| 1212 | |||
| 1213 | |||
| 1214 | |||
| 1215 | |||
| 1216 | |||
| 1217 | // que_process не всегда должна работать в режиме прямой работы с БД !! Она может работать и в режиме эмуляции |
||
| 1218 | // !!!!!!!! После que_get брать не [0] элемент, а first() - тогда можно в индекс элемента засовывать que_id из таблицы |
||
| 1219 | |||
| 1220 | |||
| 1221 | // TODO - это вообще-то надо хранить в конфигурации |
||
| 1222 | public static function db_get_user_player_username_last_registered() { |
||
| 1228 | |||
| 1229 | // Это для поиска по кэшу |
||
| 1230 | protected static function db_get_record_by_field($location_type) { |
||
| 1232 | |||
| 1233 | // Для модулей - регистрация юнитов |
||
| 1234 | public static function unit_register() { |
||
| 1237 | |||
| 1238 | |||
| 1239 | public static function init_0_prepare() { |
||
| 1254 | |||
| 1255 | public static function init_1_constants() { |
||
| 1284 | |||
| 1285 | public static function init_3_load_config_file() { |
||
| 1295 | |||
| 1296 | public static function init_global_objects() { |
||
| 1297 | /** |
||
| 1298 | * @var classSupernova $supernova |
||
| 1299 | */ |
||
| 1300 | global $supernova, $sn_cache; |
||
| 1301 | |||
| 1302 | self::$user_options = new userOptions(0); |
||
| 1303 | |||
| 1304 | /** |
||
| 1305 | * @var classSupernova $supernova |
||
| 1306 | */ |
||
| 1307 | $supernova = new classSupernova(); |
||
| 1308 | |||
| 1309 | // Initializing global 'cacher' object |
||
| 1310 | static::$cache = new classCache(classSupernova::$cache_prefix); |
||
| 1311 | $sn_cache = static::$cache; |
||
| 1312 | empty($sn_cache->tables) ? sys_refresh_tablelist() : false; |
||
| 1313 | empty($sn_cache->tables) ? die('DB error - cannot find any table. Halting...') : false; |
||
| 1314 | |||
| 1315 | // Initializing global "config" object |
||
| 1316 | classSupernova::$config = static::$config = new classConfig(classSupernova::$cache_prefix); |
||
| 1317 | } |
||
| 1318 | |||
| 1319 | public static function init_debug_state() { |
||
| 1342 | |||
| 1343 | } |
||
| 1344 |
Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.
The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.
This check looks for comments that seem to be mostly valid code and reports them.