Sistema de Archivos

Podemos manejar tanto los directorios como los archivos de manera sencilla con dos clases básicas: Directory y File.

Directory

Como su nombre lo indica, es un asistente para manejar directorios, nos permite verificar si un directorio existe, listar archivos en directorios, directorios en directorios, crear y eliminar carpetas.

• exists( $directoryPath )

  Pasamos el nombre de un directorio y nos devuelve verdadero si existe. Caso contario nos devolverá falso. Su parámeto es:

  • $directoryPath.- Es una cadena, la ruta del directorio del cual deseamos verificar su existencia.
  
  


• getFiles( $directoryPath, $extensions = nul )

  Con esta función obtenemos un listado de archivos a partir de una ruta de directorio, permitiendonos aplicar filtros por extensión de archivo. Sus parámetros son:

  • $directoryPath.- Es un cadena, la ruta del directorio del cual deseamos listar los archivos.
  • $extensions.- Es un arreglo de cadenas, un listado de extensiones de archivo para filtrar los resultados.

  Ejemplo del código:

              
                function getfilesTest() {
                  $directoryPath = '/home/luis';
                  $files = Directory::getFiles( $directoryPath );
                  print_r( $files );
                } // end function getFiles
              
            

  Lo que imprimiría algo como esto:

              
                Array
                (
                    [0] => /home/luis/doc.html
                    [1] => /home/luis/phones.txt
                    [2] => /home/luis/centosrecipes.txt
                    [3] => /home/luis/screenshot103024.jpg
                )
              
            

  
  


• getDirectories( $directoryPath )

  Esta función regresa un listado de directorios a partir de una ruta de un directorio particular. Tiene un único parámetro:

  • $directoryPath.- Es un cadena, la ruta del directorio del cual deseamos listar los directorios.

  Ejemplo del código:

              
                function printDirectories() {
                  $directoryPath = '/home/luis';
                  $directories = Directory::getDirectories( $directoryPath );
                  print_r( $directories );
                } // end function printDirectories
              
            

  Lo que imprimiría algo como esto:

              
                Array
                (
                    [0] => /home/luis/apps
                    [1] => /home/luis/config
                    [2] => /home/luis/lib
                    [3] => /home/luis/tmp
                )
              
            




• create( $directoryPath )

  Crea un directorio. Si el directorio ya existe, devolverá un error. Tiene solo un parámetro:

  • $directoryPath.- Es la ruta del directorio a crear.

  Ejemplo del código:

              
                //  La ruta deseada:
                $directoryPath = '/home/luis/docs';
                //  Crea un directorio
                if ( Directory::create( $directoryPath ) {
                  //  Hacer algo con el directorio
                  echo( "Directorio $directoryPath creado.");
                } // end if Directory create
              
            




• delete( $directoryPath, $recursive = false )

  Elimina un directorio. Puede hacerlo de forma recursiva y eliminar todos los archivos y sub directorios dentro del mismo.

  • $directoryPath.- Es la ruta del directorio a eliminar.
  • $recursive.- Por defecto es "false". Si se especifica como "true", aplicar recursividad y elimina todo dentro del directorio, incluidos sub directorios.

  Ejemplo del código:

              
                //  La ruta deseada:
                $directoryPath = '/home/luis/tmp';
                //  Borra el directorio
                if ( Directory::delete( $directoryPath ) {
                  //  Hacer algo con el directorio
                  echo( "Directorio $directoryPath ha sido borrado.");
                } // end if Directory delete
  
                //  La ruta deseada:
                $directoryPath = '/home/luis/tmp2';
                //  Borra el directorio y todos sus sub directorios
                if ( Directory::delete( $directoryPath, true ) {
                  //  Hacer algo con el directorio
                  echo( "Directorio $directoryPath y todos su contenido ha sido borrado.");
                } // end if Directory delete
              
            

File

Nos asiste en el manejo de archivos, para checar si existen, crearlos, leerlos, modificarlos, eliminarlos y moverlos. Es una clase estática y tiene las siguientes funciones:

• exists( $filePath )

  Devuelve "true" Si el archivo existe. Su único parámetro es:

  
  
  • $filePath.- Es una cadena que contiene la ruta al archivo a verificar.

  Ejemplo:

          
            if ( File::exists( '/home/luis/phonelist.text' ) ) {
              //  Do something with the file
              echo "Files exists";
            } // end if file exists
          
        



• read( $filePath )

  Devuelve el contenido del archivo en una cadena. Tiene un parámetro:

  • $ filePath.- Es la ruta del archivo a leer.

  Ejemplo:

          
            //  Obtener el contenido del archivo
            $content = File::read( '/home/luis/phonelist.text' );
            //  Hacer algo con el contenido
            echo "El contenido del archivo es $content";
          
        



• write( $filePath, $content = "", $append = false )

  Escribe contenido a un archivo. Tiene los siguiente parámetros:

  • $filePath.- Es la ruta al archivo que deseamos escribir.
  • $content.- Es el contenido que deseamos escribir en el archivo.
  • $append.- Indica si se agregará el contenido al actual (si es true) o si se reemplazará (si es false, por defecto).

          
            //  Obtener el contenido del archivo
            $content = 'Hola mundo! Este es un texto importante';
            //  Escribir el contenido
            File::write( '/home/luis/prueba.text', $content );
  
            // O, si queremos agregar el contenido
            File::write( 'home/luis/prueba.text', $content, true );
          
        



• delete( $filePath )

  Borra un archivo. Tiene los siguiente parámetros:

  • $filePath.- Es la ruta al archivo que deseamos escribir.

          
            //  Borra el archivo
            File::delete( '/home/luis/phonelist.text' );
          
        



• copy( $fileOrigin, $fileDestination )

  Copia un archivo de una ubicación a otra.

  • $fileOrigin.- Es la ruta al archivo que deseamos copiar.
  • $fileDestination.- Es la ruta a donde deseamos copiar el archivo.

          
            //  Copia el archivo
            File::copy(
              'home/luis/phonelist.text',
              'home/cosme/fulanito/phonelist2.text'
            );
          
        



• move( $fileOrigin, $fileDestination )

  Mueve un archivo de una ubicación a otra. Sirve para renombrar el archivo.

  • $fileOrigin.- Es la ruta al archivo que deseamos mover.
  • $fileDestination.- Es la nueva ruta que deseamos que tenga el archivo.

          
            //  Mueve el archivo
            File::move(
              'home/luis/phonelist.text',
              'home/cosme/fulanito/phonelist2.text'
            );
          
        



• getExtension( $filePath )

  Obtiene la extensión de un archivo.

  • $filePath.- Es la ruta al archivo.

          
            //  Obtiene la ruta del archivo
            $ext = File::getExtension( $filePath );
            //  Haz algo con la extensión
            echo $ext;
          
        



• writeToResponse( $filePath )

  Escribe el contenido de un archivo a la respuesta http. Limpia el buffer de salida, obtiene el tipo de archivo y escribe el contenido.

  • $filePath.- Es la ruta al archivo.

          
            //  Escribe un archivo a la respuesta http.
            File::writeToResponse( '/home/luis/pic.jpg' );