In the docs for the State API, the term 'reset' is used, without any reference as to what a reset is:

use State API to store transient information, that is okay to lose after a reset.

I've spent a significant amount of time digging through the back-end implementation of the State API, looking at the database tables, and testing writing values, and as far as I can tell, the state data is never removed. So I'm thinking that by a 'reset', they mean wiping the entire DB, re-installing Drupal, then importing all the config.

I'm just looking for other confirmation before I update the doc page with a clearer explanation. Can anyone confirm that my theory on what a 'reset' is, is correct? And if it's not, can anyone explain what a 'reset' is?

  • 1
    state is instance-specific(like last cron run time), config is site-specific(like system mail) / permanent. Reset means that if you delete all state, nothing breaks.
    – user21641
    Sep 19, 2017 at 5:53
  • Thank you for your reply, I appreciate you taking the time, but I'm still not clear on what a 'reset' is. I've never seen this term used in reference to Drupal before this.
    – Jaypan
    Sep 19, 2017 at 9:17
  • 2
    that documentation is bogus, there is no reset and it is never OK to delete state information, it is also not done :) Please create a bug report
    – Berdir
    Sep 19, 2017 at 11:14
  • @Berdir: "never OK to delete state information" - what use case is there that would cause site to break if state would got flushed?
    – user21641
    Sep 19, 2017 at 11:44
  • 1
    Berdir - thanks. I opened a ticket here: drupal.org/node/2909896
    – Jaypan
    Sep 19, 2017 at 11:49


Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Browse other questions tagged or ask your own question.