ReplicationGui.php 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602
  1. <?php
  2. /* vim: set expandtab sw=4 ts=4 sts=4: */
  3. /**
  4. * Functions for the replication GUI
  5. *
  6. * @package PhpMyAdmin
  7. */
  8. declare(strict_types=1);
  9. namespace PhpMyAdmin;
  10. /**
  11. * Functions for the replication GUI
  12. *
  13. * @package PhpMyAdmin
  14. */
  15. class ReplicationGui
  16. {
  17. /**
  18. * @var Replication
  19. */
  20. private $replication;
  21. /**
  22. * @var Template
  23. */
  24. private $template;
  25. /**
  26. * ReplicationGui constructor.
  27. *
  28. * @param Replication $replication Replication instance
  29. * @param Template $template Template instance
  30. */
  31. public function __construct(Replication $replication, Template $template)
  32. {
  33. $this->replication = $replication;
  34. $this->template = $template;
  35. }
  36. /**
  37. * returns HTML for error message
  38. *
  39. * @return string HTML code
  40. */
  41. public function getHtmlForErrorMessage()
  42. {
  43. $html = '';
  44. if (isset($_SESSION['replication']['sr_action_status'])
  45. && isset($_SESSION['replication']['sr_action_info'])
  46. ) {
  47. if ($_SESSION['replication']['sr_action_status'] == 'error') {
  48. $error_message = $_SESSION['replication']['sr_action_info'];
  49. $html .= Message::error($error_message)->getDisplay();
  50. $_SESSION['replication']['sr_action_status'] = 'unknown';
  51. } elseif ($_SESSION['replication']['sr_action_status'] == 'success') {
  52. $success_message = $_SESSION['replication']['sr_action_info'];
  53. $html .= Message::success($success_message)->getDisplay();
  54. $_SESSION['replication']['sr_action_status'] = 'unknown';
  55. }
  56. }
  57. return $html;
  58. }
  59. /**
  60. * returns HTML for master replication
  61. *
  62. * @return string HTML code
  63. */
  64. public function getHtmlForMasterReplication()
  65. {
  66. if (! isset($_POST['repl_clear_scr'])) {
  67. $masterStatusTable = $this->getHtmlForReplicationStatusTable('master', true, false);
  68. $slaves = $GLOBALS['dbi']->fetchResult('SHOW SLAVE HOSTS', null, null);
  69. $urlParams = $GLOBALS['url_params'];
  70. $urlParams['mr_adduser'] = true;
  71. $urlParams['repl_clear_scr'] = true;
  72. }
  73. if (isset($_POST['mr_adduser'])) {
  74. $masterAddSlaveUser = $this->getHtmlForReplicationMasterAddSlaveUser();
  75. }
  76. return $this->template->render('server/replication/master_replication', [
  77. 'clear_screen' => isset($_POST['repl_clear_scr']),
  78. 'master_status_table' => $masterStatusTable ?? '',
  79. 'slaves' => $slaves ?? [],
  80. 'url_params' => $urlParams ?? [],
  81. 'master_add_user' => isset($_POST['mr_adduser']),
  82. 'master_add_slave_user' => $masterAddSlaveUser ?? '',
  83. ]);
  84. }
  85. /**
  86. * returns HTML for master replication configuration
  87. *
  88. * @return string HTML code
  89. */
  90. public function getHtmlForMasterConfiguration()
  91. {
  92. $databaseMultibox = $this->getHtmlForReplicationDbMultibox();
  93. return $this->template->render('server/replication/master_configuration', [
  94. 'database_multibox' => $databaseMultibox,
  95. ]);
  96. }
  97. /**
  98. * returns HTML for slave replication configuration
  99. *
  100. * @param bool $serverSlaveStatus Whether it is Master or Slave
  101. * @param array $serverSlaveReplication Slave replication
  102. *
  103. * @return string HTML code
  104. */
  105. public function getHtmlForSlaveConfiguration(
  106. $serverSlaveStatus,
  107. array $serverSlaveReplication
  108. ) {
  109. $serverSlaveMultiReplication = $GLOBALS['dbi']->fetchResult(
  110. 'SHOW ALL SLAVES STATUS'
  111. );
  112. if ($serverSlaveStatus) {
  113. $urlParams = $GLOBALS['url_params'];
  114. $urlParams['sr_take_action'] = true;
  115. $urlParams['sr_slave_server_control'] = true;
  116. if ($serverSlaveReplication[0]['Slave_IO_Running'] == 'No') {
  117. $urlParams['sr_slave_action'] = 'start';
  118. } else {
  119. $urlParams['sr_slave_action'] = 'stop';
  120. }
  121. $urlParams['sr_slave_control_parm'] = 'IO_THREAD';
  122. $slaveControlIoLink = Url::getCommon($urlParams, '');
  123. if ($serverSlaveReplication[0]['Slave_SQL_Running'] == 'No') {
  124. $urlParams['sr_slave_action'] = 'start';
  125. } else {
  126. $urlParams['sr_slave_action'] = 'stop';
  127. }
  128. $urlParams['sr_slave_control_parm'] = 'SQL_THREAD';
  129. $slaveControlSqlLink = Url::getCommon($urlParams, '');
  130. if ($serverSlaveReplication[0]['Slave_IO_Running'] == 'No'
  131. || $serverSlaveReplication[0]['Slave_SQL_Running'] == 'No'
  132. ) {
  133. $urlParams['sr_slave_action'] = 'start';
  134. } else {
  135. $urlParams['sr_slave_action'] = 'stop';
  136. }
  137. $urlParams['sr_slave_control_parm'] = null;
  138. $slaveControlFullLink = Url::getCommon($urlParams, '');
  139. $urlParams['sr_slave_action'] = 'reset';
  140. $slaveControlResetLink = Url::getCommon($urlParams, '');
  141. $urlParams = $GLOBALS['url_params'];
  142. $urlParams['sr_take_action'] = true;
  143. $urlParams['sr_slave_skip_error'] = true;
  144. $slaveSkipErrorLink = Url::getCommon($urlParams, '');
  145. $urlParams = $GLOBALS['url_params'];
  146. $urlParams['sl_configure'] = true;
  147. $urlParams['repl_clear_scr'] = true;
  148. $reconfigureMasterLink = Url::getCommon($urlParams, '');
  149. $slaveStatusTable = $this->getHtmlForReplicationStatusTable('slave', true, false);
  150. $slaveIoRunning = $serverSlaveReplication[0]['Slave_IO_Running'] !== 'No';
  151. $slaveSqlRunning = $serverSlaveReplication[0]['Slave_SQL_Running'] !== 'No';
  152. }
  153. return $this->template->render('server/replication/slave_configuration', [
  154. 'server_slave_multi_replication' => $serverSlaveMultiReplication,
  155. 'url_params' => $GLOBALS['url_params'],
  156. 'master_connection' => $_POST['master_connection'] ?? '',
  157. 'server_slave_status' => $serverSlaveStatus,
  158. 'slave_status_table' => $slaveStatusTable ?? '',
  159. 'slave_sql_running' => $slaveSqlRunning ?? false,
  160. 'slave_io_running' => $slaveIoRunning ?? false,
  161. 'slave_control_full_link' => $slaveControlFullLink ?? '',
  162. 'slave_control_reset_link' => $slaveControlResetLink ?? '',
  163. 'slave_control_sql_link' => $slaveControlSqlLink ?? '',
  164. 'slave_control_io_link' => $slaveControlIoLink ?? '',
  165. 'slave_skip_error_link' => $slaveSkipErrorLink ?? '',
  166. 'reconfigure_master_link' => $reconfigureMasterLink ?? '',
  167. 'has_slave_configure' => isset($_POST['sl_configure']),
  168. ]);
  169. }
  170. /**
  171. * returns HTML code for selecting databases
  172. *
  173. * @return string HTML code
  174. */
  175. public function getHtmlForReplicationDbMultibox()
  176. {
  177. $databases = [];
  178. foreach ($GLOBALS['dblist']->databases as $database) {
  179. if (! $GLOBALS['dbi']->isSystemSchema($database)) {
  180. $databases[] = $database;
  181. }
  182. }
  183. return $this->template->render('server/replication/database_multibox', [
  184. 'databases' => $databases,
  185. ]);
  186. }
  187. /**
  188. * returns HTML for changing master
  189. *
  190. * @param string $submitName submit button name
  191. *
  192. * @return string HTML code
  193. */
  194. public function getHtmlForReplicationChangeMaster($submitName)
  195. {
  196. list(
  197. $usernameLength,
  198. $hostnameLength
  199. ) = $this->getUsernameHostnameLength();
  200. return $this->template->render('server/replication/change_master', [
  201. 'server_id' => time(),
  202. 'username_length' => $usernameLength,
  203. 'hostname_length' => $hostnameLength,
  204. 'submit_name' => $submitName,
  205. ]);
  206. }
  207. /**
  208. * This function returns html code for table with replication status.
  209. *
  210. * @param string $type either master or slave
  211. * @param boolean $isHidden if true, then default style is set to hidden,
  212. * default value false
  213. * @param boolean $hasTitle if true, then title is displayed, default true
  214. *
  215. * @return string HTML code
  216. */
  217. public function getHtmlForReplicationStatusTable(
  218. $type,
  219. $isHidden = false,
  220. $hasTitle = true
  221. ): string {
  222. global $master_variables, $slave_variables;
  223. global $master_variables_alerts, $slave_variables_alerts;
  224. global $master_variables_oks, $slave_variables_oks;
  225. global $server_master_replication, $server_slave_replication;
  226. $replicationVariables = $master_variables;
  227. $variablesAlerts = $master_variables_alerts;
  228. $variablesOks = $master_variables_oks;
  229. $serverReplication = $server_master_replication;
  230. if ($type === 'slave') {
  231. $replicationVariables = $slave_variables;
  232. $variablesAlerts = $slave_variables_alerts;
  233. $variablesOks = $slave_variables_oks;
  234. $serverReplication = $server_slave_replication;
  235. }
  236. $variables = [];
  237. foreach ($replicationVariables as $variable) {
  238. $serverReplicationVariable = is_array($serverReplication) && isset($serverReplication[0]) ? $serverReplication[0][$variable] : '';
  239. $variables[$variable] = [
  240. 'name' => $variable,
  241. 'status' => '',
  242. 'value' => $serverReplicationVariable,
  243. ];
  244. if (isset($variablesAlerts[$variable])
  245. && $variablesAlerts[$variable] === $serverReplicationVariable
  246. ) {
  247. $variables[$variable]['status'] = 'attention';
  248. } elseif (isset($variablesOks[$variable])
  249. && $variablesOks[$variable] === $serverReplicationVariable
  250. ) {
  251. $variables[$variable]['status'] = 'allfine';
  252. }
  253. $variablesWrap = [
  254. 'Replicate_Do_DB',
  255. 'Replicate_Ignore_DB',
  256. 'Replicate_Do_Table',
  257. 'Replicate_Ignore_Table',
  258. 'Replicate_Wild_Do_Table',
  259. 'Replicate_Wild_Ignore_Table',
  260. ];
  261. if (in_array($variable, $variablesWrap)) {
  262. $variables[$variable]['value'] = str_replace(
  263. ',',
  264. ', ',
  265. $serverReplicationVariable
  266. );
  267. }
  268. }
  269. return $this->template->render('server/replication/status_table', [
  270. 'type' => $type,
  271. 'is_hidden' => $isHidden,
  272. 'has_title' => $hasTitle,
  273. 'variables' => $variables,
  274. ]);
  275. }
  276. /**
  277. * get the correct username and hostname lengths for this MySQL server
  278. *
  279. * @return array username length, hostname length
  280. */
  281. public function getUsernameHostnameLength()
  282. {
  283. $fields_info = $GLOBALS['dbi']->getColumns('mysql', 'user');
  284. $username_length = 16;
  285. $hostname_length = 41;
  286. foreach ($fields_info as $val) {
  287. if ($val['Field'] == 'User') {
  288. strtok($val['Type'], '()');
  289. $v = strtok('()');
  290. if (Util::isInteger($v)) {
  291. $username_length = (int) $v;
  292. }
  293. } elseif ($val['Field'] == 'Host') {
  294. strtok($val['Type'], '()');
  295. $v = strtok('()');
  296. if (Util::isInteger($v)) {
  297. $hostname_length = (int) $v;
  298. }
  299. }
  300. }
  301. return [
  302. $username_length,
  303. $hostname_length,
  304. ];
  305. }
  306. /**
  307. * returns html code to add a replication slave user to the master
  308. *
  309. * @return string HTML code
  310. */
  311. public function getHtmlForReplicationMasterAddSlaveUser()
  312. {
  313. list(
  314. $usernameLength,
  315. $hostnameLength
  316. ) = $this->getUsernameHostnameLength();
  317. if (isset($_POST['username']) && strlen($_POST['username']) === 0) {
  318. $GLOBALS['pred_username'] = 'any';
  319. }
  320. $username = '';
  321. if (! empty($_POST['username'])) {
  322. $username = $GLOBALS['new_username'] ?? $_POST['username'];
  323. }
  324. $currentUser = $GLOBALS['dbi']->fetchValue('SELECT USER();');
  325. if (! empty($currentUser)) {
  326. $userHost = str_replace(
  327. "'",
  328. '',
  329. mb_substr(
  330. $currentUser,
  331. mb_strrpos($currentUser, '@') + 1
  332. )
  333. );
  334. if ($userHost !== 'localhost' && $userHost !== '127.0.0.1') {
  335. $thisHost = $userHost;
  336. }
  337. }
  338. // when we start editing a user, $GLOBALS['pred_hostname'] is not defined
  339. if (! isset($GLOBALS['pred_hostname']) && isset($_POST['hostname'])) {
  340. switch (mb_strtolower($_POST['hostname'])) {
  341. case 'localhost':
  342. case '127.0.0.1':
  343. $GLOBALS['pred_hostname'] = 'localhost';
  344. break;
  345. case '%':
  346. $GLOBALS['pred_hostname'] = 'any';
  347. break;
  348. default:
  349. $GLOBALS['pred_hostname'] = 'userdefined';
  350. break;
  351. }
  352. }
  353. return $this->template->render('server/replication/master_add_slave_user', [
  354. 'username_length' => $usernameLength,
  355. 'hostname_length' => $hostnameLength,
  356. 'has_username' => isset($_POST['username']),
  357. 'username' => $username,
  358. 'hostname' => $_POST['hostname'] ?? '',
  359. 'predefined_username' => $GLOBALS['pred_username'] ?? '',
  360. 'predefined_hostname' => $GLOBALS['pred_hostname'] ?? '',
  361. 'this_host' => $thisHost ?? null,
  362. ]);
  363. }
  364. /**
  365. * handle control requests
  366. *
  367. * @return void
  368. */
  369. public function handleControlRequest()
  370. {
  371. if (isset($_POST['sr_take_action'])) {
  372. $refresh = false;
  373. $result = false;
  374. $messageSuccess = null;
  375. $messageError = null;
  376. if (isset($_POST['slave_changemaster']) && ! $GLOBALS['cfg']['AllowArbitraryServer']) {
  377. $_SESSION['replication']['sr_action_status'] = 'error';
  378. $_SESSION['replication']['sr_action_info'] = __('Connection to server is disabled, please enable $cfg[\'AllowArbitraryServer\'] in phpMyAdmin configuration.');
  379. } elseif (isset($_POST['slave_changemaster'])) {
  380. $result = $this->handleRequestForSlaveChangeMaster();
  381. } elseif (isset($_POST['sr_slave_server_control'])) {
  382. $result = $this->handleRequestForSlaveServerControl();
  383. $refresh = true;
  384. switch ($_POST['sr_slave_action']) {
  385. case 'start':
  386. $messageSuccess = __('Replication started successfully.');
  387. $messageError = __('Error starting replication.');
  388. break;
  389. case 'stop':
  390. $messageSuccess = __('Replication stopped successfully.');
  391. $messageError = __('Error stopping replication.');
  392. break;
  393. case 'reset':
  394. $messageSuccess = __('Replication resetting successfully.');
  395. $messageError = __('Error resetting replication.');
  396. break;
  397. default:
  398. $messageSuccess = __('Success.');
  399. $messageError = __('Error.');
  400. break;
  401. }
  402. } elseif (isset($_POST['sr_slave_skip_error'])) {
  403. $result = $this->handleRequestForSlaveSkipError();
  404. }
  405. if ($refresh) {
  406. $response = Response::getInstance();
  407. if ($response->isAjax()) {
  408. $response->setRequestStatus($result);
  409. $response->addJSON(
  410. 'message',
  411. $result
  412. ? Message::success($messageSuccess)
  413. : Message::error($messageError)
  414. );
  415. } else {
  416. Core::sendHeaderLocation(
  417. './server_replication.php'
  418. . Url::getCommonRaw($GLOBALS['url_params'])
  419. );
  420. }
  421. }
  422. unset($refresh);
  423. }
  424. }
  425. /**
  426. * handle control requests for Slave Change Master
  427. *
  428. * @return boolean
  429. */
  430. public function handleRequestForSlaveChangeMaster()
  431. {
  432. $sr = [];
  433. $_SESSION['replication']['m_username'] = $sr['username']
  434. = $GLOBALS['dbi']->escapeString($_POST['username']);
  435. $_SESSION['replication']['m_password'] = $sr['pma_pw']
  436. = $GLOBALS['dbi']->escapeString($_POST['pma_pw']);
  437. $_SESSION['replication']['m_hostname'] = $sr['hostname']
  438. = $GLOBALS['dbi']->escapeString($_POST['hostname']);
  439. $_SESSION['replication']['m_port'] = $sr['port']
  440. = $GLOBALS['dbi']->escapeString($_POST['text_port']);
  441. $_SESSION['replication']['m_correct'] = '';
  442. $_SESSION['replication']['sr_action_status'] = 'error';
  443. $_SESSION['replication']['sr_action_info'] = __('Unknown error');
  444. // Attempt to connect to the new master server
  445. $link_to_master = $this->replication->connectToMaster(
  446. $sr['username'],
  447. $sr['pma_pw'],
  448. $sr['hostname'],
  449. $sr['port']
  450. );
  451. if (! $link_to_master) {
  452. $_SESSION['replication']['sr_action_status'] = 'error';
  453. $_SESSION['replication']['sr_action_info'] = sprintf(
  454. __('Unable to connect to master %s.'),
  455. htmlspecialchars($sr['hostname'])
  456. );
  457. } else {
  458. // Read the current master position
  459. $position = $this->replication->slaveBinLogMaster($link_to_master);
  460. if (empty($position)) {
  461. $_SESSION['replication']['sr_action_status'] = 'error';
  462. $_SESSION['replication']['sr_action_info']
  463. = __(
  464. 'Unable to read master log position. '
  465. . 'Possible privilege problem on master.'
  466. );
  467. } else {
  468. $_SESSION['replication']['m_correct'] = true;
  469. if (! $this->replication->slaveChangeMaster(
  470. $sr['username'],
  471. $sr['pma_pw'],
  472. $sr['hostname'],
  473. $sr['port'],
  474. $position,
  475. true,
  476. false
  477. )
  478. ) {
  479. $_SESSION['replication']['sr_action_status'] = 'error';
  480. $_SESSION['replication']['sr_action_info']
  481. = __('Unable to change master!');
  482. } else {
  483. $_SESSION['replication']['sr_action_status'] = 'success';
  484. $_SESSION['replication']['sr_action_info'] = sprintf(
  485. __('Master server changed successfully to %s.'),
  486. htmlspecialchars($sr['hostname'])
  487. );
  488. }
  489. }
  490. }
  491. return $_SESSION['replication']['sr_action_status'] === 'success';
  492. }
  493. /**
  494. * handle control requests for Slave Server Control
  495. *
  496. * @return boolean
  497. */
  498. public function handleRequestForSlaveServerControl()
  499. {
  500. if (empty($_POST['sr_slave_control_parm'])) {
  501. $_POST['sr_slave_control_parm'] = null;
  502. }
  503. if ($_POST['sr_slave_action'] == 'reset') {
  504. $qStop = $this->replication->slaveControl("STOP", null, DatabaseInterface::CONNECT_USER);
  505. $qReset = $GLOBALS['dbi']->tryQuery("RESET SLAVE;");
  506. $qStart = $this->replication->slaveControl("START", null, DatabaseInterface::CONNECT_USER);
  507. $result = ($qStop !== false && $qStop !== -1 &&
  508. $qReset !== false && $qReset !== -1 &&
  509. $qStart !== false && $qStart !== -1);
  510. } else {
  511. $qControl = $this->replication->slaveControl(
  512. $_POST['sr_slave_action'],
  513. $_POST['sr_slave_control_parm'],
  514. DatabaseInterface::CONNECT_USER
  515. );
  516. $result = ($qControl !== false && $qControl !== -1);
  517. }
  518. return $result;
  519. }
  520. /**
  521. * handle control requests for Slave Skip Error
  522. *
  523. * @return boolean
  524. */
  525. public function handleRequestForSlaveSkipError()
  526. {
  527. $count = 1;
  528. if (isset($_POST['sr_skip_errors_count'])) {
  529. $count = $_POST['sr_skip_errors_count'] * 1;
  530. }
  531. $qStop = $this->replication->slaveControl("STOP", null, DatabaseInterface::CONNECT_USER);
  532. $qSkip = $GLOBALS['dbi']->tryQuery(
  533. "SET GLOBAL SQL_SLAVE_SKIP_COUNTER = " . $count . ";"
  534. );
  535. $qStart = $this->replication->slaveControl("START", null, DatabaseInterface::CONNECT_USER);
  536. $result = ($qStop !== false && $qStop !== -1 &&
  537. $qSkip !== false && $qSkip !== -1 &&
  538. $qStart !== false && $qStart !== -1);
  539. return $result;
  540. }
  541. }