Файловая система php

Абсолютные и относительные пути

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

Абсолютный путь включает в себя полный адрес файла от корня диска.
Пример:

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

Полезные константы

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

— Полный путь к директории, в которой находится текущий сценарий — Полный путь к текущему сценарию

Create The Upload File PHP Script

The «upload.php» file contains the code for uploading a file:

<?php$target_dir = «uploads/»;$target_file = $target_dir . basename($_FILES);$uploadOk = 1;$imageFileType =
strtolower(pathinfo($target_file,PATHINFO_EXTENSION));// Check if image file is a actual image or fake imageif(isset($_POST)) {
  $check = getimagesize($_FILES);  if($check !== false) {    echo «File is an image — » . $check . «.»;    $uploadOk = 1;
  } else {    echo «File is not an image.»;
    $uploadOk = 0;  }}?>

PHP script explained:

• $target_dir = «uploads/» — specifies the directory where the file is going to be placed
• $target_file specifies the path of the file to be uploaded
• $uploadOk=1 is not used yet (will be used later)
• $imageFileType holds the file extension of the file (in lower case)
• Next, check if the image file is an actual image or a fake image

Note: You will need to create a new directory called
«uploads» in the
directory where «upload.php» file resides. The uploaded files
will be saved there.

Отправка файлов

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

Тут есть два важных отличия от первого примера:

• Добавился новый атрибут , который всегда должен иметь значение. Если его не будет, то файл не отправится.
• Сам файл загружается при помощи поля с типом «file».

В PHP загруженный файл будет доступен в другом специальном массиве — .

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

Для начала нужно убедиться, что в рабочей директории проекта существует папка для хранения загруженных файлов. Пусть она называется .

Перемещение загруженного файла

Для перемещения файла нужно знать, где он находится сейчас, и адрес папки, в которую он будет переноситься.
С текущим адресом всё крайне просто — он уже находится в массиве . Новый адрес файла, в свою очередь, состоит из пути к папке и имени файла. Так как папка находится там же, где и текущий сценарий, получить путь к ней можно так: .

Код для перемещения файла в новую папку:

Функция выполняет два действия:

1. Проверяет, что файл действительно загружен через форму.
2. Перемещает загруженный файл по новому адресу.

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

Чтобы открыть файл в PHP, используют функцию fopen(). Она определяется следующим образом:

resource fopen(string $filename, string $mode)

Первый атрибут $filename служит для предоставления пути к файлу, а второй параметр обеспечивает его открытие. В зависимости от того, каковы цели открытия и какой тип файла, параметр может принимать несколько значений:
– ‘r’: файл открывается лишь для чтения. Если файл отсутствует, возвращается false;
— ‘r+’: файл открывается лишь для чтения, но есть возможность записи. Если файла нет, возвращается false;
— ‘w’: файл открывается для записи. Когда такой файл уже есть, он перезаписывается, когда нет — создаётся;
— ‘w+’: файл открывается для записи, но есть возможность чтения. Если файл существует, происходит перезапись, если нет — создание;
— ‘a’: файл открывается для записи. При его существовании информация записывается в конец файла, при этом старые данные сохраняются. Если файла нет, происходит его создание;
— ‘a+’: файл открывается и для чтения, и для записи. Когда файл существует, данные дописываются в конец файла. Если файл отсутствует, он создаётся.

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

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

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

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

PHP Filesystem Functions

❮ Previous
Next ❯

Описание

int fopen (string filename, string mode )

Если
filename
начинается с «http://» (нечувствительно к регистру), то HTTP 1.0 соединение
открывается со специфицированным сервером, страница запрашивается методом HTTP GET
и указатель файла возвращается в начало тела ответа.  ‘Host:’-header
отправляется вместе с запросом, чтобы обработать виртуальные хосты на основе имён.

Начиная с PHP 4.3.0, если вы скомпилировали поддержку OpenSSL, вы можете
использовать «https://» для открытия HTTP-соединения через SSL.

Обратите внимание, что указатель файла позволяет вам запрашивать только
body\тело ответа; для запрашивания шапки/header HTTP-ответа вам нужно использовать PHP 4.0.5
или новее; эти шапки будут храниться в переменной $http_response_header.
Начиная с PHP 4.3.0, header-информация может быть запрошена с использованием функции file_get_wrapper_data(). HTTP-соединения являются read-only; вы не можете записывать данные или копировать файлы в HTTP-ресурс

HTTP-соединения являются read-only; вы не можете записывать данные или копировать файлы в HTTP-ресурс.

