Local.php
Same filename in other branches
Namespace
Drupal\Core\FileTransferFile
-
core/
lib/ Drupal/ Core/ FileTransfer/ Local.php
View source
<?php
namespace Drupal\Core\FileTransfer;
use Drupal\Core\DependencyInjection\DependencySerializationTrait;
use Drupal\Core\File\FileSystemInterface;
/**
* Defines the local connection class for copying files as the httpd user.
*/
class Local extends FileTransfer implements ChmodInterface {
use DependencySerializationTrait;
/**
* The file system service.
*
* @var \Drupal\Core\File\FileSystemInterface
*/
protected $fileSystem;
/**
* {@inheritdoc}
*/
public function __construct($jail, FileSystemInterface $file_system) {
parent::__construct($jail);
$this->fileSystem = $file_system;
}
/**
* {@inheritdoc}
*/
public function connect() {
// No-op
}
/**
* {@inheritdoc}
*/
public static function factory($jail, $settings) {
return new Local($jail, \Drupal::service('file_system'));
}
/**
* {@inheritdoc}
*/
protected function copyFileJailed($source, $destination) {
if (@(!copy($source, $destination))) {
throw new FileTransferException('Cannot copy %source to %destination.', 0, [
'%source' => $source,
'%destination' => $destination,
]);
}
}
/**
* {@inheritdoc}
*/
protected function createDirectoryJailed($directory) {
if (!is_dir($directory) && @(!mkdir($directory, 0777, TRUE))) {
throw new FileTransferException('Cannot create directory %directory.', 0, [
'%directory' => $directory,
]);
}
}
/**
* {@inheritdoc}
*/
protected function removeDirectoryJailed($directory) {
if (!is_dir($directory)) {
// Programmer error assertion, not something we expect users to see.
throw new FileTransferException('removeDirectoryJailed() called with a path (%directory) that is not a directory.', 0, [
'%directory' => $directory,
]);
}
/** @var \Drupal\Core\File\FileSystemInterface $file_system */
$file_system = \Drupal::service('file_system');
foreach (new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($directory, \RecursiveDirectoryIterator::SKIP_DOTS), \RecursiveIteratorIterator::CHILD_FIRST) as $filename => $file) {
if ($file->isDir()) {
if (@(!$file_system->rmdir($filename))) {
throw new FileTransferException('Cannot remove directory %directory.', 0, [
'%directory' => $filename,
]);
}
}
elseif ($file->isFile()) {
if (@(!$this->fileSystem
->unlink($filename))) {
throw new FileTransferException('Cannot remove file %file.', 0, [
'%file' => $filename,
]);
}
}
}
if (@(!$file_system->rmdir($directory))) {
throw new FileTransferException('Cannot remove directory %directory.', 0, [
'%directory' => $directory,
]);
}
}
/**
* {@inheritdoc}
*/
protected function removeFileJailed($file) {
if (@(!$this->fileSystem
->unlink($file))) {
throw new FileTransferException('Cannot remove file %file.', 0, [
'%file' => $file,
]);
}
}
/**
* {@inheritdoc}
*/
public function isDirectory($path) {
return is_dir($path);
}
/**
* {@inheritdoc}
*/
public function isFile($path) {
return is_file($path);
}
/**
* {@inheritdoc}
*/
public function chmodJailed($path, $mode, $recursive) {
if ($recursive && is_dir($path)) {
foreach (new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($path, \RecursiveDirectoryIterator::SKIP_DOTS), \RecursiveIteratorIterator::SELF_FIRST) as $filename => $file) {
if (@(!chmod($filename, $mode))) {
throw new FileTransferException('Cannot chmod %path.', 0, [
'%path' => $filename,
]);
}
}
}
elseif (@(!chmod($path, $mode))) {
throw new FileTransferException('Cannot chmod %path.', 0, [
'%path' => $path,
]);
}
}
}
Classes
Title | Deprecated | Summary |
---|---|---|
Local | Defines the local connection class for copying files as the httpd user. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.