file_exists
На платформах Windows, для проверки наличия файлов на сетевых ресурсах, используйте имена, подобные //computername/share/filename или \\computername\share\filename .
Возвращаемые значения
Возвращает true , если файл или каталог, указанный параметром filename , существует, иначе возвращает false .
Замечание:
Данная функция возвращает false для символических ссылок, указывающих на несуществующие файлы.
Замечание:
Проверка происходит с помощью реальных UID/GID, а не эффективных идентификаторов.
Замечание: Так как тип integer в PHP является целым числом со знаком, и многие платформы используют 32-х битные целые числа, то некоторые функции файловых систем могут возвращать неожиданные результаты для файлов размером больше 2 Гб.
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING .
Примеры
Пример #1 Проверка существования файла
if ( file_exists ( $filename )) <
echo «Файл $filename существует» ;
> else <
echo «Файл $filename не существует» ;
>
?>
Примечания
Замечание: Результаты этой функции кешируются. Более подробную информацию смотрите в разделе clearstatcache() .
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обёртками url. Список обёрток, поддерживаемых семейством функций stat() , смотрите в разделе Поддерживаемые протоколы и обёртки.
Смотрите также
- is_readable() — Определяет существование файла и доступен ли он для чтения
- is_writable() — Определяет, доступен ли файл для записи
- is_file() — Определяет, является ли файл обычным файлом
- file() — Читает содержимое файла и помещает его в массив
- SplFileInfo
User Contributed Notes 31 notes
Note: The results of this function are cached. See clearstatcache() for more details.
That’s a pretty big note. Don’t forget this one, since it can make your file_exists() behave unexpectedly — probably at production time 😉
file_exists() does NOT search the php include_path for your file, so don’t use it before trying to include or require.
@$result = include $filename;
Yes, include does return false when the file can’t be found, but it does also generate a warning. That’s why you need the @. Don’t try to get around the warning issue by using file_exists(). That will leave you scratching your head until you figure out or stumble across the fact that file_exists() DOESN’T SEARCH THE PHP INCLUDE_PATH.
In response to seejohnrun’s version to check if a URL exists. Even if the file doesn’t exist you’re still going to get 404 headers. You can still use get_headers if you don’t have the option of using CURL..
$file = ‘http://www.domain.com/somefile.jpg’;
$file_headers = @get_headers($file);
if($file_headers[0] == ‘HTTP/1.1 404 Not Found’) <
$exists = false;
>
else <
$exists = true;
>
file_exists() is vulnerable to race conditions and clearstatcache() is not adequate to avoid it.
The following function is a good solution:
<?php
function file_exists_safe ( $file ) <
if (! $fd = fopen ( $file , ‘xb’ )) <
return true ; // the file already exists
>
fclose ( $fd ); // the file is now created, we don’t need the file handler
return false ;
>
?>
The function will create a file if non-existent, following calls will fail because the file exists (in effect being a lock).
IMPORTANT: The file will remain on the disk if it was successfully created and you must clean up after you, f.ex. remove it or overwrite it. This step is purposely omitted from the function as to let scripts do calculations all the while being sure the file won’t be «seized» by another process.
NOTE: This method fails if the above function is not used for checking in all other scripts/processes as it doesn’t actually lock the file.
FIX: You could flock() the file to prevent that (although all other scripts similarly must check it with flock() then, see https://www.php.net/manual/en/function.flock.php). Be sure to unlock and fclose() the file AFTER you’re done with it, and not within the above function:
<?php
function create_and_lock ( $file ) <
if (! $fd = fopen ( $file , ‘xb’ )) <
return false ;
>
if (! flock ( $fd , LOCK_EX | LOCK_NB )) < // may fail for other reasons, LOCK_NB will prevent blocking
fclose ( $fd );
unlink ( $file ); // clean up
return false ;
>
return $fd ;
>
if ( $lock = create_and_lock ( «foo.txt» )) <
// do stuff
flock ( $fd , LOCK_UN ); // unlock
fclose ( $fd ); // close
>
?>
SEE ALSO: https://linux.die.net/man/2/open about O_CREAT|O_EXCL (which is used with the ‘x’ modifier for fopen()) and problems with NFS
I was having problems with the file_exists when using urls, so I made this function:
<?php
function file_exists_2 ( $filePath )
<
return ( $ch = curl_init ( $filePath )) ? @ curl_close ( $ch ) || true : false ;
>
?>
Cheers!
If you are trying to access a Windows Network Share you have to configure your WebServer with enough permissions for example:
You will get an error telling you that the pathname doesnt exist this will be because Apache or IIS run as LocalSystem so you will have to enter to Services and configure Apache on «Open a session as» Create a new user that has enough permissions and also be sure that target share has the proper permissions.
Hope this save some hours of research to anyone.
With PHP 7.0 on Ubuntu 17.04 and with the option allow_url_fopen=On, file_exists() returns always false when trying to check a remote file via HTTP.
returns always «missing», even for an existing URL.
I found that in the same situation the file() function can read the remote file, so I changed my routine in
This is clearly a bit slower, especially if the remote file is big, but it solves this little problem.
I wrote this little handy function to check if an image exists in a directory, and if so, return a filename which doesnt exists e.g. if you try ‘flower.jpg’ and it exists, then it tries ‘flower[1].jpg’ and if that one exists it tries ‘flower[2].jpg’ and so on. It works fine at my place. Ofcourse you can use it also for other filetypes than images.
<?php
function imageExists ( $image , $dir ) <
$i = 1 ; $probeer = $image ;
while( file_exists ( $dir . $probeer )) <
$punt = strrpos ( $image , «.» );
if( substr ( $image ,( $punt — 3 ), 1 )!==( «[» ) && substr ( $image ,( $punt — 1 ), 1 )!==( «]» )) <
$probeer = substr ( $image , 0 , $punt ). «[» . $i . «]» .
substr ( $image ,( $punt ), strlen ( $image )- $punt );
> else <
$probeer = substr ( $image , 0 ,( $punt — 3 )). «[» . $i . «]» .
substr ( $image ,( $punt ), strlen ( $image )- $punt );
>
$i ++;
>
return $probeer ;
>
?>
Note on openspecies entry (excellent btw, thanks!).
If your server cannot resolve its own DNS, use the following:
$f = preg_replace(‘/www\.yourserver\.(net|com)/’, getenv(‘SERVER_ADDR’), $f);
Just before the $h = @get_headers($f); line.
Replace the extensions (net|com|. ) in the regexp expression as appropriate.
The preg_replace will effectively ‘resolve’ the address for you by assigning $f as follows:
http://10.0.0.125/myfile.gif
NB: This function expects the full server-related pathname to work.
For example, if you run a PHP routine from within, for example, the root folder of your website and and ask:
You will get FALSE even if that file does exist off root.
You need to add
to get it to return TRUE — ie : /srv/www/mywebsite.com/public/images/Proofreading_patients.jpg
You could use document root to be on the safer side because the function does not take relative paths:
<?php
if( file_exists ( $_SERVER < 'DOCUMENT_ROOT' >. «/my_images/abc.jpg» )) <
.
>
?>
Do not forget to put the slash ‘/’, e.g. my doc root in Ubuntu is /var/www without the slash.
this code here is in case you want to check if a file exists in another server:
<?php
function fileExists ( $path ) <
return (@ fopen ( $path , «r» )== true );
>
?>
unfortunately the file_exists can’t reach remote servers, so I used the fopen function.
When using file_exists, seems you cannot do:
<?php
foreach ( $possibles as $poss )
<
if ( file_exists ( SITE_RANGE_IMAGE_PATH . $this -> range_id . ‘/ ‘ . $poss . ‘.jpg’ ) )
<
// exists
>
else
<
// not found
>
>
?>
so you must do:
<?php
foreach ( $possibles as $poss )
<
$img = SITE_RANGE_IMAGE_PATH . $this -> range_id . ‘/ ‘ . $poss . ‘.jpg’
if ( file_exists ( $img ) )
<
// exists
>
else
<
// not found
>
>
?>
Then things will work fine.
This is at least the case on this Windows system running php 5.2.5 and apache 2.2.3
Not sure if it is down to the concatenation or the fact theres a constant in there, i’m about to run away and test just that.
For some reason, none of the url_exists() functions posted here worked for me, so here is my own tweaked version of it.
<?php
function url_exists ( $url ) <
$url = str_replace ( «http://» , «» , $url );
if ( strstr ( $url , «/» )) <
$url = explode ( «/» , $url , 2 );
$url [ 1 ] = «/» . $url [ 1 ];
> else <
$url = array( $url , «/» );
>
$fh = fsockopen ( $url [ 0 ], 80 );
if ( $fh ) <
fputs ( $fh , «GET » . $url [ 1 ]. » HTTP/1.1\nHost:» . $url [ 0 ]. «\n\n» );
if ( fread ( $fh , 22 ) == «HTTP/1.1 404 Not Found» ) < return FALSE ; >
else
Older php (v4.x) do not work with get_headers() function. So I made this one and working.
<?php
function url_exists ( $url ) <
// Version 4.x supported
$handle = curl_init ( $url );
if ( false === $handle )
<
return false ;
>
curl_setopt ( $handle , CURLOPT_HEADER , false );
curl_setopt ( $handle , CURLOPT_FAILONERROR , true ); // this works
curl_setopt ( $handle , CURLOPT_NOBODY , true );
curl_setopt ( $handle , CURLOPT_RETURNTRANSFER , false );
$connectable = curl_exec ( $handle );
curl_close ( $handle );
return $connectable ;
>
?>
file_exists
На платформах Windows, для проверки наличия файлов на сетевых ресурсах, используйте имена, подобные //computername/share/filename или \\computername\share\filename .
Возвращаемые значения
Возвращает TRUE , если файл или каталог, указанный параметром filename , существует, иначе возвращает FALSE .
Замечание:
Данная функция возвращает FALSE для символических ссылок, указывающих на несуществующие файлы.
Если файлы недоступны из-за ограничений, налагаемых безопасным режимом, то данная функция вернет FALSE . Однако, эти файлы все еще могут быть подключены, если они располагаются в каталоге safe_mode_include_dir.
Замечание:
Проверка происходит с помощью реальных UID/GID, а не эффективных идентификаторов.
Замечание: Так как тип integer в PHP является целым числом со знаком и многие платформы используют 32-х битные целые числа, то некоторые функции файловых систем могут возвращать неожиданные результаты для файлов размером больше 2ГБ.
Примеры
Пример #1 Проверка существования файла
if ( file_exists ( $filename )) <
echo «Файл $filename существует» ;
> else <
echo «Файл $filename не существует» ;
>
?>
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING .
Примечания
Замечание: Результаты этой функции кэшируются. Более подробную информацию смотрите в разделе clearstatcache() .
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat() , смотрите в Поддерживаемые протоколы и обработчики (wrappers).
Проверка файла на наличие / существование
Порой мы отображаем на сайтах контент с других ресурсов: картинки или фавиконы. Некоторе браузеры просто оставят пустое место (Firefox), другие же отобразят уродский прямоугольник, явно указывая, что чего-то не хватает (IE). Как же можно средствами PHP проверить существование файла.
Есть функция file_exists(), но она хороша только для файлов в пределах нашей файловой системы, а с удаленным сервером не пройдет.
Есть вариант открывать файл на чтение и в случие ошибки констатировать факт, что файла не существует:
<?
// файл, который мы проверяем
$url = "http://url.to/favicon.ico";
// пробуем открыть файл для чтения
if (@fopen($url, "r")) <
echo "Файл существует";
> else <
echo "Файл не найден";
>
?>
Однако такой прием занимает достаточно много времени.
Есть вариант еще лучше — использовать функцию get_headers():
она делает запрос к файлу и получает все заголовки с ответом примерно в таком массиве
Array
(
[0] => HTTP/1.1 200 OK
[1] => Date: Sat, 29 May 2004 12:28:13 GMT
[2] => Server: Apache/1.3.27 (Unix) (Red-Hat/Linux)
[3] => Last-Modified: Wed, 08 Jan 2003 23:11:55 GMT
[4] => ETag: "3f80f-1b6-3e1cb03b"
[5] => Accept-Ranges: bytes
[6] => Content-Length: 438
[7] => Connection: close
[8] => Content-Type: text/html
)
Как мы видим, в нулевом элементе есть код ответа, 200 значит, что файл существует, и мы спокойно можем получить к нему доступ.
Вот код, который проверит существование файла.
<?
// файл, который мы проверяем
$url = "http://url.to/favicon.ico";
$Headers = @get_headers($url);
// проверяем ли ответ от сервера с кодом 200 — ОК
//if(preg_match("|200|", $Headers[0])) < // - немного дольше :)
if(strpos(‘200’, $Headers[0])) <
echo "Файл существует";
> else <
echo "Файл не найден";
>
?>
Теперь сравним по времени два метода с существующей favicon и с несуществующей:
при несуществующем файле второй метод (get_headers) выигрывает на две сотые секунды.
при существующем файле оба метода показали примерно одинаковое время.
PHP File Exists
Summary: in this tutorial, you will learn how to check if a file exists in PHP using the file_exists() , is_file() , is_readable() , and is_writable() functions.
PHP provides some useful functions that allow you to check if a file exists. Let’s examine these functions and how to use them effectively.
Check if a file exists using the file_exists() function
To check if a file exists, you use the file_exist() function:
The file_exists() function accepts a filename and returns true if the file exists; otherwise it returns false .
The following example uses the file_exists() function to check if the file readme.txt exists in the current directory:
If the readme.txt exists in the same directory of the script, you’ll see the following message:
…otherwise, you’ll see a different message:
Note that the $filename can be also a path to a directory. In this case, the file_exists() function returns true if the directory exists.
Check if a file exists using the is_file() function
If you want to check if a path is a file (not a directory) and exists in the file system, you can use the is_file() function.
The is_file() function accepts a $filename and returns true if the $filename is a file and exists:
The following example uses the is_file() function to check if the file readme.txt exists:
Check if a file exists and readable
In practice, you often want to check if a file exists before reading its contents. To check if a file exists and is readable, you use the is_readable() function:
The is_readable() function returns true if the $filename exists and readable, or false otherwise. Note that the $filename can be a directory.
The following example uses the is_readable() function to check if the readme.txt file exists and readable:
Check if a file exists and writable
Before writing to a file, you need to check the file exists and is writable. In this case, you can use the is_writable() function:
The is_writable() function returns true if the $filename exists and writable, or false otherwise.