J4.x

CLI Database Exporter Importer: Difference between revisions

From Joomla! Documentation

m Sandra97 moved page CLI Database Exporter Importer to J4.x:CLI Database Exporter Importer: Using the correct namespace
m Remove --all it is not used in J4.2.5 and throws an error
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== About ==
<noinclude><languages /></noinclude>
Before updating Joomla! or [[J4.x:CLI Update|installing a third party extension]], it is strongly recommended that you back up your site.
<noinclude>{{Joomla version|version=4.0}}</noinclude>
The Joomla! 4.x Console provides commands for exporting (backing up) and importing (restoring) your Joomla! database.
{{-}}
<translate>
== About == <!--T:1-->
</translate>
<translate><!--T:2-->
Before updating Joomla! or [[S:MyLanguage/J4.x:CLI Update|installing a third party extension]], it is strongly recommended that you back up your site.<br />
The Joomla! 4.x Console provides commands for exporting (backing up) and importing (restoring) your Joomla! database. Note that it doesn't backup your filesystem which should be done separately</translate>


== Requirements ==
<translate>
 
== Requirements == <!--T:3-->
</translate>
<translate><!--T:4-->
To use these commands, you need a secured shell access (SSH) to your host on which the PHP CLI (Command Line Interface) is installed.
To use these commands, you need a secured shell access (SSH) to your host on which the PHP CLI (Command Line Interface) is installed.
Consider to have basic knowledge of using shell commands.
Consider to have basic knowledge of using shell commands.</translate>
 
== Instructions ==
Log in to your host and go to the root folder of your site.
I recommend to use the Joomla! 'tmp' folder in your <folder_path> to have read/write permissions.
 
* List all available commands of the Joomla! Console:
<tt>php cli/joomla.php list</tt>
 
* Export the database to the folder :
<tt>php cli/joomla.php database:export --all --folder <folder_path></tt>
 
* Import the database from folder:
<tt>php cli/joomla.php database:import --all --folder <folder_path></tt>
 
You can also :
 
* Export the database in a zip file :
<tt>php cli/joomla.php database:export --all --zip</tt>
 
* Export a table :
<tt>php cli/joomla.php database:export --table <table_name></tt>
 
* Export a table as a .zip file :
<tt>php cli/joomla.php database:export --table <table_name> --zip</tt>
 
* Import a table :
<tt>php cli/joomla.php database:import --table <table_name></tt>
 
* If you need help:
<tt>php cli/joomla.php database:export --help</tt>
 
<tt>php cli/joomla.php database:import --help</tt>
 
== Back up and restore ==
To make a full backup (with folders, files and database) of your site, you can execute these commands:


# Archive your joomla root directory:
<translate>
<tt>tar --exclude='./tmp/joomla_bak.*' -zcvf tmp/joomla_bak.tgz . > tmp/joomla_bak.log</tt>
== Instructions == <!--T:5-->
</translate>
<translate><!--T:6-->
Log into your host and go to the root folder of your site.<br />
I recommend to use the Joomla 'tmp' folder in your <folder_path> to have read/write permissions.</translate>


# Export all the joomla database:
* <translate><!--T:7--> List all available commands of the Joomla Console:<br /><tt>php cli/joomla.php list</tt></translate>
<tt>php cli/joomla.php database:export --all --folder tmp/db_bak</tt>
* <translate><!--T:8--> Export the database to the folder:<br /><tt>php cli/joomla.php database:export --folder <folder_path></tt></translate>
* <translate><!--T:9--> Import the database from folder:<br /><tt>php cli/joomla.php database:import --folder <folder_path></tt></translate>


<translate><!--T:10--> You can also:</translate>
<translate><!--T:11-->
* Export the database as a .zip file:<br /><tt>php cli/joomla.php database:export --zip</tt>
* Export a table:<br /><tt>php cli/joomla.php database:export --table <table_name></tt>
* Export a table as a .zip file:<br /><tt>php cli/joomla.php database:export --table <table_name> --zip</tt>
* Import a table:<br /><tt>php cli/joomla.php database:import --table <table_name></tt>
* If you need help:<br /><tt>php cli/joomla.php database:export --help</tt> <tt>php cli/joomla.php database:import --help</tt></translate>


And to restore it, execute these commands:
<translate>


# Import all the joomla database:
== Back up and restore == <!--T:12-->
<tt>php cli/joomla.php database:import --all --folder tmp/db_bak</tt>
</translate>
<translate><!--T:13--> To make a full backup (with folders, files and database) of your site, you can execute these commands:</translate>
<translate>
<!--T:14-->
# Archive your Joomla root directory:<br /><tt>tar --exclude='./tmp/joomla_bak.*' -zcvf tmp/joomla_bak.tgz . > tmp/joomla_bak.log</tt>
# Export all the Joomla database:<br /><tt>php cli/joomla.php database:export --all --folder tmp/db_bak</tt></translate>


# Extract the archive:
<translate><!--T:15--> And to restore it, execute these commands:</translate>
<tt>tar --recursive-unlink -xvf tmp/joomla_bak.tgz .</tt>
<translate><!--T:16-->
# Import all the Joomla database:<br /><tt>php cli/joomla.php database:import --all --folder tmp/db_bak</tt>
# Extract the archive:<br /><tt>tar --recursive-unlink -xvf tmp/joomla_bak.tgz .</tt></translate>


<noinclude>[[Category:Joomla! 4.x]]</noinclude>
<noinclude>
[[Category:Joomla! 4.x]]
[[Category:Joomla! 4.0{{#translation:}}]]
[[Category:Development{{#translation:}}]]
[[Category:Platform{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Joomla CLI]]
</noinclude>

Latest revision as of 19:01, 29 November 2022

Joomla! 
4.0

About

Before updating Joomla! or installing a third party extension, it is strongly recommended that you back up your site.
The Joomla! 4.x Console provides commands for exporting (backing up) and importing (restoring) your Joomla! database. Note that it doesn't backup your filesystem which should be done separately


Requirements

To use these commands, you need a secured shell access (SSH) to your host on which the PHP CLI (Command Line Interface) is installed. Consider to have basic knowledge of using shell commands.

Instructions

Log into your host and go to the root folder of your site.
I recommend to use the Joomla 'tmp' folder in your <folder_path> to have read/write permissions.

  • List all available commands of the Joomla Console:
    php cli/joomla.php list
  • Export the database to the folder:
    php cli/joomla.php database:export --folder <folder_path>
  • Import the database from folder:
    php cli/joomla.php database:import --folder <folder_path>

You can also:

  • Export the database as a .zip file:
    php cli/joomla.php database:export --zip
  • Export a table:
    php cli/joomla.php database:export --table <table_name>
  • Export a table as a .zip file:
    php cli/joomla.php database:export --table <table_name> --zip
  • Import a table:
    php cli/joomla.php database:import --table <table_name>
  • If you need help:
    php cli/joomla.php database:export --help php cli/joomla.php database:import --help


Back up and restore

To make a full backup (with folders, files and database) of your site, you can execute these commands:

  1. Archive your Joomla root directory:
    tar --exclude='./tmp/joomla_bak.*' -zcvf tmp/joomla_bak.tgz . > tmp/joomla_bak.log
  2. Export all the Joomla database:
    php cli/joomla.php database:export --all --folder tmp/db_bak

And to restore it, execute these commands:

  1. Import all the Joomla database:
    php cli/joomla.php database:import --all --folder tmp/db_bak
  2. Extract the archive:
    tar --recursive-unlink -xvf tmp/joomla_bak.tgz .