upstream/opnsense-docs
1
0
Fork 0
mirror of https://github.com/opnsense/docs.git synced 2026-04-27 00:58:42 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

note the parent method call necessity (#374)

Browse source
This commit is contained in:
kulikov-a 2022-01-17 15:14:02 +03:00 committed by GitHub
parent 1672961faa
commit deaab7382b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 3 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
source/development/frontend/models_migrations.rst
View file

@ -69,6 +69,9 @@ It contains two methods, :code:`run()` and :code:`post()`. The first one is exec
back to the running configuration and for all version steps in sequence. (an upgrade from 1.0.0 to 1.0.2 might execute 1.0.1, 1.0.2, 1.0.3).
The configuration data itself will be synced ones in this case.
.. Note::
Except in special cases, a :code:`run()` method should always contain a parent method call :code:`parent::run($model);` to perform the basic migration function.
The post action is called after normal model configuration and can sometimes be practical to alter the raw model xml, for example if
model versions require a move of datasets, without actually changing content.