diff --git a/reference/filesystem/functions/fscanf.xml b/reference/filesystem/functions/fscanf.xml new file mode 100644 index 000000000..e22cf88ea --- /dev/null +++ b/reference/filesystem/functions/fscanf.xml @@ -0,0 +1,98 @@ + + + + + + + fscanf + Обрабатывает данные из файла в соответствии с форматом + + + Описание + + mixedfscanf + resourcehandle + stringformat + mixed&... + + + Функция fscanf похожа на + sscanf, но берёт данные для обработки из файла, + ассоциируемого с handle, и интерпретирует их + согласно формату format, который описан в + документации функции sprintf. Если в функцию + переданы только два аргумента, обработанные значения будут возвращены + в виде массива. В ином случае, если были переданы необязательные + аргументы, функция вернёт количество присвоенных значений. Необязательные + аргументы должны быть переданы по ссылке. + + + Любое пустое пространство в строке формата эквивалентно любому пустому + пространству во входящем потоке. Это означает, что даже табуляция + \t в строке формата может быть сопоставлена + одному символу пробела во входящем потоке данных. + + + + Пример использования функции <function>fscanf</function> + + +]]> + + + + Содержимое файла users.txt + + + + + + + + В версиях PHP ниже 4.3.0, максимальное количество символов, которые + считывались из файла, составляло 512 (или до первого символа \n - + смотря что встретится первым). + Начиная с версии PHP 4.3.0, длинна строк не ограничена. + + + + См. также описание функций fread, fgets, + fgetss, sscanf, + printf и sprintf. + + + + + diff --git a/reference/filesystem/functions/fseek.xml b/reference/filesystem/functions/fseek.xml new file mode 100644 index 000000000..8e741ac8d --- /dev/null +++ b/reference/filesystem/functions/fseek.xml @@ -0,0 +1,100 @@ + + + + + + + fseek + Устанавливает смещение в файловом указателе + + + Описание + + intfseek + resourcehandle + intoffset + intwhence + + + Устанавливает смещение в файле, на который ссылается + handle. Новое смещение, измеряемое в байтах от + начала файла, получается путём прибавления параметра + offset к позиции, указанной в параметре + whence, значения которого определяются + следующим образом: + + SEEK_SET - Устанавливает смещение в offset байт. + SEEK_CUR - Устанавливает смещение в текущее плюс offset. + SEEK_END - Устанавливает смещение в размер файла плюс offset. + (Чтобы перейти к смещению перед концом файла, вы должны передать + отрицательное значение в параметр offset.) + + + + Если whence не указан, по умолчанию он + устанавливается в SEEK_SET. + + + В случае успеха возвращает 0; в противном сучае возвращает -1. + Обратите внимание, что переход к смещению за концом файла не + считается ошибкой. + + + + Пример использования функции <function>fseek</function> + + +]]> + + + + + Не может использоваться на файловых указателях, возвращённых функцией + fopen, если они используют форматы "http://" + или "ftp://". fseek также возвращает неопределённый + результат для потоков "дописать в конец" (открытых с флагом "a"). + + + + Параметр whence был добавлен в версии PHP 4.0.0. + + + + См. также описание функций ftell и + rewind. + + + + + diff --git a/reference/filesystem/functions/fstat.xml b/reference/filesystem/functions/fstat.xml new file mode 100644 index 000000000..11bec4f01 --- /dev/null +++ b/reference/filesystem/functions/fstat.xml @@ -0,0 +1,100 @@ + + + + + + + fstat + Получает информацию о файле используя открытый файловый указатель + + + Описание + + arrayfstat + resourcehandle + + + Собирает статистическую информацию о открытом файле по файловому + указателю handle. Эта функция похожа на + stat, за исключением того, что она работает с + открытым файловым указателем, а не именем файла. + + + Возвращает массив со статистической информацией на файл; формат массива + подробно описан на странице описания функции stat. + + + + Пример использования функции <function>fstat</function> + + +]]> + + + Этот пример выведет: + + + 771 + [ino] => 488704 + [mode] => 33188 + [nlink] => 1 + [uid] => 0 + [gid] => 0 + [rdev] => 0 + [size] => 1114 + [atime] => 1061067181 + [mtime] => 1056136526 + [ctime] => 1056136526 + [blksize] => 4096 + [blocks] => 8 +) +]]> + + + + + ¬e.clearstatcache; + + ¬e.no-remote; + + + + + diff --git a/reference/filesystem/functions/ftell.xml b/reference/filesystem/functions/ftell.xml new file mode 100644 index 000000000..3d7395969 --- /dev/null +++ b/reference/filesystem/functions/ftell.xml @@ -0,0 +1,77 @@ + + + + + + + ftell + Сообщает текущее смещение чтения/записи файла + + + Описание + + intftell + resourcehandle + + + Возвращает смещение файлового указателя, ассоциируемого с + handle. + + + При возникновении ошибки, возвращает &false;. + + + Файловый указатель должен быть действующим указателем + на поток, открытый функциями fopen или + popen. + ftell возвращает неопределённые результаты для + потоков "дописать в конец" (открытых с флагом "a" flag). + + + + Пример использования функции <function>ftell</function> + + +]]> + + + + + См. также описание функций fopen, popen, + fseek и rewind. + + + + + diff --git a/reference/filesystem/functions/ftruncate.xml b/reference/filesystem/functions/ftruncate.xml new file mode 100644 index 000000000..2f970384f --- /dev/null +++ b/reference/filesystem/functions/ftruncate.xml @@ -0,0 +1,55 @@ + + + + + + + ftruncate + Урезает файл до указанной длинны + + + Описание + + boolftruncate + resourcehandle + intsize + + + Принимает файловый указатель handle и урезает + соответствующий файл до размера size. + &return.success; + + + + В версиях PHP ниже 4.3.3, ftruncate возвращает + значение integer 1 в случае успеха, вместо + boolean &true;. + + + + См. также описание функций fopen и + fseek. + + + + + diff --git a/reference/filesystem/functions/fwrite.xml b/reference/filesystem/functions/fwrite.xml new file mode 100644 index 000000000..f72b263af --- /dev/null +++ b/reference/filesystem/functions/fwrite.xml @@ -0,0 +1,112 @@ + + + + + + + fwrite + Бинарно-безопасная запись в файл + + + Описание + + intfwrite + resourcehandle + stringstring + intlength + + + fwrite записывает содержимое + string в файловый поток + handle. Если передан аргумент + length, запись остановится после того, + как length байтов будут записаны или + будет достигнут конец строки string, + смотря что произойдёт первым. + + + fwrite возвращает количество записанных байтов + или &false; в случае ошибки. + + + Обратите внимание, что если аргумент length + указан, то конфигурационная опция magic_quotes_runtime + будет проигнорирована и строка string + не будет очищена от слешей. + + + + В системах, различающих двоичные и текстовые файлы (к примеру, Windows), + файл должен быть открыт используя флаг 'b' в конце аргумента mode + функции fopen. + + + + + Простой пример использования fwrite + + +]]> + + + + + См. также описание функций fread, + fopen, + fsockopen, + popen и + file_put_contents. + + + + + diff --git a/reference/filesystem/functions/glob.xml b/reference/filesystem/functions/glob.xml new file mode 100644 index 000000000..6be28fa17 --- /dev/null +++ b/reference/filesystem/functions/glob.xml @@ -0,0 +1,132 @@ + + + + + + glob + Находит файловые пути, совпадающие с шаблоном + + + Описание + + arrayglob + stringpattern + intflags + + + Функция glob ищет все пути, совпадающие с шаблоном + pattern согласно правилам, используемым + в функции glob() библиотеки libc, которые похожи на правила, используемые + большинством распространённых оболочек. Раскрытие тильды или подстановки + параметров не совершаются. + + + Возвращает массив, который содержит совпадающие файлы/директории или + &false; в случае ошибки. + + + Допустимые флаги: + + + + GLOB_MARK - Добавляет слеш к каждому возвращаемому + предмету + + + + + GLOB_NOSORT - Возвращает файлы в таком виде, в + котором они содержатся в директории (без сортировки) + + + + + GLOB_NOCHECK - Возвращает шаблон поиска, если + с его помощью не был найден ни один файл. + + + + + GLOB_NOESCAPE - Обратные слеши не экранируют + метасимволы + + + + + GLOB_BRACE - Раскрывает {a,b,c} для совпадения с + 'a', 'b' или 'c' + + + + + GLOB_ONLYDIR - Возвращает только директории, + совпадающие с шаблоном + + + + + + + В версиях ниже PHP ниже 4.3.3 GLOB_ONLYDIR был + не + доступен в Windows и других системах, не использующих библиотеку GNU C. + + + + + + Удобный способ, как при помощи <function>glob</function> можно заменить + <function>opendir</function> и её друзей. + + + +]]> + + + Результат будет примерно таким: + + + + + + + + ¬e.no-remote; + + + См. также описание функций opendir, + readdir, + closedir и fnmatch. + + + + + diff --git a/reference/filesystem/functions/is-dir.xml b/reference/filesystem/functions/is-dir.xml new file mode 100644 index 000000000..4cdcc1e39 --- /dev/null +++ b/reference/filesystem/functions/is-dir.xml @@ -0,0 +1,76 @@ + + + + + + + is_dir + Определает, является ли файл директорией + + + Описание + + boolis_dir + stringfilename + + + Возвращает &true;, если файл существует и является директорией. Если + filename - это относительное имя файла, + оно будет проверено относительно текущей рабочей директории. + + ¬e.clearstatcache; + + + Пример использования функции <function>is_dir</function> + + +]]> + + + Результат выполнения примера: + + + + + + + &tip.fopen-wrapper.stat; + + + См. также описание функций chdir, dir, + opendir, is_file и + is_link. + + + + + diff --git a/reference/filesystem/functions/is-executable.xml b/reference/filesystem/functions/is-executable.xml new file mode 100644 index 000000000..66b26ab37 --- /dev/null +++ b/reference/filesystem/functions/is-executable.xml @@ -0,0 +1,74 @@ + + + + + + + is_executable + Определяет, является ли файл исполняемым + + + Описание + + boolis_executable + stringfilename + + + Возвращает &true;, если файл существует и является исполняемым. + + + is_executable стала доступна в + Windows начиная с версии PHP 5.0.0. + + + + Пример использования функции <function>is_executable</function> + + +]]> + + + + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + + + См. также описание функций is_file и + is_link. + + + + + diff --git a/reference/filesystem/functions/is-file.xml b/reference/filesystem/functions/is-file.xml new file mode 100644 index 000000000..2d02c8f17 --- /dev/null +++ b/reference/filesystem/functions/is-file.xml @@ -0,0 +1,50 @@ + + + + + + + is_file + Определяет, является ли файл обычным файлом + + + Описание + + boolis_file + stringfilename + + + Возвращает &true;, если файл существует и является обычным файлом. + + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + + + См. также описание функций is_dir и + is_link. + + + + + diff --git a/reference/filesystem/functions/is-link.xml b/reference/filesystem/functions/is-link.xml new file mode 100644 index 000000000..45e673613 --- /dev/null +++ b/reference/filesystem/functions/is-link.xml @@ -0,0 +1,50 @@ + + + + + + + is_link + Определяет, является ли файл символической ссылкой + + + Описание + + boolis_link + stringfilename + + + Возвращает &true;, если файл существует и является символической ссылкой. + + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + + + См. также описание функций is_dir, + is_file и readlink. + + + + + diff --git a/reference/filesystem/functions/is-readable.xml b/reference/filesystem/functions/is-readable.xml new file mode 100644 index 000000000..48e6c59a5 --- /dev/null +++ b/reference/filesystem/functions/is-readable.xml @@ -0,0 +1,56 @@ + + + + + + + is_readable + Определяет, доступен ли файл для чтения + + + Описание + + boolis_readable + stringfilename + + + Возвращает &true;, если файл существует и доступен для чтения. + + + Не забывайте, что PHP может обращаться к файлам от имени + пользователя, от которого запущен веб-сервер (часто 'nobody'). + Ограничения безопасного режима не беруться во внимание. + + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + + + См. также описание функций is_writable, + file_exists и + fgets. + + + + + diff --git a/reference/filesystem/functions/is-uploaded-file.xml b/reference/filesystem/functions/is-uploaded-file.xml new file mode 100644 index 000000000..24998acfe --- /dev/null +++ b/reference/filesystem/functions/is-uploaded-file.xml @@ -0,0 +1,95 @@ + + + + + + + is_uploaded_file + Определяет, был ли файл загружен при помощи HTTP POST + + + Описание + + boolis_uploaded_file + stringfilename + + + Возвращает &true;, если файл filename был + загружен при помощи HTTP POST. Это полезно, чтобы убедиться в том, + что злонамеренный пользователь не пытается обмануть скрипт так, чтобы + он работал с файлами, с которыми работать не должен -- к примеру, + /etc/passwd. + + + Такие проверки особенно полезны, если существует вероятность того, + что операции над файлом могут показать его содержимое пользователю + или даже другим пользователям той же системы. + + + Функция is_uploaded_file доступна только начиная + с версии PHP 3.0.16 и PHP 4.0.2 для третьей и четвёртой линеек + соответственно. Если вам необходимо использовать более ранние версии, + вы можете использовать такую функцию, чтобы обезопасить себя: + + + Следующий пример не работает + в версиях PHP выше 4.0.2. Он полагается на внутреннюю + функциональность PHP, которая изменилась после этой версии. + + + + + Пример использования функции <function>is_uploaded_file</function> + + +]]> + + + + См. также описание функции move_uploaded_file и раздел + Загрузка файлов на сервер + для получения простых примеров использования. + + + + + diff --git a/reference/filesystem/functions/is-writable.xml b/reference/filesystem/functions/is-writable.xml new file mode 100644 index 000000000..c0d68dc9a --- /dev/null +++ b/reference/filesystem/functions/is-writable.xml @@ -0,0 +1,58 @@ + + + + + + + is_writable + Определяет, доступен ли файл для записи + + + Описание + + boolis_writable + stringfilename + + + Возвращает &true;, если файл filename существует и + доступен для записи. Аргумент filename может быть именем директории, что + позволяет вам проверять директории на доступность для записи. + + + Не забывайте, что PHP может обращаться к файлу от имени того пользователя, + от которого запущен веб-сервер (обычно 'nobody'). Ограничения безопасного + режима не принимаются во внимание. + + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + + + См. также описание функций is_readable, + file_exists и + fwrite. + + + + + diff --git a/reference/filesystem/functions/is-writeable.xml b/reference/filesystem/functions/is-writeable.xml new file mode 100644 index 000000000..b3f114528 --- /dev/null +++ b/reference/filesystem/functions/is-writeable.xml @@ -0,0 +1,37 @@ + + + + + + + is_writeable + Псевдоним функции is_writable + + + Описание + + Эта функция является псевдонимом для фукнции is_writable. + + + + + diff --git a/reference/filesystem/functions/link.xml b/reference/filesystem/functions/link.xml new file mode 100644 index 000000000..94c5f34f4 --- /dev/null +++ b/reference/filesystem/functions/link.xml @@ -0,0 +1,51 @@ + + + + + + + link + Создаёт жёсткую ссылку + + + Описание + + boollink + stringtarget + stringlink + + + link создаёт жесткую ссылку. &return.success; + + + ¬e.no-remote; + ¬e.no-windows; + + + См. также описание функции symlink для создания + мягких ссылок, а также readlink и + linkinfo. + + + + + diff --git a/reference/filesystem/functions/linkinfo.xml b/reference/filesystem/functions/linkinfo.xml new file mode 100644 index 000000000..01a8b0474 --- /dev/null +++ b/reference/filesystem/functions/linkinfo.xml @@ -0,0 +1,66 @@ + + + + + + + linkinfo + Получает информацию о ссылке + + + Описание + + intlinkinfo + stringpath + + + linkinfo возвращает поле st_dev + структуры stat из Unix C, которую возвращает системный вызов + lstat. Эта функция используется для определения, + существует ли ссылка (на которую указывает path) + на самом деле (используя тот же метод, что и макро S_ISLNK, + определённый в stat.h). + Возвращает 0 или &false; в случае ошибки. + + + + Пример использования функции <function>linkinfo</function> + + +]]> + + + + ¬e.no-windows; + + См. также описание функций symlink, link + и readlink. + + + + + diff --git a/reference/filesystem/functions/lstat.xml b/reference/filesystem/functions/lstat.xml new file mode 100644 index 000000000..e411b21ec --- /dev/null +++ b/reference/filesystem/functions/lstat.xml @@ -0,0 +1,59 @@ + + + + + + + lstat + Получает информацию о файле или символической ссылке + + + Описание + + arraylstat + stringfilename + + + Собирает статистику на файл или символическую ссылку с именем + filename. Эта функция идентична функции + stat, за исключением того, что если + filename является символической ссылкой, + возвращается статус символической ссылки, а не того файла, на + который она указывает. + + + Обратитесь к странице руководства функции stat для + получения информации о структуре массива, который возвращает + lstat. + + + ¬e.clearstatcache; + + &tip.fopen-wrapper.stat; + + + См. также описание функции stat. + + + + + diff --git a/reference/filesystem/functions/mkdir.xml b/reference/filesystem/functions/mkdir.xml new file mode 100644 index 000000000..299488767 --- /dev/null +++ b/reference/filesystem/functions/mkdir.xml @@ -0,0 +1,94 @@ + + + + + + + mkdir + Создаёт директорию + + + Description + + boolmkdir + stringpathname + intmode + boolrecursive + resourcecontext + + + Пытается создать директорию, заданную в pathname. + + + Обратите внимание, что аргумент mode необходимо задавать + в виде восьмиричного числа (первой цифрой должен быть ноль). + На аргумент mode также влияет текущее значение umask, которое + можно изменить при помощи umask. + + + + + Аргумент mode игнорируется в Windows и стал необязательным начиная с + версии PHP 4.2.0. + + + + + По умолчанию mode равен 0777, что является самыми широкими правами + доступа. Для получения информации о режимах, обратитесь к странице + chmod. + + Пример использования функции <function>mkdir</function> + + +]]> + + + + + &return.success; + + + + Начиная с версии PHP 5.0.0 mkdir также может + использоваться с некоторыми URL-обвёртками. + Обратитесь к для получения списка обвёрток, + которые поддерживает mkdir. + + + + + Аргументы recursive и context + доступны начиная с версии PHP 5.0.0. + + + ¬e.sm.uidcheck.dir; + + См. также описание функции rmdir. + + + + + diff --git a/reference/filesystem/functions/move-uploaded-file.xml b/reference/filesystem/functions/move-uploaded-file.xml new file mode 100644 index 000000000..8fd5d84dd --- /dev/null +++ b/reference/filesystem/functions/move-uploaded-file.xml @@ -0,0 +1,84 @@ + + + + + + + move_uploaded_file + Перемещает загруженный файл в новое место + + + Описание + + boolmove_uploaded_file + stringfilename + stringdestination + + + Эта функция проверяет, является ли файл + filename загруженным на сервер + (переданным по протоколу HTTP POST). Если файл действительно + загружен на сервер, он будет перемещён в место, указанное + в аргументе destination. + + + Если filename не является загруженным файлов, + никаких действий не предпринимается и + move_uploaded_file возвращает &false;. + + + Если filename является загруженным файлом, но + не может быть перемещён по каким-либо причинам, никакие действия не + предпринимаются и + move_uploaded_file возвращает &false;. + Кроме того, отображается предупреждение. + + + Такая проверка особенно важна в том случае, если существует шанс того, + что какие-либо действия, производимые над загруженным файлом, могут + открыть его содержимое пользователю или даже другим пользователям + системы. + + ¬e.sm.uidcheck; + + + На move_uploaded_file не распространяются нормальные + UID-ограничения режима &safemode;. Это не является нарушением + безопасности, потому что move_uploaded_file + оперирует лишь теми файлами, которые загружены на сервер через PHP. + + + + + Если файл destination уже существует, он + будет перезаписан. + + + + См. также описание функции is_uploaded_file и раздел + Загрузка файлов на сервер + для примеров использования этих функций. + + + + + diff --git a/reference/filesystem/functions/parse-ini-file.xml b/reference/filesystem/functions/parse-ini-file.xml new file mode 100644 index 000000000..30946b4f6 --- /dev/null +++ b/reference/filesystem/functions/parse-ini-file.xml @@ -0,0 +1,164 @@ + + + + + + + parse_ini_file + Обрабатывает конфигурационный файл + + + Описание + + arrayparse_ini_file + stringfilename + boolprocess_sections + + + parse_ini_file загружает + ini-файл, указанный в аргументе filename, + и возвращает его настройки в виде ассоциативного массива. + Установив последний аргумент process_sections + в &true;, вы получаете многомерный массив, который включает как название + отдельных настроек, так и секции. По умолчанию + process_sections равен &false; + + + + Эта функция не имеет никакого отношения к файлу &php.ini;. + К моменту выполнения вашего скрипта, он уже обработан. + Эта функция может быть использована для загрузки настроек + вашего собственного приложения. + + + + + Если значение в ini-файле содержит прочие символы, кроме букв и цифр, + оно должно заключаться в двойные кавычки ("). + + + + + Начиная с версии PHP 4.2.1, на поведение этой функции влияет &safemode; и + open_basedir. + + + + + Существует зарезервированные слова, которые вы не можете использовать + в качестве ключей в ini-файлах. Такими словами являются следующие: + null, yes, no, true и false. + + + + Структура ini-файла похожа на структуру &php.ini;. + + + Константы также могут быть + обработаны в ini-файле, так что если вы объявите константу в виде значения + для ini-файла до вызова parse_ini_file, она (константа) + будет правильно обработана. Таким образом обрабатываются только значения. + Например: + + + + Содержимое <filename>sample.ini</filename> + + + + + + + + Пример использования функции <function>parse_ini_file</function> + + +]]> + + + Результат: + + + 1 + [five] => 5 + [animal] => Dodo bird + [path] => /usr/local/bin + [URL] => http://www.example.com/~username +) +Array +( + [first_section] => Array + ( + [one] => 1 + [five] => 5 + [animal] = Dodo bird + ) + + [second_section] => Array + ( + [path] => /usr/local/bin + [URL] => http://www.example.com/~username + ) + +) +]]> + + + + + Ключи и имена секций, состоящие из цифр, будут обработаны как + целые числа в PHP, + поэтому числа, начинающиеся с 0 будут считаться восьмиричными, + а начинающиеся с 0x - шестнадцатиричными. + + + + + diff --git a/reference/filesystem/functions/pathinfo.xml b/reference/filesystem/functions/pathinfo.xml new file mode 100644 index 000000000..3518b54c8 --- /dev/null +++ b/reference/filesystem/functions/pathinfo.xml @@ -0,0 +1,93 @@ + + + + + + + pathinfo + Возвращает информацию о пути к файлу + + + Описание + + arraypathinfo + stringpath + intoptions + + + pathinfo возвращает ассоциативный массив, + который содержит информацию о пути path. + Возвращаемый массив состоит из следующих элементов: + dirname, basename + и extension. + + + Вы можете указать, какие элементы будут возвращены при помощи + необязательного параметра options. Он состоит из + PATHINFO_DIRNAME, + PATHINFO_BASENAME и + PATHINFO_EXTENSION. + По умолчанию возвращаются все элементы. + + + + Пример использования функции <function>pathinfo</function> + + +]]> + + + Результат: + + + + + + + + + Для дополнительной информации о получении текущей информации о пути, + обратитесь к секции + Предопределенные зарезервированные переменные. + + + + См. также описание функций dirname, + basename, + parse_url + и realpath. + + + + + diff --git a/reference/filesystem/functions/pclose.xml b/reference/filesystem/functions/pclose.xml new file mode 100644 index 000000000..574a73ccf --- /dev/null +++ b/reference/filesystem/functions/pclose.xml @@ -0,0 +1,52 @@ + + + + + + + pclose + Закрывает файловый указатель процесса + + + Описание + + intpclose + resourcehandle + + + Закрывает файловый указатель на канал, открытый при помощи + popen. + + + Файловый указатель должен быть действующим и должен быть возвращён + успешным вызовом функции popen. + + + Возвращает статус выхода завершающегося процесса. + + + См. также описание функции popen. + + + + + diff --git a/reference/filesystem/functions/popen.xml b/reference/filesystem/functions/popen.xml new file mode 100644 index 000000000..8aec0c556 --- /dev/null +++ b/reference/filesystem/functions/popen.xml @@ -0,0 +1,101 @@ + + + + + + + popen + Открывает файловый указатель процесса + + + Описание + + resourcepopen + stringcommand + stringmode + + + Открывает поток к процессу, выполняемую при помощи форкинга (forking) + комманды, заданной в command. + + + Возвращает файловый указатель, идентичный возвращаемому + функцией fopen, за исключением того, что он + односторонний (может быть использован только для чтения или записи) + и должен быть закрыт при помощи pclose. + Этот указатель может быть использован с fgets, + fgetss и + fwrite. + + + В случае возникновения ошибки, возвращает &false;. + + + + Если вы ищите двустороннюю связь, используйте + proc_open. + + + + + Пример использования функции <function>popen</function> + + +]]> + + + + + Если комманда для выполнения не может быть найдена, будет + возвращён действующий ресурс. Это может выглядить странно, но + имеет смысл; это даёт вам возможность получить доступ к любому + сообщению об ошибке, которое вернёт оболочка: + + +&1', 'r'); +echo "'$handle'; " . gettype($handle) . "\n"; +$read = fread($handle, 2096); +echo $read; +pclose($handle); +?> +]]> + + + + ¬e.exec-path; + &warn.sm.exec; + + См. также описание функций pclose, fopen + и proc_open. + + + + + diff --git a/reference/filesystem/functions/readfile.xml b/reference/filesystem/functions/readfile.xml new file mode 100644 index 000000000..7d19d6f37 --- /dev/null +++ b/reference/filesystem/functions/readfile.xml @@ -0,0 +1,61 @@ + + + + + + + readfile + Выводит файл + + + Описание + + intreadfile + stringfilename + booluse_include_path + resourcecontext + + + Читает файл и записывает его в буфер вывода. + + + Возвращает количество прочитанных из файла байт. В случае возникновения + ошибки вернёт &false;, если только функция не была вызвана как + @readfile, и выведет сообщение об ошибке. + + &tip.fopen-wrapper; + + Вы можете установить в &true; необязательный второй аргумент, + если вы также хотите попытаться найти файл в include_path. + + + См. также описание функций fpassthru, + file, fopen, + include, require, + virtual, file_get_contents + и . + + + + + diff --git a/reference/filesystem/functions/readlink.xml b/reference/filesystem/functions/readlink.xml new file mode 100644 index 000000000..0b444f733 --- /dev/null +++ b/reference/filesystem/functions/readlink.xml @@ -0,0 +1,64 @@ + + + + + + + readlink + Возвращает файл, на который указывает символическая ссылка + + + Описание + + stringreadlink + stringpath + + + readlink делает то же самое, что и функция C readlink + - возвращает содержимое пути символической ссылки или &false; в случае + ошибки. + + + + Пример использования функции <function>readlink</function> + + +]]> + + + + ¬e.no-windows; + + См. также описание функций is_link, + symlink и + linkinfo. + + + + +