ฉันจะลบไดเร็กทอรีและเนื้อหาทั้งหมด (ไฟล์ + ไดเร็กทอรีย่อย) ซ้ำใน PHP ได้อย่างไร


136

ฉันจะลบไดเร็กทอรีและเนื้อหาทั้งหมด (ไฟล์และไดเร็กทอรีย่อย) ใน PHP ได้อย่างไร


คำตอบ:


210

ส่วนที่ผู้ใช้สนับสนุนในหน้าคู่มือrmdirประกอบด้วยการใช้งานที่เหมาะสม:

 function rrmdir($dir) { 
   if (is_dir($dir)) { 
     $objects = scandir($dir);
     foreach ($objects as $object) { 
       if ($object != "." && $object != "..") { 
         if (is_dir($dir. DIRECTORY_SEPARATOR .$object) && !is_link($dir."/".$object))
           rrmdir($dir. DIRECTORY_SEPARATOR .$object);
         else
           unlink($dir. DIRECTORY_SEPARATOR .$object); 
       } 
     }
     rmdir($dir); 
   } 
 }

1
@ ผู้พัฒนาพิกเซล - ฉันได้เพิ่มคำตอบที่แสดงให้เห็นว่า
โรงเกลือ

2
ลองดูวิธีแก้ปัญหาที่มีคนถามฉันด้วยคำถามเดียวกัน: glob ดูเหมือนจะทำงานได้ดีกว่า: stackoverflow.com/questions/11267086/…
NoodleOfDeath

สิ่งนี้เรียกis_dirสองครั้งสำหรับแต่ละไดเรกทอรีที่เรียกซ้ำ หากอาร์กิวเมนต์เป็น symlink ก็จะตามด้วยแทนที่จะลบ symlink ซึ่งอาจใช่หรือไม่ใช่สิ่งที่คุณต้องการ ไม่ว่าในกรณีใดมันไม่ใช่สิ่งที่rm -rfทำ
Vladimir Panteleev

120

อาคารคิดเห็นพิกเซลของนักพัฒนา , ตัวอย่างโดยใช้ SPL อาจมีลักษณะดังนี้:

$files = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
    RecursiveIteratorIterator::CHILD_FIRST
);

foreach ($files as $fileinfo) {
    $todo = ($fileinfo->isDir() ? 'rmdir' : 'unlink');
    $todo($fileinfo->getRealPath());
}

rmdir($dir);

หมายเหตุ: ไม่มีการตรวจสอบความสมบูรณ์และใช้แฟล็ก SKIP_DOTS ที่นำมาใช้กับ FilesystemIterator ใน PHP 5.3.0 แน่นอนว่า$todoอาจจะเป็น/if elseจุดสำคัญCHILD_FIRSTคือใช้เพื่อวนซ้ำกับเด็ก (ไฟล์) ก่อนพาเรนต์ (โฟลเดอร์)


SKIP_DOTSได้รับการแนะนำใน PHP 5.3 เท่านั้น? คุณเห็นสิ่งนั้นที่ไหน
Alix Axel

ขอบคุณ. นอกจากนี้คุณไม่ควรใช้getPathname()วิธีนี้แทนgetRealPath()หรือ?
Alix Axel

3
วิธีนี้ใช้งานได้ดี แต่จะลบทุกอย่าง ... ยกเว้นไดเร็กทอรี (ไม่ว่าจะว่างหรือไม่ก็ตาม) ควรมีrmdir($dir)ในตอนท้ายของสคริปต์
laurent

4
นี่คือฟังก์ชั่นเดียวกันที่ไม่ได้ปิดกั้นเอกสารถูกบล็อกและทำให้สอดคล้องกับrmdir()และunlink()เช่นยกเลิกE_WARNINGและส่งคืนtrueหรือfalseระบุว่าสำเร็จ
mindplay.dk

2
@dbf ไม่มันจะไม่FilesystemIteratorไม่ใช่ตัววนซ้ำแบบวนซ้ำ
ถวายพระพร

17

ลบไฟล์และโฟลเดอร์ทั้งหมดในเส้นทาง

