1<?php 2 3/** 4 * webtrees: online genealogy 5 * Copyright (C) 2021 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 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' => '', 89 'pl_long' => '', 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 throw $ex; 101 // Already deleted, or does not exist; 102 } 103 104 DB::table('placelocation') 105 ->update([ 106 'pl_place' => new Expression('SUBSTR(pl_place, 1, 120)'), 107 ]); 108 109 // The lack of unique key constraints means that there may be duplicates... 110 while (true) { 111 // Two places with the same name and parent... 112 $row = DB::table('placelocation') 113 ->select([ 114 new Expression('MIN(pl_id) AS min'), 115 new Expression('MAX(pl_id) AS max'), 116 ]) 117 ->groupBy(['pl_parent_id', 'pl_place']) 118 ->having(new Expression('COUNT(*)'), '>', '1') 119 ->first(); 120 121 if ($row === null) { 122 break; 123 } 124 125 // ...move children to the first 126 DB::table('placelocation') 127 ->where('pl_parent_id', '=', $row->max) 128 ->update(['pl_parent_id' => $row->min]); 129 130 // ...delete the second 131 DB::table('placelocation') 132 ->where('pl_id', '=', $row->max) 133 ->delete(); 134 } 135 136 // This is the SQL standard. It works with Postgres, Sqlite and MySQL 8 137 $select1 = DB::table('placelocation') 138 ->leftJoin('place_location', 'id', '=', 'pl_id') 139 ->whereNull('id') 140 ->orderBy('pl_level') 141 ->orderBy('pl_id') 142 ->select([ 143 'pl_id', 144 new Expression('CASE pl_parent_id WHEN 0 THEN NULL ELSE pl_parent_id END'), 145 'pl_place', 146 new Expression("CAST(REPLACE(REPLACE(pl_lati, 'S', '-'), 'N', '') AS FLOAT)"), 147 new Expression("CAST(REPLACE(REPLACE(pl_long, 'W', '-'), 'E', '') AS FLOAT)"), 148 ]); 149 150 // This works for MySQL 5.7 and lower, which cannot cast to FLOAT 151 $select2 = DB::table('placelocation') 152 ->leftJoin('place_location', 'id', '=', 'pl_id') 153 ->whereNull('id') 154 ->orderBy('pl_level') 155 ->orderBy('pl_id') 156 ->select([ 157 'pl_id', 158 new Expression('CASE pl_parent_id WHEN 0 THEN NULL ELSE pl_parent_id END'), 159 'pl_place', 160 new Expression("REPLACE(REPLACE(pl_lati, 'S', '-'), 'N', '')"), 161 new Expression("REPLACE(REPLACE(pl_long, 'W', '-'), 'E', '')"), 162 ]); 163 164 try { 165 DB::table('place_location') 166 ->insertUsing(['id', 'parent_id', 'place', 'latitude', 'longitude'], $select1); 167 } catch (PDOException $ex) { 168 DB::table('place_location') 169 ->insertUsing(['id', 'parent_id', 'place', 'latitude', 'longitude'], $select2); 170 } 171 172 DB::schema()->drop('placelocation'); 173 } 174 175 // Earlier versions of webtrees used 0 and NULL interchangeably. 176 // Assume 0 at the country-level and NULL at lower levels. 177 DB::table('place_location') 178 ->whereNotNull('parent_id') 179 ->where('latitude', '=', 0) 180 ->where('longitude', '=', 0) 181 ->update([ 182 'latitude' => null, 183 'longitude' => null, 184 ]); 185 } 186} 187