Skip to content
Snippets Groups Projects

Issue #3266092: Make sure staging root is unique for each Drupal site

Merged Issue #3266092: Make sure staging root is unique for each Drupal site
All threads resolved!
All threads resolved!
1 file
+ 8
9
Compare changes
  • Side-by-side
  • Inline
@@ -41,15 +41,14 @@ use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
* before any such operations are done. A stage is claimed by presenting a
* unique token that is generated when the stage is created.
*
* Although a site can only have one staging area, it is possible, but unlikely,
* for privileged users to destroy a stage created by another user, then create
* their own, new stage. To prevent such situations from putting the file system
* into an indeterminate state (for example, if a stage is destroyed by another
* user while it is still being created), each staging area lives in its own
* directory with a randomly generated name. For additional cleanliness, all
* staging areas created by a specific site live in a single directory, called
* the "staging root" and identified by the site UUID, which is deleted when any
* stage created by that site is destroyed.
* Although a site can only have one staging area, it is possible for privileged
* users to destroy a stage created by another user. To prevent such actions
* from putting the file system into an uncertain state (for example, if a stage
* is destroyed by another user while it is still being created), each staging
* area lives in its own directory with a randomly generated name. For
* additional cleanliness, all staging areas created by a specific site live in
* a single directory, called the "staging root" and identified by the site
* UUID, which is deleted when any stage created by that site is destroyed.
*/
class Stage {
@@ -512,7+511,7 @@
* Returns the path of the directory where changes should be staged.
*
* @return string
* The absolute path of the directory where changes should be staged.
*
* @throws \LogicException
* If this method is called before the stage has been created or claimed.
Loading