Учебник PHP

         

fbsql_num_fields

(PHP 4 >= 4.0.6)

fbsql_num_fields - получает количество полей в результате.

Описание

int fbsql_num_fields (resource result)

fbsql_num_fields() возвращает количество полей в результирующем наборе.

См. также: fbsql_db_query(), fbsql_query(), fbsql_fetch_field() и fbsql_num_rows().

fbsql_num_rows

(PHP 4 >= 4.0.6)

fbsql_num_rows - получает количество рядов в результате.

Описание

int fbsql_num_rows (resource result)

fbsql_num_rows() возвращает количество рядов в результирующем наборе. Эта команда верна только для операторов SELECT. Чтобы запросить количество рядов из запросов INSERT, UPDATE или DELETE, используйте fbsql_affected_rows().

Пример 1. fbsql_num_rows()
<?php
$link = fbsql_connect("localhost", "username", "password");
fbsql_select_db("database", $link);
$result = fbsql_query("SELECT * FROM table1;", $link);
$num_rows = fbsql_num_rows($result);
echo "$num_rows Rows\n";
?>

См. также: fbsql_affected_rows(), fbsql_connect(),


fbsql_select_db() и fbsql_query().

fbsql_password

(PHP 4 >= 4.0.6)

fbsql_password - получает или устанавливает пароль пользователя/user password для соединения.

Описание

string fbsql_password (resource link_identifier [, string password])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

fbsql_pconnect

(PHP 4 >= 4.0.6)

fbsql_pconnect - открывает постоянное соединение в FrontBase-сервером.

Описание

resource fbsql_pconnect ([string hostname [, string username [, string password]]])

Возвращает положительный идентификатор постоянной FrontBase при успехе, FALSE при ошибке.

fbsql_pconnect() устанавливает соединение с FrontBase-сервером. Для отсутствующих параметров принимаются следующие значения оп умолчанию: host = 'localhost', username = "_SYSTEM" и password = пустой пароль.

fbsql_pconnect() работает аналогично fbsql_connect(), но с двумя важными отличиями.

Для установки номера порта Frontbase-сервера используйте fbsql_select_db().

Во-первых, при соединении эта функция сначала попытается найти (постоянную) ссылку/link, которая уже открыта с этим же хостом, username и password. Если она найдена, возвращается идентификатор для неё, вместо открытия нового соединения.

Во-вторых, соединение с SQL-сервером не будет закрыто при окончании работы скрипта. Ссылка останется открытой для последующего использования.

Этот тип ссылок поэтому называется 'persistent/постоянные'.

fbsql_query

(PHP 4 >= 4.0.6)

fbsql_query - отправляет FrontBase -запрос/query.

Описание

resource fbsql_query (string query [, resource link_identifier])

fbsql_query() отправляет запрос текущей активной БД на сервере, которая идентифицирована со специфицированным идентификатором ссылки/link identifier. Если link_identifier не специфицирован, принимается последняя открытая ссылка. Если ни одной открытой ссылки нет, функция пытается установить ссылку, как если бы была вызвана fbsql_connect() без аргументов, и использует её.

Примечание: строка запроса всегда заканчивается точкой с запятой.

fbsql_query() возвращает TRUE (ненулевое значение) или FALSE, указывая, нормально ли прошёл запрос. TRUE означает, что запрос правильный и может быть выполнен сервером. Ничего не сообщается о количестве задействованных или возвращаемых рядов. Запрос может выполняться, но без влияния на ряды или без возвращения рядов.

Следующий запрос синтаксически неверен, поэтому fbsql_query() терпит неудачу и возвращает FALSE:

fbsql_read_blob

(PHP 4 >= 4.2.0)

fbsql_read_blob - читает BLOB из БД.

Описание

string fbsql_read_blob (string blob_handle [, resource link_identifier])

Возвращает: строку, содержащую BLOB, специфицированный blob_handle.

fbsql_read_blob() читает BLOB-данные из БД. Если оператор select содержит BLOB и/или BLOB-столбцы, FrontBase возвратит данные непосредственно при извлечении данных. Это поведение по умолчанию может быть изменено функцией fbsql_set_lob_mode(), так что функция извлечения возвратит дескрипторы BLOB и CLOB-данных. Если дескриптор извлечён, пользователь обязан вызвать fbsql_read_blob() для получения BLOB-данных их БД.

fbsql_read_clob

(PHP 4 >= 4.2.0)

fbsql_read_clob - читает CLOB из БД.

Описание

string fbsql_read_clob (string clob_handle [, resource link_identifier])

Возвращает строку, содержащую CLOB, специфицированный clob_handle.

fbsql_read_clob() читает CLOB-данные из БД. Если оператор select содержит BLOB и/или CLOB-столбцы, FrontBase возвратит данные непосредственно при их извлечении. Это поведение по умолчанию может быть изменено функцией fbsql_set_lob_mode(), так что функции извлечения будут возвращать дескрипторы BLOB и CLOB-данных. Если дескриптор извлечён, пользователь обязан вызвать fbsql_read_clob() для получения CLOB-данных из БД.

fbsql_result

(PHP 4 >= 4.0.6)

fbsql_result - получает результирующие данные.

Описание

mixed fbsql_result (resource result, int row [, mixed field])

fbsql_result() возвращает содержимое одной ячейки из результирующего набора FrontBase. Аргументом field может быть смещение или имя поля, или имя таблицы поля с точкой + имя поля (tabledname.fieldname). Если был создан псевдоним имени столбца ('select foo as bar from...'), используйте этот псевдоним вместо имени столбца.

При работе с большими результирующими наборами вы должны предусмотреть использование одной из функций, которые запрашивают весь ряд целиком (специфицированы ниже). Поскольку эти функции возвращают содержимое нескольких ячеек в одном вызове, они работают НАМНОГО быстрее, чем fbsql_result(). Также отметьте, что специфицирование смещение для аргумента field намного быстрее, чем специфицирование аргумента fieldname или tablename.fieldname.

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

Рекомендуемые высокопроизводительные альтернативы: fbsql_fetch_row(), fbsql_fetch_array() и fbsql_fetch_object().

fbsql_rollback

(PHP 4 >= 4.0.6)