function recurseRmdir($dir) {
  $files = array_diff(scandir($dir), array('.','..'));
  foreach ($files as $file) {
    (is_dir("$dir/$file")) ? recurseRmdir("$dir/$file") : unlink("$dir/$file");
  }
  return rmdir($dir);
}

1
rm -rf /== recurseRmdir('/'):)
Aaron Esau

6
โปรดทราบว่านี่ไม่ใช่ symlink ที่ปลอดภัย! คุณต้องตรวจสอบความมีสติหลังจาก is_dir เพื่อตรวจสอบด้วยว่าเป็น! is_link เพราะไม่เช่นนั้นคุณสามารถ symlink ไปยังโฟลเดอร์ภายนอกซึ่งจะถูกลบไปและอาจถือเป็นช่องโหว่ด้านความปลอดภัย ดังนั้นคุณควรเปลี่ยนis_dir("$dir/$file")เป็นis_dir("$dir/$file") && !is_link("$dir/$file")
Kira M. Backes

13

สำหรับ * nix คุณสามารถใช้shell_execสำหรับrm -RหรือDEL /S folder_nameสำหรับ Windows


2
วิธีการเกี่ยวกับDEL /S folder_nameสำหรับ Windows
ankitjaininfo

@Gordon RMDIR /S /Q folder_nameคือสิ่งที่เหมาะกับฉัน
Brian Leishman

2
@ WiR3D ตราบใดที่คำสั่ง exec ไม่มีอินพุตของผู้ใช้คุณควรจะดี เช่นexec('rm -rf ' . __DIR__ . '/output/*.log');
Brian Hannay


4
<?php

use RecursiveDirectoryIterator;
use RecursiveIteratorIterator;
use SplFileInfo;

# http://stackoverflow.com/a/3352564/283851
# https://gist.github.com/XzaR90/48c6b615be12fa765898

# Forked from https://gist.github.com/mindplay-dk/a4aad91f5a4f1283a5e2

/**
 * Recursively delete a directory and all of it's contents - e.g.the equivalent of `rm -r` on the command-line.
 * Consistent with `rmdir()` and `unlink()`, an E_WARNING level error will be generated on failure.
 *
 * @param string $source absolute path to directory or file to delete.
 * @param bool   $removeOnlyChildren set to true will only remove content inside directory.
 *
 * @return bool true on success; false on failure
 */
function rrmdir($source, $removeOnlyChildren = false)
{
    if(empty($source) || file_exists($source) === false)
    {
        return false;
    }

    if(is_file($source) || is_link($source))
    {
        return unlink($source);
    }

    $files = new RecursiveIteratorIterator
    (
        new RecursiveDirectoryIterator($source, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );

    //$fileinfo as SplFileInfo
    foreach($files as $fileinfo)
    {
        if($fileinfo->isDir())
        {
            if(rrmdir($fileinfo->getRealPath()) === false)
            {
                return false;
            }
        }
        else
        {
            if(unlink($fileinfo->getRealPath()) === false)
            {
                return false;
            }
        }
    }

    if($removeOnlyChildren === false)
    {
        return rmdir($source);
    }

    return true;
}

ข้อเสนอแนะที่ค่อนข้างซับซ้อน ;-)
ฟิลิปป์

@ ฟิลิปป์ใช่ฉันเดา ฉันทำส้อมออกมาจากgist.github.com/mindplay-dk/a4aad91f5a4f1283a5e2เพราะฉันไม่ได้ใช้งานดังนั้นฉันจึงคิดว่าฉันอาจจะแชร์ด้วย
XzaR

มีปัญหา จะไม่ลบโฟลเดอร์ว่างหลังจากลบไฟล์ทั้งหมดแล้ว โพสต์เวอร์ชันที่แก้ไขเล็กน้อยเป็นคำตอบด้านล่าง
Vladislav Rastrusny

@Vladislav Rastrusny จริงเหรอ? มันใช้ได้กับฉัน บางทีคุณอาจมีโฟลเดอร์แบบอ่านอย่างเดียวหรือบางอย่าง
XzaR

1

รหัส 'ง่าย' ที่ใช้งานได้และเด็กอายุสิบขวบสามารถอ่านได้:

