archived-doc-ru/reference/filesystem/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68ca0a46a0db2f5d5858127f8c02c502b2519af2 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="filesystem.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 <variablelist>
  <varlistentry xml:id="constant.seek-set">
   <term>
    <constant>SEEK_SET</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.seek-cur">
   <term>
    <constant>SEEK_CUR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.seek-end">
   <term>
    <constant>SEEK_END</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.lock-sh">
   <term>
    <constant>LOCK_SH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.lock-ex">
   <term>
    <constant>LOCK_EX</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.lock-un">
   <term>
    <constant>LOCK_UN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.lock-nb">
   <term>
    <constant>LOCK_NB</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
 <variablelist>
  <title>
   Флаги, доступные для параметра <parameter>flags</parameter>
   функции <function>file</function>
  </title>

  <varlistentry xml:id="constant.file-use-include-path">
   <term>
    <constant>FILE_USE_INCLUDE_PATH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ищет название файла <parameter>filename</parameter>
     в списке путей директивы <link linkend="ini.include-path">include_path</link>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.file-no-default-context">
   <term>
    <constant>FILE_NO_DEFAULT_CONTEXT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.file-append">
   <term>
    <constant>FILE_APPEND</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавить содержимое в конец существующего файла.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.file-ignore-new-lines">
   <term>
    <constant>FILE_IGNORE_NEW_LINES</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Удалить EOL-символы конца строки.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.file-skip-empty-lines">
   <term>
    <constant>FILE_SKIP_EMPTY_LINES</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Пропустить пустые строки.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.file-binary">
   <term>
    <constant>FILE_BINARY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Двоичный режим.
     <warning>
      <simpara>
       Константа устарела с PHP 8.1.0 и ни на что не влияет.
      </simpara>
     </warning>
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.file-text">
   <term>
    <constant>FILE_TEXT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Текстовый режим.
     <warning>
      <simpara>
       Константа устарела с PHP 8.1.0 и ни на что не влияет.
      </simpara>
     </warning>
    </para>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Флаги, доступные для параметра <parameter>flags</parameter>
   функции <function>glob</function>
  </title>

  <varlistentry xml:id="constant.glob-available-flags">
   <term>
    <constant>GLOB_AVAILABLE_FLAGS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Флаги семейства <constant>GLOB_<replaceable>*</replaceable></constant> вместе взятые.
     Эквивалентно записи <literal>0</literal> | <constant>GLOB_BRACE</constant> |
     <constant>GLOB_MARK</constant> | <constant>GLOB_NOSORT</constant> |
     <constant>GLOB_NOCHECK</constant> | <constant>GLOB_NOESCAPE</constant> |
     <constant>GLOB_ERR</constant> | <constant>GLOB_ONLYDIR</constant>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-brace">
   <term>
    <constant>GLOB_BRACE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Разворачивает шаблон {a,b,c} так, чтобы он соответствовал "a", "b" или "c".
    </simpara>
    <note>
     <simpara>
      Флаг <constant>GLOB_BRACE</constant> недоступен на ряде систем
      наподобие Solaris или Alpine Linux, которые работают не на ядре GNU.
     </simpara>
    </note>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-err">
   <term>
    <constant>GLOB_ERR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Останавливаться при ошибках считывания наподобие нечитаемых каталогов,
     по умолчанию ошибки игнорируются.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-mark">
   <term>
    <constant>GLOB_MARK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлять слеши, или обратные слеши в ОС Windows, к каждому каталогу, который возвращает функция.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-nocheck">
   <term>
    <constant>GLOB_NOCHECK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Вернуть шаблон поиска, если функция не нашла ни одного файла, который соответствует шаблону.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-noescape">
   <term>
    <constant>GLOB_NOESCAPE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Не экранировать метасимволы обратными слешами.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-nosort">
   <term>
    <constant>GLOB_NOSORT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращать файлы в том виде, в котором файлы лежат в каталоге, без сортировки.
     Без этого флага названия путей файлов сортируются по алфавиту.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.glob-onlydir">
   <term>
    <constant>GLOB_ONLYDIR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращать только те записи каталога, которые соответствуют шаблону.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Флаги, доступные для параметра <parameter>flags</parameter>
   функции <function>pathinfo</function>
  </title>
  <varlistentry xml:id="constant.pathinfo-all">
   <term>
    <constant>PATHINFO_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращать части информации о пути в ассоциативном массиве.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pathinfo-dirname">
   <term>
    <constant>PATHINFO_DIRNAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Путь к каталогу или файлу.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pathinfo-basename">
   <term>
    <constant>PATHINFO_BASENAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Название каталога
     или название и расширение файла.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pathinfo-extension">
   <term>
    <constant>PATHINFO_EXTENSION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Расширение файла.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pathinfo-filename">
   <term>
    <constant>PATHINFO_FILENAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Название каталога
     или файла без расширения.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Режимы сканирования, доступные для параметра <parameter>scanner_mode</parameter>
   функций <function>parse_ini_file</function>
   и <function>parse_ini_string</function>
  </title>


  <varlistentry xml:id="constant.ini-scanner-normal">
   <term>
    <constant>INI_SCANNER_NORMAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Обычный режим сканирования INI.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.ini-scanner-raw">
   <term>
    <constant>INI_SCANNER_RAW</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Режим необработанного (raw) сканирования INI.
    </simpara>
   </listitem>
  </varlistentry>

   <varlistentry xml:id="constant.ini-scanner-typed">
   <term>
    <constant>INI_SCANNER_TYPED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Режим типизированного сканирования INI.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist>
  <title>
   Флаги, доступные для параметра <parameter>flags</parameter>
   функции <function>fnmatch</function>
  </title>

  <varlistentry xml:id="constant.fnm-noescape">
   <term>
    <constant>FNM_NOESCAPE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Отключает экранирование обратных слешей.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.fnm-pathname">
   <term>
    <constant>FNM_PATHNAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Слеши в строках совпадают только со слешами в указанном шаблоне.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.fnm-period">
   <term>
    <constant>FNM_PERIOD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Ведущая точка в строке должна точно совпадать с точкой в заданном шаблоне.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.fnm-casefold">
   <term>
    <constant>FNM_CASEFOLD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Совпадение без учёта регистра. Часть модуля операционной системы GNU.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="filesystem.constants.upload">
  <title>PHP-константы загрузки файлов</title>
  <varlistentry xml:id="constant.upload-err-cant-write">
   <term>
    <constant>UPLOAD_ERR_CANT_WRITE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Не получилось записать файл на диск.
     Значение константы равно <literal>7</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-extension">
   <term>
    <constant>UPLOAD_ERR_EXTENSION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     PHP-модуль остановил загрузку файла на сервер. PHP не даёт
     способа выяснить, какой модуль вызвал остановку загрузки файла;
     определить причину иногда помогает проверка списка загруженных модулей функцией <function>phpinfo</function>.
     Значение константы равно <literal>8</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-form-size">
   <term>
    <constant>UPLOAD_ERR_FORM_SIZE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Загруженный на сервер файл превысил значение
     директивы <emphasis>MAX_FILE_SIZE</emphasis>, которую указали в HTML-форме.
     Значение константы равно <literal>2</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-ini-size">
   <term>
    <constant>UPLOAD_ERR_INI_SIZE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Загруженный на сервер файл превысил значение директивы
     <link linkend="ini.upload-max-filesize">upload_max_filesize</link>
     файла &php.ini;.
     Значение константы равно <literal>1</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-no-file">
   <term>
    <constant>UPLOAD_ERR_NO_FILE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Ни один файл не загрузился на сервер.
     Значение константы равно <literal>4</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-no-tmp-dir">
   <term>
    <constant>UPLOAD_ERR_NO_TMP_DIR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Отсутствует временная папка.
     Значение константы равно <literal>6</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-ok">
   <term>
    <constant>UPLOAD_ERR_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Ошибок не возникло, файл успешно загрузился на сервер.
     Значение константы равно <literal>0</literal>.
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.upload-err-partial">
   <term>
    <constant>UPLOAD_ERR_PARTIAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     Файл загрузился на сервер только частично.
     Значение константы равно <literal>3</literal>.
    </para>
   </listitem>
  </varlistentry>
 </variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->