fbsql_rollback - откатывает транзакцию БД.

Описание

bool fbsql_rollback ([resource link_identifier])

Возвращает TRUE при успехе, FALSE при неудаче.

fbsql_rollback() заканчивает текущую транзакцию, откатывая все операторы, вызванные после последнего подтверждения. Эта команда нужна только в том случае, если autocommit установлено в false.

См. также fbsql_autocommit() и fbsql_commit().

fbsql_select_db

(PHP 4 >= 4.0.6)

fbsql_select_db - выбирает БД FrontBase.

Описание

bool fbsql_select_db (string database_name [, resource link_identifier])

Возвращает TRUE при успехе, FALSE при ошибке.

fbsql_select_db() устанавливает текущую активную БД на сервере, ассоциированную со специфицированным идентификатором ссылки. Если идентификатор ссылки не специфицирован, принимается последняя открытая ссылка. Если открытых ссылок нет, функция пытается установить ссылку, как при вызове fbsql_connect(), и использует её.

Клиент контактирует с FBExec для получения номера порта, используемого при соединении с БД. Если имя БД это номер, система будет использовать его как номер порта и не будет запрашивать в FBExec номер порта. FrontBase-сервер может стартовать как FRontBase -FBExec=No -port=<port number> <databasename>.

Каждый последующий вызов fbsql_query() будет делаться с активной БД.

Если БД защищена паролем базы данных, пользователь обязан вызывать fbsql_database_password() перед выбором БД.

См. также fbsql_connect(), fbsql_pconnect(), fbsql_database_password() и fbsql_query().

fbsql_set_lob_mode

(PHP 4 >= 4.2.0)

fbsql_set_lob_mode - устанавливает режим запроса LOB для результирующего набора FrontBase.

Описание

bool fbsql_set_lob_mode (resource result, string database_name)

Возвращает TRUE при успехе, FALSE при ошибке.

fbsql_set_lob_mode() устанавливает режим запроса LOB-данных из БД. Когда BLOB и CLOB-данные хранятся во FrontBase, они могут храниться непосредственно или косвенно. Непосредственно хранящиеся LOB-данные всегда будут извлекаться вне зависимости от установок режима lob. Если LOB-данные менее 512 байт, они всегда будут храниться непосредственно.

FBSQL_LOB_DIRECT - LOB-данные запрашиваются непосредственно. Если данные извлекаются из БД функцией fbsql_fetch_row() и другими fetch-функциями, все CLOB и BLOB-столбцы будут возвращены как обычные столбцы. Это значение по умолчанию нового результата FrontBase.

FBSQL_LOB_HANDLE - LOB-данные запрашиваются как дескрипторы данных. Когда данные извлекаются из БД с помощью функции fbsql_fetch_row () и других fetch-функций, LOB-данные будут возвращены как дескриптор данных, если эти данные хранятся косвенно, или как сами данные, если хранятся непосредственно. Если возвращается дескриптор, он будет 27-байтной строкой в формате "@'000000000000000000000000'".

См. также fbsql_create_blob(), fbsql_create_clob(), fbsql_read_blob() и fbsql_read_clob().

fbsql_set_transaction

(PHP 4 >= 4.2.0)

fbsql_set_transaction - устанавливает блокировку и изоляцию транзакции.

Описание

void fbsql_set_transaction (resource link_identifier, int Locking, int Isolation)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

fbsql_start_db

(PHP 4 >= 4.0.6)

fbsql_start_db - стартует БД на локальном или удалённом сервере.

Описание

bool fbsql_start_db (string database_name [, resource link_identifier])

Возвращает TRUE при успехе, FALSE при неудаче.

См. также: fbsql_db_status() и fbsql_stop_db().

fbsql_stop_db

(PHP 4 >= 4.0.6)

fbsql_stop_db - останавливает БД на локальном или удалённом сервере.

Описание

bool fbsql_stop_db (string database_name [, resource link_identifier])

Возвращает TRUE при успехе, FALSE при неудаче.

См. также: fbsql_db_status() и fbsql_start_db().

fbsql_tablename

(PHP 4 >= 4.2.0)

fbsql_tablename - получает имя таблицы поля.

Описание

string fbsql_tablename (resource result, int i)

fbsql_tablename() берёт результирующий указатель, возвращаемый функцией fbsql_list_tables(), а также целочисленный индекс, и возвращает имя таблицы. Функция fbsql_num_rows() может использоваться для определения количества таблиц в результирующем указателе.

fbsql_username

(PHP 4 >= 4.0.6)

fbsql_username - получает или устанавливает пользователя хоста, используемого в соединении.

Описание

string fbsql_username (resource link_identifier [, string username])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

fbsql_warnings

(PHP 4 >= 4.0.6)

fbsql_warnings - включает или отключает предупреждения FrontBase.

Описание

bool fbsql_warnings ([bool OnOff])

Возвращает TRUE, если предупреждения включены, иначе FALSE.

fbsql_warnings() включает или отключает предупреждения FrontBase.

fclose

(PHP 3, PHP 4 )

fclose - закрывает открытый указатель файла.

Описание

bool fclose (int fp)

Закрывается файл, на который указывает fp.

Возвращает TRUE при успехе, FALSE при неудаче.

Указатель файла обязан быть правильным и обязан указывать на файл, успешно открытый функцией fopen() или fsockopen().

fdf_add_template

(PHP 3>= 3.0.13, PHP 4 )

fdf_add_template - добавляет шаблон/template в FDF-документ.

Описание

bool fdf_add_template (int fdfdoc, int newpage, string filename, string template, int rename)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

fdf_close

(PHP 3>= 3.0.6, PHP 4)

fdf_close - закрывает FDF-документ.

Описание

bool fdf_close (int fdf_document)

Функция fdf_close() закрывает FDF-документ.

См. также fdf_open().

fdf_create

(PHP 3>= 3.0.6, PHP 4)

fdf_create - создаёт новый FDF-документ.

Описание

int fdf_create (void)

fdf_create() создаёт новый FDF-документ. Эта функция нужна, если необходимо заполнить поля ввода FDF-документа данными.

fdf_get_file

(PHP 3>= 3.0.6, PHP 4)