function deleteNonEmptyDir($dir) 
{
   if (is_dir($dir)) 
   {
        $objects = scandir($dir);

        foreach ($objects as $object) 
        {
            if ($object != "." && $object != "..") 
            {
                if (filetype($dir . "/" . $object) == "dir")
                {
                    deleteNonEmptyDir($dir . "/" . $object); 
                }
                else
                {
                    unlink($dir . "/" . $object);
                }
            }
        }

        reset($objects);
        rmdir($dir);
    }
}

โปรดทราบว่าทั้งหมดที่ฉันทำคือขยาย / ลดความซับซ้อนและแก้ไข (ใช้ไม่ได้สำหรับ dir ที่ไม่ว่างเปล่า) วิธีแก้ปัญหาที่นี่: ใน PHP ฉันจะลบโฟลเดอร์ทั้งหมดที่ไม่ว่างเปล่าซ้ำได้อย่างไร


1

โซลูชันของ @Artefacto ที่ได้รับการปรับปรุง - แก้ไขการพิมพ์ผิดและโค้ดที่ง่ายขึ้นซึ่งใช้งานได้กับทั้งไดเร็กทอรีว่าง &&

  function recursive_rmdir($dir) { 
    if( is_dir($dir) ) { 
      $objects = array_diff( scandir($dir), array('..', '.') );
      foreach ($objects as $object) { 
        $objectPath = $dir."/".$object;
        if( is_dir($objectPath) )
          recursive_rmdir($objectPath);
        else
          unlink($objectPath); 
      } 
      rmdir($dir); 
    } 
  }

1

โซลูชันการทำงาน 100%

public static function rmdir_recursive($directory, $delete_parent = null)
  {
    $files = glob($directory . '/{,.}[!.,!..]*',GLOB_MARK|GLOB_BRACE);
    foreach ($files as $file) {
      if (is_dir($file)) {
        self::rmdir_recursive($file, 1);
      } else {
        unlink($file);
      }
    }
    if ($delete_parent) {
      rmdir($directory);
    }
  }

1

การใช้ DirectoryIterator และการเรียกซ้ำอย่างถูกต้อง:

function deleteFilesThenSelf($folder) {
    foreach(new DirectoryIterator($folder) as $f) {
        if($f->isDot()) continue; // skip . and ..
        if ($f->isFile()) {
            unlink($f->getPathname());
        } else if($f->isDir()) {
            deleteFilesThenSelf($f->getPathname());
        }
    }
    rmdir($folder);
}

0

อะไรทำนองนี้?

function delete_folder($folder) {
    $glob = glob($folder);
    foreach ($glob as $g) {
        if (!is_dir($g)) {
            unlink($g);
        } else {
            delete_folder("$g/*");
            rmdir($g);
        }
    }
}

ฉันอธิบายไม่ได้ว่าทำไม แต่มันไม่ได้ผลสำหรับฉัน มันพยายามลบโฟลเดอร์ที่ไม่ว่างเปล่า คำตอบที่สองข้างต้นใช้งานได้ดี
laurent

1
@ buggy3 คุณหมายถึงรหัสใด ลิงก์จะเชื่อมโยงไปยังหน้าคำถามนี้
cgogolin

0

ตัวอย่างด้วยฟังก์ชันglob () มันจะลบไฟล์และโฟลเดอร์ทั้งหมดแบบวนซ้ำรวมถึงไฟล์ที่ขึ้นต้นด้วยจุด

delete_all( 'folder' );

function delete_all( $item ) {
    if ( is_dir( $item ) ) {
        array_map( 'delete_all', array_diff( glob( "$item/{,.}*", GLOB_BRACE ), array( "$item/.", "$item/.." ) ) );
        rmdir( $item );
    } else {
        unlink( $item );
    }
};

ฉันไปด้วยsystem('rm -fr folder')
Itay Moav -Malimovka

0

ฟังก์ชั่นยกเลิกการลิงก์ซ้ำจะลบโฟลเดอร์และไฟล์ทั้งหมดในเส้นทางที่กำหนดโดยตรวจสอบให้แน่ใจว่าไม่ได้ลบสคริปต์เอง

function unlinkr($dir, $pattern = "*") {
    // find all files and folders matching pattern
    $files = glob($dir . "/$pattern"); 

    //interate thorugh the files and folders
    foreach($files as $file){ 
    //if it is a directory then re-call unlinkr function to delete files inside this directory     
        if (is_dir($file) and !in_array($file, array('..', '.')))  {
            echo "<p>opening directory $file </p>";
            unlinkr($file, $pattern);
            //remove the directory itself
            echo "<p> deleting directory $file </p>";
            rmdir($file);
        } else if(is_file($file) and ($file != __FILE__)) {
            // make sure you don't delete the current script
            echo "<p>deleting file $file </p>";
            unlink($file); 
        }
    }
}

หากคุณต้องการลบไฟล์และโฟลเดอร์ทั้งหมดที่คุณวางสคริปต์นี้ให้เรียกมันว่าดังต่อไปนี้

//get current working directory
$dir = getcwd();
unlinkr($dir);

หากคุณต้องการลบไฟล์ php เพียงอย่างเดียวให้เรียกมันดังต่อไปนี้

unlinkr($dir, "*.php");

คุณสามารถใช้เส้นทางอื่นเพื่อลบไฟล์ได้เช่นกัน

unlinkr("/home/user/temp");

การดำเนินการนี้จะลบไฟล์ทั้งหมดในไดเร็กทอรี home / user / temp


0

ฉันใช้รหัสนี้ ...

 function rmDirectory($dir) {
        foreach(glob($dir . '/*') as $file) {
            if(is_dir($file))
                rrmdir($file);
            else
                unlink($file);
        }
        rmdir($dir);
    }

หรืออันนี้ ...

<?php 
public static function delTree($dir) { 
   $files = array_diff(scandir($dir), array('.','..')); 
    foreach ($files as $file) { 
      (is_dir("$dir/$file")) ? delTree("$dir/$file") : unlink("$dir/$file"); 
    } 
    return rmdir($dir); 
  } 
?>

สิ่งนี้เกิดซ้ำหรือไม่?
Martin Tournoij

0

เมื่อคุณดำเนินการทดสอบเสร็จแล้วให้ลบ # ออกจาก#unlinkและ#rmdirในชั้นเรียน

<?php 
class RMRFiles {

        function __construct(){
        }

    public function recScan( $mainDir, $allData = array() )
    {

    // hide files
    $hidefiles = array(
    ".",
    "..") ;

    //start reading directory
    $dirContent = scandir( $mainDir ) ;

        //cycle through
        foreach ( $dirContent as $key => $content )
        {
            $path = $mainDir . '/' . $content ;

            // if is readable / file
            if ( ! in_array( $content, $hidefiles ) )
            {
            if ( is_file( $path ) && is_readable( $path ) )
            {
            #delete files within directory
            #unlink($path);
            $allData['unlink'][] = $path ;
            }

            // if is readable / directory
            else
            if ( is_dir( $path ) && is_readable( $path ) )
            {
            /*recursive*/
            $allData = $this->recScan( $path, $allData ) ;

            #finally remove directory
            $allData['rmdir'][]=$path;
            #rmdir($path);
            }
            }
        }

    return $allData ;

    }

}

header("Content-Type: text/plain");

/* Get absolute path of the running script 
Ex : /home/user/public_html/   */
define('ABPATH', dirname(__file__) . '/'); 

/* The folder where we store cache files 
Ex: /home/user/public_html/var/cache   */
define('STOREDIR','var/cache'); 

$rmrf = new RMRFiles();
#here we delete folder content files & directories
print_r($rmrf->recScan(ABPATH.STOREDIR));
#finally delete scanned directory ? 
#rmdir(ABPATH.STOREDIR);

?>

0
<?php

/**
 * code by Nk (nk.have.a@gmail.com)
 */

class filesystem
{
    public static function remove($path)
    {
        return is_dir($path) ? rmdir($path) : unlink($path);
    }

    public static function normalizePath($path)
    {
        return $path.(is_dir($path) && !preg_match('@/$@', $path) ? '/' : '');      
    }

