class UpdateRootFactory

Gets the root path used by the Update Manager to install or update projects.

Hierarchy

Expanded class hierarchy of UpdateRootFactory

1 string reference to 'UpdateRootFactory'
update.services.yml in core/modules/update/update.services.yml
core/modules/update/update.services.yml
1 service uses UpdateRootFactory
update.root.factory in core/modules/update/update.services.yml
Drupal\update\UpdateRootFactory

File

core/modules/update/src/UpdateRootFactory.php, line 11

Namespace

Drupal\update
View source
class UpdateRootFactory {
    
    /**
     * The Drupal kernel.
     *
     * @var \Drupal\Core\DrupalKernelInterface
     */
    protected $drupalKernel;
    
    /**
     * The request stack.
     *
     * @var \Symfony\Component\HttpFoundation\RequestStack
     */
    protected $requestStack;
    
    /**
     * Constructs an UpdateRootFactory instance.
     *
     * @param \Drupal\Core\DrupalKernelInterface $drupal_kernel
     *   The Drupal kernel.
     * @param \Symfony\Component\HttpFoundation\RequestStack $request_stack
     *   The request stack.
     */
    public function __construct(DrupalKernelInterface $drupal_kernel, RequestStack $request_stack) {
        $this->drupalKernel = $drupal_kernel;
        $this->requestStack = $request_stack;
    }
    
    /**
     * Gets the root path under which projects are installed or updated.
     *
     * The Update Manager will ensure that project files can only be copied to
     * specific subdirectories of this root path.
     *
     * @return string
     */
    public function get() {
        // Normally the Update Manager's root path is the same as the app root (the
        // directory in which the Drupal site is installed).
        $root_path = $this->drupalKernel
            ->getAppRoot();
        // When running in a test site, change the root path to be the testing site
        // directory. This ensures that it will always be writable by the webserver
        // (thereby allowing the actual extraction and installation of projects by
        // the Update Manager to be tested) and also ensures that new project files
        // added there won't be visible to the parent site and will be properly
        // cleaned up once the test finishes running. This is done here (rather
        // than having the tests enable a module which overrides the update root
        // factory service) to ensure that the parent site is automatically kept
        // clean without relying on test authors to take any explicit steps. See
        // also \Drupal\update\Tests\UpdateTestBase::setUp().
        if (DRUPAL_TEST_IN_CHILD_SITE) {
            $kernel = $this->drupalKernel;
            $request = $this->requestStack
                ->getCurrentRequest();
            $root_path .= '/' . $kernel::findSitePath($request);
        }
        return $root_path;
    }

}

Members

Title Sort descending Modifiers Object type Summary
UpdateRootFactory::$drupalKernel protected property The Drupal kernel.
UpdateRootFactory::$requestStack protected property The request stack.
UpdateRootFactory::get public function Gets the root path under which projects are installed or updated.
UpdateRootFactory::__construct public function Constructs an UpdateRootFactory instance.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.