Gestió carpetes i arxius

Gestió de directoris

Gestió d'arxius: Moviment i eliminació

Exemple de moviment

$origen = 'temp/imatge_temporal.jpg';
$desti = 'uploads/imatge_final.jpg';

if (rename($origen, $desti)) {
    echo "Fitxer mogut correctament.";
} else {
    echo "Error en moure el fitxer. Revisa permisos.";
}

Recorrer directoris

Per veure el contingut d'una carpeta, s'utilitzen principalment dues funcions:

Lectura ràpida (scandir())

Aquesta funció llegeix tots els elements d'un directori i els retorna en un array.

$carpeta = 'uploads/';
$elements = scandir($carpeta);

echo "<h2>Contingut de 'uploads/'</h2>";
foreach ($elements as $element) {
    if ($element !== '.' && $element !== '..') {
        echo $element . "<br>";
    }
}

Recorregut orientat a objectes (DirectoryIterator)

Per a una gestió més complexa i orientada a objectes, es pot utilitzar la classe DirectoryIterator (o RecursiveDirectoryIterator per a subdirectoris).

$iterator = new DirectoryIterator('uploads/');

echo "<h2>Contingut amb DirectoryIterator</h2>";
foreach ($iterator as $fitxer) {
    if ($fitxer->isFile()) {
        echo "Fitxer: " . $fitxer->getFilename() . " (" . $fitxer->getSize() . " bytes)<br>";
    }
}

Quan treballes amb iteradors de fitxers i directoris a PHP, les classes més comunes són DirectoryIterator i SplFileInfo (de la qual DirectoryIterator hereta gran part de les seves funcionalitats). Aquestes classes et proporcionen un conjunt ric de mètodes orientats a objectes per obtenir informació detallada sobre cada fitxer o carpeta sense haver de cridar funcions de PHP pures (filesize(), is_file(), etc.).

Mètodes de l'objecte iterador (DirectoryIterator / SplFileInfo)

La majoria d'aquests mètodes són accessibles directament sobre l'objecte ($fitxer) dins d'un bucle foreach quan utilitzes un DirectoryIterator.

Mètodes d'inspecció i tipus

Aquests mètodes ajuden a determinar la naturalesa de l'element (si és un fitxer, un directori, o un element especial).

Mètodes d'obtenció de noms i rutes

Aquests mètodes són essencials per construir rutes d'accés o mostrar informació a l'usuari.

Mètodes d'obtenció de metadades

Permeten obtenir informació sobre la mida, els permisos, i la data de modificació de l'element, substituint funcions com filesize() o filemtime().

Exemple

Així és com utilitzaries diversos d'aquests mètodes dins d'un bucle per inspeccionar un directori:

<?php
$iterator = new DirectoryIterator('/var/www/uploads');

echo "<h2>Inspecció del Directori d'Uploads</h2>";

foreach ($iterator as $fitxer) {
    
    // Saltem els directoris especials (IMPORTANT)
    if ($fitxer->isDot()) {
        continue;
    }
    
    echo "Nom: <strong>" . $fitxer->getFilename() . "</strong>";

    if ($fitxer->isFile()) {
        echo " [Fitxer] ";
        echo "Extensió: " . $fitxer->getExtension();
        echo " | Mida: " . number_format($fitxer->getSize() / 1024, 2) . " KB"; 
        
    } elseif ($fitxer->isDir()) {
        echo " [Carpeta] ";
        echo "Ruta Completa: " . $fitxer->getPathname();
    }
    
    echo "<br>";
}
?>

Aquests mètodes permeten un codi més net, més llegible i menys propens a errors que si es fes una concatenació de múltiples funcions procedimentals de PHP per a cada element.

El RecursiveDirectoryIterator és la millor eina de PHP per recórrer un directori i tots els seus subdirectoris de manera automàtica, sense haver de gestionar recursivitat manualment.

Exemple amb RecursiveDirectoryIterator

Aquest codi PHP recorrerà la carpeta /var/www/projecte (simulació) i mostrarà el nom, la mida i la ruta de tots els fitxers que hi trobi, incloent-hi els que es trobin a les subcarpetes (css, js, img, etc.).

<?php
// Defineix el directori arrel a escanejar
$rootPath = '/var/www/projecte'; // Hauries d'ajustar aquesta ruta al teu entorn

// 1. Crear el RecursiveDirectoryIterator (Defineix l'estructura a recórrer)
$directoryIterator = new RecursiveDirectoryIterator(
    $rootPath, 
    RecursiveDirectoryIterator::SKIP_DOTS // Ignora . i .. automàticament
);

// 2. Crear el RecursiveIteratorIterator (Gestiona la recursivitat del bucle)
$iterator = new RecursiveIteratorIterator(
    $directoryIterator,
    RecursiveIteratorIterator::SELF_FIRST // Permet accedir a la carpeta i després al seu contingut
);

echo "<h2>Exploració Recursiva de Fitxers a: $rootPath</h2>";
echo "<ul style='list-style-type: none; padding-left: 0;'>";

// 3. Recórrer
foreach ($iterator as $fitxer) {
    
    // Per cada element, $fitxer és un objecte SplFileInfo/RecursiveDirectoryIterator
    
    // Mostrem només els fitxers, no els directoris
    if ($fitxer->isFile()) {
        
        $ruta_completa = $fitxer->getPathname();
        $mida_kb = number_format($fitxer->getSize() / 1024, 2);
        
        // Determinem la indentació per visualitzar l'estructura de carpetes
        $nivell = $iterator->getDepth();
        $indentacio = str_repeat('&nbsp;&nbsp;&nbsp;&nbsp;', $nivell); 
        
        echo "<li>";
        echo $indentacio;
        echo "📄 **" . $fitxer->getFilename() . "**";
        echo " | Mida: {$mida_kb} KB";
        echo " | Ruta: <small>{$ruta_completa}</small>";
        echo "</li>";
        
    } elseif ($fitxer->isDir()) {
         $nivell = $iterator->getDepth();
         $indentacio = str_repeat('&nbsp;&nbsp;&nbsp;&nbsp;', $nivell);
         echo "<li>" . $indentacio . " **" . $fitxer->getFilename() . "**</li>";
    }
}

echo "</ul>";

?>