    public static function rscandir($dir, $sort = SCANDIR_SORT_ASCENDING)
    {
        $results = array();

        if(!is_dir($dir))
        return $results;

        $dir = self::normalizePath($dir);

        $objects = scandir($dir, $sort);

        foreach($objects as $object)
        if($object != '.' && $object != '..')
        {
            if(is_dir($dir.$object))
            $results = array_merge($results, self::rscandir($dir.$object, $sort));
            else
            array_push($results, $dir.$object);
        }

        array_push($results, $dir);

        return $results;
    }

    public static function rrmdir($dir)
    {
        $files = self::rscandir($dir);

        foreach($files as $file)
        self::remove($file);

        return !file_exists($dir);
    }
}

?>

cleanup.php:

<?php

/* include.. */

filesystem::rrmdir('/var/log');
filesystem::rrmdir('./cache');

?>

0

ดูเหมือนว่าคำตอบอื่น ๆ ทั้งหมดถือว่าเส้นทางที่กำหนดให้กับฟังก์ชันนั้นเป็นไดเร็กทอรีเสมอ ตัวแปรนี้ใช้เพื่อลบไดเร็กทอรีและไฟล์เดียว:

/**
 * Recursively delete a file or directory.  Use with care!
 *
 * @param string $path
 */
function recursiveRemove($path) {
    if (is_dir($path)) {
        foreach (scandir($path) as $entry) {
            if (!in_array($entry, ['.', '..'])) {
                recursiveRemove($path . DIRECTORY_SEPARATOR . $entry);
            }
        }
        rmdir($path);
    } else {
        unlink($path);
    }
}

-1

ฉันเพิ่งสร้างรหัสนี้จากการอภิปราย StackOverflow ฉันยังไม่ได้ทดสอบสภาพแวดล้อม Linux ทำขึ้นเพื่อลบไฟล์หรือไดเร็กทอรีโดยสมบูรณ์:

function splRm(SplFileInfo $i)
{
    $path = $i->getRealPath();

    if ($i->isDir()) {
        echo 'D - ' . $path . '<br />';
        rmdir($path);
    } elseif($i->isFile()) {
        echo 'F - ' . $path . '<br />';
        unlink($path);
    }
}

function splRrm(SplFileInfo $j)
{
    $path = $j->getRealPath();

    if ($j->isDir()) {
        $rdi = new RecursiveDirectoryIterator($path, FilesystemIterator::SKIP_DOTS);
        $rii = new RecursiveIteratorIterator($rdi, RecursiveIteratorIterator::CHILD_FIRST);
        foreach ($rii as $i) {
            splRm($i);
        }
    }
    splRm($j);

}

splRrm(new SplFileInfo(__DIR__.'/../dirOrFileName'));

-1
function rmdir_recursive( $dirname ) {

    /**
     * FilesystemIterator and SKIP_DOTS
     */

    if ( class_exists( 'FilesystemIterator' ) && defined( 'FilesystemIterator::SKIP_DOTS' ) ) {

        if ( !is_dir( $dirname ) ) {
            return false;
        }

        foreach( new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $dirname, FilesystemIterator::SKIP_DOTS ), RecursiveIteratorIterator::CHILD_FIRST ) as $path ) {
            $path->isDir() ? rmdir( $path->getPathname() ) : unlink( $path->getRealPath() );
        }

        return rmdir( $dirname );

    }

    /**
     * RecursiveDirectoryIterator and SKIP_DOTS
     */

    if ( class_exists( 'RecursiveDirectoryIterator' ) && defined( 'RecursiveDirectoryIterator::SKIP_DOTS' ) ) {

        if ( !is_dir( $dirname ) ) {
            return false;
        }

        foreach( new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $dirname, RecursiveDirectoryIterator::SKIP_DOTS ), RecursiveIteratorIterator::CHILD_FIRST ) as $path ) {
            $path->isDir() ? rmdir( $path->getPathname() ) : unlink( $path->getRealPath() );
        }

        return rmdir( $dirname );

    }

    /**
     * RecursiveIteratorIterator and RecursiveDirectoryIterator
     */

    if ( class_exists( 'RecursiveIteratorIterator' ) && class_exists( 'RecursiveDirectoryIterator' ) ) {

        if ( !is_dir( $dirname ) ) {
            return false;
        }

        foreach( new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $dirname ), RecursiveIteratorIterator::CHILD_FIRST ) as $path ) {
            if ( in_array( $path->getFilename(), array( '.', '..' ) ) ) {
                continue;
            }
            $path->isDir() ? rmdir( $path->getPathname() ) : unlink( $path->getRealPath() );
        }

        return rmdir( $dirname );

    }

    /**
     * Scandir Recursive
     */

    if ( !is_dir( $dirname ) ) {
        return false;
    }

    $objects = scandir( $dirname );

    foreach ( $objects as $object ) {
        if ( $object === '.' || $object === '..' ) {
            continue;
        }
        filetype( $dirname . DIRECTORY_SEPARATOR . $object ) === 'dir' ? rmdir_recursive( $dirname . DIRECTORY_SEPARATOR . $object ) : unlink( $dirname . DIRECTORY_SEPARATOR . $object );
    }

    reset( $objects );
    rmdir( $dirname );

    return !is_dir( $dirname );

}

