Download the PHP package erikgreasy/wp-db-migrations without Composer
On this page you can find all versions of the php package erikgreasy/wp-db-migrations. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download erikgreasy/wp-db-migrations
More information about erikgreasy/wp-db-migrations
Files in erikgreasy/wp-db-migrations
Package wp-db-migrations
Short Description Databse migrations for WordPress inspired by Laravel framework.
License
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package wp-db-migrations
WordPress database migrations
Databse migrations for WordPress inspired by Laravel framework.
Installation
There are few ways you can install WP DB migrations:
1. Install as a mu-plugin.
Download the latest release ZIP and extract it into your mu-plugins. You will need some type of must-use plugins autoloader in order for this to work, for example Bedrock Autoloader.
2. Install as a regular plugin
Download the latest release ZIP and extract it into your plugins, or install via wp-admin plugins section.
Getting started
Registering your migrations folders
When running the migrations with WP CLI command, the plugin scans all folders that are registered as "migrations folders". Migration folder is basically a folder in your plugin/theme, where your migrations are stored.
The plugin supports registering multiple migrations folders, so you can have separate migration folder for mulitple plugins.
To register a new migration folder, use the following WP filter:
Creating your first migration file
Migration file is just a PHP file, which follows specific structure, so the plugin can scan this file and run.
Migration structure
Simple example migration may look like this:
Few important points to take from example above are:
- we use PHP anonymous classes that extends the base Migration class. This base class provides few useful methods and properties for working with wpdb.
- the up() method is required and contains all your migration logic
- naming convention for the migration file is as follows:
- to prefix your migration with index (eg. 001)
- use some kind of identifier (eg. reviewplugin)
- the rest of the file name should describe what the migration does
- use snake_case for better readability
Creating migration files
You can create the migrations files manually, or you can generate them with WP CLI command:
which will create an empty migration with specified name in the location, from where the command was run.
Running your migrations
Now you are ready to run your migrations. To run the migrations, use the WP CLI command:
Add this command to the deploy script of your app, or run the command manually.
Alternatively, you can run the migrations directly, without using WP_CLI, by calling Migrator method. For example, this can be done during the plugin activation:
