I made this function to search and/or display files by extension or for a string occurance in the filename. Any comments or enhancements are welcome offcourse. I'll update this function soon.
usage: list_files([string], [string], [int 1 | 0], [int 1 | 0]);
search for extension: list_files([string], [string], [0], [int 1 | 0]);
returns array: $myArray = list_files([string], [string], [0], [0]);
echo result: list_files([string], [string], [0], [1]);
search for string occurance: list_files([string], [string], [1], [int 1 | 0]);
returns array: $myArray = list_files([string], [string], [1], [0]);
echo result: list_files([string], [string], [1], [1]);
<?php
function list_files($directory, $stringSearch, $searchHandler, $outputHandler) {
$errorHandler = false;
$result = array();
if (! $directoryHandler = @opendir ($directory)) {
echo ("<pre>\nerror: directory \"$directory\" doesn't exist!\n</pre>\n");
return $errorHandler = true;
}
if ($searchHandler === 0) {
while (false !== ($fileName = @readdir ($directoryHandler))) {
if(@substr ($fileName, - @strlen ($stringSearch)) === $stringSearch) {
@array_push ($result, $fileName);
}
}
}
if ($searchHandler === 1) {
while(false !== ($fileName = @readdir ($directoryHandler))) {
if(@substr_count ($fileName, $stringSearch) > 0) {
@array_push ($result, $fileName);
}
}
}
if (($errorHandler === true) && (@count ($result) === 0)) {
echo ("<pre>\nerror: no filetype \"$fileExtension\" found!\n</pre>\n");
}
else {
sort ($result);
if ($outputHandler === 0) {
return $result;
}
if ($outputHandler === 1) {
echo ("<pre>\n");
print_r ($result);
echo ("</pre>\n");
}
}
}
?>
Funciones del Sistema de Archivos
Ver también
Para funciones relacionadas, vea también las secciones Directorio y Ejecución de Programas.
Para una lista y explicación de las distintas envolturas URL que se pueden usar como archivos remotos, vea también Protocolos y Envolturas soportados.
Tabla de contenidos
- basename — Devuelve el componente de nombre de rastreo de la ruta
- chgrp — Cambia el grupo del archivo
- chmod — Cambia el modo de archivo
- chown — Cambia el propietario del archivo
- clearstatcache — Limpia la caché de estado de un archivo
- copy — Copia archivos
- delete — Véase unlink o unset
- dirname — Devuelve el directorio padre de la ruta
- disk_free_space — Devuelve el espacio disponible de un sistema de archivos o partición de disco
- disk_total_space — Devuelve el tamaño total de un sistema de archivos o partición de disco
- diskfreespace — Alias de disk_free_space
- fclose — Cierra un puntero a un archivo abierto
- feof — Comprueba si el puntero a un archivo está al final del archivo
- fflush — Vuelca la salida a un archivo
- fgetc — Obtiene un carácter de un puntero a un archivo
- fgetcsv — Obtiene una línea del puntero a un archivo y la examina para tratar campos CSV
- fgets — Obtiene una línea desde el puntero a un fichero
- fgetss — Obtiene un línea desde un puntero a un archivo y elimina las etiquetas HTML
- file_exists — Comprueba si existe un fichero o directorio
- file_get_contents — Transmite un fichero entero a una cadena
- file_put_contents — Escribe una cadena a un fichero
- file — Transfiere un fichero completo a un array
- fileatime — Obtiene el momento del último acceso a un archivo
- filectime — Obtiene el momento del último cambio del i-nodo de un archivo
- filegroup — Obtiene el grupo de un archivo
- fileinode — Obtiene el i-nodo del archivo
- filemtime — Obtiene el momento de la última modificación de un archivo
- fileowner — Obtiene el propietario de un archivo
- fileperms — Obtiene los permisos de un archivo
- filesize — Obtiene el tamaño de un fichero
- filetype — Obtiene el tipo de fichero
- flock — Bloqueo de archivos asesorado portable
- fnmatch — Compara un nombre de fichero con un patrón
- fopen — Abre un fichero o una URL
- fpassthru — Escribe toda la información restante de un puntero a un archivo
- fputcsv — Da formato a una línea como CSV y la escribe en un puntero a un archivo
- fputs — Alias de fwrite
- fread — Lectura de un fichero en modo binario seguro
- fscanf — Analiza la entrada desde un archivo de acuerdo a un formato
- fseek — Busca sobre un puntero a un fichero
- fstat — Obtiene información acerca de un archivo usando un puntero al archivo abierto
- ftell — Devuelve la posición de lectura/escritura actual del puntero a un fichero
- ftruncate — Trunca un archivo a una longitud dada
- fwrite — Escritura de un archivo en modo binario seguro
- glob — Busca coincidencias de nombres de ruta con un patrón
- is_dir — Indica si el nombre de archivo es un directorio
- is_executable — Indica si el nombre de archivo es ejecutable
- is_file — Indica si el nombre de fichero es un fichero normal
- is_link — Indica si el nombre de archivo es un enlace simbólico
- is_readable — Indica si un fichero existe y es legible
- is_uploaded_file — Indica si el archivo fue subido mediante HTTP POST
- is_writable — Indica si un archivo existe y es escribible
- is_writeable — Alias de is_writable
- lchgrp — Cambia el grupo de un enlace simbólico
- lchown — Cambia el propietario de un enlace simbólico
- link — Crea un enlace duro
- linkinfo — Obtiene información acerca de un enlace
- lstat — Da información acerca de un archivo o enlace simbólico
- mkdir — Crea un directorio
- move_uploaded_file — Mueve un archivo subido a una nueva ubicación
- parse_ini_file — Analiza un archivo de configuración
- parse_ini_string — Analiza una cadena de configuración
- pathinfo — Devuelve información acerca de la ruta de un fichero
- pclose — Cierra un proceso de un puntero a un archivo
- popen — Abre un proceso de un puntero a un archivo
- readfile — Realizar la salida de un fichero
- readlink — Devuelve el objetivo de un enlace simbólico
- realpath_cache_get — Obtiene las entradas de la caché de la ruta real
- realpath_cache_size — Obtiene el tamaño de la caché de la ruta real
- realpath — Devuelve el nombre de la ruta absoluta canonizada
- rename — Renombra un archivo o directorio
- rewind — Rebobina la posción de un puntero a un archivo
- rmdir — Elimina un directorio
- set_file_buffer — Alias de stream_set_write_buffer
- stat — Da información acerca de un fichero
- symlink — Crea un enlace simbólico
- tempnam — Crea un archivo con un nombre de archivo único
- tmpfile — Crea un archivo temporal
- touch — Establece el momento de acceso y modificación de un archivo
- umask — Cambia la máscara de usuario actual
- unlink — Borra un archivo
tunnelareaten at gmail dot com ¶
8 years ago
Christian ¶
6 years ago
I just learned that, to specify file names in a portable manner, you DON'T need 'DIRECTORY_SEPARATOR' - just use '/'. This really surprised and shocked me, as until now I typed about a zillion times 'DIRECTORY_SEPARATOR' to stay platform independent - unnecessary. Don't make the same mistake.
drapeko.com ¶
4 years ago
You have an array of directories (straightforward list of directories):
<?php
$array = array(
'/home/drapeko/var',
'/home/drapeko/var/y',
'/home/drapeko',
'/home',
'/var/libexec'
);
);
?>
And you would like to transform this array to hierarchy of directories:
<?php
$array = array (
'home' => array (
'drapeko' => array (
'var' => array (
'y' => array()
)
)
),
'var' => array(
'libexec' => array()
)
);
?>
How can you do it?
First of all the below function will help us.
<?php
/**
* This function converts real filesystem path to the string array representation.
*
* for example,
* '/home/drapeko/var/y will be converted to $result_array['home']['drapeko']['var']['y']
* '/home/drapeko/var/y/file.txt will be converted to $result_array['home']['drapeko']['var']['y']
*
* @param $path realpath of the directory
* @return string string array representation of the path
*/
function pathToArrayStr($path) {
// TODO constants/configs?
$res_path = str_replace(array(':/', ':\\', '/', '\\', DIRECTORY_SEPARATOR), '/', $path);
// if the first or last symbol is '/' delete it (e.g. for linux)
$res_path = preg_replace(array("/^\//", "/\/$/"), '', $res_path);
// create string
$res_path = '[\''.str_replace('/', '\'][\'', $res_path).'\']';
return $res_path;
}
?>
It simply converts the real path of the file to array string representation.
How can you use this function? I know it looks like a little confusing. But it's quite simple. Consider the example below:
<?php
$result = array();
$check = array();
foreach($array as $val) {
$str = pathToArrayStr($val, 'result');
foreach($check as $ck) {
if (strpos($ck, $str) !== false) {
continue 2;
}
}
$check[] = $str;
eval('$result'.$str.' = array();');
}
print_r($result);
?>
Heh, how do you find it? This approach has helped me very much. I hope you will find it useful. :)
Gregor Mosheh ¶
9 years ago
This function searches a directory and returns an array of all files whose filename matches the specified regular expression. It's similar in concept to the Unix find program.
function findfile($location='',$fileregex='') {
if (!$location or !is_dir($location) or !$fileregex) {
return false;
}
$matchedfiles = array();
$all = opendir($location);
while ($file = readdir($all)) {
if (is_dir($location.'/'.$file) and $file <> ".." and $file <> ".") {
$subdir_matches = findfile($location.'/'.$file,$fileregex);
$matchedfiles = array_merge($matchedfiles,$subdir_matches);
unset($file);
}
elseif (!is_dir($location.'/'.$file)) {
if (preg_match($fileregex,$file)) {
array_push($matchedfiles,$location.'/'.$file);
}
}
}
closedir($all);
unset($all);
return $matchedfiles;
}
$htmlfiles = findfile('/some/dir','/\.(htm|html)$/');
l_domenech at yahoo dot ca ¶
9 years ago
In the code samples of the user-contributed notes, you'll find functions that sometimes need a slash at the end of a folder path and sometimes don't.
Here's a little function to append a slash at the end of a path if there isn't one already.
function append_slash_if_none($string)
{
if (ereg ("/$", $string))
{
return $string;
}
else
{
return ereg_replace("$", "/", $string);
}
}
(Replace with a backslash if you're on Windows...)
regis at webstuff dot com dot br ¶
10 years ago
Here is a useful function if you're having trouble writing raw bytes into a file.
It receives an integer and returns an array containing the ASCII values of the bytes on each index of the array.
function int2bytes($number){
$byte = $number;
$i=0;
do{
$dec_tmp = $byte;
$byte = bcdiv($byte,256,0);
$resto = $dec_tmp - (256 * $byte);
$return[] = $resto;
} while($byte >= 256);
if($byte) $return[] = $byte;
return array_reverse($return);
}
Example:
$arr = int2bytes(75832);
$arr will contain the following values:
Array
(
[0] => 1
[1] => 40
[2] => 56
)
Now, to write this data to the file, just use a fputs() with chr(), just like this:
fputs($fp,chr($arr[0]).chr($arr[1]).chr($arr[2]))
-- Regis
ob at babcom dot biz ¶
3 months ago
a function based on "tunnelareaten at gmail dot com"s idea to search for files in a given directory by a searchstring or by fileextension.
I added support to search recursively through all sub-directories an to determine weather the filepath should be returned or not.
<?php
// recursive function to get contents of given folder by searchterm or fileextension
// (does not show folders)
// standards: Foldername: string
// Searchterm: string
// Searchtype: ext/search (file-extension or searchterm within filename)
// SaveCompletePath: true/1
// usage: array FileSearch_r($Folder,$Search[,$SearchType,$SavePath])
function FileSearch_r($Dir,$Search,$SearchType="search",$SavePath=1) {
$Array=array();
$D=dir($Dir);
while (false!==($Entry=$D->read()))
if ($Entry!='.' && $Entry!='..') {
$Entry=$Dir.$Entry;
if (is_dir($Entry)) $Array=array_merge($Array,FileSearch_r($Entry.'/',$Search,$SearchType,$SavePath));
else
if ($SearchType=="search"
?substr_count($Entry,$Search)>0
:($SearchType=="ext"
?substr($Entry,-strlen($Search))===$Search
:true))
$Array[]=$Entry;
}
$D->close();
sort($Array,SORT_STRING);
if(!(bool)$SavePath) $Array=str_replace($Dir,"",array_values($Array));
return $Array;
}
?>
mitra at mitra dot biz ¶
10 years ago
Pollard@php.net contributed this in response to a question on setting these variables ...
This option *IS* settable within your PHP scripts.
Example:
<?php
ini_set('auto_detect_line_endings', true);
$contents = file('unknowntype.txt');
ini_set('auto_detect_line_endings', false);
$content2 = file('unixfile.txt');
?>
Note, with PHP 4.3 anytime Mac files are read using fgets or file you'll need to auto_detect_line_endings since \n is otherwise assumed. However, with PHP 5.0, stream_get_line() will allow you to specify what line ending character to read up to.
\\ Read a line from a MAC file
stream_get_line($fp, 4096, "\r");
\\ Read a line from a UNIX file
stream_get_line($fp, 4096, "\n");
\\ Read a line from a DOS file
stream_get_line($fp, 4096, "\r\n");
\\ Read a line up to any filesystem line ending
ini_set('auto_detect_line_endings', true); fgets($fp);
\\ You can also make up your own line ending characters:
\\ Read up to the first instance of ":"
stream_get_line($fp, 4096, ":");
jdhurn at uberidx dot com ¶
10 years ago
This is a function I use to determine if a file contains Binary information. I use this for my search engine so that it doesn't try to index files like .zip or .mp3 or any other file that doesn't contain readable information. It makes use of the Character Type Extension if it's loaded, if it's not then it uses Regular Expressions.
function is_binary($link)
{
$tmpStr = '';
@$fp = fopen($link, 'rb');
@$tmpStr = fread($fp, 256);
@fclose($fp);
if($tmpStr != '')
{
$tmpStr = str_replace(chr(10), '', $tmpStr);
$tmpStr = str_replace(chr(13), '', $tmpStr);
$tmpInt = 0;
for($i =0; $i < strlen($tmpStr); $i++)
{
if( extension_loaded('ctype') )
{
if( !ctype_print($tmpStr[$i]) )
$tmpInt++;
}
else
{
if( !eregi("[[:print:]]+", $tmpStr[$i]) )
$tmpInt++;
}
}
if($tmpInt > 5)
return(0);
else
return(1);
}
else
return(0);
}
Gregor Mosheh ¶
9 years ago
I needed a function to find disk usage for a directory and its subs, so here it is. It's kinda like the Unix du program, except it returns the usage in bytes, not blocks.
function du($location) {
if (!$location or !is_dir($location)) {
return 0;
}
$total = 0;
$all = opendir($location);
while ($file = readdir($all)) {
if (is_dir($location.'/'.$file) and $file <> ".." and $file <> ".") {
$total += du($location.'/'.$file);
unset($file);
}
elseif (!is_dir($location.'/'.$file)) {
$stats = stat($location.'/'.$file);
$total += $stats['size'];
unset($file);
}
}
closedir($all);
unset($all);
return $total;
}
print du('/some/directory');
http://iubito.free.fr ¶
9 years ago
Here is a function I wrote to get the relative path between 2 files or directory.
We suppose that paths are wrotten in Unix format (/ instead of windows \\)
<?php
/**
* Return the relative path between two paths / Retourne le chemin relatif entre 2 chemins
*
* If $path2 is empty, get the current directory (getcwd).
* @return string
*/
function relativePath($path1, $path2='')
{
if ($path2 == '') {
$path2 = $path1;
$path1 = getcwd();
}
//Remove starting, ending, and double / in paths
$path1 = trim($path1,'/');
$path2 = trim($path2,'/');
while (substr_count($path1, '//')) $path1 = str_replace('//', '/', $path1);
while (substr_count($path2, '//')) $path2 = str_replace('//', '/', $path2);
//create arrays
$arr1 = explode('/', $path1);
if ($arr1 == array('')) $arr1 = array();
$arr2 = explode('/', $path2);
if ($arr2 == array('')) $arr2 = array();
$size1 = count($arr1);
$size2 = count($arr2);
//now the hard part :-p
$path='';
for($i=0; $i<min($size1,$size2); $i++)
{
if ($arr1[$i] == $arr2[$i]) continue;
else $path = '../'.$path.$arr2[$i].'/';
}
if ($size1 > $size2)
for ($i = $size2; $i < $size1; $i++)
$path = '../'.$path;
else if ($size2 > $size1)
for ($i = $size1; $i < $size2; $i++)
$path .= $arr2[$i].'/';
return $path;
}
?>
Enjoy ! :-)
