Использование файловой системы

Используя несложные PHP-сценарии, вы можете делать все, что угодно с файловой системой вашего компьютера. В этой главе вы узнаете, как с помощью сценариев РНР выполнять следующие действия:

Замечание о путях к файлу

Сценарии, которые мы будем создавать в этой главе, могут быть выполнены как под управлением операционной системы Windows так и под управлением Linux/Unix. Указывая путь к файлу в операционной системе Windows, вы можете использовать символы, как прямой (/), так и обратной косой черты (\). В других операционных системах вы должны использовать в путях только прямую косую черту (/). Поэтому все сценарии, которые будут описаны в этой главе, будут использовать в путях к файлам прямую косую черту (/) для обеспечения совместимости со всеми операционными системами. Этот метод работает, даже если вы не укажите букву имени диска, как, например, в пути

Такой путь в операционной системе Windows предполагает, что будет использоваться текущий диск (в нашем случае С:/). Если вам нужно указать не текущий диск, то вы должны сделать это явным образом. Например,

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

Отображение содержимого папки (каталога)

Вы можете не поверить, но сценарий, который вы сейчас создадите - самый сложный в этой главе, хотя он состоит всего из 32 строк! Задачей сценария является открыть папку, найти в ней имена всех файлов и отобразить результат в виде маркированного списка.

Термин "указатель" будет использоваться для ссылки на открытую папку в последующих функциях, связанными с папками.

В конечном счете вы поместите результаты в маркированный список, содержащейся в переменной с именем $file_list.

Функция readdir () возвращает имя следующего файла в папке; в этом случае имя файла присваивается значению переменной $file_name.

Чтобы исключить из рассмотрения имена файлов текущего (.) и родительского (..) каталога, используйте оператор if, который проверяет значение переменной $file_name на равенство "." и "..".

Если значение переменной $file_name не равно ни ".", ни "..", то добавим его к значению переменной $file_list, используя операцию присоединения:

Теперь проверьте работоспособность созданного сценария.

http://localhost/listfiles.php

На Рис. 5.2 вы видите маркированный список файлов, храня-щихся в папке, заданной переменной $dir_name. Ваш список будет другим, так как вы будете использовать в качестве значения этой переменной путь к папке с файлами на вашем компьютере, то результатом работы сценария будет список файлов указанной вами папки. Проверьте, как работает этот сценарий с другими папками вашего компьютера. Если заданной вами папки не существует, то сценарий не сообщит об ошибке, он просто не вернет никаких результатов.

Работа с функциями fopen( ) и fclose( )

Перед тем как приступить к работе с файлами, вам необходимо немного узнать о функции fopen (), которая используется для открытия файла. Эта функция требует указания имени файла и режима. Результатом ее работы является указатель файла. Указатель файла содержит информацию о файле и используется как ссылка. Имя файла является полным путем к файлу, который вы хотите создать или открыть. В качестве режима может быть использован любой из режимов, перечисленных в таблице 5.1.

Цель следующего сценария - просто создать новый пустой файл в указанном месте.

Создайте указатель файла и используйте функцию fopen() для открытия файла, указанного в предыдущей строке, для чтения и записи.

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

http://localhost/newfile.php

Браузер загрузит страницу Создание нового файла (pис. 5.4).

На pис. 5.4 вы видите сообщение об успешном создании файла. Однако, если попытка создания файла окончится неудачно, или вы укажите несуществующий путь к создаваемому файлу, то на экран будет выведено сообщение об ошибке. Чтобы проверить это, выполните следующие действия:

http://localhost/newfile.php

Браузер загрузит страницу с сообщением об ошибке и невозможностью создания файла (pис. 5.5).

Рис. 5.5. Страница с сообщением об ошибке.

На рис. 5.5 вы видите сообщение об ошибке в пятой строке сценария. Это сообщение можно предотвратить, запретив вывод предупреждений и сообщений об ошибке, поместив символ @ перед именем функции. Для проверки этого выполните следующие действия:

http://localhost/newfile.php

Браузер загрузит страницу с одним сообщением о невозможности создания файла (pис. 5.6).

