flysystem error message. Driver is missing

Question

In my Drupal 8 project, I want to use the Flysystem module in order to manage files directly on a remote FTP server.

I installed the module and all external libraries via composer. I also edited settings.php and added the FTP schema based on the README file.

Everything seems to be right, but in the status report, I always see a "Driver is missing" error message.

I don't know what wrong. I searched the Drupal website and module issue page, but I found no solution or guidelines for FTP.

Does any body know how can we use the module with FTP?

Answer 1

Requirements

If you look at the flysystem.install file (it's currently the same whether you installed 2.0.x or 8.x-1.x), you can see the code used for flysystem_requirements().

The general structure of the checking is as follows:

1. Validate the schemes in settings.php
2. Make sure the dependencies are installed:
   a) League\Flysystem\Filesystem
   b) League\Flysystem\Replicate\ReplicateAdapter
   c) Twistor\FlysystemStreamWrapper
3. Then, it calls ensure() on the plugin for each scheme, and makes sure the plugin can be instantiated.

This 3rd step calls this code (src/FlysystemFactory.php):

  public function getPlugin($scheme) {
    if (!isset($this->plugins[$scheme])) {
      $settings = $this->getSettings($scheme);

      $this->plugins[$scheme] = $this->pluginManager->createInstance($settings['driver'], $settings['config']);
    }

    return $this->plugins[$scheme];
  }

It also provides the defaults:

  protected $defaults = [
    'driver' => '',
    'config' => [],
    'replicate' => FALSE,
    'cache' => FALSE,
    'name' => '',
    'description' => '',
  ];

Given the above information, your plugin and schema should have declared your driver with 'driver' => 'ftp'.

Solution?

Also, on the main module page under "supported adapters", it says:

Ftp (Requires the ftp extension)

Though I'm not sure, since it doesn't link to another module like the other adapters, I think it means the PHP extension. Try installing the ftp PHP extension. Here's the page for setup instructions.