-1

ตัวแปรที่แก้ไขของโซลูชัน @XzaR มันจะลบโฟลเดอร์ว่างเมื่อไฟล์ทั้งหมดถูกลบออกไปและมันจะแสดงข้อยกเว้นแทนที่จะส่งคืนเท็จเมื่อเกิดข้อผิดพลาด

function recursivelyRemoveDirectory($source, $removeOnlyChildren = true)
{
    if (empty($source) || file_exists($source) === false) {
        throw new Exception("File does not exist: '$source'");
    }

    if (is_file($source) || is_link($source)) {
        if (false === unlink($source)) {
            throw new Exception("Cannot delete file '$source'");
        }
    }

    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($source, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );

    foreach ($files as $fileInfo) {
        /** @var SplFileInfo $fileInfo */
        if ($fileInfo->isDir()) {
            if ($this->recursivelyRemoveDirectory($fileInfo->getRealPath()) === false) {
                throw new Exception("Failed to remove directory '{$fileInfo->getRealPath()}'");
            }
            if (false === rmdir($fileInfo->getRealPath())) {
                throw new Exception("Failed to remove empty directory '{$fileInfo->getRealPath()}'");
            }
        } else {
            if (unlink($fileInfo->getRealPath()) === false) {
                throw new Exception("Failed to remove file '{$fileInfo->getRealPath()}'");
            }
        }
    }

    if ($removeOnlyChildren === false) {
        if (false === rmdir($source)) {
            throw new Exception("Cannot remove directory '$source'");
        }
    }
}

-1
function deltree_cat($folder)
{
    if (is_dir($folder))
    {
             $handle = opendir($folder);
             while ($subfile = readdir($handle))
             {
                     if ($subfile == '.' or $subfile == '..') continue;
                     if (is_file($subfile)) unlink("{$folder}/{$subfile}");
                     else deltree_cat("{$folder}/{$subfile}");
             }
             closedir($handle);
             rmdir ($folder);
     }
     else
     {
        unlink($folder);
     }
}

1
หากคุณกำลังตอบคำถามเก่าที่มีคำตอบอยู่แล้วรวมทั้งคำถามที่ได้รับการยอมรับคุณต้องโพสต์คำอธิบายว่าคำตอบของคุณเพิ่มคุณค่าอะไรไม่ใช่แค่รหัส คำตอบแบบใช้รหัสเท่านั้นมักจะขมวดคิ้วโดยทั่วไป แต่โดยเฉพาะกรณีนี้
Jared Smith

ฉันโหวตให้คำตอบนี้และยอมรับคำตอบ นี้ไม่ได้เลวร้ายจากการตรวจสอบมาตรฐานของฉัน (โดยไม่ต้องunlink, rmdir) เดอะopendir+ readdirการทำงานที่เร็วกว่าเดิมscandirและRecursiveDirectoryIteratorมันก็ยังใช้หน่วยความจำน้อยกว่าทั้งหมด ในการลบโฟลเดอร์ฉันต้องออกclosedirก่อนฉันติดอยู่ที่นี่ ขอบคุณสำหรับคำตอบนี้
vee
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.