Возвращает false и ошибку если файл уже существует

В этой уроке мы рассмотрим несколько функций, с помощью которых будем открывать, читать и закрывать файлы на сервере.

Функция PHP fopen()

Функция fopen() в PHP — это встроенная функция, которая используется для открытия файла или URL-адреса. В случае сбоя, она возвращает FALSE и выдаёт ошибку. Если вам нужно скрыть вывод ошибки добавьте символ '@' перед именем функции.

Синтаксис

Параметры

• filename : Обязательный параметр, определяющий файл.
• mode : Обязательный параметр, определяющий тип доступа к файлу или потоку.
  Он может иметь следующие возможные значения:
  • «r»: Открывает файл только для чтения; помещает указатель в начало файла.
  • «r+»: Окрывает файл для чтения и записи; помещяет указатель в начало файла.
  • «w»: Открывает файл только для записи; помещает указатель в начало файла и обрезает файл до нулевой длинны. Если файл не существует — пробует его создать.
  • «w+»: Открывает файл для чтения и записи; помещает указатель в начало файла и обрезает файл до нулевой длинны. Если файл не существует — пробует его создать.
  • «a»: Открывает файл только для записи; помещает указатель в конец файла. Если файл не существует — пытается его создать.
  • «a+»: Открывает файл для чтения и записи; помещает указатель в конец файла. Если файл не существует — пытается его создать.
  • «x»: Создаёт и открывает только для записи. Он создает новый файл и возвращает FALSE и ошибку, если файл уже существует.
  • «x+»: Создаёт и открывает для чтения и записи. Создает новый файл и возвращает FALSE и ошибку, если файл уже существует.
  • «c»: Открывает файл только для записи. Если файл не существует, то он создается. Если же файл существует, то он не обрезается (в отличие от ‘w’), и вызов к этой функции не вызывает ошибку (также как и в случае с ‘x’).
  • «c+»: Открывает файл для чтения и записи; в остальном имеет то же поведение, что и ‘c’.
  • «e»: Установить флаг close-on-exec (закрыть при запуске) на открытый файловый дескриптор. Доступно только в PHP скомпилированном на системах поддерживающих POSIX.1-2008.
• include_path : Необязательный параметр, для которого установлено значение в ‘1’ или TRUE, если вы хотите искать файл в include_path (например, php.ini).
• context : Необязательный параметр, который используется для установки поведения потока.

В этом уроке мы будем использовать текстовый файл mane.txt:

AJAX = Asynchronous JavaScript and XML
CSS = Cascading Style Sheets
HTML = Hyper Text Markup Language
PHP = PHP Hypertext Preprocessor
SQL = Structured Query Language
SVG = Scalable Vector Graphics
XML = EXtensible Markup Language

В следующем примере, ипользуя функцию fopen(), откроем файл «mane.txt» в режиме чтения:

<?php
$myfile = fopen("mane.txt", "r") or die("Невозможно открыть файл!");

echo fread($myfile,filesize("mane.txt"));

fclose($myfile);

?>

Конструкция or die(«Невозможно открыть файл!») позволяет прекратить работу скрипта и вывесте некоторое сообщение об ошибке, если функция fopen не смогла открыть файл.

Чтение файла — fread()

Функция fread() считывает информацию из открытого файла.

Первый параметр fread() содержит имя файла для чтения, а второй параметр указывает максимальное количество байтов для чтения.

Следующий код PHP читает файл «mane.txt» до конца:

Закрытие файла — fclose()

Функция fclose() используется, чтобы закрыть открытый файл.

Синтаксис

bool fclose ( resource handle )

Функция закрывает файл, на который указывает handle.

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Дескриптор должен указывать на файл, открытый ранее с помощью функции fopen() или fsockopen().

Однострочное чтение — fgets()

Функция fgets() используется для чтения одной строки из файла.

В приведенном ниже примере выводится первая строка файла mane.txt:

<?php
$myfile = fopen("mane.txt", "r") or die("Невозможно открыть файл!");

echo fgets($myfile);

fclose($myfile);

?>

Проверка окончания файла — feof()

Функция feof() определяет, достигнут ли конец файла. Если в указанном дескрипторе, определяется окончание файла, возвращает True. В противном случае, False.

Функция feof() полезна для цикла работающего с данным неизвестной длины.