fdf_get_file - получает значение ключа /F.

Описание

string fdf_get_file (int fdf_document)

fdf_set_file() возвращает значение ключа /F.

См. также fdf_set_file().

fdf_get_status

(PHP 3>= 3.0.6, PHP 4)

fdf_get_status - получает значение ключа /STATUS.

Описание

string fdf_get_status (int fdf_document)

fdf_get_status() возвращает значение ключа /STATUS.

См. также fdf_set_status().

fdf_get_value

(PHP 3>= 3.0.6, PHP 4)

fdf_get_value - получает значение поля.

Описание

string fdf_get_value (int fdf_document, string fieldname)

Функция fdf_get_value() возвращает значение поля.

См. также fdf_set_value().

fdf_next_field_name

(PHP 3>= 3.0.6, PHP 4)

fdf_next_field_name - получает имя следующего поля.

Описание

string fdf_next_field_name (int fdf_document [, string fieldname])

fdf_next_field_name() возвращает имя поля, идущего после поля в fieldname, или имя поля первого поля, если второй параметр NULL.

См. также fdf_set_value(), fdf_get_value().

fdf_open

(PHP 3>= 3.0.6, PHP 4 )

fdf_open - открывает FDF-документ.

Описание

int fdf_open (string filename)

fdf_open() открывает файл с данными формы. Этот файл обязан содержать данные, возвращённые из PDF-формы. В настоящее время этот файл создаётся 'вручную' с помощью fopen() и последующей записи в него содержимого HTTP_FDF_DATA с помощью fwrite(). Этот механизм напоминает данные HTML-формы, где для каждого поля ввода создаётся переменная.

fdf_save

(PHP 3>= 3.0.6, PHP 4 )

fdf_save - сохраняет FDF-документ.

Описание

int fdf_save (string filename)

fdf_save() сохраняет FDF-документ. FDF Toolkit предоставляет средства для вывода документа в stdout, если параметр filename имеет значение '.'. Это не работает, если PHP используется как Аpache-модуль. В этом случае нужно записать в файл и использовать, например, fpassthru() для вывода.

См. также fdf_close() и пример для fdf_create().

fdf_set_ap

(PHP 3>= 3.0.6, PHP 4)

fdf_set_ap - устанавливает вид поля.

Описание

bool fdf_set_ap ( int fdf_document, string field_name, int face, string filename, int page_number)

Функция fdf_set_ap() устанавливает вид поля (т.е. значение ключа /AP). Возможные значения face это: 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP.

fdf_set_encoding

(PHP 4 >= 4.1.0)

fdf_set_encoding - устанавливает кодировку символов FDF.

Описание

bool fdf_set_encoding (int fdf_document, string encoding)

fdf_set_encoding() устанавливает кодировку символов FDF-документа fdf_document.
encoding должно быть правильным именем кодировки. Правильными значениями кодировки в Acrobat 5.0 являются "Shift-JIS", "UHC", "GBK", "BigFive".

fdf_set_encoding() доступна, начиная с версии PHP 4.1.0 и далее.

fdf_set_file

(PHP 3>= 3.0.6, PHP 4 )

fdf_set_file - устанавливает значение ключа /F.

Описание

bool fdf_set_file (int fdf_document, string filename)

fdf_set_file() устанавливает значение ключа /F. Ключ /F это просто ссылка на PDF-форму, заполняемую данными. В web-окружении это URL (например, http:/testfdf/resultlabel.pdf).

См. также fdf_get_file() и пример для fdf_create().

fdf_set_flags

(PHP 4 >= 4.0.2)

fdf_set_flags - устанавливает флаги поля.

Описание

bool fdf_set_flags (int fdf_document, string fieldname, int whichFlags, int newFlags)

fdf_set_flags() устанавливает определённые флаги данного поля fieldname.

См. также fdf_set_opt().

fdf_set_javascript_action

(PHP 4 >= 4.0.2)

fdf_set_javascript_action - устанавливает акцию javascript поля.

Описание

bool fdf_set_javascript_action (int fdf_document, string fieldname, int trigger, string script)

fdf_set_javascript_action() устанавливает акцию javascript для данного поля fieldname.

См. также fdf_set_submit_form_action().

fdf_set_opt

(PHP 4 >= 4.0.2)

fdf_set_opt - устанавливает опцию поля.

Описание

bool fdf_set_opt (int fdf_document, string fieldname, int element, string str1, string str2)

fdf_set_opt() устанавливает опцию данного поля fieldname.

См. также fdf_set_flags().

fdf_set_status

(PHP 3>= 3.0.6, PHP 4)

fdf_set_status - устанавливает значение ключа /STATUS.

Описание

bool fdf_set_status (int fdf_document, string status)

fdf_set_status() устанавливает значение ключа /STATUS.

См. также fdf_get_status().

fdf_set_submit_form_action

(PHP 4 >= 4.0.2)

fdf_set_submit_form_action - устанавливает акцию submit формы для данного поля.

Описание

bool fdf_set_submit_form_action (int fdf_document, string fieldname, int trigger, string script, int flags)

fdf_set_submit_form_action() устанавливает акцию submit формы для данного поля fieldname.

См. также fdf_set_javascript_action().

fdf_set_value

(PHP 3>= 3.0.6, PHP 4)

fdf_set_value - устанавливает значение  поля.

Описание

bool fdf_set_value (int fdf_document, string fieldname, string value, int isName)

Функция fdf_set_value() устанавливает значение  поля. Последний параметр определяет, конвертируется ли значение поля в PDF Name (isName = 1) или устанавливается в PDF String (isName = 0).

См. также fdf_get_value().

feof

(PHP 3, PHP 4)

feof - проверяет end-of-file/конец файла указателя файла.

Описание

int feof ( int fp)

Возвращает TRUE, если указатель файла находится в точке EOF или возникла ошибка; иначе возвращает FALSE.

Указатель файла обязан быть правильным и указывать на файл, успешно открытый функциями fopen(), popen() или fsockopen().

fflush

(PHP 4 >= 4.0.1)

fflush - очищает и выводит в файл.

Описание

int fflush (int fp)

Эта функция форсирует запись всего буферизованного вывода в  ресурс, на который указывает дескриптор fp. Возвращает TRUE при успехе, FALSE - в ином случае.