Рис. 5.6. Страница с сообщением о невозможности создания файла.

На pис. 5.6 вы видите только ваше сообщение, заданное в функции die(), а сообщения синтаксического анализатора РНР нет.

Проверка существования файла

Чтобы избежать некоторых возможных ошибок при работе с файловой системой, вы можете использовать функцию file_exists(), которая проверяет существование файла перед его созданием. В следующем ниже сценарии вы используете эту функцию и выведёте на экран одно из двух сообщений

Запустите Web-браузер, в поле ввода Адрес введите:

http://localhost/newfile_checkfirst.php

Так как файл с именем mydata.txt уже существует (вы создали его с помощью сценария newfile.php), вы увидите в рабочем окне браузера сообщение о существовании файла.

Если изменить имя файла в переменной $filename на другое имя (ещё не несуществующее имя, например mydate.xls), то в рабочее окно браузера будет выведено сообщение об успешном создании файла (pис.5.9).

Просто создавать файл неинтересно. В следующем параграфе вы узнаете о том, как записать в файл данные.

Задачей сценария, который вы создадите в этом параграфе, является добавление данных в файл. Если файл существует, то сценарий запишет данные в него. Если же файл не существует, то он будет создан перед тем, как в него будут помещены данные.

Использование символа новой строки (\n) вызовет перевод строки в этом месте текста.

Создайте указатель файла и используйте функцию fopen() для открытия указанного в переменной $filename файла для чтения и записи. Если попытка открытия файла окончится неудачей, то с помощью функции die() на экран будет выведено сообщение об ошибке.

http://localhost/writedata.php

Если при вводе текста сценария вы не допустили ошибок, то в рабочем окне браузера появится сообщение об успешном завершении операций создания, открытия и записи данных в указанный вами файл textfile.txt.

Полный листинг, набранного вами файла, writedata.php должен соответствовать приведённому на рис. 5.11.

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

В этом параграфе вы создадите сценарий, который прочтет данные из файла textfile.txt, созданного в предыдущем параграфе. Конечно, вы можете посмотреть этот файл с помощью любого текстового редактора, но это не представляет для нас интереса. РНР имеет очень удобную функцию fread (), которая выполнит для вас эту работу.

Создайте указатель файла и используйте функцию fopen() для открытия указанного в переменной $filename файла только для чтения. Если попытка открытия файла окончится неудачей, то с помощью функции die() на экран будет выведено сообщение об ошибке.

Второй аргумент, используемый функцией fread(), является длиной файла. Функция РНР filesize( ) определяет длину указанного в аргументе файла. Если длина файла неизвестна, то вы можете использовать функцию filesize($filename) для ее определения.

http://localhost/readdata.php

С первого взгляда может показаться, что цель создаваемого сценария достигнута. Однако это не совсем так. Если вы внимательно посмотрите на текст, отображенный браузером, то сможете заметить, что текст файла напечатан в одну строку, тогда как при записи текста в файл в предыдущем сценарии, мы вставили после первого предложения символ перевода строки. Дело в том, что символ перевода строки ничего не значит для Web-браузера, который воспринимает только код HTML. К счастью, группа разработкиков РНР предвидела это и создала функцию nl2br(), название которой представляет собой сокращение от английского newline-to-break (начать с новой строки). Будьте внимательны - вторая буква в функции латинская эл (l), а не цифра 1. Чтобы cозданный сценарий правильно отображал содержимое файла, необходимо внести в него незначительные изменения. Для этого выполните следующие действия:

Полный листинг без комментарий, изменённого вами файла, readdata.php должен соответствовать приведённому на рис. 5.14, за исключением пути к вашему файлу указанному во второй строке сценария.

http://localhost/readdata.php

Браузер загрузит страницу Чтение данных из файла, которая правильно отобразит содержимое файла (Рис. 5.15).

Рис. 5.15. Страница Чтение данных из файла, правильно отображающая чтение данных из файла.

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

Oтпpaвкa содержимого файла через E-mail

Если вы сохраняете результаты, введенные из HTML-формы, как простой текстовый файл, и хотите прочитать их в определенное время, то вы можете написать небольшой сценарий, чтобы содержимое этого файла оправлялось по почте по вашему требованию. Для этого выполните следующие действия:

Полный листинг файла, mailcontents.php должен соответствовать приведённому на рис. 5.16, за исключением пути к вашему файлу указанному во второй строке сценария.

http://localhost/mailcontents.php

Сообщение на этой странице предлагает вам проверить свою почту.

С помощью почтовой программы получите почту и откройте полученное письмо. Оно должно выглядеть примерно как на pис. 5.18.

Как вы видите на рис. 5.18, содержимое файла отображается правильно (есть перевод строки после первого предложения). Таким образом, в отличие от предыдущего сценария, при отправке содержимого файла по почте нет необходимости использовать функцию nl2br(). Она необходима только для отображения содержимого файла в окне Web-браузера.

Служебные действия с файловой системой

Сценарии РНР, которые будут созданы в этом знакомстве, помогут вам выполнить основные задачи при работе с файлами, такие, как копирование, переименование и удаление файлов. Необходимо помнить, что вы можете выполнить перечисленные выше функции только в том случае, если вы, как пользователь РНР, имеете надлежащие полномочия.

Копирование файлов

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

Для подавления предупреждений синтаксического анализатора РНР используется символ @ в начале функции, а с помощью функции die() на экран будет выведено сообщение при неудачном завершении операции.

Полный листинг файла, copyfile.php должен соответствовать приведённому на рис. 5.19, за исключением пути к вашему файлу указанному во второй строке сценария

Рис. 5.19. Полный листинг файла copyfile.php без комментариев

http://localhost/copyfile.php

Браузер загрузит страницу Копирование файла (pис. 5.20)

Фрагмент изменённой части выделен рамкой. Листинга файла copyfile.php приведён на рис. 5.21.

Рис. 5.21. Фрагмент изменённой части листинга copyfile.php.

http://localhost/copyfile.php

Браузер загрузит страницу Копирование файла с сообщением о невозможности скопировать файл (рис. 5.22).

Рис. 5.22. Страница с сообщением об ошибке при копировании файла.

Переименование файлов

Так же как и функция сору(), функция rename() нуждается в указании существующего имени файла и имени нового файла. Сценарий, который вы сейчас создадите, переименует существующий файл, не копируя его.

Для подавления предупреждений используется @ в начале функции, а с помощью функции die() на экран будет выведено сообщение при неудачном завершении операции.

Полный листинг файла, renamefile.php должен соответствовать приведённому на рис. 5.23, за исключением пути к вашему файлу указанному во второй строке сценария

Рис. 5.23. Полный листинг файла renamefile.php без комментариев.

http://localhost/renamefile.php

Браузер загрузит страницу Переименование файла (pис. 5.24.)

На pис. 5.24. вы видите подтверждение успешного завершения операции переименования файла. Чтобы проверить выдачу сообщения об ошибке, укажите переименование уже несуществующего файла в вашей папке для значения переменной $new_filename.

http://localhost/renamefile.php

Браузер загрузит страницу с сообщением о невозможности переименовать файл (Рис. 5.25).

Рис. 5.25. Страница с сообщением об ошибке при переименовании файла

Удаление файлов

Нужно очень внимательно относиться к использованию функции unlink(), потому что, удалив файл, вы уже не сможете его восстановить.

Для подавления предупреждений используется @ в начале функции, а с помощью функции die() на экран будет выведено сообщение при неудачном завершении операции.

Полный листинг файла, deletefile.php должен соответствовать приведённому на рис. 5.26, за исключением пути к вашему файлу указанному во второй строке сценария.

Рис. 5.26. Полный листинг файла deletefile.php без комментариев.

http://localhost/deletefile.php

Браузер загрузит страницу Удаление файла (pис. 5.27).

На Рис. 5.27 вы видите сообщение об успешном завершении операции удаления файла. Чтобы проверить выдачу сообщения об ошибке, попробуйте удалить ещё раз уже удалённый и поэтому

http://localhost/deletefile.php

Браузер загрузит страницу (pис. 5.28) с сообщением о невозможности удалить файл.

Рис. 5.28. Страница с сообщением об ошибке при удалении файла