В приведенном ниже примере файл «mane.txt» считывается построчно, пока не будет достигнут конец файла:

<?php
$myfile = fopen("mane.txt", "r") or die("Невозможно открыть файл!");

while(!feof($myfile)) {  // цикл завершится, при обнаружении конца файла

  echo fgets($myfile) . "<br>"; // Вывести одну строку

}

?>

Чтение одного символа — fgetc()

Функция fgetc() используется для чтения одного символа из файла.

В приведенном ниже примере файл «mane.txt» считывается посимвольно, пока не будет достигнут конец файла:

<?php
$myfile = fopen("mane.txt", "r") or die("Невозможно открыть файл!");

while(!feof($myfile)) {  // цикл завершится, при обнаружении конца файла

  echo fgetc($myfile) . "<br>"; // Вывести один символ

}

?>

Примечание: Не перепутайте имя функции fgets() оканчивается символом s — string, а имя функции fgetc() оканчивается символом c — character.

PHP Экзаменатор

Вернуться к: Файловая система

The fopen() function in PHP is an inbuilt function which is used to open a file or an URL. It is used to bind a resource to a steam using a specific filename. The filename and mode to be checked are sent as parameters to the fopen() function and it returns a file pointer resource if a match is found and a False on failure. The error output can be hidden by adding an ‘@’ in front of the function name.

Syntax:

resource fopen ( $file, $mode, $include_path, $context)

Parameters Used:
The fopen() function in PHP accepts four parameters.

• $file: It is a mandatory parameter which specifies the file.
• $mode: It is a mandatory parameter which specifies the access type of the file or stream.
  It can have the following possible values:
  • “r”: It represents Read only. It starts at the beginning of the file.
  • “r+”: It represents Read/Write.It starts at the beginning of the file.
  • “w”: It represents Write only.It opens and clears the contents of file or create a new file if it doesn’t exist.
  • “w+”: It represents Read/Write. It opens and clears the contents of file or creates a new file if it doesn’t exist.
  • “a”: It represents Write only. It opens and writes to the end of the file or creates a new file if it doesn’t exist.
  • “a+”: It represents Read/Write. It preserves the file’s content by writing to the end of the file.
  • “x”: It represents Write only. It creates a new file and returns FALSE and an error if the file already exists.
  • “x+”: It represents Read/Write.It creates a new file and returns FALSE and an error if file already exists.
• $include_path: It is an optional parameter which is set to 1 if you want to search for the file in the include_path (Ex. php.ini).
• $context: It is an optional parameter which is used to set the behavior of the stream.

Return Value:
It returns a file pointer resource on success, or FALSE on error.

Exceptions:

• When writing to a text file, the correct line-ending character should be used based on the platform.For example Unix systems use \n, Windows systems use \r\n, and Macintosh systems use \r as the line ending character.
• It is recommended to use the ‘b’ flag when opening files with fopen().
• An error of level E_WARNING is generated if the open fails.
• When safe mode is enabled, PHP checks whether the directory in which the script is operating has the same UID (owner) as the script that is being executed.
• If you are unsure whether filename is a file or a directory, you may need to use the is_dir() function before calling fopen() since fopen() function may also succeed when filename is a directory.

Below programs illustrate the fopen() function.

Program 1:

Output:

File does not exist!

Program 2:

Output:

portal for geeks!

Program 3:

Output:

portal for geeks!

Program 4:

Output:

geeksportalks

Reference:
http://php.net/manual/en/function.fopen.php

Работа с файловой системой

Последнее обновление: 1.11.2015

Как и большинство языков программирования, PHP поддерживает работу с файлами, которые являются одним из способов хранения информации.

Чтение и запись файлов

Открытие и закрытие файлов

Для открытия файлов в PHP определена функция fopen(). Она имеет следующее определение:
resource fopen(string $filename, string $mode). Первый параметр $filename представляет путь к файлу, а второй — режим открытия. В зависимости
от цели открытия и типа файла данный параметр может принимать следующие значения:

• 'r': файл открывается только для чтения. Если файла не существует, возвращает false

• 'r+': файл открывается только для чтения с возможностью записи. Если файла не существует, возвращает false

• 'w': файл открывается для записи. Если такой файл уже существует, то он перезаписывается, если нет — то он создается

• 'w+': файл открывается для записи с возможностью чтения. Если такой файл уже существует, то он перезаписывается, если нет — то он создается

• 'a': файл открывается для записи. Если такой файл уже существует, то данные записываются в конец файла, а старые данные остаются.
  Если файл не существует, то он создается

• 'a+': файл открывается для чтения и записи. Если файл уже существует, то данные дозаписываются в конец файла. Если файла нет, то он создается

Результатом функции fopen будет дескриптор файла. Этот дескриптор используется для операций с файлом и для его закрытия.

После окончания работы файл надо закрыть с помощью функции fclose(), которая принимает в качестве параметра дескриптор файла. Например,
откроем и закроем файл:

$fd = fopen("form.php", 'r') or die("не удалось открыть файл");
fclose($fd);

Конструкция or die("текст ошибки") позволяет прекратить работу скрипта и вывесте некоторое сообщение об ошибке, если функция fopen
не смогла открыть файл.

Чтение файла

Для чтения файла можно использовать несколько функций. Для построчного чтения используется функция fgets(),
которая получает дескриптор файла и возвращает одну считанную строку. Пройдем построчно по всему файлу:

<?php
$fd = fopen("form.php", 'r') or die("не удалось открыть файл");
while(!feof($fd))
{
	$str = htmlentities(fgets($fd));
	echo $str;
}
fclose($fd);
?>

При каждом вызове fgets() PHP будет помещать указатель в конец считанной строки. Чтобы проследить окончание файла, используется функция
feof(), которая возвращает true при завершении файла. И пока не будет достигнут конец файла, мы можем применять функцию
fgets().

Чтение файла полностью

Если нам надо прочитать файл полностью, то мы можем облегчить себе жизнь, применив функцию file_get_contents():

<?php
$str = htmlentities(file_get_contents("form.php"));
echo $str;
?>

При этом нам не надо открывать явно файл, получать дескриптор, а затем закрывать файл.

Поблочное считывание

Также можно провести поблочное считывание, то есть считывать определенное количество байт из файла с помощью функции fread():

<?php
$fd = fopen("form.php", 'r') or die("не удалось открыть файл");
while(!feof($fd))
{
	$str = htmlentities(fread($fd, 600));
	echo $str;
}
fclose($fd);
?>

Функция fread() принимает два параметра: дескриптор считываемого файла и количество считываемых байтов. При считывании блока указатель в файле
становится в конец этого блока. И также с помощью функции feof() можно отследить завершение файла.

Запись файла

Для записи файла применяется функция fwrite(), которая записывает в файл строку:

<?php
$fd = fopen("hello.txt", 'w') or die("не удалось создать файл");
$str = "Привет мир";
fwrite($fd, $str);
fclose($fd);
?>

Аналогично работает другая функция fputs():

<?php
$fd = fopen("hello.txt", 'w') or die("не удалось создать файл");
$str = "Привет мир";
fputs($fd, $str);
fclose($fd);
?>

Работа с указателем файла

При открытии файла для чтения или записи в режиме ‘w’, указатель в файле помещается в начало. При считывании данных PHP перемещает указатель в файле в конец блока
считанных данных. Однако мы также вручную можем управлять указателем в файле и устанавливать его в произвольное место. Для этого надо использовать функцию
fseek, которая имеет следующее формальное определение:

int fseek (resource $handle , int $offset [, int $whence = SEEK_SET ] )

Параметр $handle представляет дескриптор файла. Параметр $offset — смещение в байтах относительно начала файла, с которого начнется считывание/запись.
Третий необязательный параметр задает способ установки смещения. Он может принимать три значения:

• SEEK_SET: значение по умолчанию, устанавливает смещение в offset байт относительно начала файла

• SEEK_CUR: устанавливает смещение в offset байт относительно начала текущей позиции в файле

• SEEK_END: устанавливает смещение в offset байт от конца файла

В случае удачной установки указателя функция fseek() возвращает 0, а при неудачной установке возвращает -1.

Пример использования функции:

$fd = fopen("hello.txt", 'w+') or die("не удалось открыть файл");
$str = "Привет мир!"; // строка для записи
fwrite($fd, $str); // запишем строку в начало
fseek($fd, 0); // поместим указатель файла в начало
fwrite($fd, "Хрю"); // запишем в начало строку
fseek($fd, 0, SEEK_END); // поместим указатель в конец
fwrite($fd, $str); // запишем в конце еще одну строку
fclose($fd);