Указатель файла обязан быть правильным и указывать на файл, успешно открытый функциями fopen(), popen() или fsockopen().

fgetc

(PHP 3, PHP 4)

fgetc - получает символ из указателя файла.

Описание

string fgetc (int fp)

Возвращает строку, содержащую символ, прочитанный из файла, на который указывает fp. Возвращает FALSE, если EOF.

Указатель файла обязан быть правильным и указывать на файл, успешно открытый функциями fopen(), popen() или fsockopen().

См. также fread(), fopen(), popen(), fsockopen() и fgets().

fgetcsv

(PHP 3>= 3.0.8, PHP 4)

fgetcsv - получает строку из указателя файла и разбирает её на CSV-поля.

Описание

array fgetcsv (int fp, int length [, string delimiter [, string enclosure]])

Работает, как и fgets(), но fgetcsv() разбирает строку на поля в формате CSV и возвращает массив, содержащий прочитанные поля. Разделителем полей является запятая, если вы не специфицировали другой разделитель в необязательном третьем параметре. Символ-ограничитель enclosure это двойная кавычка, если иной не специфицирован. Delimiter и enclosure не могут быть null, и при их спецификации используется только первый значащий символ.

Fp обязан быть правильным указателем на файл, успешно открытый функциями fopen(), popen() или fsockopen().

Length обязан быть больше самой длинной строки, найденной в CSV-файле (что даёт возможность вставить ведомые символы конца строки).

fgetcsv() возвращает FALSE при ошибке, включая конец файла.

Примечание: пустая строка в CSV-файле возвратится как массив из единственного NULL-поля и не будет считаться ошибкой.

enclosure введён в PHP 4.3.0.

fgets

(PHP 3, PHP 4)

fgets - получает строку из указателя на файл.

Описание

string fgets (int fp [, int length])

Возвращает строку размером длина строки - 1 байт, прочитанную из файла, на который указывает fp. Чтение заканчивается при достижении точки length - 1 байт, символа newline (который включается в return-значение) или EOF (смотря что будет найдено первым). Если length не специфицирован, по умолчанию length будет 1k, или 1024 байт.

Если возникла ошибка, возвращает FALSE.

Обычные недочёты:

Те, кто использует семантику 'C' с функцией fgets(), должны учитывать отличия при возвращении EOF.

Указатель на файл обязан быть правильным и указывать на файл, успешно открытый функциями fopen(), popen() или fsockopen().

Вот простой пример:

fgetss

(PHP 3, PHP 4)

fgetss - получает строку из указателя на файл и вырезает тэги HTML.

Описание

string fgetss (int fp, int length [, string allowable_tags])

Идентична fgets(), но fgetss пытается вырезать любые тэги HTML и PHP из текста.

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

Примечание: allowable_tags был введён в PHP 3.0.13, PHP 4.0.0.

См. также fgets(), fopen(), fsockopen(), popen() и strip_tags().

file

(PHP 3, PHP 4)

file - читает весь файл в массив.

Описание

array file (string filename [, int use_include_path])

Идентична readfile(), но file() возвращает файл в виде массива. Каждый элемент массива соответствует строке файла с символом newline.

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

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

file_exists

(PHP 3, PHP 4)

file_exists - проверяет, существует ли файл.

Описание

bool file_exists (string filename)

Возвращает TRUE, если файл, специфицированный параметром filename, существует; FALSE в ином случае.

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера

Результаты работы этой функции кэшируются. См. clearstatcache().

В windows используйте "//computername/share/filename" или "\\\\computername\share\filename" для проверки файлов, совместно используемых в сети.

file_get_contents

(только PHP 4 CVS)

file_get_contents - читает весь файл в строку.

Описание

string file_get_contents (string filename [, int use_include_path])

Идентична readfile(), но file_get_contents() возвращает файл в строке.

Примечание: эта функция была введена в PHP 4.3.0.

Примечание: эта функция является binary-safe.

Подсказка: вы можете использовать URL в качестве с этой функцией, если "fopen-оболочки" включены. См. fopen().

См. также fgets(), file(), fread(), include() и readfile().

file_register_wrapper

(только PHP 4 CVS)

file_register_wrapper - регистрирует оболочку URL, реализованную как PHP-класс.

Описание

boolean file_register_wrapper (string protocol, string classname)

Эта функция задокументирована в настоящее время только следующим примером:

Пример 1. Реализация протокола шифрования base64

file_get_wrapper_data

(только PHP 4 CVS)

file_get_wrapper_data - запрашивает header/meta-данные из "обёрнутых" указателей на файлы.

Описание

mixed file_get_wrapper_data (int fp)

Эта функция возвращает header- или meta-данные из файлов, открытых функцией fopen(). Это используется для возвращения header'ов ответа для HTTP-соединений или для статистики некоторых других ресурсов.

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

Примечание: эта функция была введена в PHP 4.3.0.

fileatime

(PHP 3, PHP 4)

fileatime - получает время последнего доступа к файлу.

Описание

int fileatime (string filename)

Возвращает время последнего доступа к файлу или FALSE - при возникновении ошибки. Время возвращается как Unix timestamp.

Результаты работы этой функции кэшируются. См. clearstatcache().

Примечание: atime файла изменяется, когда читаются блоки данных файла. Это может быть довольно затратно, если приложение регулярно выполняет доступ к большому количеству файлов и директорий. Некоторые файловые системы Unix могут монтироваться с отключенными обновлениями atime для увеличения производительности таких приложений; спулы новостей USENET  - обычный пример. В таких файловых системах эта функция будет бесполезна.

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

filectime

(PHP 3, PHP 4)

filectime - получает inode-вермя изменения файла.

Описание

int filectime (string filename)

Возвращает время последнего изменения файла или FALSE - при возникновении ошибки. Время возвращается как Unix timestamp.

Результаты работы этой функции кэшируются. См. clearstatcache().

Примечание: в большинстве систем Unix файл считается изменённым, когда изменены его inode-данные; то есть, когда permissions, owner, group или другие метаданные из inode обновились. См. также filemtime() (которую вы, возможно, будете использовать, если захотите создать футэр "Last Modified" на web-странице) и fileatime().