Версии до PHP 4.0.5 не обрабатывают HTTP-перенаправления. Поэтому директории обязаны иметь ведомые слэши.

Если
filename
начинается с «ftp://» (нечувствительно к регистру), открывается ftp-соединение
со специфицированным сервером и возвращается указатель на запрашиваемый файл. Если
сервер не поддерживает ftp пассивного режима, это не удастся сделать. Вы
можете открывать файлы для чтения или записи через ftp (но не для того и
другого одновременно). Если удалённый/remote файл уже существует на ftp-сервере
и вы пытаетесь открыть его для записи, это не получится.
Если вам нужно обновить существующие файлы по ftp, используйте

ftp_connect()
.

Если
filename
это «php://stdin»,
«php://stdout» или «php://stderr», будет открыт соответствующий поток stdio. (Это
появилось в PHP 3.0.13; до этого такие имена файлов, как «/dev/stdin» или
«/dev/fd/0», должны были использоваться для доступа к stdio-потокам.)

Если
filename
начинается ещё с чего-нибудь, файл будет открыт из файловой системы и будет
возвращён указатель на открытый файл.

Если открыть файл не удалось, эта функция возвращает

FALSE
.

mode
может иметь значения:

• ‘r’ — Открыть только для чтения; поместить указатель в начало файла.

• ‘r+’ — Открыть для чтения и записи; поместить указатель в начало файла.

• ‘w’ — Открыть только для записи; поместить указатель в начало файла и
  усечь файл до нулевой длины. Если файл не существует, делается попытка создать его.

• ‘w+’ — Открыть для чтения и записи; поместить указатель в начало файла
  и усечь файл до нулевой длины. Если файл не существует, делается попытка создать его.

• ‘a’ — Открыть только для записи; поместить указатель в конец файла.
  Если файл не существует, делается попытка создать его.

• ‘a+’ — Открыть для чтения и записи; поместить указатель в конец файла.
  Если файл не существует, делается попытка создать его.

Вы можете использовать необязательный третий параметр и установить в него
значение «1», если хотите найти файл также и в .

$fp = fopen ("/home/rasmus/file.txt", "r");
$fp = fopen ("/home/rasmus/file.gif", "wb");
$fp = fopen ("http://www.example.com/", "r");
$fp = fopen ("ftp://user:password@example.com/", "w");

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

На платформе Windows мнемонизируйте (escape) все обратные слэши в пути к
файлу или используйте обычные слэши.

$fp = fopen ("c:\\data\\info.txt", "r");

См. также

fclose()
,
fsockopen()
,

socket_set_timeout()
и

popen()
.

Работа с потоком

// Открытие потока на чтение и получение его дескриптора
$f = fopen("file.txt", "r") or die("Не могу открыть файл!");

// Закрытие потока
fclose($f);

// Открытие потока на чтение и запись
$f = fopen("file.txt", "r+");
// Открытие потока на запись. Указатель помещается в конец файла
$f = fopen("file.txt", "a");
// Открытие потока на чтение и запись. Указатель помещается в конец файла
$f = fopen("file.txt", "a+");
// Открытие потока на запись. Файл обрезается до нулевой длины
$f = fopen("file.txt", "w");
// Открытие потока на чтение и запись. Файл обрезается до нулевой длины
$f = fopen("file.txt", "w+");

// Читаем файл кусками
$f = fopen("file.txt", "r");
// Читаем первые 5 байт из потока
echo fread($f, 5);
// Читаем следующие 3 байта из потока
echo fread($f, 3);
//Выводим всё с текущей позиции до конца
fpassthru($f);
fclose($f);

// Читаем файл построчно в массив
$f = fopen("file.txt", "r");
$lines = [];
while ( $line = fgets($f) ){
  $lines[] = $line;
}
fclose($f);

// Читаем файл построчно в массивы, вырезаем html-тэги, оставляя нужные
$f = fopen("file.html", "r");
$lines = [];
while ( $line = fgetss($f, 4096, "<p><br>") ){
	$lines[] = $line;
}
fclose($f);

// Читаем файл побайтово в массив
$f = fopen("file.txt", "r");
$bytes = [];
while ( !feof($f) ){
	$bytes[]= fgetc($f);
}
fclose($f);

// Пишем в файл
$f = fopen("file.txt", "r+");
fwrite($f, "Новый текст", 25);
fclose($f);

// Пишем в конец файла
$f = fopen("file.txt", "a");
fputs($f, "\nНовая строка");
fclose($f);

