You are browsing the latest version of the documentation which is not released yet. See the current stable version instead.

Dumping and Importing the Database

Sometimes you may need to dump (i.e. export) and import the application database. The typical use case is creating and restoring a database backup or transferring database from one machine to another.

In Shopsys Framework, database dumps consist of public schema only. This schema contains all the application data. There are other database objects inside pg_catalog schema (like collations or extensions) but those are not considered part of the application database and therefore are not included in database dumps.

Dumping (exporting) database

The following command will create a SQL file with database dump:

php bin/console shopsys:database:dump dump.sql

Importing database into the current database

If you want to import the database into an existing application database, you first need wipe all the data in the current database:

phing db-wipe-public-schema

Danger

This command wipes everything in public database schema (i.e. you will lose all application data)!

Hint

In this step you were using Phing target db-wipe-public-schema.
More information about what Phing targets are and how they work can be found in Console Commands for Application Management (Phing Targets)

Then you can import the dump:

psql --quiet --username=database_user --host=database_host target_database_name < dump.sql

Replace database_user, database_host and target_database_name with the correct values (from your .env.local). The command will prompt you for the user's password.

Importing database into a new database

First, edit your config/parameters.yaml and set the new database name.

Note

If you are not in the DEVELOPMENT environment you will have to clear the cache via php phing clean for the changes to take effect.

After that you can create the new database including the required content of pg_catalog schema by executing:

php phing db-create

Then you can import the dump:

psql --quiet --username=database_user --host=database_host target_database_name < dump.sql

Replace database_user, database_host and target_database_name with the correct values (from your .env.local). The command will prompt you for the user's password.