Заметьте также, что в некоторых текстах Unix ctime файла называется временем создания файла. Это неверно. В большинстве Unix-систем нет времени создания Unix-файлов.

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера.

filegroup

(PHP 3, PHP 4)

filegroup - получает группу файла.

Описание

int filegroup (string filename)

Возвращает group ID владельца файла или FALSE в случае ошибки.
group ID возвращается в числовом формате; используйте posix_getgrgid() для разрешения его в group name.

Результаты работы этой функции кэшируются. См. clearstatcache().

Примечание: эта функция не реализована для платформ Windows.

Примечание: эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера.

fileinode

(PHP 3, PHP 4)

fileinode - получает inode файла.

Описание

int fileinode (string filename)

Возвращает inode-число файла или FALSE - в случае ошибки.

Результаты работы этой функции кэшируются. См. clearstatcache().

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера.

Примечание: эта функция не реализована для платформ Windows.

filemtime

(PHP 3, PHP 4)

filemtime - получа6т время изменения файла.

Описание

int filemtime (string filename)

Возвращает время последнего изменения файла или FALSE - в случае ошибки. Время возвращается как Unix timestamp.

Результаты работы этой функции кэшируются. См. clearstatcache().

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера.

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

См. также filectime() и touch().

fileowner

(PHP 3, PHP 4)

fileowner - получает владельца файла.

Описание

int fileowner (string filename)

Возвращает user ID владельца файла или FALSE - в случае ошибки.
user ID возвращается в числовом формате; используйте posix_getpwuid() для разрешения его в username.

Результаты работы этой функции кэшируются. См. clearstatcache().

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера.

Примечание: эта функция не реализована для платформ Windows.

fileperms

(PHP 3, PHP 4)

fileperms - получает права доступа к файлу.

Описание

int fileperms (string filename)

Возвращает права доступа к файлу или FALSE - в случае ошибки.

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл должен быть доступен через файловую систему сервера.

Результаты работы этой функции кэшируются.

См. clearstatcache().

filepro

(PHP 3, PHP 4)

filepro - читает и проверяет файл карты/map file.

Описание

bool filepro (string directory)

Читает и проверяет файл карты, хранящий количество полей и информацию.

Блокировка не выполняется, поэтому вы должны исключить модификацию ваше БД filePro, когда она может быть открыта в PHP.

Примечание: если safe mode включён, PHP проверяет, имеют ли файл(-ы)/директории, с которыми вы намереваетесь работать, тот же UID, что и выполняемый скрипт.

filepro_fieldcount

(PHP 3, PHP 4)

filepro_fieldcount - определяет, сколько полей имеется в БД filePro.

Описание

int filepro_fieldcount (void)

Возвращает количество полей (столбцов) в открытой БД filePro.

См. также filepro().

filepro_fieldname

(PHP 3, PHP 4)

filepro_fieldname - получает имя поля.

Описание

string filepro_fieldname (int field_number)

Возвращает имя поля, соответствующего field_number.

filepro_fieldtype

(PHP 3, PHP 4)

filepro_fieldtype - получает тип поля.

Описание

string filepro_fieldtype (int field_number)

Возвращает тип поля, соответствующего field_number.

filepro_fieldwidth

(PHP 3, PHP 4)

filepro_fieldwidth - ширину поля.

Описание

int filepro_fieldwidth (int field_number)

Возвращает ширину поля, соответствующего field_number.

filepro_retrieve

(PHP 3, PHP 4)

filepro_retrieve - запрашивает данные из БД filePro.

Описание

string filepro_retrieve (int row_number, int field_number)

Возвращает данные из специфицированного места в БД.

Примечание: если safe mode включён, PHP проверяет, имеют ли файл(-ы)/директории, с которыми вы намереваетесь работать, тот же UID, что и выполняемый скрипт.

filepro_rowcount

(PHP 3, PHP 4)

filepro_rowcount - определяет, сколько рядов имеется в БД filePro.

Описание

int filepro_rowcount (void)

Возвращает количество рядов в открытой БД filePro.

Примечание: если safe mode включён, PHP проверяет, имеют ли файл(-ы)/директории, с которыми вы намереваетесь работать, тот же UID, что и выполняемый скрипт.

См. также filepro().

filesize

(PHP 3, PHP 4)

filesize - получает размер файла.

Описание

int filesize (string filename)

Возвращает размер файла в байтах или FALSE - в случае ошибки.

Результаты работы этой функции кэшируются. См. clearstatcache().

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл обязан быть доступен через файловую систему сервера.

filetype

(PHP 3, PHP 4)

filetype - получает тип файла.

Описание

string filetype (string filename)

Возвращает тип файла. Возможные значения: fifo, char, dir, block, link, file и unknown.

Возвращает FALSE при ошибке.

Результаты работы этой функции кэшируются. См. clearstatcache().

Эта функция не будет работать с remote/удалёнными файлами; проверяемый файл обязан быть доступен через файловую систему сервера.

См. также is_dir(), is_file(), is_link(), file_exists() и stat().

floatval

(PHP 4 >= 4.2.0)

floatval - получает значение переменной - число с плавающей точкой (float).

Описание

float floatval (mixed var)

Возвращает float-значение переменной var.

Var может быть любым скалярным типом. Вы не можете использовать floatval() с массивами или объектами.

$var = '122.34343The';
$float_value_of_var = floatval ($var);
print $float_value_of_var; // печатает 122.34343

См. также intval(), strval(), settype() и Трюки с типами.

flock

(PHP 3>= 3.0.7, PHP 4)

flock - переносимое "совещательное/advisory" блокирование файлов.

Описание

bool flock (int fp, int operation [, int &wouldblock])

PHP поддерживает перенос блокированных файлов advisory-способом (что означает, что все программы, выполняющие доступ, должны использовать тот же способ блокирования, или блокировка работать не будет).

flock() работает с fp, который обязан быть открытым указателем на файл.
operation имеет одно из следующих значений:

Для получения shared-блокировки (reader) установите в operation значение LOCK_SH (установите 1 в версиях до PHP 4.0.1).