// Читаем последние 10 байт из потока
$f = fopen("file.txt", "r");
// Устанавливаем указатель в нужную позицию
fseek($f, -10, SEEK_END);
// В какой позиции мы находимся?
echo ftell($f);
// Читаем данные
echo fread($f, 10);
// Устанавливаем указатель в начало потока
rewind($f);
fclose($f);

Отправка формы

Рассмотрим один типичный пример — форма обратной связи. Для связи пользователей с авторами сайта, как правило, используются формы обратной связи, где человек указывает имя, почту для обратной связи и текст своего сообщения.
Такая форма в HTML может выглядеть следующим образом:

Это очень простая форма, состоящая из трёх полей и одной кнопки отправки.

Почти весь приведённый код описывает внешний вид и содержание формы, но следует обратить внимание на два атрибута тега , которые нужны для указания на способ обработки данных:

• — этот атрибут используется для определения метода HTTP, который будет использован для передачи данных на сервер. Вы уже знакомы с HTTP-методом , предписывающим серверу просто вернуть определённый документ.
  Метод сообщает о намерении передать на сервер некоторую информацию, что, впрочем, не отменяет последующее получение контента.
• — содержит адрес PHP-скрипта, который должен обработать эту форму.

После нажатия на кнопку «отправить», браузер выполняет POST запрос со введёнными данными на адрес, указанный в атрибуте .

КомментарииRemarks

Функция fopen открывает файл, указанный параметром filename.The fopen function opens the file that is specified by filename. По умолчанию строка с узким именем интерпретируется с использованием кодовой страницы ANSI (CP_ACP).By default, a narrow filename string is interpreted using the ANSI codepage (CP_ACP). В классических приложениях Windows эту страницу можно изменить на кодовую страницу OEM (CP_OEMCP) с помощью функции SetFileApisToOEM .In Windows Desktop applications this can be changed to the OEM codepage (CP_OEMCP) by using the SetFileApisToOEM function. С помощью функции AreFileApisANSI можно определить, интерпретируется ли имя файла с использованием ANSI или системной кодовой страницы OEM по умолчанию.You can use the AreFileApisANSI function to determine whether filename is interpreted using the ANSI or the system default OEM codepage. _wfopen — это версия fopen с расширенными символами; аргументы для _wfopen являются строками расширенных символов._wfopen is a wide-character version of fopen; the arguments to _wfopen are wide-character strings. В противном случае _wfopen и fopen работают одинаково.Otherwise, _wfopen and fopen behave identically. Простое использование _wfopen не влияет на закодированную кодировку, используемую в файловом потоке.Just using _wfopen does not affect the coded character set that is used in the file stream.

fopen принимает пути, допустимые в файловой системе в момент выполнения. fopen принимает UNC-пути и пути, которые используют сопоставленные сетевые диски, если система, в которой выполняется код, имеет доступ к общей папке или подключенному диску во время выполнения.fopen accepts paths that are valid on the file system at the point of execution; fopen accepts UNC paths and paths that involve mapped network drives as long as the system that executes the code has access to the share or mapped drive at the time of execution. При создании путей для fopen убедитесь, что диски, пути или сетевые папки будут доступны в среде выполнения.When you construct paths for fopen, make sure that drives, paths, or network shares will be available in the execution environment. В пути в качестве разделителей каталогов можно использовать прямую (/) или обратную (\) косую черту.You can use either forward slashes (/) or backslashes (\) as the directory separators in a path.

Всегда проверяйте возвращаемое значение, чтобы узнать, равен ли указатель NULL, прежде чем выполнять какие-либо дальнейшие операции с файлом.Always check the return value to see whether the pointer is NULL before you perform any additional operations on the file. При возникновении ошибки устанавливается глобальная переменная со значением « No », которую можно использовать для получения конкретных сведений об ошибке.If an error occurs, the global variable errno is set and may be used to obtain specific error information. Дополнительные сведения см. в разделе errno, _doserrno, _sys_errlist и _sys_nerr.For more information, see errno, _doserrno, _sys_errlist, and _sys_nerr.

По умолчанию глобальное состояние этой функции ограничивается приложением.By default, this function’s global state is scoped to the application. Чтобы изменить это, см. раздел глобальное состояние в CRT.To change this, see Global state in the CRT.

Чтение файлов

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

