is*() methods now return boolean values;
[phpmyadmin.git] / export.php
bloba4681a6dea4be6268cfcfa0b2078b76b2f80b68a
1 <?php
2 /* vim: set expandtab sw=4 ts=4 sts=4: */
3 /**
4 * @todo too much die here, or?
5 * @version $Id$
6 * @package phpMyAdmin
7 */
9 /**
10 * Get the variables sent or posted to this script and a core script
12 require_once './libraries/common.inc.php';
13 require_once './libraries/zip.lib.php';
14 require_once './libraries/plugin_interface.lib.php';
16 PMA_checkParameters(array('what', 'export_type'));
18 // Scan plugins
19 $export_list = PMA_getPlugins('./libraries/export/', array('export_type' => $export_type, 'single_table' => isset($single_table)));
21 // Backward compatbility
22 $type = $what;
24 // Check export type
25 if (!isset($export_list[$type])) {
26 die('Bad type!');
29 /**
30 * valid compression methods
32 $compression_methods = array(
33 'zip',
34 'gzip',
35 'bzip',
38 /**
39 * init and variable checking
41 $compression = false;
42 $onserver = false;
43 $save_on_server = false;
44 $buffer_needed = false;
45 if (empty($_REQUEST['asfile'])) {
46 $asfile = false;
47 } else {
48 $asfile = true;
49 if (in_array($_REQUEST['compression'], $compression_methods)) {
50 $compression = $_REQUEST['compression'];
51 $buffer_needed = true;
53 if (!empty($_REQUEST['onserver'])) {
54 $onserver = $_REQUEST['onserver'];
55 // Will we save dump on server?
56 $save_on_server = ! empty($cfg['SaveDir']) && $onserver;
60 // Does export require to be into file?
61 if (isset($export_list[$type]['force_file']) && ! $asfile) {
62 $message = PMA_Message::error('strExportMustBeFile');
63 $GLOBALS['js_include'][] = 'functions.js';
64 require_once './libraries/header.inc.php';
65 if ($export_type == 'server') {
66 $active_page = 'server_export.php';
67 require './server_export.php';
68 } elseif ($export_type == 'database') {
69 $active_page = 'db_export.php';
70 require './db_export.php';
71 } else {
72 $active_page = 'tbl_export.php';
73 require './tbl_export.php';
75 exit();
78 // Generate error url and check for needed variables
79 if ($export_type == 'server') {
80 $err_url = 'server_export.php?' . PMA_generate_common_url();
81 } elseif ($export_type == 'database' && strlen($db)) {
82 $err_url = 'db_export.php?' . PMA_generate_common_url($db);
83 // Check if we have something to export
84 if (isset($table_select)) {
85 $tables = $table_select;
86 } else {
87 $tables = array();
89 } elseif ($export_type == 'table' && strlen($db) && strlen($table)) {
90 $err_url = 'tbl_export.php?' . PMA_generate_common_url($db, $table);
91 } else {
92 die('Bad parameters!');
95 // Get the functions specific to the export type
96 require './libraries/export/' . PMA_securePath($type) . '.php';
98 /**
99 * Increase time limit for script execution and initializes some variables
101 @set_time_limit($cfg['ExecTimeLimit']);
102 if (!empty($cfg['MemoryLimit'])) {
103 @ini_set('memory_limit', $cfg['MemoryLimit']);
106 // Start with empty buffer
107 $dump_buffer = '';
108 $dump_buffer_len = 0;
110 // We send fake headers to avoid browser timeout when buffering
111 $time_start = time();
115 * Output handler for all exports, if needed buffering, it stores data into
116 * $dump_buffer, otherwise it prints thems out.
118 * @param string the insert statement
120 * @return bool Whether output suceeded
122 function PMA_exportOutputHandler($line)
124 global $time_start, $dump_buffer, $dump_buffer_len, $save_filename;
126 // Kanji encoding convert feature
127 if ($GLOBALS['output_kanji_conversion']) {
128 $line = PMA_kanji_str_conv($line, $GLOBALS['knjenc'], isset($GLOBALS['xkana']) ? $GLOBALS['xkana'] : '');
130 // If we have to buffer data, we will perform everything at once at the end
131 if ($GLOBALS['buffer_needed']) {
133 $dump_buffer .= $line;
134 if ($GLOBALS['onfly_compression']) {
136 $dump_buffer_len += strlen($line);
138 if ($dump_buffer_len > $GLOBALS['memory_limit']) {
139 if ($GLOBALS['output_charset_conversion']) {
140 $dump_buffer = PMA_convert_string($GLOBALS['charset'], $GLOBALS['charset_of_file'], $dump_buffer);
142 // as bzipped
143 if ($GLOBALS['compression'] == 'bzip' && @function_exists('bzcompress')) {
144 $dump_buffer = bzcompress($dump_buffer);
146 // as a gzipped file
147 elseif ($GLOBALS['compression'] == 'gzip' && @function_exists('gzencode')) {
148 // without the optional parameter level because it bug
149 $dump_buffer = gzencode($dump_buffer);
151 if ($GLOBALS['save_on_server']) {
152 $write_result = @fwrite($GLOBALS['file_handle'], $dump_buffer);
153 if (!$write_result || ($write_result != strlen($dump_buffer))) {
154 $GLOBALS['message'] = PMA_Message::error('strNoSpace');
155 $GLOBALS['message']->addParam($save_filename);
156 return false;
158 } else {
159 echo $dump_buffer;
161 $dump_buffer = '';
162 $dump_buffer_len = 0;
164 } else {
165 $time_now = time();
166 if ($time_start >= $time_now + 30) {
167 $time_start = $time_now;
168 header('X-pmaPing: Pong');
169 } // end if
171 } else {
172 if ($GLOBALS['asfile']) {
173 if ($GLOBALS['output_charset_conversion']) {
174 $line = PMA_convert_string($GLOBALS['charset'], $GLOBALS['charset_of_file'], $line);
176 if ($GLOBALS['save_on_server'] && strlen($line) > 0) {
177 $write_result = @fwrite($GLOBALS['file_handle'], $line);
178 if (!$write_result || ($write_result != strlen($line))) {
179 $GLOBALS['message'] = PMA_Message::error('strNoSpace');
180 $GLOBALS['message']->addParam($save_filename);
181 return false;
183 $time_now = time();
184 if ($time_start >= $time_now + 30) {
185 $time_start = $time_now;
186 header('X-pmaPing: Pong');
187 } // end if
188 } else {
189 // We export as file - output normally
190 echo $line;
192 } else {
193 // We export as html - replace special chars
194 echo htmlspecialchars($line);
197 return true;
198 } // end of the 'PMA_exportOutputHandler()' function
200 // Defines the default <CR><LF> format. For SQL always use \n as MySQL wants this on all platforms.
201 if ($what == 'sql') {
202 $crlf = "\n";
203 } else {
204 $crlf = PMA_whichCrlf();
207 $output_kanji_conversion = function_exists('PMA_kanji_str_conv') && $type != 'xls';
209 // Do we need to convert charset?
210 $output_charset_conversion = $asfile && $cfg['AllowAnywhereRecoding']
211 && isset($charset_of_file) && $charset_of_file != $charset
212 && $type != 'xls';
214 // Use on the fly compression?
215 $onfly_compression = $GLOBALS['cfg']['CompressOnFly'] && ($compression == 'gzip' || $compression == 'bzip');
216 if ($onfly_compression) {
217 $memory_limit = trim(@ini_get('memory_limit'));
218 // 2 MB as default
219 if (empty($memory_limit)) {
220 $memory_limit = 2 * 1024 * 1024;
223 if (strtolower(substr($memory_limit, -1)) == 'm') {
224 $memory_limit = (int)substr($memory_limit, 0, -1) * 1024 * 1024;
225 } elseif (strtolower(substr($memory_limit, -1)) == 'k') {
226 $memory_limit = (int)substr($memory_limit, 0, -1) * 1024;
227 } elseif (strtolower(substr($memory_limit, -1)) == 'g') {
228 $memory_limit = (int)substr($memory_limit, 0, -1) * 1024 * 1024 * 1024;
229 } else {
230 $memory_limit = (int)$memory_limit;
233 // Some of memory is needed for other thins and as treshold.
234 // Nijel: During export I had allocated (see memory_get_usage function)
235 // approx 1.2MB so this comes from that.
236 if ($memory_limit > 1500000) {
237 $memory_limit -= 1500000;
240 // Some memory is needed for compression, assume 1/3
241 $memory_limit /= 8;
244 // Generate filename and mime type if needed
245 if ($asfile) {
246 $pma_uri_parts = parse_url($cfg['PmaAbsoluteUri']);
247 if ($export_type == 'server') {
248 if (isset($remember_template)) {
249 PMA_setCookie('pma_server_filename_template', $filename_template);
251 $filename = str_replace('__SERVER__', $GLOBALS['cfg']['Server']['host'], strftime($filename_template));
252 } elseif ($export_type == 'database') {
253 if (isset($remember_template)) {
254 PMA_setCookie('pma_db_filename_template', $filename_template);
256 $filename = str_replace('__DB__', $db, str_replace('__SERVER__', $GLOBALS['cfg']['Server']['host'], strftime($filename_template)));
257 } else {
258 if (isset($remember_template)) {
259 PMA_setCookie('pma_table_filename_template', $filename_template);
261 $filename = str_replace('__TABLE__', $table, str_replace('__DB__', $db, str_replace('__SERVER__', $GLOBALS['cfg']['Server']['host'], strftime($filename_template))));
264 // convert filename to iso-8859-1, it is safer
265 if (!(isset($cfg['AllowAnywhereRecoding']) && $cfg['AllowAnywhereRecoding'] )) {
266 $filename = PMA_convert_string($charset, 'iso-8859-1', $filename);
267 } else {
268 $filename = PMA_convert_string($convcharset, 'iso-8859-1', $filename);
271 // Grab basic dump extension and mime type
272 $filename .= '.' . $export_list[$type]['extension'];
273 $mime_type = $export_list[$type]['mime_type'];
275 // If dump is going to be compressed, set correct encoding or mime_type and add
276 // compression to extension
277 $content_encoding = '';
278 if ($compression == 'bzip') {
279 $filename .= '.bz2';
280 // browsers don't like this:
281 //$content_encoding = 'x-bzip2';
282 $mime_type = 'application/x-bzip2';
283 } elseif ($compression == 'gzip') {
284 $filename .= '.gz';
285 // Needed to avoid recompression by server modules like mod_gzip.
286 // It seems necessary to check about zlib.output_compression
287 // to avoid compressing twice
288 if (!@ini_get('zlib.output_compression')) {
289 // On Firefox 3, sending this content encoding corrupts the .gz
290 // (as tested on Windows and Linux) but detect GECKO 1.9
291 if (! (PMA_USR_BROWSER_AGENT == 'GECKO' && PMA_USR_BROWSER_VER == '1.9')) {
292 $content_encoding = 'x-gzip';
294 $mime_type = 'application/x-gzip';
296 } elseif ($compression == 'zip') {
297 $filename .= '.zip';
298 $mime_type = 'application/zip';
302 // Open file on server if needed
303 if ($save_on_server) {
304 $save_filename = PMA_userDir($cfg['SaveDir']) . preg_replace('@[/\\\\]@', '_', $filename);
305 unset($message);
306 if (file_exists($save_filename) && empty($onserverover)) {
307 $message = PMA_Message::error('strFileAlreadyExists');
308 $message->addParam($save_filename);
309 } else {
310 if (is_file($save_filename) && !is_writable($save_filename)) {
311 $message = PMA_Message::error('strNoPermission');
312 $message->addParam($save_filename);
313 } else {
314 if (!$file_handle = @fopen($save_filename, 'w')) {
315 $message = PMA_Message::error('strNoPermission');
316 $message->addParam($save_filename);
320 if (isset($message)) {
321 $GLOBALS['js_include'][] = 'functions.js';
322 require_once './libraries/header.inc.php';
323 if ($export_type == 'server') {
324 $active_page = 'server_export.php';
325 require './server_export.php';
326 } elseif ($export_type == 'database') {
327 $active_page = 'db_export.php';
328 require './db_export.php';
329 } else {
330 $active_page = 'tbl_export.php';
331 require './tbl_export.php';
333 exit();
338 * Send headers depending on whether the user chose to download a dump file
339 * or not
341 if (!$save_on_server) {
342 if ($asfile) {
343 // Download
344 // (avoid rewriting data containing HTML with anchors and forms;
345 // this was reported to happen under Plesk)
346 @ini_set('url_rewriter.tags','');
348 if (!empty($content_encoding)) {
349 header('Content-Encoding: ' . $content_encoding);
351 header('Content-Type: ' . $mime_type);
352 header('Expires: ' . gmdate('D, d M Y H:i:s') . ' GMT');
353 // lem9: Tested behavior of
354 // IE 5.50.4807.2300
355 // IE 6.0.2800.1106 (small glitch, asks twice when I click Open)
356 // IE 6.0.2900.2180
357 // Firefox 1.0.6
358 // in http and https
359 header('Content-Disposition: attachment; filename="' . $filename . '"');
360 if (PMA_USR_BROWSER_AGENT == 'IE') {
361 header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
362 header('Pragma: public');
363 } else {
364 header('Pragma: no-cache');
365 // test case: exporting a database into a .gz file with Safari
366 // would produce files not having the current time
367 // (added this header for Safari but should not harm other browsers)
368 header('Last-Modified: ' . gmdate('D, d M Y H:i:s') . ' GMT');
370 } else {
371 // HTML
372 if ($export_type == 'database') {
373 $num_tables = count($tables);
374 if ($num_tables == 0) {
375 $message = PMA_Message::error('strNoTablesFound');
376 $GLOBALS['js_include'][] = 'functions.js';
377 require_once './libraries/header.inc.php';
378 $active_page = 'db_export.php';
379 require './db_export.php';
380 exit();
383 $backup_cfgServer = $cfg['Server'];
384 require_once './libraries/header.inc.php';
385 $cfg['Server'] = $backup_cfgServer;
386 unset($backup_cfgServer);
387 echo "\n" . '<div align="' . $cell_align_left . '">' . "\n";
388 //echo ' <pre>' . "\n";
389 echo ' <form name="nofunction">' . "\n"
390 // remove auto-select for now: there is no way to select
391 // only a part of the text; anyway, it should obey
392 // $cfg['TextareaAutoSelect']
393 //. ' <textarea name="sqldump" cols="50" rows="30" onclick="this.select();" id="textSQLDUMP" wrap="OFF">' . "\n";
394 . ' <textarea name="sqldump" cols="50" rows="30" id="textSQLDUMP" wrap="OFF">' . "\n";
395 } // end download
398 // Fake loop just to allow skip of remain of this code by break, I'd really
399 // need exceptions here :-)
400 do {
402 // Add possibly some comments to export
403 if (!PMA_exportHeader()) {
404 break;
407 // Will we need relation & co. setup?
408 $do_relation = isset($GLOBALS[$what . '_relation']);
409 $do_comments = isset($GLOBALS[$what . '_comments']);
410 $do_mime = isset($GLOBALS[$what . '_mime']);
411 if ($do_relation || $do_comments || $do_mime) {
412 require_once './libraries/relation.lib.php';
413 $cfgRelation = PMA_getRelationsParam();
415 if ($do_mime) {
416 require_once './libraries/transformations.lib.php';
419 // Include dates in export?
420 $do_dates = isset($GLOBALS[$what . '_dates']);
423 * Builds the dump
425 // Gets the number of tables if a dump of a database has been required
426 if ($export_type == 'server') {
427 if (isset($db_select)) {
428 $tmp_select = implode($db_select, '|');
429 $tmp_select = '|' . $tmp_select . '|';
431 // Walk over databases
432 foreach ($GLOBALS['pma']->databases as $current_db) {
433 if ((isset($tmp_select) && strpos(' ' . $tmp_select, '|' . $current_db . '|'))
434 || !isset($tmp_select)) {
435 if (!PMA_exportDBHeader($current_db)) {
436 break 2;
438 if (!PMA_exportDBCreate($current_db)) {
439 break 2;
441 $tables = PMA_DBI_get_tables($current_db);
442 $views = array();
443 foreach ($tables as $table) {
444 // if this is a view, collect it for later; views must be exported
445 // after the tables
446 $is_view = PMA_Table::isView($current_db, $table);
447 if ($is_view) {
448 $views[] = $table;
450 if (isset($GLOBALS[$what . '_structure'])) {
451 // for a view, export a stand-in definition of the table
452 // to resolve view dependencies
453 if (!PMA_exportStructure($current_db, $table, $crlf, $err_url, $do_relation, $do_comments, $do_mime, $do_dates, $is_view ? 'stand_in' : 'create_table', $export_type)) {
454 break 3;
457 if (isset($GLOBALS[$what . '_data']) && ! $is_view) {
458 $local_query = 'SELECT * FROM ' . PMA_backquote($current_db) . '.' . PMA_backquote($table);
459 if (!PMA_exportData($current_db, $table, $crlf, $err_url, $local_query)) {
460 break 3;
464 foreach($views as $view) {
465 // no data export for a view
466 if (isset($GLOBALS[$what . '_structure'])) {
467 if (!PMA_exportStructure($current_db, $view, $crlf, $err_url, $do_relation, $do_comments, $do_mime, $do_dates, 'create_view', $export_type)) {
468 break 3;
472 if (!PMA_exportDBFooter($current_db)) {
473 break 2;
477 } elseif ($export_type == 'database') {
478 if (!PMA_exportDBHeader($db)) {
479 break;
481 $i = 0;
482 $views = array();
483 // $tables contains the choices from the user (via $table_select)
484 foreach ($tables as $table) {
485 // if this is a view, collect it for later; views must be exported after
486 // the tables
487 $is_view = PMA_Table::isView($db, $table);
488 if ($is_view) {
489 $views[] = $table;
491 if (isset($GLOBALS[$what . '_structure'])) {
492 // for a view, export a stand-in definition of the table
493 // to resolve view dependencies
494 if (!PMA_exportStructure($db, $table, $crlf, $err_url, $do_relation, $do_comments, $do_mime, $do_dates, $is_view ? 'stand_in' : 'create_table', $export_type)) {
495 break 2;
498 if (isset($GLOBALS[$what . '_data']) && ! $is_view) {
499 $local_query = 'SELECT * FROM ' . PMA_backquote($db) . '.' . PMA_backquote($table);
500 if (!PMA_exportData($db, $table, $crlf, $err_url, $local_query)) {
501 break 2;
505 foreach ($views as $view) {
506 // no data export for a view
507 if (isset($GLOBALS[$what . '_structure'])) {
508 if (!PMA_exportStructure($db, $view, $crlf, $err_url, $do_relation, $do_comments, $do_mime, $do_dates, 'create_view', $export_type)) {
509 break 2;
514 if (!PMA_exportDBFooter($db)) {
515 break;
517 } else {
518 if (!PMA_exportDBHeader($db)) {
519 break;
521 // We export just one table
523 if ($limit_to > 0 && $limit_from >= 0) {
524 $add_query = ' LIMIT '
525 . (($limit_from > 0) ? $limit_from . ', ' : '')
526 . $limit_to;
527 } else {
528 $add_query = '';
531 $is_view = PMA_Table::isView($db, $table);
532 if (isset($GLOBALS[$what . '_structure'])) {
533 if (!PMA_exportStructure($db, $table, $crlf, $err_url, $do_relation, $do_comments, $do_mime, $do_dates, $is_view ? 'create_view' : 'create_table', $export_type)) {
534 break;
537 // If this is an export of a single view, we have to export data;
538 // for example, a PDF report
539 if (isset($GLOBALS[$what . '_data'])) {
540 if (!empty($sql_query)) {
541 // only preg_replace if needed
542 if (!empty($add_query)) {
543 // remove trailing semicolon before adding a LIMIT
544 $sql_query = preg_replace('%;\s*$%', '', $sql_query);
546 $local_query = $sql_query . $add_query;
547 PMA_DBI_select_db($db);
548 } else {
549 $local_query = 'SELECT * FROM ' . PMA_backquote($db) . '.' . PMA_backquote($table) . $add_query;
551 if (!PMA_exportData($db, $table, $crlf, $err_url, $local_query)) {
552 break;
555 if (!PMA_exportDBFooter($db)) {
556 break;
559 if (!PMA_exportFooter()) {
560 break;
563 } while (false);
564 // End of fake loop
566 if ($save_on_server && isset($message)) {
567 $GLOBALS['js_include'][] = 'functions.js';
568 require_once './libraries/header.inc.php';
569 if ($export_type == 'server') {
570 $active_page = 'server_export.php';
571 require './server_export.php';
572 } elseif ($export_type == 'database') {
573 $active_page = 'db_export.php';
574 require './db_export.php';
575 } else {
576 $active_page = 'tbl_export.php';
577 require './tbl_export.php';
579 exit();
583 * Send the dump as a file...
585 if (!empty($asfile)) {
586 // Convert the charset if required.
587 if ($output_charset_conversion) {
588 $dump_buffer = PMA_convert_string($GLOBALS['charset'], $GLOBALS['charset_of_file'], $dump_buffer);
591 // Do the compression
592 // 1. as a zipped file
593 if ($compression == 'zip') {
594 if (@function_exists('gzcompress')) {
595 $zipfile = new zipfile();
596 $zipfile -> addFile($dump_buffer, substr($filename, 0, -4));
597 $dump_buffer = $zipfile -> file();
600 // 2. as a bzipped file
601 elseif ($compression == 'bzip') {
602 if (@function_exists('bzcompress')) {
603 $dump_buffer = bzcompress($dump_buffer);
606 // 3. as a gzipped file
607 elseif ($compression == 'gzip') {
608 if (@function_exists('gzencode')) {
609 // without the optional parameter level because it bug
610 $dump_buffer = gzencode($dump_buffer);
614 /* If ve saved on server, we have to close file now */
615 if ($save_on_server) {
616 $write_result = @fwrite($file_handle, $dump_buffer);
617 fclose($file_handle);
618 if (strlen($dump_buffer) !=0 && (!$write_result || ($write_result != strlen($dump_buffer)))) {
619 $message = new PMA_Message('strNoSpace', PMA_Message::ERROR, $save_filename);
620 } else {
621 $message = new PMA_Message('strDumpSaved', PMA_Message::SUCCESS, $save_filename);
624 $GLOBALS['js_include'][] = 'functions.js';
625 require_once './libraries/header.inc.php';
626 if ($export_type == 'server') {
627 $active_page = 'server_export.php';
628 require_once './server_export.php';
629 } elseif ($export_type == 'database') {
630 $active_page = 'db_export.php';
631 require_once './db_export.php';
632 } else {
633 $active_page = 'tbl_export.php';
634 require_once './tbl_export.php';
636 exit();
637 } else {
638 echo $dump_buffer;
642 * Displays the dump...
644 else {
646 * Close the html tags and add the footers in dump is displayed on screen
648 //echo ' </pre>' . "\n";
649 echo '</textarea>' . "\n"
650 . ' </form>' . "\n";
651 echo '</div>' . "\n";
652 echo "\n";
654 <script type="text/javascript">
655 //<![CDATA[
656 var bodyWidth=null; var bodyHeight=null;
657 if (document.getElementById('textSQLDUMP')) {
658 bodyWidth = self.innerWidth;
659 bodyHeight = self.innerHeight;
660 if (!bodyWidth && !bodyHeight) {
661 if (document.compatMode && document.compatMode == "BackCompat") {
662 bodyWidth = document.body.clientWidth;
663 bodyHeight = document.body.clientHeight;
664 } else if (document.compatMode && document.compatMode == "CSS1Compat") {
665 bodyWidth = document.documentElement.clientWidth;
666 bodyHeight = document.documentElement.clientHeight;
669 document.getElementById('textSQLDUMP').style.width=(bodyWidth-50) + 'px';
670 document.getElementById('textSQLDUMP').style.height=(bodyHeight-100) + 'px';
672 //]]>
673 </script>
674 <?php
675 require_once './libraries/footer.inc.php';
676 } // end if