Для получения исключительной/exclusive блокировки (writer) установите в operation значение LOCK_EX (установите 2 в версиях до PHP 4.0.1).

Для освобождения блокировки (shared или exclusive) установите в operation значение LOCK_UN (3 в версиях до PHP 4.0.1).

Если вы не хотите, чтобы flock() блокировала, добавьте LOCK_NB (4 в версиях до PHP 4.0.1) в operation.

flock() позволяет реализовать простую модель reader/writer, которая может использоваться на практически любой платформе (включая большинство клонов Unix и даже Windows). Необязательный третий аргумент устанавливается в TRUE, если блокировка возможна (EWOULDBLOCK errno condition).

flock() возвращает TRUE при успехе и FALSE при ошибке (например, когда блокировка не может быть получена).

Примечание: поскольку flock() требует указателя на файл, вам может понадобиться использовать специальную блокировку файла для предотвращения доступа к файлу, который вы намереваетесь усечь в режиме write (с аргументом "w" или "w+" для fopen()).

Предупреждение!flock() не будет работать в NFS и многих других сетевых файловых системах. См. в вашей документации по ОС детальную информацию.

В некоторых ОС flock() реализуется на уровне процесса. При использовании API многопоточного сервера типа ISAPI вы не сможете рассчитывать на flock() для защиты файлов относительно других PHP-скриптов, запущенных в параллельных потоках в том же самом экземпляре сервера!

flock() не поддерживается на старинных файловых системах вроде FAT и их клонах и, следовательно, всегда возвращает FALSE в такой среде (это также верно для пользователей Windows 98).

floor

(PHP 3, PHP 4)

floor - округляет дроби в сторону уменьшения.

Описание

float floor (float value)

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

flush

(PHP 3, PHP 4)

flush - очищает буфер вывода.

Описание

void flush (void)

Очищает буфер вывода PHP и всё используемое PHP (CGI, web-сервер и т.д.). Она активно пытается выдать весь вывод в браузер пользователя.

Примечание: flush() не действует на схему буферизации вашего web-сервера или браузера - на стороне клиента.

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

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

Даже браузер может буферизовать свой ввод до отображения. Netscape, например, буферизует текст, пока не получит end-of-line или начало тэга, и не будет отображать таблицы, пока не увидит тэга </table> самой внешней таблицы.

Некоторые версии Microsoft Internet Explorer начинают отображать страницу только после получения 256 байт вывода, поэтому вам может понадобиться отправить дополнительные пробелы перед очисткой, чтобы такие браузеры вывели страницу.

fopen

(PHP 3, PHP 4)

fopen - открывает файл или URL.

Описание

int fopen (string filename, string mode [, int use_include_path])

Если 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-ресурс.

Версии до 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+' - Открыть для чтения и записи; поместить указатель в конец файла. Если файл не существует, делается попытка создать его.

Примечание: mode может содержать букву 'b'. Это используется только в системах, различающих двоичные и текстовые файлы (т.е. в Windows. В Unix это бесполезно). Если не нужен, он игнорируется.

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

fpassthru

(PHP 3, PHP 4)

fpassthru - выводит все оставшиеся в файловом указателе данные.

Описание

int fpassthru (int fp)

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

Если возникла ошибка, fpassthru() возвращает FALSE.

Указатель файла обязан быть правильным и указывать на файл, успешно открытый функцией fopen(), popen() или fsockopen(). Вам может потребоваться вызов rewind() для возвращения указателя в начало файла, если вы уже записывали данные в файл. Файл закрывается, когда fpassthru() закончила его чтение (без использования fp).

Если вы просто хотите сбросить содержимое файла в stdout, вы можете использовать readfile(), которая сохраняет всё для вызова fopen().

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

См. также readfile(), fopen(), popen() и fsockopen().

fputs

(PHP 3, PHP 4)

fputs - записывает в указатель файла.

Описание

int fputs (int fp, string str [, int length])

fputs() это псевдоним fwrite(), идентичный во всём. Заметьте, что параметр length является необязательным и, если не специфицирован, записывается вся строка.

fread

(PHP 3, PHP 4)

fread - Binary-safe чтение файла.

Описание

string fread (int fp, int length)

fread() читает length байт из указателя файла, на который ссылается fp. Чтение останавливается, если прочитано length байт или если достигнут EOF (конец файла), смотря что вперёд.

FrenchToJD

(PHP 3, PHP 4)

FrenchToJD - конвертирует данные из Французского республиканского календаря в Юлианское летосчисление.

Описание

int frenchtojd (int month, int day, int year)

Конвертирует данные из Французского республиканского календаря в Юлианское летосчисление.

Эти утилиты конвертируют только даты лет с 1 до 14 (григорианские даты с 22 сентября 1792 до 22 сентября 1806). Это перекрывает период использования этого календаря.

fribidi_log2vis

(PHP 4 >= 4.0.4)

fribidi_log2vis - конвертирует логическую строку в визуальную.

Описание

string fribidi_log2vis (string str, string direction, int charset)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

  Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

fscanf

(PHP 4 >= 4.0.1)

fscanf - разьирает ввод из файла в соответствии с форматом.

Описание

mixed fscanf (int handle, string format [, string var1])

Функция fscanf() похожа на sscanf(), но принимает ввод из файла, ассоциированного с дескриптором handle, и интерпретирует ввод в соответствии со специфицированным форматом format. Если функции переданы только два параметра, разобранные значения будут возвращаться как массив. Иначе, если передаются необязательные параметры, эта функция возвратит количество присвоенных значений. Необязательные параметры обязаны передаваться по ссылке.

Любой пробел в строке формата совпадает с пробелом в потоке ввода. Это означает, что даже tab \n в строке формата может совпадать с одиночным пробельным символом в потоке ввода.

fseek

(PHP 3, PHP 4)

fseek - ищет позицию указателя файла.

Описание

int fseek (int fp, int offset [, int whence])

Устанавливает индикатор позиции указателя файла, на который ссылается fp. Новая позиция высчитанная в байтах от начала файла, получается путём прибавления смещения offset к позиции, специфицированной параметром whence, значения которого определены так: SEEK_SET - Установить позицию, равной смещению offset байтов. SEEK_CUR - Установить позицию - текущее положение плюс offset. SEEK_END - Установить позицию - end-of-file плюс offset. (Чтобы поместить позицию перед end-of-file, необходимо передать в offset отрицательное значение.)