Функции для работы с файлами PHP облегчают задачу. В данном случае понадобится file_get_contents(). Она будет считывать все содержимое файла в переменную без необходимости открывать или закрывать файл самостоятельно. Это удобно, когда объем записи относительно невелик, так как сразу считывать 1 ГБ данных в архив не всегда рационально в PHP. Работа с «.ini»-файлами и функцией file_get_contents() показана ниже.

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

Для работы с функцией fopen() необходимы два аргумента:

• файл, который нужно открыть;
• режим, используемый в этом случае является «r» для чтения.

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

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

Использование do-while-цикла является хорошим выбором, чтобы узнать заранее, сколько строк в файле. Функция feof() проверяет, достиг ли файл завершения, а цикл продолжается до тех пор, пока не будет достигнут конец условия файла. После окончания чтения используется функция fclose() для закрытия документа.

Выбор за вами

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

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

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

Похожие темы

• Оригинал статьи: The right way to read files with PHP.
• PHP.net — полный справочник по PHP на все случаи жизни.
• Прочитайте «PHP через примеры, Часть 1» и откройте для себя упрощенный метод PHP для построения сложных и мощных программ для Web.
• Узнайте о функции , которая не рассматривается в данной статье.
• Узнайте о функции , которая не рассматривается в данной статье.
• PHP.net — отличный ресурс для PHP-разработчиков.
• Ознакомьтесь с «Рекомендуемым списком книг по PHP.»
• Просмотрите все связанные с PHP материалы на developerWorks.
• Усовершенствуйте ваши навыки программирования на PHP, ознакомившись с ресурсами проекта PHP на сайте IBM developerWorks.
• Посетите Раздел Open Source на developerWorks для получения разнообразной информации о средствах и методах разработки ПО, инструментальных средств и обновлений проектов, что поможет вам в разработке технологий с открытым исходным кодом и использовании их с программными продуктами IBM.
• Рационализируйте свой следующий проект по разработке ПО с открытым исходным кодом с помощью пробного ПО IBM, доступного на DVD или для загрузки.
• Посетите Safari Books Online, где представлено множество ресурсов по технологиям с открытым исходным кодом.

Запись файлов

Два часто используемых режима при записи в файл с использованием функции fwrite(): «w» и «a». «W» означает, что нужно записать в документ, но он предварительно удалит любое содержимое, «a» — добавление новых данные к тому, что уже существует в файле. Нужно быть уверенным, что используется правильный вариант.

В следующем примере будет использоваться режим «a» для записи.

Сначала имя файла назначается переменной, затем он открывается в режиме «a» для добавления. Данные, которые должны быть записаны, назначаются переменной $output и fwrite(), а информация добавляется в файл. Процесс повторяется, чтобы добавить еще одну строку, затем документ закрывается с использованием fclose().

Предварительно определенная константа PHP_EOL добавляет символ новой строки, специфичный для платформы, на которой работает PHP с текстовыми файлами.

Содержимое файла после выполнения вышеуказанного кода должно выглядеть следующим образом:

• банан;
• Китай.

Функция file_put_contents() также может записывать в файл. Она принимает имя файла, данные, которые должны быть записаны и константу FILE_APPEND, если она должна добавить данные (будет перезаписывать содержимое файла по умолчанию).

Вот такой же пример, как и выше, но на этот раз используется file_put_contents().

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

Create The HTML Form

Next, create an HTML form that allow users to choose the image file they want to upload:

<!DOCTYPE html><html><body><form action=»upload.php» method=»post»
enctype=»multipart/form-data»>  Select image to upload:  <input type=»file» name=»fileToUpload» id=»fileToUpload»>
  <input type=»submit» value=»Upload Image» name=»submit»>
</form></body></html>

Some rules to follow for the HTML form above:

• Make sure that the form uses method=»post»
• The form also needs the following attribute: enctype=»multipart/form-data». It specifies which content-type to use when submitting the form

Without the requirements above, the file upload will not work.

Other things to notice:

The type=»file» attribute of the tag shows the input field as a file-select control, with a «Browse» button next to the input control

The form above sends data to a file called «upload.php», which we will create next.

Способы подключения файлов

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

Примеры подключения файлов

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

Содержимое файла :

В файле находится код, который подключит сценарий :

Интересный факт: можно использовать как ключевое слово, либо как функцию.
Результат будет одним и тем же:

Результат работы:

Привет, я содержимое из sub.php!
А я - index.php!

Что произошло? Два сценария как бы склеились в один: выполнилось все содержимое и добавилось в начало сценария .

О том, как работать с функцией , подробно рассказано в этом задании.

Runtime Configuration

The behavior of the filesystem functions is affected by settings in php.ini.