Bootstrap - Switch default boot process. Update docs. #145
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
cv
supports two protocols for booting a full environment with CiviCRM+CMS.--level=full
Bootstrap.php
civicrm-core
'scivicrm.config.php
. Boots Civi then CMS.CIVICRM_SETTINGS
--level=cms-full
CmsBootstrap.php
CIVICRM_BOOT
With this PR,
cv
will preferCmsBootstrap.php
. It aims to phase-out the olderBootstrap.php
. However, this is a notable policy change, andCmsBootstrap.php
has not been tested as widely. The PR retains some options so that the site-builder can switch between them more easily.Comments
README.md
describes more about how to use the options.CmsBootstrap
ought to be better, but it hasn't been used much. And that won't change unless we make it the default. So we'll go ahead with the change. But if anyone needs a way to back out, they can set:export CIVICRM_SETTINGS=Auto
Technical Details
cv
subcommands default to--level=full|cms-full
. The PR changes the interpretation offull|cms-full
.--level=full
to--level=cms-full
.CIVICRM_BOOT
already provided a way to configure theCmsBootstrap.php
protocol.CIVICRM_BOOT
already signaled an intent to activateCmsBootstrap.php
.CIVICRM_SETTINGS
already provided a way to configure/ theBootstrap.php
protocol.CIVICRM_SETTINGS
also signals an intent to activateBootstrap.php
.CIVICRM_BOOT
andCIVICRM_SETTINGS
accept a few more values than before:CIVICRM_BOOT=Auto://.
will activateCmsBootstrap.php
and allow it to search for the CMS.CIVICRM_SETTINGS=Auto
will activateBootstrap.php
and allow it to search for CiviCRM.