Если whence не специфицирован, принимается значение SEEK_SET.

При успехе возвращает 0; иначе возвращает -1. Обратите внимание, что поиск после EOF не считается ошибкой.

Не может использоваться с файловыми указателями, возвращаемыми функцией fopen(), если они используют форматы "http://" или "ftp://".

Примечание: аргумент whence был введён после PHP 4.0.0.

См. также ftell() и rewind().

fsockopen

(PHP 3, PHP 4)

fsockopen - открывает сокет соединения домена Internet или Unix.

Описание

int fsockopen (string hostname, int port [, int errno [, string errstr [, float timeout]]])

Инициирует поточное соединение в домене Internet (AF_INET, используя TCP или UDP) или Unix (AF_UNIX). Для домена Internet открывает сокет соединения TCP с hostname через порт port.
hostname может быть в этом случае либо полным квалифицированным именем домена, либо IP-адресом. Для UDP необходимо явно специфицировать протокол путём добавления к hostname префикса 'udp://'.
Для домена Unix - hostname будет использоваться как путь к сокету , port обязан быть установлен 0 в этом случае. Необязательный timeout может использоваться для установки таймаута в секундах для системного вызова connect.

В PHP 4.3.0, если вы скомпилируете с поддержкой OpenSSL, вы сможете вводить для hostname префикс 'ssl://' или 'tls://', для использования SSL, или соединение TLS-клиента через TCP/IP для подключения к удалённому хосту.

fsockopen() возвращает указатель файла, который может использоваться другими функциями (такими как fgets(), fgetss(), fputs(), fclose() и feof()).

Если вызов терпит неудачу, возвращается FALSE и, если необязательные аргументы errno и errstr имеются, они получат установки, указывающие фактический уровень системной ошибки, возникшей при вызове connect() системного уровня. Если в errno возвращено значение 0 и функция возвращает FALSE, это указывает на то, что ошибка возникла до вызова connect(). Вероятнее всего это произошло из-за проблем инициализации сокета. Заметьте, что аргументы errno и errstr всегда будут передаваться по ссылке.

В зависимости от окружения, домен Unix или необязательный таймаут соединения могут быть недоступны.

Сокет может быть по умолчанию открыт в блокирующем/blocking режиме. Вы можете переключиться в не-блокирующий режим с помощью socket_set_blocking().

Пример 1. fsockopen()
<?php
$fp = fsockopen ("www.example.com", 80, $errno, $errstr, 30);
if (!$fp) {
echo "$errstr ($errno)<br>\n";
} else {
fputs ($fp, "GET / HTTP/1.0\r\nHost: www.example.com\r\n\r\n");
while (!feof($fp)) {
echo fgets ($fp,128);
}
fclose ($fp);
}
?>

Следующий пример показывает, как запросить день и время из "daytime" (port 13) UDP-сервиса на вашей собственной машине.

fstat

(PHP 4)

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

Описание

array fstat (int fp)

Получает статистическую информацию о файле, открытом файловым указателем fp. Эта функция аналогична stat(), но работает с открытым указателем файла, а не с именем файла.

Возвращает массив со статистикой файла - следующими элементами:

    device/устройство

    inode

    количество ссылок

    user id владельца

    group id владельца

    тип устройства, если inode device *

    размер в байтах

    время последнего доступа

    время последней модификации

    время последнего изменения

    размер блока для filesystem I/O *

    количество занимаемых блоков

* - верно только для систем, поддерживающих тип st_blksize — другие системы (Windows) возвращают -1.

Результаты работы этой функции кэшируются. См. clearstatcache().

ftell

(PHP 3, PHP 4)

ftell - сообщает позицию read/write указателя файла.

Описание

int ftell (int fp)

Возвращает позицию указателя файла, на который ссылается fp; т.е. - его смещение в потоке файла.

Если возникает ошибка, возвращает FALSE.

Указатель файла обязан быть правильным и указывать на файл, успешно открытый функциями fopen() или popen().

См. также fopen(), popen(), fseek() и rewind().

ftok

(PHP 4 >= 4.2.0)

ftok - конвертирует pathname и идентификатор проекта в System V IPC-ключ.

Описание

int ftok (string pathname, string proj)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

ftp_cdup

(PHP 3>= 3.0.13, PHP 4)

ftp_cdup - переходит в родительскую директорию.

Описание

bool ftp_cdup (resource ftp_stream)

Переходит в родительскую директорию.

Возвращает TRUE при успехе, FALSE - при ошибке.

ftp_chdir

(PHP 3>= 3.0.13, PHP 4)

ftp_chdir - меняет директорию на FTP-сервере.

Описание

bool ftp_chdir (resource ftp_stream, string directory)

Переходит в специфицированную directory.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_close

(PHP 4 >= 4.2.0)

ftp_close - закрывает FTP-соединение.

Описание

void ftp_close (resource ftp_stream)

Примечание: эта функция доступна только в  CVS.

ftp_close() закрывает ftp_stream и высвобождает ресурс. Вы не можете повторно использовать этот ресурс, а должны создать новый с помощью ftp_connect().

ftp_connect

(PHP 3>= 3.0.13, PHP 4)

ftp_connect - открывает FTP-соединение.

Описание

resource ftp_connect (string host [, int port [, int timeout]])

Возвращает поток FTP при успехе, FALSE при ошибке.

ftp_connect() открывает FTP-соединение со специфицированным host. Параметр port специфицирует альтернативный порт. Если он опущен или нулевой, по умолчанию будет использован FTP-порт 21.

Параметр timeout специфицирует таймаут для всех последующих сетевых операций. Если опущен, значение по умолчанию будет 90 секунд. Таймаут можно изменить и запросить в любой момент функциями ftp_set_option() и ftp_get_option().

Примечание: этот параметр доступен только в CVS.

ftp_delete

(PHP 3>= 3.0.13, PHP 4)

ftp_delete - удаляет файл на FTP-сервере.

Описание

bool ftp_delete (resource ftp_stream, string path)

ftp_delete() удаляет файл, специфицированный в path, с FTP-сервера.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_exec

