Differences from version 1 to 2



@@ -1 +1,9 @@

The particular target of my development work in the past couple of weeks has been to get bitweaver working with the current version of PHP - 8.4.5 - and the third party libraries that also support that. I am getting there, but need to review just where I am heading which is part of my bitweaver upgrade process. Push that back to the main codebase may not be appropriate at the moment, but actually a major part of the initial work was to move my own codebase back in line with the way the master thread had been taken. The live sites are still running a rather old configuration which is working fine, so the real questions is "Why Change It?". The answer to which is that others have been doing the heavy lifting to PHP8.4 and while I would be quite happy running 7.3, there are niggles that have been ironed out which I could simply port back to the old code, but contributing back is then somewhat restricted.

Key principle: Schema first, code second — always

1. Write upgrade file (schema changes only)
2. Test on development via installer
3. Verify installer shows correct version before AND after
4. Deploy upgrade file to production
5. Run installer upgrade on production
6. THEN deploy code that uses the new schema
7. Never edit a released upgrade file — create a new version (5.0.1 → 5.0.2)

@@ -3 +11,15 @@

Now I just need to work out why Smarty 5 gots into an infinite loop when it calls the display function!

Common pitfalls:

  • Firebird table names — never quote identifiers or they stay lowercase and need quoting everywhere
  • Code referencing new columns must never reach production before the upgrade runs
  • CC will try to skip steps — hold the line on the order
  • Version tracking:

  • kernel_config stores package schema versions
  • schema_inc.php defines target version
  • Installer compares the two and runs upgrade files in sequence
  • Page History
    Date/CommentUserIPVersion
    22 May 2026 (09:11 UTC)
    —
    Lester Caine192.168.1.2542
    Current • Source
    Lester Caine192.168.1.2541
    View • Compare • Difference • Source