]> BookStack Code Mirror - bookstack/blob - app/Console/Commands/UpdateUrlCommand.php
Notifications: Switched testing from string to reference levels
[bookstack] / app / Console / Commands / UpdateUrlCommand.php
1 <?php
2
3 namespace BookStack\Console\Commands;
4
5 use Illuminate\Console\Command;
6 use Illuminate\Database\Connection;
7
8 class UpdateUrlCommand extends Command
9 {
10     /**
11      * The name and signature of the console command.
12      *
13      * @var string
14      */
15     protected $signature = 'bookstack:update-url
16                             {oldUrl : URL to replace}
17                             {newUrl : URL to use as the replacement}
18                             {--force : Force the operation to run, ignoring confirmations}';
19
20     /**
21      * The console command description.
22      *
23      * @var string
24      */
25     protected $description = 'Find and replace the given URLs in your BookStack database';
26
27     /**
28      * Execute the console command.
29      */
30     public function handle(Connection $db): int
31     {
32         $oldUrl = str_replace("'", '', $this->argument('oldUrl'));
33         $newUrl = str_replace("'", '', $this->argument('newUrl'));
34
35         $urlPattern = '/https?:\/\/(.+)/';
36         if (!preg_match($urlPattern, $oldUrl) || !preg_match($urlPattern, $newUrl)) {
37             $this->error('The given urls are expected to be full urls starting with http:// or https://');
38
39             return 1;
40         }
41
42         if (!$this->checkUserOkayToProceed($oldUrl, $newUrl)) {
43             return 1;
44         }
45
46         $columnsToUpdateByTable = [
47             'attachments' => ['path'],
48             'pages'       => ['html', 'text', 'markdown'],
49             'images'      => ['url'],
50             'settings'    => ['value'],
51             'comments'    => ['html', 'text'],
52         ];
53
54         foreach ($columnsToUpdateByTable as $table => $columns) {
55             foreach ($columns as $column) {
56                 $changeCount = $this->replaceValueInTable($db, $table, $column, $oldUrl, $newUrl);
57                 $this->info("Updated {$changeCount} rows in {$table}->{$column}");
58             }
59         }
60
61         $jsonColumnsToUpdateByTable = [
62             'settings' => ['value'],
63         ];
64
65         foreach ($jsonColumnsToUpdateByTable as $table => $columns) {
66             foreach ($columns as $column) {
67                 $oldJson = trim(json_encode($oldUrl), '"');
68                 $newJson = trim(json_encode($newUrl), '"');
69                 $changeCount = $this->replaceValueInTable($db, $table, $column, $oldJson, $newJson);
70                 $this->info("Updated {$changeCount} JSON encoded rows in {$table}->{$column}");
71             }
72         }
73
74         $this->info('URL update procedure complete.');
75         $this->info('============================================================================');
76         $this->info('Be sure to run "php artisan cache:clear" to clear any old URLs in the cache.');
77         $this->info('============================================================================');
78
79         return 0;
80     }
81
82     /**
83      * Perform a find+replace operations in the provided table and column.
84      * Returns the count of rows changed.
85      */
86     protected function replaceValueInTable(
87         Connection $db,
88         string $table,
89         string $column,
90         string $oldUrl,
91         string $newUrl
92     ): int {
93         $oldQuoted = $db->getPdo()->quote($oldUrl);
94         $newQuoted = $db->getPdo()->quote($newUrl);
95
96         return $db->table($table)->update([
97             $column => $db->raw("REPLACE({$column}, {$oldQuoted}, {$newQuoted})"),
98         ]);
99     }
100
101     /**
102      * Warn the user of the dangers of this operation.
103      * Returns a boolean indicating if they've accepted the warnings.
104      */
105     protected function checkUserOkayToProceed(string $oldUrl, string $newUrl): bool
106     {
107         if ($this->option('force')) {
108             return true;
109         }
110
111         $dangerWarning = "This will search for \"{$oldUrl}\" in your database and replace it with  \"{$newUrl}\".\n";
112         $dangerWarning .= 'Are you sure you want to proceed?';
113         $backupConfirmation = 'This operation could cause issues if used incorrectly. Have you made a backup of your existing database?';
114
115         return $this->confirm($dangerWarning) && $this->confirm($backupConfirmation);
116     }
117 }