(PHP 4 >= 4.0.3)

ftp_exec - запрашивает выполнение программы на FTP-сервере.

Описание

bool ftp_exec (resource ftp_stream, string command)

Отправляет запрос SITE EXEC command на FTP-сервер. Возвращает FALSE, ели запрос терпит неудачу, иначе возвращает вывод команды.

ftp_fget

(PHP 3>= 3.0.13, PHP 4)

ftp_fget - загружает файл с FTP-сервера и сохраняет его в открытом файле.

Описание

bool ftp_fget (resource ftp_stream, resource fp, string remote_file, int mode)

ftp_fget() запрашивает remote_file с FTP-сервера и записывает его в данный указатель файла fp. Режим переноса mode обязан быть FTP_ASCII или FTP_BINARY.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_fput

(PHP 3>= 3.0.13, PHP 4)

ftp_fput - загружает из открытого файла на FTP-сервер.

Описание

bool ftp_fput (resource ftp_stream, string remote_file, resource fp, int mode)

ftp_fput() загружает данные из файлового указателя fp до конца файла. Результаты хранятся в remote_file на FTP-сервере. Режим mode обязан быть FTP_ASCII или FTP_BINARY.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_get

(PHP 3>= 3.0.13, PHP 4)

ftp_get - загружает файл с FTP-сервера.

Описание

bool ftp_get (resource ftp_stream, string local_file, string remote_file, int mode)

ftp_get() запрашивает remote_file с FTP-сервера и сохраняет его в local_file локально. Режим трансфера mode обязан быть FTP_ASCII или FTP_BINARY.

Возвращает TRUE при успехе, FALSE при ошибке.

См. также ftp_fget().

ftp_get_option

(PHP 4 >= 4.2.0)

ftp_get_option - запрашивает различное поведение на этапе прогона текущего потока FTP.

Описание

mixed ftp_get_option (resource ftp_stream, int option)

Примечание: эта функция доступна только в CVS.

Возвращает значение при успехе или FALSE, если данная option не поддерживается. В последнем случае выдаётся также предупреждение.

Эта функция возвращает значение запрошенной опции option из специфицированного потока ftp_stream. В настоящее время (июнь 2002) поддерживаются следующие опции:

Таблица 1. Поддерживаемые опции FTP времени выполнения
FTP_TIMEOUT_SEC Возвращает текущий таймаут, используемый для связанных сетевых операций.

ftp_login

(PHP 3>= 3.0.13, PHP 4)

ftp_login - логин в FTP-соединение.

Описание

bool ftp_login (resource ftp_stream, string username, string password)

В ходит в данный поток FTP.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_mdtm

(PHP 3>= 3.0.13, PHP 4)

ftp_mdtm - возвращает время последней модификации данного файла.

Описание

int ftp_mdtm (resource ftp_stream, string remote_file)

ftp_mdtm() проверяет время last-modified данного файла и возвращает его как UNIX timestamp. Если возникает ошибка или файл не существует, возвращается -1. Заметьте, что не все серверы поддерживают эту возможность.

Возвращает UNIX при успехе или -1 при ошибке.

Примечание: ftp_mdtm() не работает с директориями.

ftp_mkdir

(PHP 3>= 3.0.13, PHP 4)

ftp_mkdir - создаёт директорию/каталог.

Описание

string ftp_mkdir (resource ftp_stream, string directory)

Создаёт специфицированную directory.

Возвращает имя вновь созданной директории при успехе, FALSE - при ошибке.

ftp_nlist

(PHP 3>= 3.0.13, PHP 4)

ftp_nlist - возвращает список файлов в данной директории.

Описание

array ftp_nlist (resource ftp_stream, string directory)

Возвращает массив из имён файлов, находящихся в специфицированной директории (при успехе), FALSE при ошибке.

ftp_pasv

(PHP 3>= 3.0.13, PHP 4)

ftp_pasv - включает выключает пассивный режим/passive mode.

Описание

bool ftp_pasv (resource ftp_stream, bool pasv)

ftp_pasv() включает passive mode, если параметр pasv имеет значение TRUE (выключает, если pasv FALSE). В пассивном режиме соединения данных инициируются клиентом, а не сервером.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_put

(PHP 3>= 3.0.13, PHP 4)

ftp_put - выгружает файл на FTP-сервер.

Описание

bool ftp_put (resource ftp_stream, string remote_file, string local_file, int mode)

ftp_put() сохраняет файл local_file на FTP-сервере как remote_file. Режим переноса mode обязан быть FTP_ASCII или FTP_BINARY.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_pwd

(PHP 3>= 3.0.13, PHP 4)

ftp_pwd - возвращает имя текущей директории.

Описание

string ftp_pwd (resource ftp_stream)

Возвращает имя текущей директории или FALSE (при ошибке).

ftp_quit

(PHP 3>= 3.0.13, PHP 4)

ftp_quit - закрывает FTP-соединение.

Описание

void ftp_quit (resource ftp_stream)

ftp_quit() это псевдоним ftp_close().

ftp_rawlist

(PHP 3>= 3.0.13, PHP 4)

ftp_rawlist - возвращает детальный список файлов в данной директории.

Описание

array ftp_rawlist (resource ftp_stream, string directory)

ftp_rawlist() выполняет команду FTP LIST и возвращает результат в виде массива. Каждый элемент соответствует одной строчке текста. Вывод не разбирается. Идентификатор системного типа, возвращаемый функцией ftp_systype(), можно использовать для определения того, как должен интерпретироваться результат.

ftp_rename

(PHP 3>= 3.0.13, PHP 4)

ftp_rename - переименовывает файл на FTP-сервере.

Описание

bool ftp_rename (resource ftp_stream, string from, string to)

ftp_rename() переименовывает файл или директорию с названием from в to в FTP-потоке ftp_stream.

Возвращает TRUE при успехе, FALSE при ошибке.

ftp_rmdir

(PHP 3>= 3.0.13, PHP 4)

ftp_rmdir - удаляет директорию.

Описание

bool ftp_rmdir (resource ftp_stream, string directory)

Удаляет специфицированную directory.

Возвращает TRUE при успехе, FALSE при ошибке.