Craft CMS Stack Exchange is a question and answer site for administrators, end users, developers and designers for Craft CMS. It only takes a minute to sign up.
Sign up to join this community
I'm developing a plugin, bumping the version number to run the migrations I'm creating but then, for sanity, checked they run when the plugin is installed for the first time, which doesn't seem to be the case.
Could someone clarify how to get the migrations to run on install?
The object of migrations is to provide a way for existing installations of your plugin to get the updated db schema as you update your plugin, without having to uninstall (which would mean they would lose all plugin data) and then reinstall your plugin.
If your schema changes over the life of your plugin, you can write a migration to keep existing installations updated with the latest schema. Craft automatically checks for new migrations whenever a plugin’s version number changes.
https://craftcms.com/docs/plugins/migrations
This is because when a plugin is installed, Craft/Yii will go through your records and create the needed tables/columns as you have defined.
If a user downloads the updated plugin and replaces the current version, they won't have the new columns and things could break as they navigate and try to add data.
This is where migrations play an important role, they are to prevent existing users having to lose all plugin data by uninstalling and reinstalling, so when you change your plugin version, Craft will see there is an update and run through all the migrations to bring them up to the current version.
This is especially handy if for example someone has version 0.1.0 and they update to version 1.0.0, which could be quite a leap.
So in short, if you add new attributes to your plugin record, they will be added for new installations but migrations are only for existing installations
