1<?php 2 3/** 4 * webtrees: online genealogy 5 * Copyright (C) 2022 webtrees development team 6 * This program is free software: you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License as published by 8 * the Free Software Foundation, either version 3 of the License, or 9 * (at your option) any later version. 10 * This program is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU General Public License for more details. 14 * You should have received a copy of the GNU General Public License 15 * along with this program. If not, see <https://www.gnu.org/licenses/>. 16 */ 17 18declare(strict_types=1); 19 20namespace Fisharebest\Webtrees\Schema; 21 22use Illuminate\Database\Capsule\Manager as DB; 23use Illuminate\Database\Query\Expression; 24use Illuminate\Database\Schema\Blueprint; 25use PDOException; 26 27/** 28 * Upgrade the database schema from version 44 to version 45. 29 */ 30class Migration44 implements MigrationInterface 31{ 32 /** 33 * Upgrade to the next version 34 * 35 * @return void 36 */ 37 public function upgrade(): void 38 { 39 // It is simpler to create a new table than to update the existing one. 40 41 if (!DB::schema()->hasTable('place_location')) { 42 DB::schema()->create('place_location', static function (Blueprint $table): void { 43 $table->integer('id', true); 44 $table->integer('parent_id')->nullable(); 45 $table->string('place', 120); 46 $table->double('latitude')->nullable(); 47 $table->double('longitude')->nullable(); 48 49 $table->unique(['parent_id', 'place']); 50 $table->unique(['place', 'parent_id']); 51 52 $table->index(['latitude']); 53 $table->index(['longitude']); 54 }); 55 56 DB::schema()->table('place_location', static function (Blueprint $table): void { 57 $table->foreign(['parent_id']) 58 ->references(['id']) 59 ->on('place_location') 60 ->onDelete('CASCADE') 61 ->onUpdate('CASCADE'); 62 }); 63 } 64 65 if (DB::schema()->hasTable('placelocation')) { 66 DB::table('placelocation') 67 ->where('pl_lati', '=', '') 68 ->orWhere('pl_long', '=', '') 69 ->update([ 70 'pl_lati' => null, 71 'pl_long' => null, 72 ]); 73 74 // Missing/invalid parents? Move them to the top level 75 DB::table('placelocation AS pl1') 76 ->leftJoin('placelocation AS pl2', 'pl1.pl_parent_id', '=', 'pl2.pl_id') 77 ->whereNull('pl2.pl_id') 78 ->update([ 79 'pl1.pl_parent_id' => 0, 80 ]); 81 82 // Remove invalid values. 83 if (DB::connection()->getDriverName() === 'mysql') { 84 DB::table('placelocation') 85 ->where('pl_lati', 'NOT REGEXP', '^[NS][0-9]+[.]?[0-9]*$') 86 ->orWhere('pl_long', 'NOT REGEXP', '^[EW][0-9]+[.]?[0-9]*$') 87 ->update([ 88 'pl_lati' => null, 89 'pl_long' => null, 90 ]); 91 } 92 93 // The existing data may have placenames that only differ after the first 120 chars. 94 // Need to remove the constraint before we truncate/merge them. 95 try { 96 DB::schema()->table('placelocation', static function (Blueprint $table): void { 97 $table->dropUnique(['pl_parent_id', 'pl_place']); 98 }); 99 } catch (PDOException $ex) { 100 // Already deleted, or does not exist; 101 } 102 103 DB::table('placelocation') 104 ->update([ 105 'pl_place' => new Expression('SUBSTR(pl_place, 1, 120)'), 106 ]); 107 108 // The lack of unique key constraints means that there may be duplicates... 109 while (true) { 110 // Two places with the same name and parent... 111 $row = DB::table('placelocation') 112 ->select([ 113 new Expression('MIN(pl_id) AS min'), 114 new Expression('MAX(pl_id) AS max'), 115 ]) 116 ->groupBy(['pl_parent_id', 'pl_place']) 117 ->having(new Expression('COUNT(*)'), '>', '1') 118 ->first(); 119 120 if ($row === null) { 121 break; 122 } 123 124 // ...move children to the first 125 DB::table('placelocation') 126 ->where('pl_parent_id', '=', $row->max) 127 ->update(['pl_parent_id' => $row->min]); 128 129 // ...delete the second 130 DB::table('placelocation') 131 ->where('pl_id', '=', $row->max) 132 ->delete(); 133 } 134 135 // This is the SQL standard. It works with Postgres, Sqlite and MySQL 8 136 $select1 = DB::table('placelocation') 137 ->leftJoin('place_location', 'id', '=', 'pl_id') 138 ->whereNull('id') 139 ->orderBy('pl_level') 140 ->orderBy('pl_id') 141 ->select([ 142 'pl_id', 143 new Expression('CASE pl_parent_id WHEN 0 THEN NULL ELSE pl_parent_id END'), 144 'pl_place', 145 new Expression("CAST(REPLACE(REPLACE(pl_lati, 'S', '-'), 'N', '') AS FLOAT)"), 146 new Expression("CAST(REPLACE(REPLACE(pl_long, 'W', '-'), 'E', '') AS FLOAT)"), 147 ]); 148 149 // This works for MySQL 5.7 and lower, which cannot cast to FLOAT 150 $select2 = DB::table('placelocation') 151 ->leftJoin('place_location', 'id', '=', 'pl_id') 152 ->whereNull('id') 153 ->orderBy('pl_level') 154 ->orderBy('pl_id') 155 ->select([ 156 'pl_id', 157 new Expression('CASE pl_parent_id WHEN 0 THEN NULL ELSE pl_parent_id END'), 158 'pl_place', 159 new Expression("REPLACE(REPLACE(pl_lati, 'S', '-'), 'N', '')"), 160 new Expression("REPLACE(REPLACE(pl_long, 'W', '-'), 'E', '')"), 161 ]); 162 163 try { 164 DB::table('place_location') 165 ->insertUsing(['id', 'parent_id', 'place', 'latitude', 'longitude'], $select1); 166 } catch (PDOException $ex) { 167 DB::table('place_location') 168 ->insertUsing(['id', 'parent_id', 'place', 'latitude', 'longitude'], $select2); 169 } 170 171 DB::schema()->drop('placelocation'); 172 } 173 174 // Earlier versions of webtrees used 0 and NULL interchangeably. 175 // Assume 0 at the country-level and NULL at lower levels. 176 DB::table('place_location') 177 ->whereNotNull('parent_id') 178 ->where('latitude', '=', 0) 179 ->where('longitude', '=', 0) 180 ->update([ 181 'latitude' => null, 182 'longitude' => null, 183 ]); 184 } 185} 186