Magento 2.3 bug on Windows: «Command line user does not have read and write permissions on generated directory»

dmitrii_fediuk · October 23, 2017, 3:46am

dmitrii_fediuk · October 23, 2017, 3:50am

Magento 2 had a similar issue with Windows in 2016:

Bug: \Magento\Framework\Setup\FilePermissions::checkDirectoryPermissionForCLIUser() fails on Windows (wrongly detects whether a directory is executable)
How to fix the «Command line user may not have proper read+execute permissions for directories under “var/generation/”» issue?

dmitrii_fediuk · October 23, 2017, 3:54am

1. Magento\Framework\Console\Exception\GenerationDirectoryAccessException::__construct()

magento/magento2/blob/e7c5bb5b/lib/internal/Magento/Framework/Console/Exception/GenerationDirectoryAccessException.php#L17-L29


/**
 * @inheritdoc
 */
public function __construct(Phrase $phrase = null, \Exception $cause = null, $code = 0)
{
    $phrase = $phrase ?: new Phrase(
        'Command line user does not have read and write permissions on '
        . $this->getDefaultDirectoryPath(DirectoryList::GENERATED) . ' directory. '
        . 'Please address this issue before using Magento command line.'
    );


    parent::__construct($phrase, $cause, $code);
}

2. Magento\Setup\Console\CompilerPreparation::handleCompilerEnvironment()

github.com

magento/magento2/blob/e7c5bb5b/setup/src/Magento/Setup/Console/CompilerPreparation.php#L75-L77


if (!$this->getGenerationDirectoryAccess()->check()) {
    throw new GenerationDirectoryAccessException();
}

3. Magento\Framework\Console\GenerationDirectoryAccess::check()

github.com

magento/magento2/blob/e7c5bb5b/lib/internal/Magento/Framework/Console/GenerationDirectoryAccess.php#L34-L74


/**
 * Check write permissions to generation folders
 *
 * @return bool
 */
public function check()
{
    $initParams = $this->serviceManager->get(InitParamListener::BOOTSTRAP_PARAM);
    $filesystemDirPaths = isset($initParams[Bootstrap::INIT_PARAM_FILESYSTEM_DIR_PATHS])
        ? $initParams[Bootstrap::INIT_PARAM_FILESYSTEM_DIR_PATHS]
        : [];
    $directoryList = new DirectoryList(BP, $filesystemDirPaths);
    $driverPool = new DriverPool();
    $fileWriteFactory = new WriteFactory($driverPool);


    $generationDirs = [
        DirectoryList::GENERATED,
        DirectoryList::GENERATED_CODE,
        DirectoryList::GENERATED_METADATA
    ];


    foreach ($generationDirs as $generationDirectory) {
        $directoryPath = $directoryList->getPath($generationDirectory);
        $directoryWrite = $fileWriteFactory->create($directoryPath);


        if (!$directoryWrite->isExist()) {
            try {
                $directoryWrite->create();
            } catch (\Exception $e) {
                return false;
            }
        }


        if (!$directoryWrite->isWritable()) {
            return false;
        }
    }


    return true;
}
}

4. Magento\Framework\Filesystem\Directory\Write::isWritable()

github.com

magento/magento2/blob/e7c5bb5b/lib/internal/Magento/Framework/Filesystem/Directory/Write.php#L224-L234


/**
 * Check if given path is writable
 *
 * @param null $path
 * @return bool
 * @throws \Magento\Framework\Exception\FileSystemException
 */
public function isWritable($path = null)
{
    return $this->driver->isWritable($this->driver->getAbsolutePath($this->path, $path));
}

5. Magento\Framework\Filesystem\Driver\File::isWritable()

github.com

magento/magento2/blob/e7c5bb5b/lib/internal/Magento/Framework/Filesystem/Driver/File.php#L159-L176


/**
 * Check if given path is writable
 *
 * @param string $path
 * @return bool
 * @throws FileSystemException
 */
public function isWritable($path)
{
    clearstatcache();
    $result = @is_writable($this->getScheme() . $path);
    if ($result === null) {
        throw new FileSystemException(
            new \Magento\Framework\Phrase('Error occurred during execution %1', [$this->getWarningMessage()])
        );
    }
    return $result;
}

dmitrii_fediuk · October 23, 2017, 4:20am

It looks like the same issue: «Can’t create directory generated/code/Magento/Framework/App/ResourceConnection/.» in Windows

dmitrii_fediuk · October 23, 2017, 4:25am

Magento 2.3 wrongly creates the generated folder’s subfolders (code and metadata) as read-only:

Magento\Framework\Filesystem\Directory\Write::create()

github.com

magento/magento2/blob/e7c5bb5b/lib/internal/Magento/Framework/Filesystem/Directory/Write.php#L89-L89


return $this->driver->createDirectory($absolutePath, $this->permissions);

It sets the 511 (it is the same as 0777) permissions for a created folder:

dmitrii_fediuk · October 23, 2017, 4:47am

The solution is to delete the generated folder.

dmitrii_fediuk · October 23, 2017, 4:53am

The same problem: Magento 2.3 bug: «Class Magento\Store\Api\Data\WebsiteExtensionInterface does not exist» on «setup:static-content:deploy»

pmsteil · July 4, 2019, 2:20am

I struggled with this for hours and then figured out my docker instance was out of space.

Deleted all var/log files and everything started working again.

A symptom was that everytime I would run start my docker swarm it would indeed start 2 or 3 of the services needed for Magento. The expected output if you start your docker swarm multiple times is that it should just tell you each of the services are “up to date” instead of starting any of them.

Hope this helps somebody.

dmitrii_fediuk · January 20, 2021, 11:30am

See also: windows-filesystem tagged topics.