# php_manual

id: getenv
type: function
doc:
<comment>Description:</comment>
  Получает значение одной или всех переменных окружения
  
  Получает значение одной или всех переменных окружения.
  
  Список всех переменных окружения можно посмотреть с помощью функции <strong>phpinfo()</strong>. Многие из этих
  переменных есть в документе RFC 3875, по большей части в разделе 4.1, "Request Meta-Variables".

<comment>Param:</comment>
  <info>string|null</info>  <strong>$name</strong>        Имя переменной в виде строки (<info>string</info>) или <info>null</info>.
  <info>bool</info>         <strong>$local_only</strong>  Если установлено значение <info>true</info>, возвращаются только локальные переменные
                            окружения, установленные операционной системой или командой putenv. Это
                            имеет значение только в том случае, если параметр <strong>$name</strong> является строкой
                            (<info>string</info>).

<comment>Return:</comment>
  <info>string|array|false</info>  Возвращает значение переменной окружения <strong>$name</strong> или <info>false</info>, если переменная
                      окружения <strong>$name</strong> не существует. Если <strong>$name</strong> равно <info>null</info>, возвращаются все
                      переменные окружения в виде ассоциативного массива (<info>array</info>).

<comment>See Also:</comment>
   * <strong>putenv()</strong>
   * <strong>apache_getenv()</strong>
   * Суперглобальные переменные


id: gethostbyaddr
type: function
doc:
<comment>Description:</comment>
  Получает доменное имя хоста, соответствующее переданному IP-адресу
    
  
  Возвращает доменное имя хоста по адресу <strong>$ip</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$ip</strong>  IP-адрес хоста

<comment>Return:</comment>
  <info>string|false</info>  Возвращает имя хоста в случае успешного выполнения, исходный <strong>$ip</strong> в случае
                возникновения ошибки, или <info>false</info> в случае ошибочного ввода.

<comment>See Also:</comment>
   * <strong>gethostbyname()</strong>
   * <strong>gethostbynamel()</strong>


id: gethostbyname
type: function
doc:
<comment>Description:</comment>
  Получает IPv4-адрес, соответствующий переданному имени хоста
    
  
  Возвращает IPv4-адрес по имени хоста <strong>$hostname</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$hostname</strong>  Имя узла.

<comment>Return:</comment>
  <info>string</info>  Возвращает адрес IPv4 или строку, содержащую неизмененный <strong>$hostname</strong> в случае возникновения
          ошибки.

<comment>See Also:</comment>
   * <strong>gethostbyaddr()</strong>
   * <strong>gethostbynamel()</strong>
   * <strong>inet_pton()</strong>
   * <strong>inet_ntop()</strong>


id: gethostbynamel
type: function
doc:
<comment>Description:</comment>
  Получает список IPv4-адресов, соответствующих переданному доменному имени хоста
    
  
  Возвращает список IPv4-адресов, в которые разрешается доменное имя хоста <strong>$hostname</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$hostname</strong>  Имя хоста.

<comment>Return:</comment>
  <info>array|false</info>  Возвращает массив адресов IPv4 или <info>false</info>, если <strong>$hostname</strong> не может быть разрешено.

<comment>See Also:</comment>
   * <strong>gethostbyname()</strong>
   * <strong>gethostbyaddr()</strong>
   * <strong>checkdnsrr()</strong>
   * <strong>getmxrr()</strong>
   * the <return>named(8)</return> manual page


id: gethostname
type: function
doc:
<comment>Description:</comment>
  Получает имя хоста
  
  Функция <strong>gethostname()</strong> получает стандартное имя хоста для локального компьютера.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает строку с именем хоста либо <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gethostbyname()</strong>
   * <strong>gethostbyaddr()</strong>
   * <strong>php_uname()</strong>


id: getimagesize
type: function
doc:
<comment>Description:</comment>
  Получение размера изображения
  
  Функция <strong>getimagesize()</strong> определит размер любого заданного, поддерживаемого изображения и вернёт
  этот размер вместе с типом файла и текстовой строкой <return>height/width</return>, которую можно будет
  использовать внутри тега HTML IMG, а также вернёт соответствующий тип содержимого HTTP.
  
  Также <strong>getimagesize()</strong> может вернуть дополнительные сведения об изображении через аргумент
  <strong>$image_info</strong>.
  
  Функция ожидает, что <strong>$filename</strong> является корректным файлом изображения. Если будет передан файл не
  содержащий изображения, он может быть некорректно интерпретирован как изображение и функция
  завершится успешно, но массив при этом будет содержать бессмысленные значения.
  
  Не используйте <strong>getimagesize()</strong> для проверки того, что файл является изображением. Для этих целей
  используйте модуль Fileinfo.
  
  Обратите внимание на тот факт, что отдельные части JPC и JP2 изображений могут иметь различную
  глубину цвета. В этом случае в параметре "bits" будет стоять максимальное значение из всех
  обнаруженных. Также JP2 файлы могут содержать <return>несколько кодовых потоков JPEG 2000</return>. В таком случае
  <strong>getimagesize()</strong> вернёт значения для первого такого потока, который будет обнаружен функцией в корне
  файла.
  
  Сведения об иконках извлекаются из иконки с наибольшим битрейтом.
  
  Изображения GIF состоят из одного или нескольких кадров, где каждый кадр может занимать только
  часть изображения. Размер изображения, возвращаемый <strong>getimagesize()</strong>, будет являться общим размером
  (прочитанным из дескриптора логического экрана).

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>    Этот аргумент задаёт файл, сведения о котором будут извлекаться. Это может
                       быть локальный или удалённый (зависит от конфигурации) файл. Передача данных
                       удалённого файла должна осуществляться одним из поддерживаемых потоков.
  <info>array</info>   <strong>$image_info</strong>  Этот необязательный аргумент позволяет извлечь некоторые расширенные сведения
                       из файла изображения. На данный момент можно получать различные JPG APP
                       маркеры в виде ассоциативного массива. Некоторые программы используют эти
                       маркеры для встраивания текста в картинку. Наиболее часто встраивают IPTC
                       сведения в APP13 маркер. Для преобразования двоичных данных APP13 маркера во
                       что-то удобочитаемое можно воспользоваться функцией <strong>iptcparse()</strong>.
                       
                       <strong>$image_info</strong> поддерживает только файлы JFIF.

<comment>Return:</comment>
  <info>array|false</info>  Возвращает массив из 7 элементов. Не все типы изображений содержат элементы с
               каналами (<return>channels</return>) и битрейтом (<return>bits</return>).
               
               Индексы 0 и 1 содержат ширину и высоту изображения.
               
               Некоторые форматы файлов могут хранить несколько изображений или не содержать
               изображения вообще. В таких случаях <strong>getimagesize()</strong> не сможет определить размер
               изображения. <strong>getimagesize()</strong> вернёт нули в качестве значений высоты и ширины.
               
               Индекс 2 содержит одну из констант типа изображения IMAGETYPE_XXX.
               
               Индекс 3 содержит строку со значениями ширины и высоты изображения <return>height="yyy"
               width="xxx"</return>, которая может быть использована внутри IMG тега.
               
               <return>mime</return> - соответствующий MIME-тип изображения. Эти сведения используются для корректной
               обработки изображения на основании заголовка <return>Content-type</return>: <strong>getimagesize()</strong> и MIME типы
               ]]>
               
               <return>channels</return> принимает значение 3 для RGB картинок и 4 для CMYK.
               
               <return>bits</return> - глубина цвета, число бит для каждого цвета.
               
               Для некоторых типов изображений наличие значений <return>channels</return> и <return>bits</return> может сбить с толку.
               Например, GIF всегда использует 3 канала на пиксель, но глубину цвета невозможно
               вычислить для анимированных GIF изображений с общей таблицей цветов.
               
               В случае возникновения ошибки функция вернёт <info>false</info>.

<comment>See Also:</comment>
   * <strong>image_type_to_mime_type()</strong>
   * <strong>exif_imagetype()</strong>
   * <strong>exif_read_data()</strong>
   * <strong>exif_thumbnail()</strong>
   * <strong>imagesx()</strong>
   * <strong>imagesy()</strong>


id: getimagesizefromstring
type: function
doc:
<comment>Description:</comment>
  Получение размера изображения из строки данных
    
  
  Функция работает идентично функции <strong>getimagesize()</strong> с той разницей, что <strong>getimagesizefromstring()</strong>
  принимает данные изображения в виде строки в качестве первого аргумента вместо имени файла.
  
  Для уточнения, как функция работает, обращайтесь к документации к функции <strong>getimagesize()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>      Данные изображения в виде строки.
  <info>array</info>   <strong>$image_info</strong>  Смотрите <strong>getimagesize()</strong>.

<comment>Return:</comment>
  <info>array|false</info>  Смотрите <strong>getimagesize()</strong>.

<comment>See Also:</comment>
   * <strong>getimagesize()</strong>


id: getlastmod
type: function
doc:
<comment>Description:</comment>
  Получает время последней модификации страницы
    
  
  Получает время последней модификации запущенного скрипта.
  
  Если требуется получить время модификации произвольного файла, используйте функцию <strong>filemtime()</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает время последней модификации текущей страницы. Значение является меткой
             времени Unix, подходящая для функции <strong>date()</strong>. Функция вернёт <info>false</info> в случае
             возникновения ошибки.

<comment>See Also:</comment>
   * <strong>date()</strong>
   * <strong>getmyuid()</strong>
   * <strong>getmygid()</strong>
   * <strong>get_current_user()</strong>
   * <strong>getmyinode()</strong>
   * <strong>getmypid()</strong>
   * <strong>filemtime()</strong>


id: getmxrr
type: function
doc:
<comment>Description:</comment>
  Получает записи MX, соответствующие переданному доменному имени хоста
  
  Ищет в DNS записи MX, соответствующие <strong>$hostname</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$hostname</strong>  Имя хоста
  <info>array</info>   <strong>$hosts</strong>     Список найденных записей MX, помещённый в массив <strong>$hosts</strong>.
  <info>array</info>   <strong>$weights</strong>   Если передан массив <strong>$weights</strong>, то он будет заполнен полученной информацией о
                     приоритетах.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если были найдены записи; возвращает <info>false</info>, если записей не было найдено
        или произошла ошибка.

<comment>See Also:</comment>
   * <strong>checkdnsrr()</strong>
   * <strong>dns_get_record()</strong>
   * <strong>gethostbyname()</strong>
   * <strong>gethostbynamel()</strong>
   * <strong>gethostbyaddr()</strong>
   * страница руководства <return>named(8)</return>


id: getmygid
type: function
doc:
<comment>Description:</comment>
  Получить GID владельца скрипта PHP
    
  
  Получает идентификатор группы текущего скрипта.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает групповой идентификатор текущего скрипта или <info>false</info> в случае возникновения
             ошибки.

<comment>See Also:</comment>
   * <strong>getmyuid()</strong>
   * <strong>getmypid()</strong>
   * <strong>get_current_user()</strong>
   * <strong>getmyinode()</strong>
   * <strong>getlastmod()</strong>


id: getmyinode
type: function
doc:
<comment>Description:</comment>
  Получает значение inode текущего скрипта
    
  
  Получает inode текущего скрипта.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает inode текущего скрипта в виде целого числа или <info>false</info> в случае ошибки.

<comment>See Also:</comment>
   * <strong>getmygid()</strong>
   * <strong>getmyuid()</strong>
   * <strong>getmypid()</strong>
   * <strong>get_current_user()</strong>
   * <strong>getlastmod()</strong>


id: getmypid
type: function
doc:
<comment>Description:</comment>
  Получение ID процесса PHP
    
  
  Получает идентификатор процесса PHP.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает идентификатор процесса PHP или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>getmygid()</strong>
   * <strong>getmyuid()</strong>
   * <strong>get_current_user()</strong>
   * <strong>getmyinode()</strong>
   * <strong>getlastmod()</strong>


id: getmyuid
type: function
doc:
<comment>Description:</comment>
  Получение UID владельца скрипта PHP
    
  
  Получает идентификатор пользователя текущего скрипта.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает идентификатор пользователя текущего скрипта или <info>false</info> в случае ошибки.

<comment>See Also:</comment>
   * <strong>getmygid()</strong>
   * <strong>getmypid()</strong>
   * <strong>get_current_user()</strong>
   * <strong>getmyinode()</strong>
   * <strong>getlastmod()</strong>


id: getopt
type: function
doc:
<comment>Description:</comment>
  Получает параметры из списка аргументов командной строки
    
  
  Анализирует параметры переданные в скрипт.

<comment>Param:</comment>
  <info>string</info>  <strong>$short_options</strong>  Каждый символ в этой строке будет рассматриваться как параметр и
                          сравниваться с символами, переданными в скрипт, перед которыми будет
                          стоять дефис (<return>-</return>).
                          
                          Например, строка параметров <return>"x"</return> распознается, как параметр <return>-x</return>.
                          
                          Допускаются только символы a-z, A-Z и 0-9.
  <info>array</info>   <strong>$long_options</strong>   Массив параметров. Каждый элемент массива будет использоваться как
                          строковый параметр и сравниваться с параметрами, переданными в скрипт,
                          перед которыми будет стоять двойной дефис (<return>--</return>).
                          
                          Например, элемент longopts <return>"opt"</return> будет расшифровываться как <return>--opt</return>.
  <info>int</info>     <strong>$rest_index</strong>     Если задан параметр <strong>$rest_index</strong>, то индекс, на котором остановился разбор,
                          будет записан в него.

<comment>Return:</comment>
  <info>array|false</info>  Функция вернёт массив пар параметров / аргументов или <info>false</info> в случае возникновения
               ошибки.
               
               Как только встретится первый символ, не являющийся параметром, разбор строки команды
               будет завершён, а оставшаяся часть строки будет проигнорирована.

<comment>See Also:</comment>
   * $argv


id: getprotobyname
type: function
doc:
<comment>Description:</comment>
  Получает номер протокола по имени
  
  Функция <strong>getprotobyname()</strong> возвращает номер протокола по имени, указанном в параметре <strong>$protocol</strong>
  согласно /etc/protocols.

<comment>Param:</comment>
  <info>string</info>  <strong>$protocol</strong>  Имя протокола.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает номер протокола или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>getprotobynumber()</strong>


id: getprotobynumber
type: function
doc:
<comment>Description:</comment>
  Получает имя протокола по номеру
  
  Функция <strong>getprotobynumber()</strong> возвращает имя протокола по номеру, указанному в параметре <strong>$protocol</strong>
  согласно /etc/protocols.

<comment>Param:</comment>
  <info>int</info>  <strong>$protocol</strong>  Номер протокола.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает имя протокола в виде строки или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>getprotobyname()</strong>


id: getrandmax
type: function
doc:
<comment>Description:</comment>
  Возвращает максимально возможное случайное число
  
  Возвращает максимальное значение, которое может быть получено функцией <strong>rand()</strong>.

<comment>Return:</comment>
  <info>int</info>  Максимально возможное случайное значение, возвращаемое функцией <strong>rand()</strong>

<comment>See Also:</comment>
   * <strong>rand()</strong>
   * <strong>srand()</strong>
   * <strong>mt_getrandmax()</strong>


id: getrusage
type: function
doc:
<comment>Description:</comment>
  Получает информацию об использовании текущего ресурса
    
  
  Это интерфейс к getrusage(2). Функция получает данные, возвращаемые из системного вызова.

<comment>Param:</comment>
  <info>int</info>  <strong>$mode</strong>  Если аргумент <strong>$mode</strong> равен 1, getrusage будет вызвана с <info>RUSAGE_CHILDREN</info>.

<comment>Return:</comment>
  <info>array|false</info>  Возвращает ассоциативный массив, содержащий данные возвращённые из системного вызова.
               Имена элементов соответствуют документированным именам полей. Возвращает <info>false</info> в
               случае возникновения ошибки.

<comment>See Also:</comment>
   * Страница системной документации getrusage(2)


id: getservbyname
type: function
doc:
<comment>Description:</comment>
  Получает номер порта, связанного с интернет-службой и протоколом
  
  Функция <strong>getservbyname()</strong> возвращает порт, который соответствует параметру <strong>$service</strong> для заданного
  протокола в параметре <strong>$protocol</strong> согласно /etc/services.

<comment>Param:</comment>
  <info>string</info>  <strong>$service</strong>   Имя службы Интернета в виде строки.
  <info>string</info>  <strong>$protocol</strong>  Параметр <strong>$protocol</strong> может быть равен <return>"tcp"</return> или <return>"udp"</return> (в нижнем регистре).

<comment>Return:</comment>
  <info>int|false</info>  Возвращает номер порта, или <info>false</info>, если <strong>$service</strong> или <strong>$protocol</strong> не найдены.

<comment>See Also:</comment>
   * <strong>getservbyport()</strong>
   * 
     Смотрите http://www.iana.org/assignments/port-numbers
     для получения полного списка номеров портов.
    


id: getservbyport
type: function
doc:
<comment>Description:</comment>
  Получает интернет-службу, соответствующую заданному порту и протоколу
  
  Функция <strong>getservbyport()</strong> возвращает Интернет-службу, соответствующую заданному в параметре <strong>$port</strong>
  порту для определённого протокола <strong>$protocol</strong> согласно /etc/services.

<comment>Param:</comment>
  <info>int</info>     <strong>$port</strong>      Номер порта.
  <info>string</info>  <strong>$protocol</strong>  Параметр <strong>$protocol</strong> может быть <return>"tcp"</return> or <return>"udp"</return> (в нижнем регистре).

<comment>Return:</comment>
  <info>string|false</info>  Возвращает имя Интернет-службы в виде строки или <info>false</info> в случае возникновения
                ошибки.

<comment>See Also:</comment>
   * <strong>getservbyname()</strong>


id: gettext
type: function
doc:
<comment>Description:</comment>
  Ищет сообщение в текущем домене
  
  Ищет сообщение в текущем домене.

<comment>Param:</comment>
  <info>string</info>  <strong>$message</strong>  Переводимое сообщение.

<comment>Return:</comment>
  <info>string</info>  Возвращает переведённую строку (<info>string</info>), если она найдена в таблице перевода, иначе -
          переданное сообщение.

<comment>See Also:</comment>
   * <strong>setlocale()</strong>


id: gettimeofday
type: function
doc:
<comment>Description:</comment>
  Возвращает текущее время
  
  Функция является интерфейсом к системному вызову gettimeofday(2). Она возвращает ассоциативный
  массив, содержащий информацию, полученную от системного вызова.

<comment>Param:</comment>
  <info>bool</info>  <strong>$as_float</strong>  Если установлено в <info>true</info>, вместо массива возвращается число с плавающей точкой.

<comment>Return:</comment>
  <info>array|float</info>  По умолчанию возвращается массив (<info>array</info>). Если установлен параметр <strong>$as_float</strong>, то
               возвращается число с плавающей точкой (<info>float</info>).
               
               Ключи массива:  "sec" - количество секунд, прошедших с эпохи Unix  "usec" -
               микросекунды  "minuteswest" - смещение к западу от Гринвича, в минутах  "dsttime" -
               тип коррекции летнего времени
               
               "sec" - количество секунд, прошедших с эпохи Unix
               
               "usec" - микросекунды
               
               "minuteswest" - смещение к западу от Гринвича, в минутах
               
               "dsttime" - тип коррекции летнего времени


id: gettype
type: function
doc:
<comment>Description:</comment>
  Возвращает тип переменной
  
  Возвращает тип PHP-переменной <strong>$value</strong>. Для проверки типа переменной используйте функции <return>is_*</return>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  Проверяемая переменная.

<comment>Return:</comment>
  <info>string</info>  Возможными значениями возвращаемой строки являются: <return>"boolean"</return><return>"integer"</return><return>"double"</return> (по
          историческим причинам в случае типа <info>float</info> возвращается <return>"double"</return>, а не просто <return>"float"</return>)
          <return>"string"</return><return>"array"</return><return>"object"</return><return>"resource"</return><return>"resource (closed)"</return> с PHP 7.2.0 <return>"NULL"</return><return>"unknown type"</return>

<comment>See Also:</comment>
   * <strong>get_debug_type()</strong>
   * <strong>settype()</strong>
   * <strong>get_class()</strong>
   * <strong>is_array()</strong>
   * <strong>is_bool()</strong>
   * <strong>is_callable()</strong>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_null()</strong>
   * <strong>is_numeric()</strong>
   * <strong>is_object()</strong>
   * <strong>is_resource()</strong>
   * <strong>is_scalar()</strong>
   * <strong>is_string()</strong>
   * <strong>function_exists()</strong>
   * <strong>method_exists()</strong>


id: glob
type: function
doc:
<comment>Description:</comment>
  Находит файловые пути, совпадающие с шаблоном
  
  Функция <strong>glob()</strong> ищет все пути, совпадающие с шаблоном <strong>$pattern</strong> согласно правилам, используемым в
  функции glob() библиотеки libc, которые похожи на правила, используемые большинством
  распространённых оболочек.

<comment>Param:</comment>
  <info>string</info>  <strong>$pattern</strong>  Шаблон. Не происходит раскрытие тильды и подстановка параметров.
                    
                    Специальные символы: <return>*</return> - Соответствует нулю или большему количеству символов. <return>?</return>
                    - Соответствует ровно одному символу (любому символу). <return>[...]</return> - Соответствует
                    одному символу из группы. Если первый символ <return>!</return>, то соответствует любому символу,
                    не входящему в группу <return>\</return> - Экранирует следующий символ, кроме случаев, когда
                    используется флаг <info>GLOB_NOESCAPE</info>.
                    
                    <return>*</return> - Соответствует нулю или большему количеству символов.
                    
                    <return>?</return> - Соответствует ровно одному символу (любому символу).
                    
                    <return>[...]</return> - Соответствует одному символу из группы. Если первый символ <return>!</return>, то
                    соответствует любому символу, не входящему в группу
                    
                    <return>\</return> - Экранирует следующий символ, кроме случаев, когда используется флаг
                    <info>GLOB_NOESCAPE</info>.
  <info>int</info>     <strong>$flags</strong>    Допустимые флаги: <info>GLOB_MARK</info> - Добавляет слеш (обратный слеш в Windows) к каждой
                    возвращаемой директории. <info>GLOB_NOSORT</info> - Возвращает файлы в том виде, в котором
                    они содержатся в директории (без сортировки). Если этот флаг не указан, то имена
                    сортируются по алфавиту. <info>GLOB_NOCHECK</info> - Возвращает шаблон поиска, если с его
                    помощью не был найден ни один файл. <info>GLOB_NOESCAPE</info> - Обратные слеши не экранируют
                    метасимволы. <info>GLOB_BRACE</info> - Раскрывает {a,b,c} для совпадения с 'a', 'b' или 'c'.
                    <info>GLOB_ONLYDIR</info> - Возвращает только директории, совпадающие с шаблоном. <info>GLOB_ERR</info> -
                    Останавливается при ошибках чтения (например, директории без права чтения), по
                    умолчанию ошибки игнорируются.   Флаг <info>GLOB_BRACE</info> недоступен на некоторых не
                    GNU-системах, например, Solaris или Alpine Linux.
                    
                    <info>GLOB_MARK</info> - Добавляет слеш (обратный слеш в Windows) к каждой возвращаемой
                    директории.
                    
                    <info>GLOB_NOSORT</info> - Возвращает файлы в том виде, в котором они содержатся в директории
                    (без сортировки). Если этот флаг не указан, то имена сортируются по алфавиту.
                    
                    <info>GLOB_NOCHECK</info> - Возвращает шаблон поиска, если с его помощью не был найден ни
                    один файл.
                    
                    <info>GLOB_NOESCAPE</info> - Обратные слеши не экранируют метасимволы.
                    
                    <info>GLOB_BRACE</info> - Раскрывает {a,b,c} для совпадения с 'a', 'b' или 'c'.
                    
                    <info>GLOB_ONLYDIR</info> - Возвращает только директории, совпадающие с шаблоном.
                    
                    <info>GLOB_ERR</info> - Останавливается при ошибках чтения (например, директории без права
                    чтения), по умолчанию ошибки игнорируются.
                    
                    Флаг <info>GLOB_BRACE</info> недоступен на некоторых не GNU-системах, например, Solaris или
                    Alpine Linux.

<comment>Return:</comment>
  <info>array|false</info>  Возвращает массив, который содержит совпадающие файлы/директории, пустой массив в
               случае отсутствия совпадения или <info>false</info> в случае ошибки.
               
               На некоторых системах невозможно отличить отсутствие совпадения и ошибку.

<comment>See Also:</comment>
   * <strong>opendir()</strong>
   * <strong>readdir()</strong>
   * <strong>closedir()</strong>
   * <strong>fnmatch()</strong>


id: gmdate
type: function
doc:
<comment>Description:</comment>
  Форматирует дату/время по Гринвичу
  
  Эта функция идентична функции <strong>date()</strong> за исключением того, что возвращает время по Гринвичу (GMT).

<comment>Param:</comment>
  <info>string</info>    <strong>$format</strong>     Формат выводимой даты типа строка (<info>string</info>). Смотрите параметры
                        форматирования для функции <strong>date()</strong>.
  <info>int|null</info>  <strong>$timestamp</strong>  Необязательный параметр <strong>$timestamp</strong> представляет собой метку времени типа
                        <info>int</info>, по умолчанию равную текущему локальному времени, если <strong>$timestamp</strong> не
                        указан или <info>null</info>. Другими словами, значение по умолчанию равно результату
                        функции <strong>time()</strong>.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку с форматированной датой.

<comment>See Also:</comment>
   * DateTimeImmutable::__construct
   * DateTimeInterface::format
   * <strong>date()</strong>
   * <strong>mktime()</strong>
   * <strong>gmmktime()</strong>
   * IntlDateFormatter::format


id: gmmktime
type: function
doc:
<comment>Description:</comment>
  Возвращает локальную метку времени Unix для времени по Гринвичу
  
  Эта функция идентична функции <strong>mktime()</strong>, за исключением того, что аргументы являются временем по
  Гринвичу (GMT). <strong>gmmktime()</strong> внутри использует <strong>mktime()</strong>, поэтому могут быть использованы только те
  даты местного времени, которые корректно представляются в этом часовом поясе.
  
  Подобно функции <strong>mktime()</strong>, необязательные аргументы могут быть опущены в порядке справа налево, при
  этом все опущенные аргументы предполагаются равными соответствующим компонентам текущего времени
  по Гринвичу.
  
  Вызов функции <strong>gmmktime()</strong> без аргументов не поддерживается и приведёт к ошибке <class>ArgumentCountError</class>.

<comment>Param:</comment>
  <info>int</info>       <strong>$hour</strong>    Количество часов, прошедших с начала дня, указанного параметрами <strong>$month</strong>, <strong>$day</strong> и
                     <strong>$year</strong>. Отрицательные значения определяют часы до полуночи указанного дня.
                     Значения, большие 23 определяют соответствующий час следующего дня (или дней).
  <info>int|null</info>  <strong>$minute</strong>  Количество минут, прошедших от начала часа, указанного параметром <strong>$hour</strong>.
                     Отрицательные значения определяют минуты предыдущего часа. Значения, большие 59
                     определяют соответствующие минуты следующего часа (или часов).
  <info>int|null</info>  <strong>$second</strong>  Количество секунд, прошедших от начала минуты, указанной параметром <strong>$minute</strong>.
                     Отрицательные значения определяют секунды из предыдущей минуты. Значения,
                     большие 59 определяют соответствующие секунды следующей минуты (или минут).
  <info>int|null</info>  <strong>$month</strong>   Количество месяцев, прошедших с конца предыдущего года. Значения от 1 до 12
                     определяют нормальные обычные календарные месяцы года. Значения, меньшие 1
                     (включая отрицательные значения) определяют месяца предыдущего года в обратном
                     порядке, то есть 0 будет декабрём, -1 - ноябрём и т.д. Значения больше 12
                     определяют соответствующий месяц в следующем году (или годах).
  <info>int|null</info>  <strong>$day</strong>     Количество дней, прошедших с конца предыдущего месяца. Значения от 1 до 28, 29,
                     30 или 31 (в зависимости от месяца) определяют нормальные дни соответствующего
                     месяца. Значения, меньшие 1 (включая отрицательные значения) определяют дни
                     предыдущего месяца, таким образом, 0 является последним днём предыдущего
                     месяца, -1 - предпоследним днём предыдущего месяца и т.д. Значения, большие
                     количества дней соответствующего месяца определяют соответствующий день
                     следующего месяца (или месяцев).
  <info>int|null</info>  <strong>$year</strong>    Год

<comment>Return:</comment>
  <info>int|false</info>  Возвращает временную метку Unix (<info>int</info>) в случае успешного выполнения или <info>false</info>, если
             временная метка не может быть представлена в виде целого числа PHP.

<comment>See Also:</comment>
   * The <class>DateTimeImmutable</class> class
   * <strong>mktime()</strong>
   * <strong>date()</strong>
   * <strong>time()</strong>


id: gmp_abs
type: function
doc:
<comment>Description:</comment>
  Абсолютная величина
  
  Получение абсолютной величины числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Возвращает абсолютную величину аргумента <strong>$num</strong>, в виде GMP числа.


id: gmp_add
type: function
doc:
<comment>Description:</comment>
  Сложение чисел
  
  Складывает два числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Первое слагаемое.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Второе слагаемое.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Сумма аргументов в виде GMP числа.


id: gmp_and
type: function
doc:
<comment>Description:</comment>
  Побитовое И
  
  Вычисляет побитовое И двух GMP чисел.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Результат побитового <return>И</return> в виде GMP числа.


id: gmp_binomial
type: function
doc:
<comment>Description:</comment>
  Вычисляет биномиальный коэффициент
  
  Вычисляет биномиальный коэффициент C(n, k).

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$n</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$k</strong>  

<comment>Return:</comment>
  <info>GMP</info>  Возвращает биномиальный коэффициент C(n, k).


id: gmp_clrbit
type: function
doc:
<comment>Description:</comment>
  Сброс бита
  
  Сбрасывает (устанавливает в 0) бит на позиции <strong>$index</strong> аргумента <strong>$num</strong>. Индексация начинается с 0.

<comment>Param:</comment>
  <info>GMP</info>  <strong>$num</strong>    Объект <class>GMP</class>.
  <info>int</info>  <strong>$index</strong>  Индекс очищаемого бита. Индекс 0 указывает на младший бит.

<comment>Return:</comment>
  <info>void</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * <strong>gmp_setbit()</strong>
   * <strong>gmp_testbit()</strong>


id: gmp_cmp
type: function
doc:
<comment>Description:</comment>
  Сравнение чисел
  
  Сравнивает два числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>int</info>  Возвращает положительное значение, если <return>a &gt; b</return>, ноль, если <return>a = b</return> и отрицательное значение,
       если <return>a \< b</return>.


id: gmp_com
type: function
doc:
<comment>Description:</comment>
  Вычисляет дополнение до единицы числа
  
  Возвращает дополнение до единицы числа <strong>$num</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Возвращает дополнение до единицы числа <strong>$num</strong> в виде числа GMP.


id: gmp_div
type: function
doc:
<comment>Description:</comment>
  Псевдоним gmp_div_q
  
  Функция является псевдонимом:  <strong>gmp_div_q()</strong>.


id: gmp_div_q
type: function
doc:
<comment>Description:</comment>
  Деление чисел
  
  Делит <strong>$num1</strong> на <strong>$num2</strong> и возвращает целочисленный результат.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>           Делимое.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>           Делитель числа <strong>$num1</strong>.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$rounding_mode</strong>  Округление результата определяется параметром <strong>$rounding_mode</strong>,
                                  который может принимать следующие значения: <info>GMP_ROUND_ZERO</info>:
                                  Дробная часть просто отрезается. <info>GMP_ROUND_PLUSINF</info>: Результат
                                  округляется до ближайшего целого в сторону <return>+бесконечности</return>.
                                  <info>GMP_ROUND_MINUSINF</info>: Результат округляется до ближайшего целого в
                                  сторону <return>-бесконечности</return>.
                                  
                                  <info>GMP_ROUND_ZERO</info>: Дробная часть просто отрезается.
                                  
                                  <info>GMP_ROUND_PLUSINF</info>: Результат округляется до ближайшего целого в
                                  сторону <return>+бесконечности</return>.
                                  
                                  <info>GMP_ROUND_MINUSINF</info>: Результат округляется до ближайшего целого в
                                  сторону <return>-бесконечности</return>.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * <strong>gmp_div_r()</strong>
   * <strong>gmp_div_qr()</strong>


id: gmp_div_qr
type: function
doc:
<comment>Description:</comment>
  Деление чисел и получение частного и остатка
  
  Функция делит <strong>$num1</strong> на <strong>$num2</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>           Делимое.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>           Делитель числа <strong>$num1</strong>.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$rounding_mode</strong>  В документации к функции <strong>gmp_div_q()</strong> приведено описание аргумента
                                  <strong>$rounding_mode</strong>.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив (<info>array</info>), в котором первый элемент содержит <return>[n/d]</return> (целое частное), а
         второй <return>(n - [n/d] * d)</return> (остаток от деления).

<comment>See Also:</comment>
   * <strong>gmp_div_q()</strong>
   * <strong>gmp_div_r()</strong>


id: gmp_div_r
type: function
doc:
<comment>Description:</comment>
  Остаток от деления чисел
  
  Вычисляет остаток от деления нацело числа <strong>$num1</strong> на <strong>$num2</strong>. Если число <strong>$num1</strong> отлично от нуля,
  результат будет иметь знак этого числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>           Делимое.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>           Делитель числа <strong>$num1</strong>.
                                  
                                  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$rounding_mode</strong>  В документации к функции <strong>gmp_div_q()</strong> приведено описание аргумента
                                  <strong>$rounding_mode</strong>.

<comment>Return:</comment>
  <info>GMP</info>  Остаток в виде GMP числа.

<comment>See Also:</comment>
   * <strong>gmp_div_q()</strong>
   * <strong>gmp_div_qr()</strong>


id: gmp_divexact
type: function
doc:
<comment>Description:</comment>
  Делит числа без остатка
  
  Делит число <strong>$num1</strong> на <strong>$num2</strong>, используя быстрый алгоритм деления без остатка. Функция выдаёт
  корректный результат, только если заведомо известно, что число <strong>$num2</strong> делит <strong>$num1</strong> нацело.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Делимое.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Делитель числа <strong>$num1</strong>.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmp_export
type: function
doc:
<comment>Description:</comment>
  Экспортировать в бинарную строку
  
  Экспортирует GMP-число в бинарную строку

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>        GMP-число для экспорта
  <info>int</info>             <strong>$word_size</strong>  По умолчанию равно 1. Количество байт в каждом блоке бинарных данных.
                              Обычно используется совместно с заданием параметра options.
  <info>int</info>             <strong>$flags</strong>      По умолчанию <info>GMP_MSW_FIRST</info> | <info>GMP_NATIVE_ENDIAN</info>.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку.

<comment>See Also:</comment>
   * <strong>gmp_import()</strong>


id: gmp_fact
type: function
doc:
<comment>Description:</comment>
  Факториал
  
  Вычисляет факториал (<return>num!</return>) числа <strong>$num</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Число, факториал которого вычисляется.
                        
                        Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmp_gcd
type: function
doc:
<comment>Description:</comment>
  Вычисление наибольшего общего делителя
  
  Вычисляет наибольший общий делитель чисел <strong>$num1</strong> и <strong>$num2</strong>. Результат всегда положителен, даже если
  одно из чисел, или оба, отрицательные.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Положительный НОД чисел <strong>$num1</strong> и <strong>$num2</strong>.

<comment>See Also:</comment>
   * <strong>gmp_lcm()</strong>


id: gmp_gcdext
type: function
doc:
<comment>Description:</comment>
  Вычисление НОД и множителей
  
  Вычисляет величины g, s и t, в выражении <return>a*s + b*t = g = gcd(a,b)</return>, где gcd - наибольший общий
  делитель. Возвращает массив, значения которого соответствуют значениям величин g, s и t.
  
  Эта функция может использоваться для решения Диофантовых уравнений с двумя переменными. Это такие
  уравнения, которые имеют только целочисленные решения и имеют вид: <return>a*x + b*y = c</return>. За
  дополнительной информацией обращайтесь на страницу "Диофантово уравнение" в MathWorld

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>array</info>  Массив (<info>array</info>) GMP чисел.


id: gmp_hamdist
type: function
doc:
<comment>Description:</comment>
  Расстояние Хэмминга
  
  Возвращает расстояние Хэмминга для чисел <strong>$num1</strong> и <strong>$num2</strong>. Оба операнда должны быть неотрицательными.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
                         
                         Должно быть неотрицательным.
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
                         
                         Должно быть неотрицательным.

<comment>Return:</comment>
  <info>int</info>  Расстояние Хэмминга между <strong>$num1</strong> и <strong>$num2</strong> в виде целого числа (<info>int</info>).

<comment>See Also:</comment>
   * <strong>gmp_popcount()</strong>
   * <strong>gmp_xor()</strong>


id: gmp_import
type: function
doc:
<comment>Description:</comment>
  Импортировать из бинарной строки
  
  Импортирует GMP-число из бинарной строки

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>       Бинарная строка для импорта
  <info>int</info>     <strong>$word_size</strong>  По умолчанию равно 1. Количество байт в каждом блоке бинарных данных. Обычно
                      используется совместно с заданием параметра options.
  <info>int</info>     <strong>$flags</strong>      По умолчанию <info>GMP_MSW_FIRST</info> | <info>GMP_NATIVE_ENDIAN</info>.

<comment>Return:</comment>
  <info>GMP</info>  Возвращает GMP-число.

<comment>See Also:</comment>
   * <strong>gmp_export()</strong>


id: gmp_init
type: function
doc:
<comment>Description:</comment>
  Создание GMP числа
  
  Создаёт GMP число из целого числа или строки.

<comment>Param:</comment>
  <info>int|string</info>  <strong>$num</strong>   Целое число или строка. Число, заданное строкой может быть десятичным,
                     шестнадцатеричным или восьмеричным.
  <info>int</info>         <strong>$base</strong>  Основание системы счисления.
                     
                     Основание может варьироваться от 2 до 62. Если основание 0 (по умолчанию),
                     основание будет определено, исходя из первых символов: если первые два символа
                     <return>0x</return> или <return>0X</return>, число будет интерпретировано как шестнадцатеричное, если первые два
                     символа - <return>0b</return> or <return>0B</return>, предполагается двоичный, если первый символ "0", то как
                     восьмеричное, в остальных случаях числа будут восприниматься как десятичные.
                     Для оснований до 36 регистр игнорируется; буквы верхнего и нижнего регистра
                     имеют одинаковое значение. Для оснований от 37 до 62 заглавные буквы
                     представляют обычные от 10 до 35, а строчные буквы - от 36 до 61.

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * GMP::__construct


id: gmp_intval
type: function
doc:
<comment>Description:</comment>
  Преобразование числа GMP в целое число
  
  Функция преобразует число GMP в обычное целое число PHP (<info>int</info>).

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>int</info>  Целое число типа <info>int</info> преобразованное из <strong>$num</strong>.


id: gmp_invert
type: function
doc:
<comment>Description:</comment>
  Инверсия остатка от деления
  
  Вычисляет инверсию остатка от деления числа <strong>$num1</strong> на число <strong>$num2</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP|false</info>  GMP число в случае успешного выполнения либо <info>false</info>, если инверсия не существует.


id: gmp_jacobi
type: function
doc:
<comment>Description:</comment>
  Символ Якоби
  
  Вычисляет Символ Якоби для чисел <strong>$num1</strong> и <strong>$num2</strong>. <strong>$num2</strong> должно быть положительным и нечётным.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
                         
                         Должно быть положительным и нечётным.

<comment>Return:</comment>
  <info>int</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * <strong>gmp_kronecker()</strong>
   * <strong>gmp_legendre()</strong>


id: gmp_kronecker
type: function
doc:
<comment>Description:</comment>
  Символ Кронекера — Якоби
  
  Производит вычисление символа Кронекера — Якоби для <strong>$num1</strong> и <strong>$num2</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>int</info>  Возвращает символ Кронекера — Якоби для <strong>$num1</strong> и <strong>$num2</strong>

<comment>See Also:</comment>
   * <strong>gmp_jacobi()</strong>
   * <strong>gmp_legendre()</strong>


id: gmp_lcm
type: function
doc:
<comment>Description:</comment>
  Вычисляет наименьшее общее кратное
  
  Функция вычисляет наименьшее общее кратное для заданных <strong>$num1</strong> и <strong>$num2</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * <strong>gmp_gcd()</strong>


id: gmp_legendre
type: function
doc:
<comment>Description:</comment>
  Символ Лежандра
  
  Вычисляет  символ Лежандра чисел <strong>$num1</strong> и <strong>$num2</strong>. <strong>$num2</strong> должно быть нечётным и положительным.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
                         
                         Должно быть положительным и нечётным.

<comment>Return:</comment>
  <info>int</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * <strong>gmp_jacobi()</strong>
   * <strong>gmp_kronecker()</strong>


id: gmp_mod
type: function
doc:
<comment>Description:</comment>
  Вычисление остатка от целочисленного деления
  
  Вычисляет остаток от деления числа <strong>$num1</strong> на <strong>$num2</strong>. Результат всегда неотрицательный, знак числа
  <strong>$num2</strong> игнорируется.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Делитель (модуль).
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmp_mul
type: function
doc:
<comment>Description:</comment>
  Умножение чисел
  
  Умножает число <strong>$num1</strong> на <strong>$num2</strong> и возвращает результат.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Первый множитель, число умножаемое на <strong>$num2</strong>.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Второй множитель, число умножаемое на <strong>$num1</strong>.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmp_neg
type: function
doc:
<comment>Description:</comment>
  Изменение знака числа
  
  Возвращает противоположное относительно нуля число.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Возвращает -<strong>$num</strong> в виде GMP числа.


id: gmp_nextprime
type: function
doc:
<comment>Description:</comment>
  Поиск следующего простого числа
  
  Ищет следующее простое число

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Возвращает следующее простое число, большее, чем <strong>$num</strong> в виде GMP числа.


id: gmp_or
type: function
doc:
<comment>Description:</comment>
  Побитовое ИЛИ
  
  Вычисляет побитовое ИЛИ двух GMP чисел.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmp_perfect_power
type: function
doc:
<comment>Description:</comment>
  Проверить, является ли число "совершенной степенью"
  
  Проверяет, является ли <strong>$num</strong> совершенной степенью. Целое число является совершенной степенью, если
  его можно получить возведением меньшего целого числа в целую степень.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если <strong>$num</strong> является совершенной степенью. В противном случае возвращает
        <info>false</info>.

<comment>See Also:</comment>
   * <strong>gmp_perfect_square()</strong>


id: gmp_perfect_square
type: function
doc:
<comment>Description:</comment>
  Проверка числа на точный квадрат
  
  Проверяет, является ли число точным квадратом, т.е. квадратом целого числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Проверяемое на точный квадрат число.
                        
                        Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если <strong>$num</strong> является квадратом целого числа, в противном случае возвращает
        <info>false</info>.

<comment>See Also:</comment>
   * <strong>gmp_perfect_power()</strong>
   * <strong>gmp_sqrt()</strong>
   * <strong>gmp_sqrtrem()</strong>


id: gmp_popcount
type: function
doc:
<comment>Description:</comment>
  Количество единиц в двоичной записи числа
  
  Возвращает количество единиц в двоичной записи числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>int</info>  Количество единиц в двоичной записи числа <strong>$num</strong>, в виде числа (<info>int</info>).


id: gmp_pow
type: function
doc:
<comment>Description:</comment>
  Возводит число в степень
  
  Возводит число <strong>$num</strong> в степень <strong>$exponent</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>       Основание степени.
                             
                             Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$exponent</strong>  Положительный показатель степени числа <strong>$num</strong>.

<comment>Return:</comment>
  <info>GMP</info>  Новое (результирующее) GMP число. Результатом примера <return>0^0</return> будет 1.


id: gmp_powm
type: function
doc:
<comment>Description:</comment>
  Возводит число в степень и производит деление по модулю
  
  Вычисляет (<strong>$num</strong> возводится в степень <strong>$exponent</strong>) остаток от целочисленного деления на <strong>$modulus</strong>.
  Если <strong>$exponent</strong> отрицателен, результат не определён.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>       Основание степени.
                             
                             Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$exponent</strong>  Положительный показатель степени, в которую возводится <strong>$num</strong>.
                             
                             Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$modulus</strong>   Делитель, остаток от целочисленного деления на который будет возвращён.
                             
                             Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Новое GMP число (результат операции).


id: gmp_prob_prime
type: function
doc:
<comment>Description:</comment>
  Проверяет, является ли число "вероятно простым"
  
  Функция использует тест Миллера-Рабина для определения, является ли число простым.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>          Число, для которого проводится проверка.
                                
                                Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$repetitions</strong>  Допустимые значения аргумента <strong>$repetitions</strong> лежат в диапазоне от 5 до
                                10 (по умолчанию 10); чем больше это число, тем меньше вероятность,
                                что непростые числа пройдут этот тест и определятся, как "возможно
                                простые".
                                
                                Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>int</info>  Если функция возвращает 0, <strong>$num</strong> точно не является простым. Если возвращает 1, то <strong>$num</strong>
       "возможно" простое. Если возвращает 2, то <strong>$num</strong> точно простое.


id: gmp_random
type: function
doc:
<comment>Description:</comment>
  Случайное число
  
  Генерирует случайное число. Число будет лежать в пределах от нуля до (2 ** n) - 1, где n - это
  число, представляющее из себя произведение числа <strong>$limiter</strong> и количества бит в лимбе (limb). Если
  число <strong>$limiter</strong> отрицательное, то будет возвращён отрицательный результат.
  
  Лимб (дословно конечность) - внутренний GMP механизм. Технически это часть числа, помещающаяся в
  одно машинное слово. Количество бит в нем может различаться в разных системах. В основном это либо
  32, либо 64, но это не гарантируется.
  
  Функция не создаёт криптографически защищённые значения и не должна использоваться для
  криптографических целей или целей, требующих, чтобы возвращаемые значения были недоступны для
  разгадывания.
  
  Если нужна криптографически безопасная случайная последовательность, можно использовать класс
  <class>Random\Randomizer</class> с движком <class>Random\Engine\Secure</class>. Для простых сценариев существуют функции
  <strong>random_int()</strong> и <strong>random_bytes()</strong> с удобным API криптографически безопасного генератора
  псевдослучайных чисел (CSPRNG), поддерживаемого операционной системой.

<comment>Param:</comment>
  <info>int</info>  <strong>$limiter</strong>  Ограничитель.
                 
                 Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Случайное GMP число.


id: gmp_random_bits
type: function
doc:
<comment>Description:</comment>
  Random number
  
  Generate a random number. The number will be between <return>0</return> and <return>2$bits - 1</return>.
  
  <strong>$bits</strong> must greater than 0, and the maximum value is restricted by available memory.
  
  Функция не создаёт криптографически защищённые значения и не должна использоваться для
  криптографических целей или целей, требующих, чтобы возвращаемые значения были недоступны для
  разгадывания.
  
  Если нужна криптографически безопасная случайная последовательность, можно использовать класс
  <class>Random\Randomizer</class> с движком <class>Random\Engine\Secure</class>. Для простых сценариев существуют функции
  <strong>random_int()</strong> и <strong>random_bytes()</strong> с удобным API криптографически безопасного генератора
  псевдослучайных чисел (CSPRNG), поддерживаемого операционной системой.

<comment>Param:</comment>
  <info>int</info>  <strong>$bits</strong>  The number of bits to generate.

<comment>Return:</comment>
  <info>GMP</info>  A random GMP number.


id: gmp_random_range
type: function
doc:
<comment>Description:</comment>
  Get a uniformly selected integer
  
  Generate a random number. The number will be between <strong>$min</strong> and <strong>$max</strong>.
  
  <strong>$min</strong> and <strong>$max</strong> can both be negative, but <strong>$min</strong> must always be less than <strong>$max</strong>.
  
  Функция не создаёт криптографически защищённые значения и не должна использоваться для
  криптографических целей или целей, требующих, чтобы возвращаемые значения были недоступны для
  разгадывания.
  
  Если нужна криптографически безопасная случайная последовательность, можно использовать класс
  <class>Random\Randomizer</class> с движком <class>Random\Engine\Secure</class>. Для простых сценариев существуют функции
  <strong>random_int()</strong> и <strong>random_bytes()</strong> с удобным API криптографически безопасного генератора
  псевдослучайных чисел (CSPRNG), поддерживаемого операционной системой.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$min</strong>  A GMP number representing the lower bound for the random number
  <info>GMP|int|string</info>  <strong>$max</strong>  A GMP number representing the upper bound for the random number

<comment>Return:</comment>
  <info>GMP</info>  Returns a <class>GMP</class> object which contains a uniformly selected integer from the closed interval
       [<strong>$min</strong>, <strong>$max</strong>]. Both <strong>$min</strong> and <strong>$max</strong> are possible return values.


id: gmp_random_seed
type: function
doc:
<comment>Description:</comment>
  Установить начальное состояние RNG

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$seed</strong>  Начальное состояние для функций <strong>gmp_random()</strong>, <strong>gmp_random_bits()</strong> и
                         <strong>gmp_random_range()</strong>.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>void</info>  Функция не возвращает значения после выполнения.

<comment>See Also:</comment>
   * <strong>gmp_init()</strong>
   * <strong>gmp_random()</strong>
   * <strong>gmp_random_bits()</strong>
   * <strong>gmp_random_range()</strong>


id: gmp_root
type: function
doc:
<comment>Description:</comment>
  Извлечь корень степени N и вернуть его целую часть
  
  Извлекает корень степени <strong>$nth</strong> из <strong>$num</strong> и возвращает целочисленную часть результата.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$nth</strong>  Положительное число степени корня <strong>$num</strong>.

<comment>Return:</comment>
  <info>GMP</info>  Целочисленную часть результата извлечения корня в виде GMP-числа.


id: gmp_rootrem
type: function
doc:
<comment>Description:</comment>
  Извлечь корень степени N и вернуть его целую часть и остаток
  
  Извлекает корень степени <strong>$nth</strong> из <strong>$num</strong>, возвращает его целую часть и остаток (остаток вычисляется
  путём вычитания из первоначального числа целочисленного результата в степени nth).

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$nth</strong>  Положительное число степени корня <strong>$num</strong>.

<comment>Return:</comment>
  <info>array</info>  Массив с двумя элементами, первый из которых равен целочисленной компоненте результата, а
         второй остатку. Оба элемента возвращаются в виде GMP-чисел.


id: gmp_scan0
type: function
doc:
<comment>Description:</comment>
  Поиск нуля в числе
  
  Сканирует <strong>$num1</strong>, начиная с бита <strong>$start</strong>, пока не найдёт бит установленный в 0.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>   Число для сканирования.
                          
                          Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$start</strong>  Бит начала сканирования.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс найденного бита в виде числа (<info>int</info>). Индексация начинается с нуля.


id: gmp_scan1
type: function
doc:
<comment>Description:</comment>
  Поиск единицы в числе
  
  Сканирует <strong>$num1</strong>, начиная с бита <strong>$start</strong>, пока не найдёт бит установленный в 1.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>   Сканируемое число.
                          
                          Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$start</strong>  Бит начала поиска.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс найденного бита в виде числа (<info>int</info>). Если таких нет, будет возвращено -1.


id: gmp_setbit
type: function
doc:
<comment>Description:</comment>
  Установка бита
  
  Устанавливает в 1 бит с индексом <strong>$index</strong> в числе <strong>$num</strong>.

<comment>Param:</comment>
  <info>GMP</info>   <strong>$num</strong>    Объект <class>GMP</class>.
  <info>int</info>   <strong>$index</strong>  Индекс устанавливаемого бита. Индекс 0 указывает на младший бит.
  <info>bool</info>  <strong>$value</strong>  True для установки бита (установки в 1/включён); false для его очистки (установки в
                0/выключен).

<comment>Return:</comment>
  <info>void</info>  Объект класса <class>GMP</class>.

<comment>See Also:</comment>
   * <strong>gmp_clrbit()</strong>
   * <strong>gmp_testbit()</strong>


id: gmp_sign
type: function
doc:
<comment>Description:</comment>
  Знак числа
  
  Проверяет знак числа.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, либо строка, содержащая число, которую можно преобразовать к
                        типу <info>int</info>.

<comment>Return:</comment>
  <info>int</info>  Возвращает 1, если <strong>$num</strong> положительное; -1, если <strong>$num</strong> отрицательное; и 0, если <strong>$num</strong> равно
       нулю.

<comment>See Also:</comment>
   * <strong>gmp_abs()</strong>
   * <strong>abs()</strong>


id: gmp_sqrt
type: function
doc:
<comment>Description:</comment>
  Вычисление квадратного корня
  
  Вычисляет квадратный корень числа <strong>$num</strong>.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Целая часть корня в виде GMP числа.


id: gmp_sqrtrem
type: function
doc:
<comment>Description:</comment>
  Квадратный корень с остатком
  
  Вычисляет квадратный корень числа, с остатком.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>  Число, из которого извлекается корень.
                        
                        Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>array</info>  Возвращает массив, в котором первый элемент - целая часть корня из числа <strong>$num</strong>, а второй -
         остаток (т.е. разность чисел <strong>$num</strong> и квадрата первого элемента массива).


id: gmp_strval
type: function
doc:
<comment>Description:</comment>
  Преобразование GMP числа в строку
  
  Преобразует GMP число в строку в системе счисления <strong>$base</strong>. По умолчанию числа преобразуются в
  десятеричной системе счисления.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>   GMP число для конвертации.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$base</strong>  Система счисления возвращаемого числа. По умолчанию - 10. Возможные
                         значения: от 2 до 62 и от -2 до -36.

<comment>Return:</comment>
  <info>string</info>  Число в виде строки (<info>string</info>).


id: gmp_sub
type: function
doc:
<comment>Description:</comment>
  Вычитание чисел
  
  Вычитает число <strong>$num2</strong> из числа <strong>$num1</strong> и возвращает результат.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Уменьшаемое.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Вычитаемое из числа <strong>$num1</strong>.
                         
                         Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmp_testbit
type: function
doc:
<comment>Description:</comment>
  Проверка, установлен ли бит в 1
  
  Проверяет, установлен ли заданный бит в 1.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num</strong>    Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>int</info>             <strong>$index</strong>  Проверяемый бит

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если бит установлен в <strong>$num</strong>, иначе <info>false</info>.

<comment>See Also:</comment>
   * <strong>gmp_setbit()</strong>
   * <strong>gmp_clrbit()</strong>


id: gmp_xor
type: function
doc:
<comment>Description:</comment>
  Побитовое исключающее ИЛИ
  
  Вычисляет побитовое исключающее ИЛИ (XOR) двух GMP чисел.

<comment>Param:</comment>
  <info>GMP|int|string</info>  <strong>$num1</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).
  <info>GMP|int|string</info>  <strong>$num2</strong>  Объект <class>GMP</class>, целое число (<info>int</info>) или числовая строка (<info>string</info>).

<comment>Return:</comment>
  <info>GMP</info>  Объект класса <class>GMP</class>.


id: gmstrftime
type: function
doc:
<comment>Description:</comment>
  Форматирует дату/время по Гринвичу с учётом текущей локали
  
  Эта функция идентична функции <strong>strftime()</strong> за исключением того, что возвращает время по Гринвичу
  (GMT). Например, при запуске на системе, где установлено Eastern Standard Time (GMT-0500), первая
  строка из примера ниже выведет "Dec 31 1998 20:00:00", тогда как вторая - "Jan 01 1999 01:00:00".
  
  Функция зависит от информации о локали операционной системы, которая может быть несовместима друг
  с другом или вообще отсутствовать. Вместо этой функции используйте метод
  IntlDateFormatter::format.

<comment>Param:</comment>
  <info>string</info>    <strong>$format</strong>     Смотрите описание функции <strong>strftime()</strong>.
  <info>int|null</info>  <strong>$timestamp</strong>  Необязательный параметр <strong>$timestamp</strong> представляет собой метку времени типа
                        <info>int</info>, по умолчанию равную текущему локальному времени, если <strong>$timestamp</strong> не
                        указан или <info>null</info>. Другими словами, значение по умолчанию равно результату
                        функции <strong>time()</strong>.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает строку, отформатированную согласно указанному формату и с использованием
                временной метки из параметра <strong>$timestamp</strong> или текущего локального времени, если
                временная метка не была указана. Названия месяцев, дней недели и других
                языкозависимых строк будут показаны с учётом настроек текущей локали, установленных
                с помощью функции <strong>setlocale()</strong>. В случае возникновения ошибки возвращает <info>false</info>.

<comment>See Also:</comment>
   * IntlDateFormatter::format
   * DateTimeInterface::format
   * <strong>strftime()</strong>


id: gnupg_adddecryptkey
type: function
doc:
<comment>Description:</comment>
  Добавить ключ для расшифровки

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>   Идентификатор gnupg, полученный из
                          <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$fingerprint</strong>  Отпечаток ключа.
  <info>string</info>    <strong>$passphrase</strong>   Кодовое слово.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_addencryptkey
type: function
doc:
<comment>Description:</comment>
  Добавляет ключ для шифрования

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>   Идентификатор gnupg, полученный из
                          <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$fingerprint</strong>  Отпечаток ключа.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_addsignkey
type: function
doc:
<comment>Description:</comment>
  Добавить ключ для подписания

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>   Идентификатор gnupg, полученный из
                          <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$fingerprint</strong>  Отпечаток ключа.
  <info>string</info>    <strong>$passphrase</strong>   Пароль.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_cleardecryptkeys
type: function
doc:
<comment>Description:</comment>
  Удаляет все ключи, которые были установлены для расшифровки раньше

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_clearencryptkeys
type: function
doc:
<comment>Description:</comment>
  Удаляет все ключи, которые были установлены для шифрования раньше

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_clearsignkeys
type: function
doc:
<comment>Description:</comment>
  Удаляет все ключи, которые были установлены для подписания раньше

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_decrypt
type: function
doc:
<comment>Description:</comment>
  Расшифровывает переданный текст
  
  Расшифровывает переданный текст ключами, установленными ранее с помощью gnupg_adddecryptkey.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$text</strong>        Расшифровываемый текст.

<comment>Return:</comment>
  <info>string|false</info>  В случае успешного выполнения, эта функция возвращает расшифрованный текст. В случае
                возникновения ошибки, эта функция возвращает <info>false</info>.


id: gnupg_decryptverify
type: function
doc:
<comment>Description:</comment>
  Расшифровывает и проверяет подпись переданного текста
  
  Расшифровывает и проверяет подпись переданного текста и возвращает информацию о подписи.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$text</strong>        Текст для расшифровки.
  <info>string</info>    <strong>$plaintext</strong>   Параметру <strong>$plaintext</strong> передаётся расшифрованный текст.

<comment>Return:</comment>
  <info>array|false</info>  В случае успешного выполнения функция возвращает информацию о подписи и передаёт в
               параметр <strong>$plaintext</strong> расшифрованный текст. В случае возникновения ошибки функция
               возвращает <info>false</info>.


id: gnupg_deletekey
type: function
doc:
<comment>Description:</comment>
  Удаляет ключ из связки ключей

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>    Идентификатор gnupg, полученный из
                           <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$key</strong>           Ключ для удаления.
  <info>bool</info>      <strong>$allow_secret</strong>  Указывает, следует ли удалять и секретные ключи.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_encrypt
type: function
doc:
<comment>Description:</comment>
  Шифрует заданный текст
  
  Шифрует заданный текст <strong>$plaintext</strong> с помощью ключа, заданного ранее с помощью функции
  gnupg_addencryptkey и возвращает результат.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$plaintext</strong>   Текст для шифрования.

<comment>Return:</comment>
  <info>string|false</info>  В случае успешного выполнения возвращает зашифрованный текст. В случае возникновения
                ошибки возвращает <info>false</info>.


id: gnupg_encryptsign
type: function
doc:
<comment>Description:</comment>
  Шифрует и подписывает переданный текст
  
  Шифрует и подписывает переданный в параметре <strong>$plaintext</strong> текст ключами, которые были установлены
  gnupg_addsignkey и gnupg_addencryptkey ранее и возвращает зашифрованный и подписанный текст.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$plaintext</strong>   Текст для шифрования.

<comment>Return:</comment>
  <info>string|false</info>  В случае успешного выполнения, эта функция возвращает зашифрованный и подписанный
                текст. В случае возникновения ошибки эта функция возвращает <info>false</info>.


id: gnupg_export
type: function
doc:
<comment>Description:</comment>
  Экспортирует ключ
  
  Экспортирует ключ <strong>$fingerprint</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>   Идентификатор gnupg, полученный из
                          <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$fingerprint</strong>  Отпечаток ключа.

<comment>Return:</comment>
  <info>string|false</info>  В случае успешного выполнения функция возвращает ключ. В случае возникновения ошибки
                функция возвращает <info>false</info>.


id: gnupg_getengineinfo
type: function
doc:
<comment>Description:</comment>
  Возвращает информацию о движке

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив с информацией о движке, состоящей из <return>protocol</return>, <return>file_name</return> и <return>home_dir</return>.


id: gnupg_geterror
type: function
doc:
<comment>Description:</comment>
  Возвращает текст сообщения об ошибке, если функция не была выполнена

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает текст сообщения об ошибке, если произошла ошибка, в противном случае
                возвращает <info>false</info>.


id: gnupg_geterrorinfo
type: function
doc:
<comment>Description:</comment>
  Возвращает информацию об ошибке

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив с информацией об ошибке.


id: gnupg_getprotocol
type: function
doc:
<comment>Description:</comment>
  Возвращает текущий активный протокол для всех операций

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.

<comment>Return:</comment>
  <info>int</info>  Возвращает текущий активный протокол, который может быть одним из <info>GNUPG_PROTOCOL_OpenPGP</info> или
       <info>GNUPG_PROTOCOL_CMS</info>.


id: gnupg_gettrustlist
type: function
doc:
<comment>Description:</comment>
  Поиск доверительных элементов

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$pattern</strong>     Выражение для ограничения списка доверительных элементов только теми,
                         которые соответствуют шаблону.

<comment>Return:</comment>
  <info>array|null</info>  В случае успешного выполнения функция возвращает массив доверительных элементов. В
              случае возникновения ошибки функция возвращает <info>null</info>.


id: gnupg_import
type: function
doc:
<comment>Description:</comment>
  Импортирует ключ
  
  Импортирует ключ <strong>$keydata</strong> и возвращает массив с информацией о процессе импорта.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$keydata</strong>     Ключ для импорта.

<comment>Return:</comment>
  <info>array|false</info>  В случае успешного выполнения возвращает массив с информацией о процессе импорта. В
               случае возникновения ошибки возвращает <info>false</info>.


id: gnupg_init
type: function
doc:
<comment>Description:</comment>
  Инициализировать GnuPG

<comment>Param:</comment>
  <info>array|null</info>  <strong>$options</strong>  Параметр принимает ассоциативный массив. Он используется для изменения
                        конфигурации криптографического механизма по умолчанию. Переопределение
                        конфигурацииКлючТипОписаниеfile_name<info>string</info> Имя файла исполняемой программы,
                        реализующей протокол, который обычно является путём к исполняемому файлу
                        <return>gpg</return>. home_dir<info>string</info> Имя каталога конфигурации. Оно также переопределяет
                        переменную окружения <return>GNUPGHOME</return>, которая используется для той же цели.

<comment>Return:</comment>
  <info>resource</info>  Возвращает ресурс (<info>resource</info>) GnuPG, который используется другими функциями GnuPG.


id: gnupg_keyinfo
type: function
doc:
<comment>Description:</comment>
  Возвращает массив с информацией обо всех ключах, которые
     соответствуют заданному шаблону

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$pattern</strong>     Шаблон, проверяемый на соответствие.

<comment>Return:</comment>
  <info>array|false</info>  Возвращает массив с информацией обо всех ключах, которые соответствуют заданному
               шаблону или <info>false</info> в случае возникновения ошибки.


id: gnupg_listsignatures
type: function
doc:
<comment>Description:</comment>
  Перечисляет подписи ключа

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$keyid</strong>       Идентификатор ключа для списка подписей.

<comment>Return:</comment>
  <info>array|null</info>  В случае успешного выполнения функция возвращает массив подписей ключей. В случае
              возникновения ошибки функция возвращает <info>null</info>.


id: gnupg_setarmor
type: function
doc:
<comment>Description:</comment>
  Переключает вывод в текстовом или бинарном режиме
  
  Переключает вывод в текстовом или бинарном режиме.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>int</info>       <strong>$armor</strong>       В случае не нулевого целого числа, функция включает текстовый режим вывода
                         (по умолчанию). В случае 0, вывод в бинарном режиме.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_seterrormode
type: function
doc:
<comment>Description:</comment>
  Устанавливает режим отчётов об ошибках (error_reporting)
  
  Устанавливает режим error_reporting.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>int</info>       <strong>$errormode</strong>   Режим ошибок.
                         
                         <strong>$errormode</strong> содержит константу, указывающую, какой тип error_reporting
                         должен быть использован. Возможные значения: <info>GNUPG_ERROR_WARNING</info>,
                         <info>GNUPG_ERROR_EXCEPTION</info> и <info>GNUPG_ERROR_SILENT</info>. По умолчанию используется
                         <info>GNUPG_ERROR_SILENT</info>.

<comment>Return:</comment>
  <info>void</info>  Функция не возвращает значения после выполнения.


id: gnupg_setsignmode
type: function
doc:
<comment>Description:</comment>
  Устанавливает режим подписывания
  
  Устанавливает режим подписывания.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info></info>          <strong>$sigmode</strong>     Режим подписывания.
                         
                         <strong>$signmode</strong> содержит константу, указывающую, какой тип подписи должен быть
                         произведён. Возможные значения: <info>GNUPG_SIG_MODE_NORMAL</info>,
                         <info>GNUPG_SIG_MODE_DETACH</info> и <info>GNUPG_SIG_MODE_CLEAR</info>. По умолчанию используется
                         <info>GNUPG_SIG_MODE_CLEAR</info>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: gnupg_sign
type: function
doc:
<comment>Description:</comment>
  Подписывает переданный текст
  
  Подписывает переданный в параметре <strong>$plaintext</strong> текст ключом, который был прежде установлен с
  помощью gnupg_addsignkey и возвращает подписанный текст или подпись, в зависимости от того, что
  было установлено в gnupg_setsignmode.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>  Идентификатор gnupg, полученный из
                         <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$plaintext</strong>   Простой текст для подписания.

<comment>Return:</comment>
  <info>string|false</info>  В случае успешного выполнения функция возвращает подписанный текст или подпись. В
                случае возникновения ошибки функция возвращает <info>false</info>.


id: gnupg_verify
type: function
doc:
<comment>Description:</comment>
  Проверяет подпись текста
  
  Проверяет подпись переданного в параметре <strong>$signed_text</strong> текста и возвращает информацию о подписи.

<comment>Param:</comment>
  <info>resource</info>  <strong>$identifier</strong>   Идентификатор gnupg, полученный из
                          <strong>gnupg_init()</strong> или <class>gnupg</class>.
  <info>string</info>    <strong>$signed_text</strong>  Подписанный текст.
  <info>string</info>    <strong>$signature</strong>    Подпись. Чтобы проверить прозрачную подпись, параметр должен быть равен
                          <info>false</info>.
  <info>string</info>    <strong>$plaintext</strong>    Обычный текст. Если этот необязательный параметр необходимо передать, то
                          он заполняется обычным текстом.

<comment>Return:</comment>
  <info>array|false</info>  В случае успешного выполнения функция возвращает информацию о подписи. В случае
               возникновения ошибки функция возвращает <info>false</info>.


id: grapheme_extract
type: function
doc:
<comment>Description:</comment>
  Функция для извлечения последовательности кластеров графем по умолчанию из текстового буфера,
  которая должна быть закодирована в UTF-8
  
  Процедурный стиль
  
  Функция для извлечения последовательности кластеров графем по умолчанию из текстового буфера,
  которая должна быть закодирована в UTF-8.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  Строка для поиска.
  <info>int</info>     <strong>$size</strong>      Максимальное количество возвращаемых элементов на основе <strong>$type</strong>.
  <info>int</info>     <strong>$type</strong>      Определяет тип единиц, на которые указывает параметр <strong>$size</strong>:
                     
                     GRAPHEME_EXTR_COUNT (по умолчанию) - <strong>$size</strong> - это количество кластеров графемы
                     для извлечения по умолчанию.GRAPHEME_EXTR_MAXBYTES - <strong>$size</strong> - максимальное
                     количество возвращаемых байтов.GRAPHEME_EXTR_MAXCHARS - <strong>$size</strong> - это
                     максимальное количество возвращаемых символов UTF-8.
  <info>int</info>     <strong>$offset</strong>    Начальная позиция <strong>$haystack</strong> в байтах - если задано, оно должно быть нулём или
                     положительным значением, которое меньше или равно длине <strong>$haystack</strong> в байтах,
                     либо отрицательным значением, отсчитываемым от конца <strong>$haystack</strong>. Если <strong>$offset</strong> не
                     указывает на первый байт символа UTF-8, начальная позиция перемещается на
                     границу следующего символа.
  <info>int</info>     <strong>$next</strong>      Ссылка на значение, которое будет установлено для следующей начальной позиции.
                     Когда вызов возвращается, это может указывать на позицию первого байта за
                     концом строки.

<comment>Return:</comment>
  <info>string|false</info>  Строка, начинающаяся со смещения <strong>$offset</strong> и заканчивающаяся границей кластера графемы
                по умолчанию, которая соответствует указанным <strong>$size</strong> и <strong>$type</strong> или <info>false</info> в случае
                возникновения ошибки.

<comment>See Also:</comment>
   * <strong>grapheme_substr()</strong>
   * 
       Сегментация текста в Unicode: границы кластера графемы
      


id: grapheme_stripos
type: function
doc:
<comment>Description:</comment>
  Находит позицию (в единицах графемы) первого появления строки без учёта регистра
  
  Процедурный стиль
  
  Находит позицию (в единицах графемы) первого появления строки без учёта регистра.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  Строка для поиска. Должна быть корректным UTF-8.
  <info>string</info>  <strong>$needle</strong>    Строка, которую нужно найти. Должна быть корректным UTF-8.
  <info>int</info>     <strong>$offset</strong>    Необязательный параметр <strong>$offset</strong> позволяет указать, где в <strong>$haystack</strong> начинать
                     поиск в виде смещения в единицах графемы (не в байтах или символах). Если
                     смещение отрицательное, оно обрабатывается относительно конца строки.
                     Возвращённая позиция по-прежнему относительно начала <strong>$haystack</strong>, независимо от
                     значения <strong>$offset</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает позицию как целое число. Если вхождение <strong>$needle</strong> не найдено, функция
             <strong>grapheme_stripos()</strong> вернёт <info>false</info>.

<comment>See Also:</comment>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: grapheme_stristr
type: function
doc:
<comment>Description:</comment>
  Возвращает часть строки haystack от первого появления needle без учёта регистра до конца haystack
  
  Процедурный стиль
  
  Возвращает часть строки <strong>$haystack</strong> от первого появления needle без учёта регистра до конца
  <strong>$haystack</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>      Входная строка. Должна быть корректным UTF-8.
  <info>string</info>  <strong>$needle</strong>        Строка, которую нужно найти. Должна быть корректным UTF-8.
  <info>bool</info>    <strong>$beforeNeedle</strong>  Если <info>true</info>, функция <strong>grapheme_strstr()</strong> возвращает часть <strong>$haystack</strong> до первого
                         появления <strong>$needle</strong> (исключая <strong>$needle</strong>).

<comment>Return:</comment>
  <info>string|false</info>  Возвращает часть строки или <info>false</info>, если вхождение <strong>$needle</strong> не найдено.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: grapheme_strlen
type: function
doc:
<comment>Description:</comment>
  Получает длину строки в единицах графемы
  
  Процедурный стиль
  
  Получает длину строки в единицах графемы (не байты или символы)

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Строка, которую необходимо измерить. Должна быть корректная строка в кодировке
                   UTF-8.

<comment>Return:</comment>
  <info>int|false|null</info>  Длина строки в случае успешного выполнения или <info>false</info> в случае возникновения
                  ошибки.

<comment>See Also:</comment>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     
   * <strong>iconv_strlen()</strong>
   * <strong>mb_strlen()</strong>
   * <strong>strlen()</strong>


id: grapheme_strpos
type: function
doc:
<comment>Description:</comment>
  Находит позицию (в единицах графемы) первого вхождения строки
  
  Процедурный стиль
  
  Находит позицию (в единицах графемы) первого вхождения строки.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  Строка для поиска. Должна быть корректным UTF-8.
  <info>string</info>  <strong>$needle</strong>    Строка, которую нужно найти. Должна быть корректным UTF-8.
  <info>int</info>     <strong>$offset</strong>    Необязательный параметр <strong>$offset</strong> позволяет указать, где в <strong>$haystack</strong> начинать
                     поиск в виде смещения в единицах графемы (не в байтах или символах). Если
                     смещение отрицательное, оно обрабатывается относительно конца строки.
                     Возвращённая позиция по-прежнему относительно начала <strong>$haystack</strong>, независимо от
                     значения <strong>$offset</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает позицию как целое число. Если вхождение <strong>$needle</strong> не найдено, функция
             <strong>grapheme_strpos()</strong> вернёт <info>false</info>.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: grapheme_strripos
type: function
doc:
<comment>Description:</comment>
  Находит позицию (в единицах графемы) последнего вхождения строки без учёта регистра
  
  Процедурный стиль
  
  Находит позицию (в единицах графемы) последнего вхождения строки без учёта регистра.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  Строка для поиска. Должна быть корректным UTF-8.
  <info>string</info>  <strong>$needle</strong>    Строка, которую нужно найти. Должна быть корректным UTF-8.
  <info>int</info>     <strong>$offset</strong>    Необязательный параметр <strong>$offset</strong> позволяет указать, где в <strong>$haystack</strong> начинать
                     поиск в виде смещения в единицах графемы (не в байтах или символах). Если
                     смещение отрицательное, оно обрабатывается относительно конца строки.
                     Возвращённая позиция по-прежнему относительно начала <strong>$haystack</strong>, независимо от
                     значения <strong>$offset</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает позицию как целое число. Если вхождение <strong>$needle</strong> не найдено, функция
             <strong>grapheme_strripos()</strong> вернёт <info>false</info>.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: grapheme_strrpos
type: function
doc:
<comment>Description:</comment>
  Находит позицию (в единицах графемы) последнего вхождения строки
  
  Процедурный стиль
  
  Находит позицию (в единицах графемы) последнего вхождения строки.

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>  Строка для поиска. Должна быть корректным UTF-8.
  <info>string</info>  <strong>$needle</strong>    Строка, которую нужно найти. Должна быть корректным UTF-8.
  <info>int</info>     <strong>$offset</strong>    Необязательный параметр <strong>$offset</strong> позволяет указать, где в <strong>$haystack</strong> начинать
                     поиск в виде смещения в единицах графемы (не в байтах или символах). Если
                     смещение отрицательное, оно обрабатывается относительно конца строки.
                     Возвращённая позиция по-прежнему относительно начала <strong>$haystack</strong>, независимо от
                     значения <strong>$offset</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает позицию как целое число. Если вхождение <strong>$needle</strong> не найдено, функция
             <strong>grapheme_strrpos()</strong> вернёт <info>false</info>.

<comment>See Also:</comment>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strstr()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: grapheme_strstr
type: function
doc:
<comment>Description:</comment>
  Возвращает часть строки haystack от первого появления needle до конца haystack
  
  Процедурный стиль
  
  Возвращает часть строки haystack от первого появления needle до конца haystack (включая needle).

<comment>Param:</comment>
  <info>string</info>  <strong>$haystack</strong>      Входная строка. Должна быть корректным UTF-8.
  <info>string</info>  <strong>$needle</strong>        Строка, которую нужно найти. Должна быть корректным UTF-8.
  <info>bool</info>    <strong>$beforeNeedle</strong>  Если <info>true</info>, функция <strong>grapheme_strstr()</strong> возвращает часть <strong>$haystack</strong> перед
                         первым появлением <strong>$needle</strong> (исключая <strong>$needle</strong>).

<comment>Return:</comment>
  <info>string|false</info>  Возвращает часть строки <strong>$haystack</strong> или <info>false</info>, если вхождение <strong>$needle</strong> не найдено.

<comment>See Also:</comment>
   * <strong>grapheme_stristr()</strong>
   * <strong>grapheme_stripos()</strong>
   * <strong>grapheme_strpos()</strong>
   * <strong>grapheme_strripos()</strong>
   * <strong>grapheme_strrpos()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: grapheme_substr
type: function
doc:
<comment>Description:</comment>
  Возвращает часть строки
  
  Процедурный стиль
  
  Возвращает часть строки.

<comment>Param:</comment>
  <info>string</info>    <strong>$string</strong>  Входная строка. Должна быть корректным UTF-8.
  <info>int</info>       <strong>$offset</strong>  Начальная позиция в единицах графемы по умолчанию. Если <strong>$offset</strong> больше, либо
                     равна нулю, возвращаемая строка будет начинаться с позиции <strong>$offset</strong> в $string,
                     начиная с нуля. Если значение <strong>$offset</strong> отрицательное, возвращаемая строка будет
                     начинаться с единицы графемы <strong>$offset</strong> от конца строки.
  <info>int|null</info>  <strong>$length</strong>  Длина в графемных единицах. Если задано положительное значение <strong>$length</strong>,
                     возвращаемая строка будет содержать не более <strong>$length</strong> единиц графемы, начиная со
                     значения <strong>$offset</strong> (в зависимости от длины строки). Если задано отрицательное
                     значение <strong>$length</strong>, то такое количество единиц графемы будет опущено в конце
                     строки (после того, как начальная позиция была вычислена, если параметр <strong>$offset</strong>
                     отрицательный). Если <strong>$offset</strong> обозначает позицию за пределами этого усечения,
                     будет возвращена пустая строка.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает извлечённую часть <strong>$string</strong> или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>grapheme_extract()</strong>
   * 
      Сегментация текста в Unicode: границы кластера графемы
     


id: gregoriantojd
type: function
doc:
<comment>Description:</comment>
  Преобразует дату по григорианскому календарю в количество дней в
     юлианском летоисчислении
    
  
  Разрешённый диапазон дат для григорианского календаря с 25 ноября 4714 года до н.э. по 31 декабря
  9999 год н.э.
  
  Несмотря на возможность обработки дат вплоть до 4714 года до н.э., такое использование имеет мало
  смысла. Григорианский календарь не существовал до 15 октября 1582 года (или 5 октября 1582 в
  юлианском календаре). Некоторые страны не переходили на этот календарь очень долгое время.
  Например, Великобритания совершила переход в 1752 году, СССР в 1918 г., Греция в 1923 г.
  Большинство стран Европы предпочитали юлианский календарь григорианскому.

<comment>Param:</comment>
  <info>int</info>  <strong>$month</strong>  Месяц в виде числа от 1 (январь) до 12 (декабрь)
  <info>int</info>  <strong>$day</strong>    День в виде числа от 1 до 31. Если в месяце меньше дней, чем передано, то произойдёт
               переполнение; смотрите пример ниже.
  <info>int</info>  <strong>$year</strong>   Года в виде числа от -4714 до 9999. Отрицательные числа означают года до н.э.,
               положительные - н.э. Обратите внимание, что не существует года <return>0</return>; 31 декабря 1 года
               до н.э. следует сразу после 1 января 1 года н.э.

<comment>Return:</comment>
  <info>int</info>  Количество дней в юлианском летоисчислении для даты по григорианскому календарю. Даты за
       пределами допустимого диапазона возвратят <return>0</return>.

<comment>See Also:</comment>
   * <strong>jdtogregorian()</strong>
   * <strong>cal_to_jd()</strong>


id: gzclose
type: function
doc:
<comment>Description:</comment>
  Закрыть указатель открытого gz-файла
  
  Закрывает открытый gz-файл по переданному указателю.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл. Должен указывать на файл, успешно открытый <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>


id: gzcompress
type: function
doc:
<comment>Description:</comment>
  Сжать строку
  
  Данная функция сжимает строку используя формат данных <return>ZLIB</return>.
  
  Подробнее про алгоритм сжатия ZLIB смотрите документ "Формат сжатия ZLIB. Спецификация версии 3.3"
  (RFC 1950).
  
  Это не то же самое, что и gzip-сжатие, которое включает в себя некоторые данные заголовка.
  Информацию о gzip-сжатии смотрите <strong>gzencode()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>      Данные для сжатия.
  <info>int</info>     <strong>$level</strong>     Уровень сжатия. Целое число от 0 до 9 (0 - без сжатия, 9 - максимальное
                     сжатие).
                     
                     Если используется значение -1, то будет установлен принятый в библиотеке zlib
                     по умолчанию уровень сжатия, который равен 6.
  <info>int</info>     <strong>$encoding</strong>  Одна из констант <info>ZLIB_ENCODING_*</info>.

<comment>Return:</comment>
  <info>string|false</info>  Сжатая строка или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzdeflate()</strong>
   * <strong>gzinflate()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzencode()</strong>


id: gzdecode
type: function
doc:
<comment>Description:</comment>
  Декодирует строку, сжатую с помощью gzip
  
  Эта функция возвращает декодированную версию входных данных. <strong>$data</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>        Данные для декодирования, закодированные с помощью <strong>gzencode()</strong>.
  <info>int</info>     <strong>$max_length</strong>  Максимальный размер строки для декодирования.

<comment>Return:</comment>
  <info>string|false</info>  Распакованная строка или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzencode()</strong>


id: gzdeflate
type: function
doc:
<comment>Description:</comment>
  Сжимает строку
  
  Данная функция сжимает строку, используя формат данных <return>DEFLATE</return>.
  
  Подробнее об алгоритме сжатия DEFLATE смотрите "Формат сжатия данных DEFLATE. Спецификация версии
  1.3" (RFC 1951).

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>      Данные для сжатия.
  <info>int</info>     <strong>$level</strong>     Уровень сжатия. 0 - без сжатия, 9 - максимум. Если не указан, будет
                     использоваться уровень сжатия по умолчанию библиотеки zlib.
  <info>int</info>     <strong>$encoding</strong>  Одна из <info>ZLIB_ENCODING_*</info> констант.

<comment>Return:</comment>
  <info>string|false</info>  Сжатая строка или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzinflate()</strong>
   * <strong>gzcompress()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzencode()</strong>


id: gzencode
type: function
doc:
<comment>Description:</comment>
  Создать сжатую строку gzip
  
  Эта функция возвращает сжатую версию входных данных <strong>$data</strong>, аналогично выводу программы gzip.
  
  Подробности о формате GZIP смотрите Формат файла GZIP. Спецификация версии 4.3 (RFC 1952).

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>      Данные для кодирования.
  <info>int</info>     <strong>$level</strong>     Уровень сжатия. 0 - без сжатия, 9 - максимальное сжатие. Если не указано, будет
                     использоваться уровень сжатия по умолчанию библиотеки zlib.
  <info>int</info>     <strong>$encoding</strong>  Режим сжатия, может быть <info>FORCE_GZIP</info> (по умолчанию) или <info>FORCE_DEFLATE</info>.
                     
                     Использование константы <info>FORCE_DEFLATE</info> генерирует вывод, совместимый с RFC 1950,
                     состоящий из заголовка zlib, сжатых данных и контрольной суммы Adler.

<comment>Return:</comment>
  <info>string|false</info>  Сжатая строка или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzdecode()</strong>
   * <strong>gzdeflate()</strong>
   * <strong>gzinflate()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzcompress()</strong>
   * 
      Спецификация ZLIB Compressed Data (RFC 1950)
     


id: gzeof
type: function
doc:
<comment>Description:</comment>
  Проверяет, находится ли текущая позиция в конце (EOF) gz-файла
  
  Проверяет, соответствует ли позиция указателя в GZ-файле позиции EOF (end-of-file, конец файла).

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл. Он должен быть корректный и должен указывать на файл,
                     успешно открытый <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если позиция указателя gz-файла соответствует EOF или возникает ошибка;
        иначе возвращает <info>false</info>.


id: gzfile
type: function
doc:
<comment>Description:</comment>
  Считывает весь gz-файл в массив
  
  Аналогична <strong>readgzfile()</strong>, за исключением того, что она возвращает файл в массиве.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>          Имя файла.
  <info>int</info>     <strong>$use_include_path</strong>  Если вы хотите, чтобы также проверялось наличие файла в директориях
                             include_path, установите значение этого параметра в <return>1</return>.

<comment>Return:</comment>
  <info>array|false</info>  Массив строк файла, в каждом элементе массива находится одна строка, пустые строки
               включаются, а переносы строк по-прежнему добавляются или <info>false</info> в случае возникновения
               ошибки.

<comment>See Also:</comment>
   * <strong>readgzfile()</strong>
   * <strong>gzopen()</strong>


id: gzgetc
type: function
doc:
<comment>Description:</comment>
  Получить символ из указателя на gz-файл
  
  Возвращает строку, содержащую один символ (несжатый), считанный из заданного указателя gz-файла.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл. Он должен быть корректный и должен указывать на файл,
                     успешно открытый <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>string|false</info>  Символ (несжатый) или <info>false</info> в случае EOF (в отличие от <strong>gzeof()</strong>).

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzgets()</strong>


id: gzgets
type: function
doc:
<comment>Description:</comment>
  Получить строку из указателя файла
  
  Получает строку (несжатую) из gz-файла, её длина ограничивается <strong>$length</strong> - 1 байтами. Чтение
  заканчивается при достижении максимальной длины, конца строки или конца файла (EOF), в зависимости
  от того, что наступит раньше.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл. Он должен быть корректный и должен указывать на файл,
                     успешно открытый <strong>gzopen()</strong>.
  <info>int|null</info>  <strong>$length</strong>  Максимальный размер возвращаемых данных.

<comment>Return:</comment>
  <info>string|false</info>  Распакованная строка или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzgetc()</strong>
   * <strong>gzwrite()</strong>


id: gzgetss
type: function
doc:
<comment>Description:</comment>
  Возвращает строку из указателя gz-файла и удалить HTML-теги
    
  
  Аналогично <strong>gzgets()</strong>, за исключением того, что <strong>gzgetss()</strong> пытается удалить любые теги HTML и PHP из
  считываемой строки.

<comment>Param:</comment>
  <info>resource</info>  <strong>$zp</strong>              Указатель на gz-файл. Он должен быть корректный и должен указывать на
                             файл, успешно открытый <strong>gzopen()</strong>.
  <info>int</info>       <strong>$length</strong>          Максимальный размер возвращаемых данных.
  <info>string</info>    <strong>$allowable_tags</strong>  Используйте этот необязательный параметр, чтобы указать теги, которые
                             не следует удалять.

<comment>Return:</comment>
  <info>string</info>  Несжатая очищенная строка или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzgets()</strong>
   * <strong>strip_tags()</strong>


id: gzinflate
type: function
doc:
<comment>Description:</comment>
  Распаковать сжатую строку
  
  Распаковывает сжатую строку.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>        Данные, сжатые функцией <strong>gzdeflate()</strong>.
  <info>int</info>     <strong>$max_length</strong>  Максимальный размер декодируемых данных.

<comment>Return:</comment>
  <info>string|false</info>  Распакованные данные или <info>false</info> в случае возникновения ошибки.
                
                Функция вернёт ошибку, если несжатые данные в 32768 раз больше размера сжатых данных
                <strong>$data</strong> или, если <strong>$max_length</strong> не <return>0</return> и больше, чем необязательный параметр <strong>$max_length</strong>.

<comment>See Also:</comment>
   * <strong>gzdeflate()</strong>
   * <strong>gzcompress()</strong>
   * <strong>gzuncompress()</strong>
   * <strong>gzencode()</strong>


id: gzopen
type: function
doc:
<comment>Description:</comment>
  Открыть gz-файл
  
  Открывает файл gzip (.gz) для чтения или записи.
  
  <strong>gzopen()</strong> также можно использовать для чтения несжатых файлов (то есть не в формате gzip). В этом
  случае <strong>gzread()</strong> будет непосредственно читать файл без какой-либо обработки.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>          Имя файла.
  <info>string</info>  <strong>$mode</strong>              Как в <strong>fopen()</strong> (<return>rb</return> или <return>wb</return>), но также может включать уровень сжатия (<return>wb9</return>)
                             или стратегию: <return>f</return> для фильтрации данных как в <return>wb6f</return>, <return>h</return> для сжатия <return>только
                             по алгоритму Хаффмана</return>, как в <return>wb1h</return> (Для более детальной информации о
                             параметре стратегии смотрите описание <return>deflateInit2</return> в zlib.h).
  <info>int</info>     <strong>$use_include_path</strong>  Если вы хотите, чтобы поиск файла выполнялся также в директориях
                             include_path, установите значение этого аргумента в <return>1</return>.

<comment>Return:</comment>
  <info>resource|false</info>  Возвращает указатель на открытый файл, после чего всё, что вы читаете из этого
                  дескриптора, будет автоматически распаковываться, а всё, что вы записываете -
                  упаковываться.
                  
                  В случае возникновения ошибки функция возвращает <info>false</info>.

<comment>See Also:</comment>
   * <strong>gzclose()</strong>


id: gzpassthru
type: function
doc:
<comment>Description:</comment>
  Вывод всех оставшихся данных из указателя gz-файла.
    
  
  Читает до конца файла (EOF) данные из указателя gz-файла, начиная с текущей позиции, и записывает
  результат (без сжатия) в стандартный вывод.
  
  Используйте <strong>gzrewind()</strong>, чтобы переместить указатель на позицию в начало файла, если вы уже
  записывали данные в него.
  
  Если вам нужно просто вывести содержимое файла без перемещения указателя на позицию или внесения
  изменений, используйте функцию <strong>readgzfile()</strong>, которая не требует вызова функции <strong>gzopen()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл, возвращённый, после его успешного открытия, функцией
                     <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>int</info>  Количество несжатых символов, прочитанных из <strong>$gz</strong> и переданных на вход.


id: gzputs
type: function
doc:
<comment>Description:</comment>
  Псевдоним gzwrite
  
  Функция является псевдонимом:  <strong>gzwrite()</strong>.


id: gzread
type: function
doc:
<comment>Description:</comment>
  Бинарное чтение gz-файла
  
  <strong>gzread()</strong> читает (распаковывая) до <strong>$length</strong> байт из gz-файла из переданного указателя gz-файла.
  Чтение заканчивается при достижении максимального размера <strong>$length</strong> распакованных данных или конца
  файла (EOF)

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл, возвращённый, после его успешного открытия, функцией
                     <strong>gzopen()</strong>.
  <info>int</info>       <strong>$length</strong>  Количество байт (после распаковки), которые следует прочитать.

<comment>Return:</comment>
  <info>string|false</info>  Прочтённые данные или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzwrite()</strong>
   * <strong>gzopen()</strong>
   * <strong>gzgets()</strong>
   * <strong>gzgetss()</strong>
   * <strong>gzfile()</strong>
   * <strong>gzpassthru()</strong>


id: gzrewind
type: function
doc:
<comment>Description:</comment>
  Переместить позицию указатель gz-файла в начало
  
  Устанавливает указатель на позицию файла на начало потока этого файла.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл, возвращённый, после его успешного открытия, функцией
                     <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzseek()</strong>
   * <strong>gztell()</strong>


id: gzseek
type: function
doc:
<comment>Description:</comment>
  Переместить указатель на позицию в указателе gz-файла
  
  Устанавливает указатель на позицию в файле, на который ссылается zp. Выполняется смещение потока
  этого файла на указанное количество байт. Эквивалентно вызову (в C) <return>gzseek(zp, offset, SEEK_SET)</return>.
  
  Если файл открыт для чтения, функция эмулируется, при этом будет работать очень медленно. Если
  файл открыт для записи, разрешено только перемещение вперёд; <strong>gzseek()</strong> при этом сжимает
  последовательность нулей до новой позиции.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл, возвращённый, после его успешного открытия, функцией
                     <strong>gzopen()</strong>.
  <info>int</info>       <strong>$offset</strong>  Смещение.
  <info>int</info>       <strong>$whence</strong>  Значения параметра <strong>$whence</strong> может быть одним из следующих: <info>SEEK_SET</info> - Установить
                     абсолютную позицию в <strong>$offset</strong> байт.<info>SEEK_CUR</info> - Установить позицию относительно
                     текущего положения, добавив к ней <strong>$offset</strong>.
                     
                     Если <strong>$whence</strong> не указан, по умолчанию используется <info>SEEK_SET</info>.

<comment>Return:</comment>
  <info>int</info>  При успешном завершении возвращает 0; иначе -1. Обратите внимание, что если установленное
       смещение перемещает указатель на позицию за EOF, это не является ошибкой.

<comment>See Also:</comment>
   * <strong>gztell()</strong>
   * <strong>gzrewind()</strong>


id: gztell
type: function
doc:
<comment>Description:</comment>
  Возвращает текущую позицию чтения/записи в указателе gz-файла
  
  Получает позицию указателя файла, то есть смещение в потоке распакованного файла.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл, возвращённый, после его успешного открытия, функцией
                     <strong>gzopen()</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Текущая позиция или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzopen()</strong>
   * <strong>gzseek()</strong>
   * <strong>gzrewind()</strong>


id: gzuncompress
type: function
doc:
<comment>Description:</comment>
  Распаковать сжатую строку
  
  Распаковывает сжатую строку.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>        Данные, сжатые функцией <strong>gzcompress()</strong>.
  <info>int</info>     <strong>$max_length</strong>  Максимальный размер данных для декодирования.

<comment>Return:</comment>
  <info>string|false</info>  Исходные несжатые данные или <info>false</info> в случае возникновения ошибки.
                
                Функция также сообщит об ошибке в случае, если несжатые данные в 32768 раз больше
                размера сжатых данных <strong>$data</strong> или больше параметра <strong>$max_length</strong>.

<comment>See Also:</comment>
   * <strong>gzcompress()</strong>
   * <strong>gzinflate()</strong>
   * <strong>gzdeflate()</strong>
   * <strong>gzencode()</strong>


id: gzwrite
type: function
doc:
<comment>Description:</comment>
  Бинарная запись в gz-файл
  
  <strong>gzwrite()</strong> записывает содержимое <strong>$data</strong> в данный gz-файл.

<comment>Param:</comment>
  <info>resource</info>  <strong>$stream</strong>  Указатель на gz-файл, возвращённый, после его успешного открытия, функцией
                     <strong>gzopen()</strong>.
  <info>string</info>    <strong>$data</strong>    Записываемая строка.
  <info>int|null</info>  <strong>$length</strong>  Число несжатых байтов для записи. Если указано, операция завершится после
                     записи <strong>$length</strong> (до сжатия) байт или при достижении конца строки, в зависимости
                     от того, что наступит раньше. <strong>$data</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает количество записанных байт (без учёта сжатия) в поток gz-файла или <info>false</info> в
             случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>gzread()</strong>
   * <strong>gzopen()</strong>


id: hash
type: function
doc:
<comment>Description:</comment>
  Генерирует хеш-код (подпись сообщения)

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>     Имя выбранного алгоритма хеширования (например, "md5", "sha256", "haval160,4" и
                    т.д.). Список поддерживаемых алгоритмов смотрите в <strong>hash_algos()</strong>.
  <info>string</info>  <strong>$data</strong>     Сообщение для хеширования.
  <info>bool</info>    <strong>$binary</strong>   Когда установлено в <info>true</info>, выводит необработанные двоичные данные. При <info>false</info>
                    выводит данные в шестнадцатеричной кодировке в нижнем регистре.
  <info>array</info>   <strong>$options</strong>  Множество опций для различных алгоритмов хеширования. В настоящее время в
                    вариантах MurmurHash поддерживается только параметр "seed".

<comment>Return:</comment>
  <info>string</info>  Возвращает строку содержащую вычисленный хеш-код в шестнадцатеричной кодировке в нижнем
          регистре. Если <strong>$binary</strong> задан как <info>true</info>, то возвращается хеш-код в виде бинарных данных.

<comment>See Also:</comment>
   * <strong>hash_file()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_init()</strong>
   * <strong>md5()</strong>
   * <strong>sha1()</strong>


id: hash_algos
type: function
doc:
<comment>Description:</comment>
  Возвращает список зарегистрированных алгоритмов хеширования

<comment>Return:</comment>
  <info>array</info>  Возвращает массив, содержащий список поддерживаемых алгоритмов хеширования.

<comment>See Also:</comment>
   * <strong>hash_hmac_algos()</strong>


id: hash_copy
type: function
doc:
<comment>Description:</comment>
  Копирует контекст хеширования

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Контекст хеширования, возвращённый <strong>hash_init()</strong>.

<comment>Return:</comment>
  <info>HashContext</info>  Возвращает копию контекста хеширования.


id: hash_equals
type: function
doc:
<comment>Description:</comment>
  Сравнивает строки без риска атаки по времени
  
  Сравнивает две строки на идентичность так, что значение параметра <strong>$known_string</strong> нельзя раскрыть
  методами, основанными на знании времени исполнения функции.
  
  Эту функцию можно применять для снижения риска атак по времени. Обычное сравнение через оператор
  === будет занимать разное время в зависимости от того, разные это значения или нет и в какой
  позиции первое отличие будет найдено, так раскрывается значение параметра <strong>$known_string</strong>.
  
  Внимание! Передавать полученную от пользователя строку необходимо во второй параметр, а не в
  первый.

<comment>Param:</comment>
  <info>string</info>  <strong>$known_string</strong>  Известная строка (<info>string</info>), которая должна держаться в секрете.
  <info>string</info>  <strong>$user_string</strong>   Пользовательская строка (<info>string</info>) для сравнения.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если строки идентичны, и <info>false</info>, если нет.

<comment>See Also:</comment>
   * <strong>hash_hmac()</strong>


id: hash_file
type: function
doc:
<comment>Description:</comment>
  Генерация хеш-значения, используя содержимое заданного файла

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>      Название выбранного алгоритма хеширования (например, "md5", "sha256",
                     "haval160,4" и т.д.). Список поддерживаемых алгоритмов смотрите в <strong>hash_algos()</strong>.
  <info>string</info>  <strong>$filename</strong>  Путь или URL к файлу, который будет хеширован; Поддерживается интерфейс fopen.
  <info>bool</info>    <strong>$binary</strong>    Когда установлено в <info>true</info>, выводит необработанные двоичные данные. При <info>false</info>
                     выводит данные в шестнадцатеричной кодировке в нижнем регистре.
  <info>array</info>   <strong>$options</strong>   Множество опций для различных алгоритмов хеширования. В настоящее время в
                     вариантах MurmurHash поддерживается только параметр "seed".

<comment>Return:</comment>
  <info>string|false</info>  Возвращает строку, содержащую вычисленный хеш-код в шестнадцатеричной кодировке в
                нижнем регистре. Если <strong>$binary</strong> задан как <info>true</info>, то возвращается хеш-код в виде
                бинарных данных.

<comment>See Also:</comment>
   * <strong>hash()</strong>
   * <strong>hash_hmac_file()</strong>
   * <strong>hash_update_file()</strong>
   * <strong>md5_file()</strong>
   * <strong>sha1_file()</strong>


id: hash_final
type: function
doc:
<comment>Description:</comment>
  Завершает инкрементальное хеширование и возвращает результат в виде хеш-кода

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Контекст хеширования, возвращённый <strong>hash_init()</strong>.
  <info>bool</info>         <strong>$binary</strong>   Когда установлено в <info>true</info>, выводит необработанные двоичные данные. При <info>false</info>
                         выводит данные в шестнадцатеричной кодировке в нижнем регистре.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку содержащую вычисленный хеш-код в шестнадцатеричной кодировке в нижнем
          регистре. Если <strong>$binary</strong> задан как <info>true</info>, то возвращается хеш-код в виде бинарных данных.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update()</strong>
   * <strong>hash_update_stream()</strong>
   * <strong>hash_update_file()</strong>


id: hash_hkdf
type: function
doc:
<comment>Description:</comment>
  Формирования ключа HKDF для заданных входных данных

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>    Имя выбранного хеширующего алгоритма (например, "sha256", "sha512", "haval160,4"
                   и т.д.) Список поддерживаемых алгоритмов можно посмотреть в описании функции
                   <strong>hash_algos()</strong>.  Не криптографические хеширующие функции не допускаются.
                   
                   Не криптографические хеширующие функции не допускаются.
  <info>string</info>  <strong>$key</strong>     Входные данные (необработанные бинарные данные). Не может быть пустым.
  <info>int</info>     <strong>$length</strong>  Выбранная длина вывода в байтах. Не может быть более чем в 255 раз больше размера
                   выбранной хеширующей функции.
                   
                   Если <strong>$length</strong> установлено как <return>0</return>, то вывод по длине будет равен размеру выбранной
                   хеширующей функции.
  <info>string</info>  <strong>$info</strong>    Информационная строка, специфичная для приложения/контекста.
  <info>string</info>  <strong>$salt</strong>    Соль, используемая при формировании ключа.
                   
                   Хотя и необязательно, но добавление случайной соли значительно улучшает силу
                   HKDF.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку, содержащую необработанные бинарные данные, представляющие
          сформированный ключ.

<comment>See Also:</comment>
   * <strong>hash_pbkdf2()</strong>
   * RFC 5869
   * пользовательская реализация


id: hash_hmac
type: function
doc:
<comment>Description:</comment>
  Генерация хеш-кода на основе ключа, используя метод HMAC

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>    Имя выбранного алгоритма хеширования (например, "md5", "sha256", "haval160,4" и
                   т.д.) Смотрите <strong>hash_hmac_algos()</strong> для получения списка поддерживаемых алгоритмов.
  <info>string</info>  <strong>$data</strong>    Сообщение для хеширования.
  <info>string</info>  <strong>$key</strong>     Общий секретный ключ, используемый для генерации HMAC хеш-кода.
  <info>bool</info>    <strong>$binary</strong>  Когда установлено в <info>true</info>, выводит необработанные двоичные данные. При <info>false</info>
                   выводит данные в шестнадцатеричной кодировке в нижнем регистре.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку, содержащую вычисленный хеш-код в шестнадцатеричной кодировке в нижнем
          регистре. Если <strong>$binary</strong> задан как <info>true</info>, то возвращается хеш-код в виде бинарных данных.

<comment>See Also:</comment>
   * <strong>hash()</strong>
   * <strong>hash_hmac_algos()</strong>
   * <strong>hash_init()</strong>
   * <strong>hash_hmac_file()</strong>
   * <strong>hash_equals()</strong>


id: hash_hmac_algos
type: function
doc:
<comment>Description:</comment>
  Возвращает список зарегистрированных алгоритмов хеширования, применимых для hash_hmac

<comment>Return:</comment>
  <info>array</info>  Возвращает индексированный массив со списком поддерживаемых функцией <strong>hash_hmac()</strong> алгоритмов
         хеширования.

<comment>See Also:</comment>
   * <strong>hash_hmac()</strong>
   * <strong>hash_algos()</strong>


id: hash_hmac_file
type: function
doc:
<comment>Description:</comment>
  Генерация хеш-кода на основе ключа, используя метод HMAC и содержимое полученного файла

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>      Имя выбранного алгоритма хеширования (например, "md5", "sha256", "haval160,4" и
                     т.д.) Смотрите <strong>hash_hmac_algos()</strong> для получения списка поддерживаемых
                     алгоритмов.
  <info>string</info>  <strong>$filename</strong>  URL расположения файла для хеширования; Поддерживаются обработчики fopen.
  <info>string</info>  <strong>$key</strong>       Общий секретный ключ, используемый для генерации HMAC хеш-кода.
  <info>bool</info>    <strong>$binary</strong>    Когда установлено в <info>true</info>, выводит необработанные двоичные данные. При <info>false</info>
                     выводит данные в шестнадцатеричной кодировке в нижнем регистре.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает строку, содержащую вычисленный хеш-код в шестнадцатеричной кодировке в
                нижнем регистре. Если <strong>$binary</strong> задан как <info>true</info>, то возвращается хеш-код в виде
                бинарных данных. Возвращает <info>false</info>, если файл <strong>$filename</strong> недоступен для чтения.

<comment>See Also:</comment>
   * <strong>hash_hmac_algos()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_file()</strong>


id: hash_init
type: function
doc:
<comment>Description:</comment>
  Инициализация инкрементального контекста хеширования

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>     Имя выбранного алгоритма хеширования (например, "md5", "sha256", "haval160,4" и
                    т.д.). Весь список поддерживаемых алгоритмов можно посмотреть в описании функции
                    <strong>hash_algos()</strong>.
  <info>int</info>     <strong>$flags</strong>    Необязательные настройки для генерации хеша, в настоящее время поддерживается
                    только один вариант: <info>HASH_HMAC</info>.  При этом параметр <strong>$key</strong> должен быть указан.
  <info>string</info>  <strong>$key</strong>      Если <info>HASH_HMAC</info> указан в параметре <strong>$flags</strong>, то в этом параметре нужно предоставить
                    общий секретный ключ, который будет использоваться с методом хеширования HMAC.
  <info>array</info>   <strong>$options</strong>  Множество опций для различных алгоритмов хеширования. В настоящее время в
                    вариантах MurmurHash поддерживается только параметр "seed".

<comment>Return:</comment>
  <info>HashContext</info>  Возвращает контекст хеширования для использования в функциях <strong>hash_update()</strong>,
               <strong>hash_update_stream()</strong>, <strong>hash_update_file()</strong> и <strong>hash_final()</strong>.

<comment>See Also:</comment>
   * <strong>hash()</strong>
   * <strong>hash_algos()</strong>
   * <strong>hash_file()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>hash_hmac_file()</strong>


id: hash_pbkdf2
type: function
doc:
<comment>Description:</comment>
  Формирования ключа PBKDF2 для заданных входных данных

<comment>Param:</comment>
  <info>string</info>  <strong>$algo</strong>        Имя выбранного хеширующего алгоритма (например, <return>md5</return>, <return>sha256</return>, <return>haval160,4</return> и
                       т.д.) Список поддерживаемых алгоритмов можно посмотреть в описании функции
                       <strong>hash_algos()</strong>.
  <info>string</info>  <strong>$password</strong>    Пароль, используемый для формирования.
  <info>string</info>  <strong>$salt</strong>        Соль, используемая при формировании ключа. Значение необходимо генерировать
                       случайным образом.
  <info>int</info>     <strong>$iterations</strong>  Количество итераций для формирования ключа.
  <info>int</info>     <strong>$length</strong>      Длина генерируемой строки. Если параметр <strong>$binary</strong> задан как <info>true</info>, то этот
                       параметр равен количеству байт в генерируемом ключе. Если <strong>$binary</strong> установлен
                       как <info>false</info>, то длина ключа в байтах будет в два раза меньше, так как каждый
                       байт ключа будет возвращён в виде двух символов шестнадцатеричной системы
                       (0-F).
                       
                       Если задано как <return>0</return>, то используется весь вывод заданного алгоритма.
  <info>bool</info>    <strong>$binary</strong>      Если установлено <info>true</info>, то вывод будет представлять из себя необработанные
                       бинарные данные, а если <info>false</info>, то вывод будет представлен в виде строки
                       шестнадцатеричных цифр в нижнем регистре.

<comment>Return:</comment>
  <info>string</info>  Возвращаемая строка содержит сформированный ключ в виде строки шестнадцатеричных чисел в
          нижнем регистре. Но если параметр <strong>$binary</strong> установлен как <info>true</info>, то будут возвращены сырые
          бинарные данные.

<comment>See Also:</comment>
   * <strong>password_hash()</strong>
   * <strong>hash_hkdf()</strong>
   * <strong>sodium_crypto_pwhash()</strong>


id: hash_update
type: function
doc:
<comment>Description:</comment>
  Добавляет данные в активный контекст хеширования

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Контекст хеширования, возвращаемый <strong>hash_init()</strong>.
  <info>string</info>       <strong>$data</strong>     Сообщение, которое должно быть включено в хеш.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update_file()</strong>
   * <strong>hash_update_stream()</strong>
   * <strong>hash_final()</strong>


id: hash_update_file
type: function
doc:
<comment>Description:</comment>
  Добавляет данные из файла в активный контекст хеширования

<comment>Param:</comment>
  <info>HashContext</info>    <strong>$context</strong>         Контекст хеширования, возвращённый <strong>hash_init()</strong>.
  <info>string</info>         <strong>$filename</strong>        Имя или URL файла для хеширования; Поддерживаются обработчики
                                  fopen.
  <info>resource|null</info>  <strong>$stream_context</strong>  Контекст потока, возвращённый <strong>stream_context_create()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update()</strong>
   * <strong>hash_update_stream()</strong>
   * <strong>hash_final()</strong>
   * <strong>hash()</strong>
   * <strong>hash_file()</strong>


id: hash_update_stream
type: function
doc:
<comment>Description:</comment>
  Добавляет данные из открытого потока в активный контекст хеширования

<comment>Param:</comment>
  <info>HashContext</info>  <strong>$context</strong>  Контекст хеширования, возвращаемый <strong>hash_init()</strong>.
  <info>resource</info>     <strong>$stream</strong>   Дескриптор открытого файла, возвращаемый любой функцией создания потока.
  <info>int</info>          <strong>$length</strong>   Максимальное число символов для копирования из <strong>$stream</strong> в контекст
                         хеширования.

<comment>Return:</comment>
  <info>int</info>  Фактическое количество байт, добавленное в контекст хеширования из <strong>$stream</strong>.

<comment>See Also:</comment>
   * <strong>hash_init()</strong>
   * <strong>hash_update()</strong>
   * <strong>hash_final()</strong>
   * <strong>hash()</strong>
   * <strong>hash_file()</strong>


id: header
type: function
doc:
<comment>Description:</comment>
  Отправка HTTP-заголовка
    
  
  <strong>header()</strong> используется для отправки HTTP-заголовка. В спецификации HTTP/1.1 есть подробное описание
  HTTP-заголовков.
  
  Помните, что функцию <strong>header()</strong> можно вызывать только если клиенту ещё не передавались данные. То
  есть она должна идти первой в выводе, перед её вызовом не должно быть никаких HTML-тегов, пустых
  строк и т.п. Довольно часто возникает ошибка, когда при чтении кода файловыми функциями, вроде
  <strong>include()</strong> или <strong>require()</strong>, в этом коде попадаются пробелы или пустые строки, которые выводятся до
  вызова <strong>header()</strong>. Те же проблемы могут возникать и при использовании PHP/HTML в одном файле.
  
  ]]>

<comment>Param:</comment>
  <info>string</info>  <strong>$header</strong>         Строка заголовка.
                          
                          Существует два специальных заголовка. Один из них начинается с "<return>HTTP/</return>"
                          (регистр не важен) и используется для отправки кода состояния HTTP.
                          Например, если веб-сервер Apache сконфигурирован таким образом, чтобы
                          запросы к несуществующим файлам обрабатывались средствами PHP-скрипта
                          (используя директиву <return>ErrorDocument</return>), вы наверняка захотите убедиться, что
                          скрипт генерирует правильный код состояния.
                          
                          
                          ]]>
                          
                          Другим специальным видом заголовков является "Location:". В этом случае
                          функция не только отправляет этот заголовок браузеру, но также возвращает
                          ему код состояния <return>REDIRECT</return> (302), если ранее не был установлен код <return>201</return> или
                          <return>3xx</return>.
                          
                          
                          ]]>
  <info>bool</info>    <strong>$replace</strong>        Необязательный параметр <strong>$replace</strong> определяет, надо ли заменять предыдущий
                          аналогичный заголовок или заголовок того же типа. По умолчанию заголовок
                          будет заменён, но если передать <info>false</info>, можно задать несколько однотипных
                          заголовков. Например:
                          
                          
                          ]]>
  <info>int</info>     <strong>$response_code</strong>  Принудительно задаёт код ответа HTTP. Следует учитывать, что это будет
                          работать, только если строка <strong>$header</strong> не является пустой.

<comment>Return:</comment>
  <info>void</info>  Функция не возвращает значения после выполнения.

<comment>See Also:</comment>
   * <strong>headers_sent()</strong>
   * <strong>setcookie()</strong>
   * <strong>http_response_code()</strong>
   * <strong>header_remove()</strong>
   * <strong>headers_list()</strong>
   * 
     Раздел документации HTTP-аутентификации
    


id: header_register_callback
type: function
doc:
<comment>Description:</comment>
  Вызывает функцию заголовка
  
  Регистрирует функцию, которая будет вызвана когда PHP начнёт отправлять вывод.
  
  Параметр <strong>$callback</strong> запускается сразу после того, как PHP были подготовлены все отправляемые
  заголовки, и перед отправкой любого другого вывода, создавая возможность для управления исходящими
  заголовками перед отправкой.

<comment>Param:</comment>
  <info>callable</info>  <strong>$callback</strong>  Функция вызывается непосредственно перед отправкой заголовков, не получает
                       параметров и возвращаемое значение игнорируется.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>headers_list()</strong>
   * <strong>header_remove()</strong>
   * <strong>header()</strong>


id: header_remove
type: function
doc:
<comment>Description:</comment>
  Удаляет ранее установленные заголовки
  
  Удаляет предварительно установленный функцией <strong>header()</strong> HTTP-заголовок.

<comment>Param:</comment>
  <info>string|null</info>  <strong>$name</strong>  Имя удаляемого заголовка. Если <info>null</info>, удаляются все ранее установленные
                      заголовки.
                      
                      Это регистронезависимый параметр.

<comment>Return:</comment>
  <info>void</info>  Функция не возвращает значения после выполнения.

<comment>See Also:</comment>
   * <strong>header()</strong>
   * <strong>headers_sent()</strong>


id: headers_list
type: function
doc:
<comment>Description:</comment>
  Возвращает список переданных заголовков (или готовых к отправке)
  
  Функция <strong>headers_list()</strong> возвращает список заголовков, передаваемых браузеру / клиенту. Для того,
  чтобы определить переданы ли уже заголовки, используйте функцию <strong>headers_sent()</strong>.

<comment>Return:</comment>
  <info>array</info>  Возвращает нумерованный массив заголовков.

<comment>See Also:</comment>
   * <strong>headers_sent()</strong>
   * <strong>header()</strong>
   * <strong>setcookie()</strong>
   * <strong>apache_response_headers()</strong>
   * <strong>http_response_code()</strong>


id: headers_sent
type: function
doc:
<comment>Description:</comment>
  Проверяет, были ли отправлены заголовки
  
  Проверяет, были ли отправлены заголовки.
  
  Нельзя отправить дополнительные строки заголовков, используя функцию <strong>header()</strong>, если заголовки уже
  отправлены. Используя эту функцию, можно предупредить ошибки, связанные с  HTTP-заголовками.
  Другим вариантом является использование буферизации вывода.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Если заданы дополнительные параметры <strong>$filename</strong> и <strong>$line</strong>, то функция
                     <strong>headers_sent()</strong> поместит имя исходного файла PHP и номер строки, с которой
                     начинается вывод в переменные <strong>$filename</strong> и <strong>$line</strong>.
                     
                     Если вывод начался до выполнения исходного файла PHP (например, из-за ошибки
                     запуска), параметр <strong>$filename</strong> будет установлен как пустая строка.
  <info>int</info>     <strong>$line</strong>      Номер строки, с которой начинается вывод.

<comment>Return:</comment>
  <info>bool</info>  Функция <strong>headers_sent()</strong> вернёт <info>false</info>, если HTTP-заголовки не были отправлены, либо <info>true</info> если
        отправлены.

<comment>See Also:</comment>
   * <strong>ob_start()</strong>
   * <strong>trigger_error()</strong>
   * <strong>headers_list()</strong>
   * 
     Смотрите информацию по функции <strong>header()</strong> для более детальной информации.
    


id: hebrev
type: function
doc:
<comment>Description:</comment>
  Преобразует текст на иврите из логической кодировки в визуальную
  
  Преобразует текст на иврите из логической кодировки в визуальную.
  
  Эта функция пытается избежать разрывов слов.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>              Входная строка на иврите.
  <info>int</info>     <strong>$max_chars_per_line</strong>  Этот необязательный параметр указывает максимально возвращаемое число
                               символов на строку.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку в визуальной кодировке.

<comment>See Also:</comment>
   * <strong>hebrevc()</strong>


id: hebrevc
type: function
doc:
<comment>Description:</comment>
  Преобразует текст на иврите из логической кодировки в визуальную с преобразованием перевода строки
  
  Эта функция похожа на <strong>hebrev()</strong> с тем отличием, что она преобразует символы перевода строки (\n) в
  "\<br&gt;\n".
  
  Эта функция пытается избежать разрывов слов.

<comment>Param:</comment>
  <info>string</info>  <strong>$hebrew_text</strong>         Входная строка на иврите.
  <info>int</info>     <strong>$max_chars_per_line</strong>  Этот необязательный параметр указывает максимально возвращаемое число
                               символов на строку.

<comment>Return:</comment>
  <info>string</info>  Возвращает строку в визуальной кодировке.

<comment>See Also:</comment>
   * <strong>hebrev()</strong>


id: hex2bin
type: function
doc:
<comment>Description:</comment>
  Преобразует шестнадцатеричные данные в двоичные
  
  Декодирует строку данных из шестнадцатеричного представления.
  
  Эта функция НЕ конвертирует шестнадцатеричные числа в двоичные. Если нужно именно это, используйте
  функцию <strong>base_convert()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Шестнадцатеричное представление данных.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает двоичное представление данных или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>bin2hex()</strong>
   * <strong>unpack()</strong>


id: hexdec
type: function
doc:
<comment>Description:</comment>
  Переводит число из шестнадцатеричной системы счисления в десятичную
  
  Возвращает десятичный эквивалент шестнадцатеричного числа, содержащегося в аргументе <strong>$hex_string</strong>.
  <strong>hexdec()</strong> преобразует шестнадцатеричную строку в десятичное число.
  
  <strong>hexdec()</strong> игнорирует любые обнаруженные не шестнадцатеричные символы. Начиная с PHP 7.4.0,
  предоставление любых некорректных символов устарело.

<comment>Param:</comment>
  <info>string</info>  <strong>$hex_string</strong>  Шестнадцатеричная строка для преобразования

<comment>Return:</comment>
  <info>int|float</info>  Десятичное представление <strong>$hex_string</strong>

<comment>See Also:</comment>
   * <strong>dechex()</strong>
   * <strong>bindec()</strong>
   * <strong>octdec()</strong>
   * <strong>base_convert()</strong>


id: highlight_file
type: function
doc:
<comment>Description:</comment>
  Подсветка синтаксиса файла
  
  Выводит или возвращает версию с подсветкой синтаксиса кода, содержащегося в файле <strong>$filename</strong>,
  используя цвета, определённые во встроенной подсветке синтаксиса PHP.
  
  Большинство серверов сконфигурированы автоматически подсвечивать файлы с расширением phps. К
  примеру, при отображении файла example.phps будет выведен код с подсветкой синтаксиса. Для
  включения добавьте следующую строку в httpd.conf:

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к подсвечиваемому файлу PHP.
  <info>bool</info>    <strong>$return</strong>    Установите в этот параметр <info>true</info> для того, чтобы функция вернула подсвеченный
                     код.

<comment>Return:</comment>
  <info>string|bool</info>  Если в <strong>$return</strong> установлено <info>true</info>, то подсвеченный код возвращается в виде строки, а
               отображает его. В другом случае будет возвращено <info>true</info>, либо <info>false</info> в случае
               возникновения ошибки.

<comment>See Also:</comment>
   * <strong>highlight_string()</strong>
   * Подсвечивание директив INI


id: highlight_string
type: function
doc:
<comment>Description:</comment>
  Подсветка синтаксиса строки
  
  Выводит или возвращает код PHP с html-разметкой c подсвеченным синтаксисом, используя цвета,
  определённые во встроенном обработчике подсветки синтаксиса PHP.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Подсвечиваемый PHP-код. Должен включать открывающий тег.
  <info>bool</info>    <strong>$return</strong>  При установке этого параметра равным <info>true</info>, функция возвращает код с подсветкой
                   синтаксиса.

<comment>Return:</comment>
  <info>string|bool</info>  Если параметр <strong>$return</strong> равен <info>true</info>, то вместо вывода в виде строки возвращается код с
               подсветкой синтаксиса. В противном случае возвращает <info>true</info> или <info>false</info> в случае
               возникновения ошибки.

<comment>See Also:</comment>
   * <strong>highlight_file()</strong>
   * Подсветка директив INI


id: hrtime
type: function
doc:
<comment>Description:</comment>
  Получить системное время высокого разрешения
  
  Возвращает время высокого разрешения системы, отсчитываемое с произвольной точки времени.
  Полученная временная метка неизменна и не может быть отрегулирована.

<comment>Param:</comment>
  <info>bool</info>  <strong>$as_number</strong>  Должно ли время высокого разрешения возвращаться в виде массива (<info>array</info>) или
                    числа.

<comment>Return:</comment>
  <info>array|int|float|false</info>  Возвращает массив целых чисел в формате [секунды, наносекунды], если
                         параметр <strong>$as_number</strong> равен false. В противном случае наносекунды
                         возвращаются в виде целого числа (<info>int</info>) (для 64-битных систем) или <info>float</info>
                         (для 32-битных систем). Возвращает <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * Модуль Время высокого разрешения
   * <strong>microtime()</strong>


id: html_entity_decode
type: function
doc:
<comment>Description:</comment>
  Преобразует HTML-сущности в соответствующие им символы
  
  <strong>html_entity_decode()</strong> является противоположностью функции <strong>htmlentities()</strong>. Она преобразует
  HTML-сущности в строке <strong>$string</strong> в соответствующие им символы.
  
  Если быть точнее, то эта функция преобразует все сущности (в том числе все числовые сущности),
  которые а) обязательно верны для выбранного типа документа - то есть, для XML эта функция не
  преобразует именованные сущности, которые могут быть определены в каком-нибудь DTD - и б) их
  символы находятся в кодировке, соответствующей выбранной и разрешены в выбранном типе документа.
  Все другие сущности остаются без изменений.

<comment>Param:</comment>
  <info>string</info>       <strong>$string</strong>    Входная строка.
  <info>int</info>          <strong>$flags</strong>     Битовая маска, состоящая из одного или более флагов, которые указывают,
                          как обращаться с кавычками и какой тип документа использовать. По
                          умолчанию маска принимает значение <return>ENT_QUOTES | ENT_SUBSTITUTE |
                          ENT_HTML401</return>. Константы <strong>$flags</strong>Имя константыОписание<info>ENT_COMPAT</info>Преобразуются
                          двойные кавычки, одинарные остаются без изменений.<info>ENT_QUOTES</info>Преобразуются
                          и двойные, и одинарные кавычки.<info>ENT_NOQUOTES</info>Оставить как двойные, так и
                          одинарные кавычки без изменений.<info>ENT_SUBSTITUTE</info> Заменяет некорректные
                          кодовые последовательности символом замены Юникода U+FFFD в случае
                          использования UTF-8 и &#FFFD; при использовании другой кодировки, вместо
                          возврата пустой строки. <info>ENT_HTML401</info> Обрабатывать код как HTML 4.01.
                          <info>ENT_XML1</info> Обрабатывать код как XML 1. <info>ENT_XHTML</info> Обрабатывать код как XHTML.
                          <info>ENT_HTML5</info> Обрабатывать код как HTML 5.
  <info>string|null</info>  <strong>$encoding</strong>  Необязательный аргумент, определяющий кодировку, используемую при
                          конвертации символов.
                          
                          Если не указан, то значение по умолчанию для <strong>$encoding</strong> зависит от
                          конфигурационной опции default_charset.
                          
                          Хотя этот аргумент является технически необязательным, настоятельно
                          рекомендуется указать правильное значение для вашего кода, опция
                          конфигурации default_charset может быть задана неверно для входных данных.
                          
                          Поддерживаются следующие кодировки: Поддерживаемые
                          кодировкиКодировкаПсевдонимыОписаниеISO-8859-1ISO8859-1
                          Западно-европейская Latin-1. ISO-8859-5ISO8859-5 Редко используемая
                          кириллическая кодировка (Latin/Cyrillic). ISO-8859-15ISO8859-15
                          Западно-европейская Latin-9. Добавляет знак евро, французские и финские
                          буквы к кодировке Latin-1 (ISO-8859-1). UTF-8 8-битная Unicode,
                          совместимая с ASCII. cp866ibm866, 866 Кириллическая кодировка, применяемая
                          в DOS. cp1251Windows-1251, win-1251, 1251 Кириллическая кодировка,
                          применяемая в Windows. cp1252Windows-1252, 1252 Западно-европейская
                          кодировка, применяемая в Windows. KOI8-Rkoi8-ru, koi8r Русская кодировка.
                          BIG5950 Традиционный китайский, применяется в основном на Тайване.
                          GB2312936 Упрощённый китайский, стандартная национальная кодировка.
                          BIG5-HKSCS Расширенная Big5, применяемая в Гонконге. Shift_JISSJIS,
                          SJIS-win, cp932, 932 Японская кодировка. EUC-JPEUCJP, eucJP-win Японская
                          кодировка. MacRoman Кодировка, используемая в Mac OS. <return>''</return> Пустая строка
                          активирует режим определения кодировки из файла скрипта (Zend multibyte),
                          default_charset и текущей локали (смотрите <strong>nl_langinfo()</strong> и <strong>setlocale()</strong>) в
                          указанном порядке. Не рекомендуется к использованию.   Остальные кодировки
                          не поддерживаются, вместо них будет применена кодировка по умолчанию и
                          сгенерировано предупреждение.
                          
                          Остальные кодировки не поддерживаются, вместо них будет применена
                          кодировка по умолчанию и сгенерировано предупреждение.

<comment>Return:</comment>
  <info>string</info>  Возвращает раскодированную строку.

<comment>See Also:</comment>
   * <strong>htmlentities()</strong>
   * <strong>htmlspecialchars()</strong>
   * <strong>get_html_translation_table()</strong>
   * <strong>urldecode()</strong>


id: htmlentities
type: function
doc:
<comment>Description:</comment>
  Преобразует все возможные символы в соответствующие HTML-сущности
  
  Эта функция идентична <strong>htmlspecialchars()</strong> за исключением того, что <strong>htmlentities()</strong> преобразует все
  символы в соответствующие HTML-сущности (для тех символов, для которых HTML-сущности существуют).
  Функция <strong>get_html_translation_table()</strong> может быть использована для возврата используемой таблицы
  перевода в зависимости от предоставленных констант в параметре <strong>$flags</strong>.
  
  Если же вы хотите раскодировать строку (наоборот), используйте <strong>html_entity_decode()</strong>.

<comment>Param:</comment>
  <info>string</info>       <strong>$string</strong>         Входная строка.
  <info>int</info>          <strong>$flags</strong>          Битовая маска из нижеуказанных флагов, определяющих режим обработки
                               кавычек, некорректных кодовых последовательностей и используемый тип
                               документа. По умолчанию используется <return>ENT_QUOTES | ENT_SUBSTITUTE |
                               ENT_HTML401</return>. Доступные значения параметра <strong>$flags</strong>Название
                               константыОписание<info>ENT_COMPAT</info>Преобразует двойные кавычки, одинарные
                               кавычки не изменяются.<info>ENT_QUOTES</info>Преобразует как двойные, так и
                               одинарные кавычки.<info>ENT_NOQUOTES</info>Оставляет без изменения как двойные,
                               так и одинарные кавычки.<info>ENT_IGNORE</info> Молча отбрасывает некорректные
                               кодовые последовательности вместо возврата пустой строки.
                               Использование этого флага не рекомендуется, так как это может внести
                               уязвимости в ваш код. <info>ENT_SUBSTITUTE</info> Заменяет некорректные кодовые
                               последовательности символом замены Юникода U+FFFD в случае
                               использования UTF-8 и &#FFFD; при использовании другой кодировки,
                               вместо возврата пустой строки. <info>ENT_DISALLOWED</info> Заменяет неверные коды
                               символов для заданного типа документа символом замены юникода U+FFFD
                               (UTF-8) или &#FFFD; (при использовании другой кодировки) вместо того,
                               чтобы оставлять все как есть. Это может быть полезно, например, для
                               того, чтобы убедиться в формальной правильности XML-документов со
                               встроенным внешним контентом. <info>ENT_HTML401</info> Обработка кода в
                               соответствии с HTML 4.01. <info>ENT_XML1</info> Обработка кода в соответствии с
                               XML 1. <info>ENT_XHTML</info> Обработка кода в соответствии с XHTML. <info>ENT_HTML5</info>
                               Обработка кода в соответствии с HTML 5.
  <info>string|null</info>  <strong>$encoding</strong>       Необязательный аргумент, определяющий кодировку, используемую при
                               конвертации символов.
                               
                               Если не указан, то значение по умолчанию для <strong>$encoding</strong> зависит от
                               конфигурационной опции default_charset.
                               
                               Хотя этот аргумент является технически необязательным, настоятельно
                               рекомендуется указать правильное значение для вашего кода, опция
                               конфигурации default_charset может быть задана неверно для входных
                               данных.
                               
                               Поддерживаются следующие кодировки: Поддерживаемые
                               кодировкиКодировкаПсевдонимыОписаниеISO-8859-1ISO8859-1
                               Западно-европейская Latin-1. ISO-8859-5ISO8859-5 Редко используемая
                               кириллическая кодировка (Latin/Cyrillic). ISO-8859-15ISO8859-15
                               Западно-европейская Latin-9. Добавляет знак евро, французские и
                               финские буквы к кодировке Latin-1 (ISO-8859-1). UTF-8 8-битная
                               Unicode, совместимая с ASCII. cp866ibm866, 866 Кириллическая
                               кодировка, применяемая в DOS. cp1251Windows-1251, win-1251, 1251
                               Кириллическая кодировка, применяемая в Windows. cp1252Windows-1252,
                               1252 Западно-европейская кодировка, применяемая в Windows.
                               KOI8-Rkoi8-ru, koi8r Русская кодировка. BIG5950 Традиционный
                               китайский, применяется в основном на Тайване. GB2312936 Упрощённый
                               китайский, стандартная национальная кодировка. BIG5-HKSCS Расширенная
                               Big5, применяемая в Гонконге. Shift_JISSJIS, SJIS-win, cp932, 932
                               Японская кодировка. EUC-JPEUCJP, eucJP-win Японская кодировка.
                               MacRoman Кодировка, используемая в Mac OS. <return>''</return> Пустая строка
                               активирует режим определения кодировки из файла скрипта (Zend
                               multibyte), default_charset и текущей локали (смотрите <strong>nl_langinfo()</strong>
                               и <strong>setlocale()</strong>) в указанном порядке. Не рекомендуется к использованию.
                               Остальные кодировки не поддерживаются, вместо них будет применена
                               кодировка по умолчанию и сгенерировано предупреждение.
                               
                               Остальные кодировки не поддерживаются, вместо них будет применена
                               кодировка по умолчанию и сгенерировано предупреждение.
  <info>bool</info>         <strong>$double_encode</strong>  При выключении параметра <strong>$double_encode</strong>, PHP не будет преобразовывать
                               существующие html-сущности. По умолчанию преобразуется все без
                               ограничений.

<comment>Return:</comment>
  <info>string</info>  Возвращает преобразованную строку.
          
          При наличии во входном параметре <strong>$string</strong> недопустимой последовательности символов в
          заданной кодировке <strong>$encoding</strong>, будет возвращена пустая строка, если не установлены флаги
          <info>ENT_IGNORE</info> или <info>ENT_SUBSTITUTE</info>.

<comment>See Also:</comment>
   * <strong>html_entity_decode()</strong>
   * <strong>get_html_translation_table()</strong>
   * <strong>htmlspecialchars()</strong>
   * <strong>nl2br()</strong>
   * <strong>urlencode()</strong>


id: htmlspecialchars
type: function
doc:
<comment>Description:</comment>
  Преобразует специальные символы в HTML-сущности
  
  В HTML некоторые символы имеют особый смысл и должны быть представлены в виде HTML-сущностей,
  чтобы сохранить их значение. Эта функция возвращает строку, над которой проведены эти
  преобразования. Если вам нужно преобразовать все возможные сущности, используйте <strong>htmlentities()</strong>.
  
  Если входная строка, переданная в эту функцию и результирующий документ используют одинаковую
  кодировку символов, то этой функции достаточно, чтобы подготовить данные для вставки в большинство
  частей HTML-документа. Однако, если данные содержат символы, не определённые в кодировке символов
  результирующего документа и вы ожидаете сохранения этих символов (как числовые или именованные
  сущности), то вам недостаточно будет этой и <strong>htmlentities()</strong> функций (которые только преобразуют
  подстроки с соответствующими сущностями). Необходимо использовать функцию
  <strong>mb_encode_numericentity()</strong>.
  
  Производятся следующие преобразованияСимволЗамена<return>&</return> (амперсанд)<return>&amp;</return><return>"</return> (двойные кавычки)<return>&quot;</return>, если
  не установлена <info>ENT_NOQUOTES</info><return>'</return> (одинарные кавычки)<return>&#039;</return> (для <info>ENT_HTML401</info>) или <return>&apos;</return> (для <info>ENT_XML1</info>,
  <info>ENT_XHTML</info> или <info>ENT_HTML5</info>), но только если установлена <info>ENT_QUOTES</info> <return>\<</return> (меньше)<return>&lt;</return><return>&gt;</return> (больше)<return>&gt;</return>

<comment>Param:</comment>
  <info>string</info>       <strong>$string</strong>         Конвертируемая строка (<info>string</info>).
  <info>int</info>          <strong>$flags</strong>          Битовая маска из нижеуказанных флагов, определяющих режим обработки
                               кавычек, некорректных кодовых последовательностей и используемый тип
                               документа. По умолчанию используется <return>ENT_QUOTES | ENT_SUBSTITUTE |
                               ENT_HTML401</return>. Доступные значения параметра <strong>$flags</strong>Название
                               константыОписание<info>ENT_COMPAT</info>Преобразует двойные кавычки, одинарные
                               кавычки не изменяются.<info>ENT_QUOTES</info>Преобразует как двойные, так и
                               одинарные кавычки.<info>ENT_NOQUOTES</info>Оставляет без изменения как двойные,
                               так и одинарные кавычки.<info>ENT_IGNORE</info> Без всяких уведомительных
                               сообщений отбрасывает некорректные кодовые последовательности вместо
                               возврата пустой строки. Использование этого флага не рекомендуется,
                               так как это может привести к негативным последствиям, связанным с
                               безопасностью. <info>ENT_SUBSTITUTE</info> Заменяет некорректные кодовые
                               последовательности символом замены Юникода U+FFFD в случае
                               использования UTF-8 или &#xFFFD; при использовании другой кодировки,
                               вместо возврата пустой строки. <info>ENT_DISALLOWED</info> Заменяет неверные коды
                               символов для заданного типа документа символом замены юникода U+FFFD
                               (UTF-8) или &#xFFFD; (при использовании другой кодировки) вместо
                               того, чтобы оставлять все как есть. Это может быть полезно, например,
                               для того, чтобы убедиться в формальной правильности XML-документов со
                               встроенным внешним контентом. <info>ENT_HTML401</info> Обработка кода в
                               соответствии с HTML 4.01. <info>ENT_XML1</info> Обработка кода в соответствии с
                               XML 1. <info>ENT_XHTML</info> Обработка кода в соответствии с XHTML. <info>ENT_HTML5</info>
                               Обработка кода в соответствии с HTML 5.
  <info>string|null</info>  <strong>$encoding</strong>       Необязательный аргумент, определяющий кодировку, используемую при
                               конвертации символов.
                               
                               Если не указан, то значение по умолчанию для <strong>$encoding</strong> зависит от
                               конфигурационной опции default_charset.
                               
                               Хотя этот аргумент является технически необязательным, настоятельно
                               рекомендуется указать правильное значение для вашего кода, опция
                               конфигурации default_charset может быть задана неверно для входных
                               данных.
                               
                               Для целей этой функции кодировки <return>ISO-8859-1</return>, <return>ISO-8859-15</return>, <return>UTF-8</return>,
                               <return>cp866</return>, <return>cp1251</return>, <return>cp1252</return> и <return>KOI8-R</return> являются практически эквивалентными,
                               предполагая то, что сама строка <strong>$string</strong> содержит корректные символы в
                               указанной кодировке, то символы, изменяемые <strong>htmlspecialchars()</strong>,
                               останутся на тех же местах во всех этих кодировках.
                               
                               Поддерживаются следующие кодировки: Поддерживаемые
                               кодировкиКодировкаПсевдонимыОписаниеISO-8859-1ISO8859-1
                               Западно-европейская Latin-1. ISO-8859-5ISO8859-5 Редко используемая
                               кириллическая кодировка (Latin/Cyrillic). ISO-8859-15ISO8859-15
                               Западно-европейская Latin-9. Добавляет знак евро, французские и
                               финские буквы к кодировке Latin-1 (ISO-8859-1). UTF-8 8-битная
                               Unicode, совместимая с ASCII. cp866ibm866, 866 Кириллическая
                               кодировка, применяемая в DOS. cp1251Windows-1251, win-1251, 1251
                               Кириллическая кодировка, применяемая в Windows. cp1252Windows-1252,
                               1252 Западно-европейская кодировка, применяемая в Windows.
                               KOI8-Rkoi8-ru, koi8r Русская кодировка. BIG5950 Традиционный
                               китайский, применяется в основном на Тайване. GB2312936 Упрощённый
                               китайский, стандартная национальная кодировка. BIG5-HKSCS Расширенная
                               Big5, применяемая в Гонконге. Shift_JISSJIS, SJIS-win, cp932, 932
                               Японская кодировка. EUC-JPEUCJP, eucJP-win Японская кодировка.
                               MacRoman Кодировка, используемая в Mac OS. <return>''</return> Пустая строка
                               активирует режим определения кодировки из файла скрипта (Zend
                               multibyte), default_charset и текущей локали (смотрите <strong>nl_langinfo()</strong>
                               и <strong>setlocale()</strong>) в указанном порядке. Не рекомендуется к использованию.
                               Остальные кодировки не поддерживаются, вместо них будет применена
                               кодировка по умолчанию и сгенерировано предупреждение.
                               
                               Остальные кодировки не поддерживаются, вместо них будет применена
                               кодировка по умолчанию и сгенерировано предупреждение.
  <info>bool</info>         <strong>$double_encode</strong>  Если параметр <strong>$double_encode</strong> выключен, то PHP не будет
                               преобразовывать существующие html-сущности. По умолчанию
                               преобразуется все без ограничений.

<comment>Return:</comment>
  <info>string</info>  Преобразованная строка (<info>string</info>).
          
          Если входная строка <strong>$string</strong> содержит неверную последовательность символов в указанной
          кодировке <strong>$encoding</strong>, то будет возвращаться пустая строка в случае, если флаги <info>ENT_IGNORE</info>
          или <info>ENT_SUBSTITUTE</info> не установлены.

<comment>See Also:</comment>
   * <strong>get_html_translation_table()</strong>
   * <strong>htmlspecialchars_decode()</strong>
   * <strong>strip_tags()</strong>
   * <strong>htmlentities()</strong>
   * <strong>nl2br()</strong>


id: htmlspecialchars_decode
type: function
doc:
<comment>Description:</comment>
  Преобразует специальные HTML-сущности обратно в соответствующие символы
    
  
  Эта функция является антиподом <strong>htmlspecialchars()</strong>. Она преобразует специальные HTML-сущности
  обратно в соответствующие символы.
  
  Конвертируемые сущности: , (когда <info>ENT_NOQUOTES</info> не установлена), <return>&#039;</return> (когда <info>ENT_QUOTES</info>
  установлена), и .

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Строка, которую надо преобразовать.
  <info>int</info>     <strong>$flags</strong>   Битовая маска из одного или нескольких следующих флагов, которые указывают как
                   обрабатывать кавычки и какие типы документов использовать. Значением по умолчанию
                   является <return>ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401</return>. Доступные константы,
                   используемые в качестве параметра <strong>$flags</strong>Имя
                   константыОписание<info>ENT_COMPAT</info>Преобразует двойные кавычки и пропускает
                   одинарные.<info>ENT_QUOTES</info>Преобразует и двойные, и одинарные кавычки.<info>ENT_NOQUOTES</info>Не
                   преобразует ни двойные, ни одинарные кавычки.<info>ENT_SUBSTITUTE</info> Заменяет некорректные
                   кодовые последовательности символом замены Юникода U+FFFD в случае использования
                   UTF-8 и &#FFFD; при использовании другой кодировки, вместо возврата пустой
                   строки. <info>ENT_HTML401</info> Обрабатывать код как HTML 4.01. <info>ENT_XML1</info> Обрабатывать код как
                   XML 1. <info>ENT_XHTML</info> Обрабатывать код как XHTML. <info>ENT_HTML5</info> Обрабатывать код как HTML
                   5.

<comment>Return:</comment>
  <info>string</info>  Возвращает преобразованную строку.

<comment>See Also:</comment>
   * <strong>htmlspecialchars()</strong>
   * <strong>html_entity_decode()</strong>
   * <strong>get_html_translation_table()</strong>


id: http_build_query
type: function
doc:
<comment>Description:</comment>
  Генерирует URL-кодированную строку запроса
  
  Генерирует URL-кодированную строку запроса из предоставленного ассоциативного (или
  индексированного) массива.

<comment>Param:</comment>
  <info>array|object</info>  <strong>$data</strong>            Может быть массив или объект, содержащий свойства.
                                 
                                 Если <strong>$data</strong> массив, то он может быть простой одномерной структурой
                                 или массивом массивов (который, в свою очередь, может содержать
                                 другие массивы).
                                 
                                 Если <strong>$data</strong> объект, тогда только общедоступные свойства будут
                                 включены в результат.
  <info>string</info>        <strong>$numeric_prefix</strong>  Если числовые индексы используются в базовом массиве и этот
                                 параметр указан, то он будет добавлен к числовому индексу для
                                 элементов только в базовом массиве.
                                 
                                 Это позволяет обеспечить допустимые имена переменных, в которые
                                 позже данные будут декодированы PHP или другим CGI-приложением.
  <info>string|null</info>   <strong>$arg_separator</strong>   Разделитель аргументов. Если не задан или <info>null</info>, то для разделения
                                 аргументов используется arg_separator.output.
  <info>int</info>           <strong>$encoding_type</strong>   По умолчанию <info>PHP_QUERY_RFC1738</info>.
                                 
                                 Если <strong>$encoding_type</strong> равен <info>PHP_QUERY_RFC1738</info>, тогда кодирование
                                 осуществляется по RFC 1738 и типу контента
                                 <return>application/x-www-form-urlencoded</return>, что подразумевает, что пробелы
                                 кодируются как символы "плюс" (<return>+</return>).
                                 
                                 Если <strong>$enc_type</strong> равен <info>PHP_QUERY_RFC3986</info>, тогда кодирование
                                 осуществляется в соответствии с RFC 3986, а пробелы будут
                                 закодированы в процентах (<return>%20</return>).

<comment>Return:</comment>
  <info>string</info>  Возвращает URL-кодированную строку.

<comment>See Also:</comment>
   * <strong>parse_str()</strong>
   * <strong>parse_url()</strong>
   * <strong>urlencode()</strong>
   * <strong>array_walk()</strong>


id: http_response_code
type: function
doc:
<comment>Description:</comment>
  Получает или устанавливает код ответа HTTP
  
  Получает или задаёт коды ответов HTTP.

<comment>Param:</comment>
  <info>int</info>  <strong>$response_code</strong>  Код ответа устанавливается с помощью опционального параметра <strong>$response_code</strong>.

<comment>Return:</comment>
  <info>int|bool</info>  Если <strong>$response_code</strong> задан, то будет возвращён предыдущий код статуса. Если
            <strong>$response_code</strong> не задан, то будет возвращён текущий код статуса. Оба этих значения будут
            по умолчанию иметь код состояния <return>200</return>, если они используются в окружении веб-сервера.
            
            Если <strong>$response_code</strong> не задан и используется не в окружении веб-сервера (например, в
            CLI), то будет возвращено <info>false</info>. Если <strong>$response_code</strong> задан и используется не в окружении
            веб-сервера, то будет возвращено <info>true</info> (но только если не был установлен предыдущий код
            статуса).

<comment>See Also:</comment>
   * <strong>header()</strong>
   * <strong>headers_list()</strong>


id: hypot
type: function
doc:
<comment>Description:</comment>
  Рассчитывает длину гипотенузы прямоугольного треугольника
    
  
  <strong>hypot()</strong> возвращает длину гипотенузы прямоугольного треугольника с длинами сторон <strong>$x</strong> и <strong>$y</strong> или
  расстояние точки (<strong>$x</strong>, <strong>$y</strong>) до начала координат Эквивалентно sqrt($x*$x + $y*$y).

<comment>Param:</comment>
  <info>float</info>  <strong>$x</strong>  Длина первой стороны
  <info>float</info>  <strong>$y</strong>  Длина второй стороны

<comment>Return:</comment>
  <info>float</info>  Вычисленная длина гипотенузы


id: ibase_add_user
type: function
doc:
<comment>Description:</comment>
  Добавляет пользователя в безопасную базу данных

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Дескриптор службы сервера базы данных.
  <info>string</info>    <strong>$user_name</strong>       Имя для входа нового пользователя базы данных.
  <info>string</info>    <strong>$password</strong>        Пароль нового пользователя.
  <info>string</info>    <strong>$first_name</strong>      Имя нового пользователя базы данных.
  <info>string</info>    <strong>$middle_name</strong>     Отчество нового пользователя базы данных.
  <info>string</info>    <strong>$last_name</strong>       Фамилия нового пользователя базы данных.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_modify_user()</strong>
   * <strong>ibase_delete_user()</strong>


id: ibase_affected_rows
type: function
doc:
<comment>Description:</comment>
  Возвращает количество строк, на которые повлиял предыдущий запрос
  
  Эта функция возвращает количество строк, на которые повлиял предыдущий запрос (INSERT, UPDATE или
  DELETE), который был выполнен из указанного контекста транзакции.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Контекст транзакции. Если <strong>$link_identifier</strong> является ресурсом
                              соединения, используется его транзакция по умолчанию.

<comment>Return:</comment>
  <info>int</info>  Возвращает количество строк в виде целого числа.

<comment>See Also:</comment>
   * <strong>ibase_query()</strong>
   * <strong>ibase_execute()</strong>


id: ibase_backup
type: function
doc:
<comment>Description:</comment>
  Инициирует задание резервного копирования в диспетчере служб и немедленно возвращает
  
  Эта функция передаёт аргументы на (удалённый) сервер базы данных. Там начинается новый процесс
  резервного копирования. Поэтому вы не получите никаких ответов.

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Ранее открытое соединение с сервером базы данных.
  <info>string</info>    <strong>$source_db</strong>       Абсолютный путь к файлу базы данных на сервере базы данных. Вы также
                             можете использовать псевдоним базы данных.
  <info>string</info>    <strong>$dest_file</strong>       Путь к файлу резервной копии на сервере базы данных.
  <info>int</info>       <strong>$options</strong>         Дополнительные опции для передачи на сервер базы данных для резервного
                             копирования. Параметр <strong>$options</strong> может быть комбинацией
                                     из следующих констант: <info>IBASE_BKP_IGNORE_CHECKSUMS</info>,
                             <info>IBASE_BKP_IGNORE_LIMBO</info>, <info>IBASE_BKP_METADATA_ONLY</info>,
                             <info>IBASE_BKP_NO_GARBAGE_COLLECT</info>, <info>IBASE_BKP_OLD_DESCRIPTIONS</info>,
                             <info>IBASE_BKP_NON_TRANSPORTABLE</info> или <info>IBASE_BKP_CONVERT</info>. Прочтите раздел о
                             для получения дополнительной информации.
  <info>bool</info>      <strong>$verbose</strong>         Поскольку процесс резервного копирования выполняется на сервере базы
                             данных, у вас нет шансов получить его вывод. Этот аргумент бесполезен.

<comment>Return:</comment>
  <info>mixed</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
         
         Поскольку процесс резервного копирования выполняется на (удалённом) сервере, эта функция
         просто передаёт ему аргументы.
             Пока аргументы корректны, вы не получите <info>false</info>.

<comment>See Also:</comment>
   * <strong>ibase_restore()</strong>


id: ibase_blob_add
type: function
doc:
<comment>Description:</comment>
  Добавляет данные во вновь созданный BLOB-объект
  
  <strong>ibase_blob_add()</strong> добавляет данные в BLOB-объект, созданный с помощью <strong>ibase_blob_create()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$blob_handle</strong>  Дескриптор BLOB-объекта, открытого с помощью <strong>ibase_blob_create()</strong>.
  <info>string</info>    <strong>$data</strong>         Данные для добавления.

<comment>Return:</comment>
  <info>void</info>  Функция не возвращает значения после выполнения.

<comment>See Also:</comment>
   * <strong>ibase_blob_cancel()</strong>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_create()</strong>
   * <strong>ibase_blob_import()</strong>


id: ibase_blob_cancel
type: function
doc:
<comment>Description:</comment>
  Отменяет создания BLOB-объекта
  
  Эта функция отбрасывает BLOB-объект, если он ещё не был закрыт с помощью <strong>ibase_blob_close()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$blob_handle</strong>  Дескриптор BLOB-объекта, открытый с помощью <strong>ibase_blob_create()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_create()</strong>
   * <strong>ibase_blob_import()</strong>


id: ibase_blob_close
type: function
doc:
<comment>Description:</comment>
  Закрывает BLOB-объект
  
  Эта функция закрывает BLOB-объект, открытый для чтения с помощью <strong>ibase_blob_open()</strong> или
  <strong>ibase_blob_create()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$blob_handle</strong>  BLOB-объект, открытый с помощью <strong>ibase_blob_create()</strong> или <strong>ibase_blob_open()</strong>.

<comment>Return:</comment>
  <info>mixed</info>  Если BLOB-объект читался, функция возвращает <info>true</info> в случае успешного выполнения, если BLOB
         записывался, функция возвращает строку, содержащую идентификатор BLOB-объекта, который был
         назначен ей базой данных. В случае неудачи функция возвращает <info>false</info>.

<comment>See Also:</comment>
   * <strong>ibase_blob_cancel()</strong>
   * <strong>ibase_blob_open()</strong>


id: ibase_blob_create
type: function
doc:
<comment>Description:</comment>
  Создаёт новый BLOB-объект для заполнения данными
  
  <strong>ibase_blob_create()</strong> создаёт новый BLOB-объект для заполнения данными.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указано, предполагается
                              последняя открытая ссылка.

<comment>Return:</comment>
  <info>resource|false</info>  Возвращает дескриптор BLOB-объекта для последующего использования с
                  <strong>ibase_blob_add()</strong> или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_blob_add()</strong>
   * <strong>ibase_blob_cancel()</strong>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_import()</strong>


id: ibase_blob_echo
type: function
doc:
<comment>Description:</comment>
  Выводит содержимое BLOB-объекта в браузер
  
  Функция открывает BLOB-объект для чтения и отправляет его содержимое на стандартный вывод (в
  большинстве случаев – браузер).

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается
                              последняя открытая ссылка.
  <info>string</info>    <strong>$blob_id</strong>          

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_blob_open()</strong>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_get()</strong>


id: ibase_blob_get
type: function
doc:
<comment>Description:</comment>
  Получает количество байтов от открытого BLOB-объекта
  
  Функция возвращает не более <strong>$len</strong> байт из BLOB-объекта, который был открыт для чтения с помощью
  <strong>ibase_blob_open()</strong>.
  
  Невозможно прочитать из BLOB-объекта, который был открыт для записи с помощью <strong>ibase_blob_create()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$blob_handle</strong>  BLOB-объект, открытый с помощью <strong>ibase_blob_open()</strong>.
  <info>int</info>       <strong>$len</strong>          Размер возвращаемых данных.

<comment>Return:</comment>
  <info>string</info>  Возвращает не более <strong>$len</strong> байт из BLOB-объекта или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_blob_open()</strong>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_echo()</strong>


id: ibase_blob_import
type: function
doc:
<comment>Description:</comment>
  Создаёт BLOB-объект, копирует в него файл и закрывает его
  
  Функция создаёт BLOB-объект, считывает в него весь файл, закрывает его и возвращает назначенный
  идентификатор BLOB-объекта.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается
                              последняя открытая ссылка.
  <info>resource</info>  <strong>$file_handle</strong>      Дескриптор файла - возвращаемый функцией <strong>fopen()</strong>.

<comment>Return:</comment>
  <info>string</info>  Возвращает идентификатор BLOB-объекта в случае успешного выполнения, или <info>false</info> в случае
          возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_blob_add()</strong>
   * <strong>ibase_blob_cancel()</strong>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_create()</strong>


id: ibase_blob_info
type: function
doc:
<comment>Description:</comment>
  Возвращает длину BLOB-объекта и другую полезную информацию
  
  Возвращает длину BLOB-объекта и другую полезную информацию.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается
                              последняя открытая ссылка.
  <info>string</info>    <strong>$blob_id</strong>          Идентификатор BLOB-объекта.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив, содержащий информацию о BLOB-объекте. Возвращаемая информация состоит из
         длины BLOB-объекта, количества содержащихся в нем сегментов, размера самого большого
         сегмента и того, является ли он BLOB-потоком или сегментированным BLOB-объектом.


id: ibase_blob_open
type: function
doc:
<comment>Description:</comment>
  Открывает BLOB-объект для извлечения частей данных
  
  Открывает существующий BLOB-объект для чтения.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается
                              последняя открытая ссылка.
  <info>string</info>    <strong>$blob_id</strong>          Идентификатор BLOB-объекта.

<comment>Return:</comment>
  <info>resource|false</info>  Возвращает дескриптор BLOB-объекта для последующего использования с помощью
                  <strong>ibase_blob_get()</strong> или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_blob_close()</strong>
   * <strong>ibase_blob_echo()</strong>
   * <strong>ibase_blob_get()</strong>


id: ibase_close
type: function
doc:
<comment>Description:</comment>
  Закрывает соединение с базой данных InterBase
  
  Закрывает ссылку на базу данных InterBase, связанную с идентификатором соединения, полученным с
  помощью <strong>ibase_connect()</strong>. Транзакция по умолчанию для ссылки зафиксирована, остальные транзакции
  отменены.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection_id</strong>  Идентификатор ссылки InterBase, полученный с помощью <strong>ibase_connect()</strong>.
                            Если не указан, предполагается последняя открытая ссылка.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_connect()</strong>
   * <strong>ibase_pconnect()</strong>


id: ibase_commit
type: function
doc:
<comment>Description:</comment>
  Фиксирует транзакцию
  
  Фиксирует транзакцию.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_or_trans_identifier</strong>  Если вызывается без аргумента, функция фиксирует транзакцию
                                       по умолчанию для ссылки по умолчанию. Если аргумент –
                                       идентификатор соединения, транзакция по умолчанию
                                       соответствующего соединения будет зафиксирована. Если
                                       аргумент – идентификатор транзакции, соответствующая
                                       транзакция будет зафиксирована.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_commit_ret
type: function
doc:
<comment>Description:</comment>
  Фиксирует транзакцию, не закрывая её
  
  Фиксирует транзакцию, не закрывая её.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_or_trans_identifier</strong>  Если вызывается без аргумента, функция фиксирует транзакцию
                                       по умолчанию для ссылки по умолчанию. Если аргумент –
                                       идентификатор соединения, транзакция по умолчанию
                                       соответствующего соединения будет зафиксирована. Если
                                       аргумент – идентификатор транзакции, соответствующая
                                       транзакция будет зафиксирована. Контекст транзакции будет
                                       сохранён, поэтому операторы, выполненные из этой транзакции,
                                       не будут признаны недействительными.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_connect
type: function
doc:
<comment>Description:</comment>
  Открывает соединение с базой данных
  
  Устанавливает соединение с сервером Firebird/InterBase.
  
  В случае повторного вызова <strong>ibase_connect()</strong> с теми же аргументами новая ссылка не будет
  установлена, вместо этого будет возвращён идентификатор уже открытой ссылки. Ссылка на сервер
  будет закрыта, как только завершится выполнение скрипта, если только она не была закрыта ранее
  явным вызовом <strong>ibase_close()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$database</strong>  Аргумент <strong>$database</strong> должен быть корректным путём к файлу базы данных на сервере,
                     на котором он находится. Если сервер не является локальным, перед ним должно
                     стоять префикс 'hostname:' (TCP / IP), 'hostname/port:' (TCP/IP с сервером
                     interbase на настраиваемом порту TCP), '//hostname/' (NetBEUI), в зависимости
                     от используемого протокола соединения.
  <info>string</info>  <strong>$username</strong>  Имя пользователя. Может быть установлено с помощью директивы <return>ibase.default_user</return>
                     php.ini.
  <info>string</info>  <strong>$password</strong>  Пароль для <strong>$username</strong>. Может быть установлен с помощью директивы
                     <return>ibase.default_password</return> php.ini.
  <info>string</info>  <strong>$charset</strong>   <strong>$charset</strong> является набором символов по умолчанию для базы данных.
  <info>int</info>     <strong>$buffers</strong>   <strong>$buffers</strong> - это количество буферов базы данных, выделяемых для кеша на стороне
                     сервера. Если 0 или не указано, сервер выбирает свой собственный по умолчанию.
  <info>int</info>     <strong>$dialect</strong>   <strong>$dialect</strong> выбирает диалект SQL по умолчанию для любого оператора, выполняемого в
                     соединении, по умолчанию он соответствует максимальному из поддерживаемых
                     клиентских библиотек.
  <info>string</info>  <strong>$role</strong>      Функционально только с InterBase 5 и выше.
  <info>int</info>     <strong>$sync</strong>      

<comment>Return:</comment>
  <info>resource</info>  Возвращает идентификатор ссылки Firebird/InterBase в случае успешного выполнения или
            <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_pconnect()</strong>
   * <strong>ibase_close()</strong>


id: ibase_db_info
type: function
doc:
<comment>Description:</comment>
  Запрашивает статистику базы данных
  
  К настоящему времени эта функция ещё не была документирована; для ознакомления доступен только
  список аргументов.

<comment>Return:</comment>
  <info>string</info>  


id: ibase_delete_user
type: function
doc:
<comment>Description:</comment>
  Удаляет пользователя из безопасной базы данных

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Дескриптор службы сервера базы данных.
  <info>string</info>    <strong>$user_name</strong>       Имя пользователя, которого вы хотите удалить из базы данных.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_add_user()</strong>
   * <strong>ibase_modify_user()</strong>


id: ibase_drop_db
type: function
doc:
<comment>Description:</comment>
  Удаляет базу данных
  
  Функция удаляет базу данных, которая была открыта либо с помощью <strong>ibase_connect()</strong>, либо
  <strong>ibase_pconnect()</strong>. База данных закрывается и удаляется с сервера.

<comment>Param:</comment>
  <info>resource</info>  <strong>$connection</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается последняя
                         открытая ссылка.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_connect()</strong>
   * <strong>ibase_pconnect()</strong>


id: ibase_errcode
type: function
doc:
<comment>Description:</comment>
  Возвращает код ошибки
  
  Возвращает код ошибки, полученный в результате последнего вызова функции InterBase.

<comment>Return:</comment>
  <info>int</info>  Возвращает код ошибки в виде целого числа или <info>false</info>, если ошибки не произошло.

<comment>See Also:</comment>
   * <strong>ibase_errmsg()</strong>


id: ibase_errmsg
type: function
doc:
<comment>Description:</comment>
  Возвращает сообщение об ошибке
  
  Возвращает сообщение об ошибке, полученное в результате последнего вызова функции InterBase.

<comment>Return:</comment>
  <info>string</info>  Возвращает сообщение об ошибке в виде строки или <info>false</info> если ошибки не произошло.

<comment>See Also:</comment>
   * <strong>ibase_errcode()</strong>


id: ibase_execute
type: function
doc:
<comment>Description:</comment>
  Выполняет предварительно подготовленный запрос
  
  Выполняет запрос, подготовленный с помощью <strong>ibase_prepare()</strong>.
  
  Это намного эффективнее, чем использование <strong>ibase_query()</strong>, если вы повторяете один и тот же тип
  запроса несколько раз, изменяя только некоторые параметры.

<comment>Param:</comment>
  <info>resource</info>  <strong>$query</strong>   Запрос InterBase, подготовленный с помощью <strong>ibase_prepare()</strong>.
  <info>mixed</info>     <strong>$values</strong>  

<comment>Return:</comment>
  <info>resource</info>  Если запрос вызывает ошибку, возвращает <info>false</info>. Если запрос выполнен успешно, и есть
            (возможно пустой) набор результатов (как при запросе SELECT), возвращает идентификатор
            результата. Если запрос выполнен успешно и результатов не было, возвращается <info>true</info>.
            
            Функция возвращает количество строк, затронутых запросом (если &gt; 0 и применимо к типу
            оператора). Если запрос выполнен успешно, но не затронул ни одну строку (например,
            UPDATE несуществующей записи), вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>ibase_query()</strong>


id: ibase_fetch_assoc
type: function
doc:
<comment>Description:</comment>
  Извлекает строку результата из запроса в виде ассоциативного массива
  
  Извлекает строку результата из запроса в виде ассоциативного массива
  
  <strong>ibase_fetch_assoc()</strong> извлекает одну строку данных из результата. Если два или более столбца
  результата имеют одинаковые наименования полей, последний столбец будет иметь приоритет. Чтобы
  получить доступ к другим столбцам с тем же именем, вам нужно либо получить доступ к результату с
  помощью числовых индексов функцией <strong>ibase_fetch_row()</strong>, либо использовать псевдонимы в своём
  запросе.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result</strong>      Дескриптор результата.
  <info>int</info>       <strong>$fetch_flag</strong>  <strong>$fetch_flag</strong> представляет собой комбинацию констант <info>IBASE_TEXT</info> и
                         <info>IBASE_UNIXTIME</info> ORed. Передача <info>IBASE_TEXT</info> заставит функцию возвращать
                         содержимое BLOB-объектов вместо идентификаторов BLOB-объектов. Передача
                         <info>IBASE_UNIXTIME</info> заставит функцию возвращать значения даты/времени как метки
                         времени Unix, а не как отформатированные строки.

<comment>Return:</comment>
  <info>array</info>  Возвращает ассоциативный массив, соответствующий выбранной строке. Последующие вызовы
         вернут следующую строку в наборе результатов или <info>false</info>, если строк больше нет.

<comment>See Also:</comment>
   * <strong>ibase_fetch_row()</strong>
   * <strong>ibase_fetch_object()</strong>


id: ibase_fetch_object
type: function
doc:
<comment>Description:</comment>
  Получает объект из базы данных InterBase
  
  Извлекает строку как псевдообъект из заданного идентификатора результата.
  
  Последующие вызовы <strong>ibase_fetch_object()</strong> вернут следующую строку в наборе результатов.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result_id</strong>   Идентификатор результата InterBase, полученный с помощью <strong>ibase_query()</strong> или
                         <strong>ibase_execute()</strong>.
  <info>int</info>       <strong>$fetch_flag</strong>  <strong>$fetch_flag</strong> представляет собой комбинацию констант <info>IBASE_TEXT</info> и
                         <info>IBASE_UNIXTIME</info> ORed. Передача <info>IBASE_TEXT</info> заставит функцию возвращать
                         содержимое BLOB-объектов вместо идентификаторов BLOB-объектов. Передача
                         <info>IBASE_UNIXTIME</info> заставит функцию возвращать значения даты/времени как метки
                         времени Unix, а не как отформатированные строки.

<comment>Return:</comment>
  <info>object</info>  Возвращает объект с информацией о строке или <info>false</info>, если строк больше нет.

<comment>See Also:</comment>
   * <strong>ibase_fetch_row()</strong>
   * <strong>ibase_fetch_assoc()</strong>


id: ibase_fetch_row
type: function
doc:
<comment>Description:</comment>
  Извлекает строку из базы данных InterBase
  
  <strong>ibase_fetch_row()</strong> извлекает одну строку данных из данного набора результатов.
  
  Последующие вызовы <strong>ibase_fetch_row()</strong> вернут следующую строку в наборе результатов или <info>false</info>, если
  строк больше нет.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result_identifier</strong>  Идентификатор результата InterBase.
  <info>int</info>       <strong>$fetch_flag</strong>         <strong>$fetch_flag</strong> представляет собой комбинацию констант <info>IBASE_TEXT</info> и
                                <info>IBASE_UNIXTIME</info> ORed. Передача <info>IBASE_TEXT</info> заставит функцию возвращать
                                содержимое BLOB-объектов вместо идентификаторов BLOB-объектов.
                                Передача <info>IBASE_UNIXTIME</info> заставит функцию возвращать значения
                                даты/времени как метки времени Unix, а не как отформатированные
                                строки.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив, соответствующий выбранной строке, или <info>false</info>, если строк больше нет.
         Каждый столбец результата сохраняется в смещении массива, начиная со смещения 0.

<comment>See Also:</comment>
   * <strong>ibase_fetch_assoc()</strong>
   * <strong>ibase_fetch_object()</strong>


id: ibase_field_info
type: function
doc:
<comment>Description:</comment>
  Получает информацию о поле
  
  Возвращает массив с информацией о поле после выполнения запроса select.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result</strong>        Идентификатор результата InterBase.
  <info>int</info>       <strong>$field_number</strong>  Смещение поля.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив со следующими ключами: <return>name</return>, <return>alias</return>, <return>relation</return>, <return>length</return> и <return>type</return>.

<comment>See Also:</comment>
   * <strong>ibase_num_fields()</strong>


id: ibase_free_event_handler
type: function
doc:
<comment>Description:</comment>
  Отменяет зарегистрированный обработчик события
  
  Функция отменяет, зарегистрированный обработчик события, указанный в <strong>$event</strong>. Callback-функция
  больше не будет вызываться для событий, для которых она была зарегистрирована.

<comment>Param:</comment>
  <info>resource</info>  <strong>$event</strong>  Ресурс события, созданный <strong>ibase_set_event_handler()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_set_event_handler()</strong>


id: ibase_free_query
type: function
doc:
<comment>Description:</comment>
  Освобождает память, выделенную на подготовку запроса
  
  Освобождает подготовленный запрос.

<comment>Param:</comment>
  <info>resource</info>  <strong>$query</strong>  Запрос, подготовленный с помощью <strong>ibase_prepare()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_free_result
type: function
doc:
<comment>Description:</comment>
  Освобождает набор результатов
  
  Освобождает набор результатов.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result_identifier</strong>  Набор результатов, созданных с помощью <strong>ibase_query()</strong> или
                                <strong>ibase_execute()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_gen_id
type: function
doc:
<comment>Description:</comment>
  Увеличивает указанный генератор и возвращает его новое значение
  
  К настоящему времени эта функция ещё не была документирована; для ознакомления доступен только
  список аргументов.

<comment>Return:</comment>
  <info>mixed</info>  Возвращает новое значение генератора в виде целого числа или строки, если значение слишком
         большое.


id: ibase_maintain_db
type: function
doc:
<comment>Description:</comment>
  Выполняет команду обслуживания на сервере базы данных
  
  К настоящему времени эта функция ещё не была документирована; для ознакомления доступен только
  список аргументов.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_modify_user
type: function
doc:
<comment>Description:</comment>
  Изменяет пользователя в безопасной базе данных

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Дескриптор службы сервера базы данных.
  <info>string</info>    <strong>$user_name</strong>       Имя пользователя базы данных для изменения.
  <info>string</info>    <strong>$password</strong>        Новый пароль пользователя.
  <info>string</info>    <strong>$first_name</strong>      Новое имя пользователя.
  <info>string</info>    <strong>$middle_name</strong>     Новое отчество пользователя.
  <info>string</info>    <strong>$last_name</strong>       Новая фамилия пользователя.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_add_user()</strong>
   * <strong>ibase_delete_user()</strong>


id: ibase_name_result
type: function
doc:
<comment>Description:</comment>
  Присваивает имя набору результатов
  
  Функция присваивает имя набору результатов. Имя может быть использовано позже в запросах
  UPDATE|DELETE ... WHERE CURRENT OF <strong>$name</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result</strong>  Набор результатов InterBase.
  <info>string</info>    <strong>$name</strong>    Имя для назначения.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_prepare()</strong>
   * <strong>ibase_execute()</strong>


id: ibase_num_fields
type: function
doc:
<comment>Description:</comment>
  Возвращает количество полей в результирующем наборе
  
  Возвращает количество полей в результирующем наборе.

<comment>Param:</comment>
  <info>resource</info>  <strong>$result_id</strong>  Идентификатор результата InterBase.

<comment>Return:</comment>
  <info>int</info>  Возвращает количество полей в виде целого числа.

<comment>See Also:</comment>
   * <strong>ibase_field_info()</strong>


id: ibase_num_params
type: function
doc:
<comment>Description:</comment>
  Возвращает количество параметров в подготовленном запросе
  
  Эта функция возвращает количество параметров в подготовленном запросе, указанном <strong>$query</strong>. Это
  количество связывающих аргументов, которые должны присутствовать при вызове <strong>ibase_execute()</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$query</strong>  Дескриптор подготовленного запроса.

<comment>Return:</comment>
  <info>int</info>  Возвращает количество параметров в виде целого числа.

<comment>See Also:</comment>
   * <strong>ibase_prepare()</strong>
   * <strong>ibase_param_info()</strong>


id: ibase_param_info
type: function
doc:
<comment>Description:</comment>
  Возвращает информацию о параметре в подготовленном запросе
  
  Возвращает массив с информацией о параметре после подготовки запроса.

<comment>Param:</comment>
  <info>resource</info>  <strong>$query</strong>         Дескриптор подготовленного запроса InterBase.
  <info>int</info>       <strong>$param_number</strong>  Смещение параметра.

<comment>Return:</comment>
  <info>array</info>  Возвращает массив со следующими ключами: <return>name</return>, <return>alias</return>, <return>relation</return>, <return>length</return> и <return>type</return>.

<comment>See Also:</comment>
   * <strong>ibase_field_info()</strong>
   * <strong>ibase_num_params()</strong>


id: ibase_pconnect
type: function
doc:
<comment>Description:</comment>
  Открывает постоянное соединение с базой данных InterBase
  
  Открывает постоянное соединение с базой данных InterBase.
  
  Принцип работы <strong>ibase_pconnect()</strong> очень похож на <strong>ibase_connect()</strong> с двумя основными отличиями.
  
  Во-первых, при подключении функция сначала попытается найти (постоянную) ссылку, которая уже
  открыта с такими же параметрами. Если она будет найдена, вместо открытия нового соединения будет
  возвращён её идентификатор.
  
  Во-вторых, соединение с сервером InterBase не будет закрыто по окончании выполнения скрипта.
  Вместо этого ссылка останется открытой для использования в дальнейшем (<strong>ibase_close()</strong> не будет
  закрывать ссылки, установленные <strong>ibase_pconnect()</strong>). Поэтому этот тип ссылки называется
  "постоянным".

<comment>Param:</comment>
  <info>string</info>  <strong>$database</strong>  Аргумент <strong>$database</strong> должен быть допустимым путём к файлу базы данных на сервере,
                     на котором он находится. Если сервер не является локальным, он должен иметь
                     префикс 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) или 'hostname@'
                     (IPX/SPX), в зависимости от используемого протокола подключения.
  <info>string</info>  <strong>$username</strong>  Имя пользователя. Можно установить с помощью директивы php.ini
                     <return>ibase.default_user</return>.
  <info>string</info>  <strong>$password</strong>  Пароль для <strong>$username</strong>. Можно установить с помощью директивы php.ini
                     <return>ibase.default_password</return>.
  <info>string</info>  <strong>$charset</strong>   <strong>$charset</strong> - набор символов по умолчанию для базы данных.
  <info>int</info>     <strong>$buffers</strong>   <strong>$buffers</strong> - количество буферов базы данных, выделяемых для кеша на стороне
                     сервера. Если значение равно 0 или опущено, сервер выбирает собственное
                     значение по умолчанию.
  <info>int</info>     <strong>$dialect</strong>   <strong>$dialect</strong> выбирает диалект SQL по умолчанию для любого выражения, выполняемого в
                     соединении, и по умолчанию выбирает самый высокий диалект, поддерживаемый
                     клиентскими библиотеками. Работает только с InterBase 6 и выше.
  <info>string</info>  <strong>$role</strong>      Работает только с InterBase 5 и выше.
  <info>int</info>     <strong>$sync</strong>      

<comment>Return:</comment>
  <info>resource</info>  Возвращает идентификатор ссылки InterBase в случае успешного выполнения или <info>false</info> в
            случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_close()</strong>
   * <strong>ibase_connect()</strong>


id: ibase_prepare
type: function
doc:
<comment>Description:</comment>
  Подготавливает запрос для последующего связывания псевдопеременных и выполнения
  
  Подготавливает запрос для последующего связывания псевдопеременных и выполнения (с помощью
  <strong>ibase_execute()</strong>).

<comment>Param:</comment>
  <info>string</info>    <strong>$query</strong>            Запрос InterBase.
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase, возвращаемый функцией <strong>ibase_connect()</strong>.
                              Если не указан, предполагается последняя открытая ссылка.
  <info>string</info>    <strong>$trans</strong>            Дескриптор транзакции InterBase, с которой должен быть связан запрос.
                              Если не указан, предполагается транзакция соединения по умолчанию.

<comment>Return:</comment>
  <info>resource</info>  Возвращает дескриптор подготовленного запроса или <info>false</info> в случае возникновения ошибки.


id: ibase_query
type: function
doc:
<comment>Description:</comment>
  Выполняет запрос к базе данных InterBase
  
  Выполняет запрос к базе данных InterBase.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается
                              последняя открытая ссылка.
  <info>string</info>    <strong>$query</strong>            Запрос InterBase.
  <info>int</info>       <strong>$bind_args</strong>        

<comment>Return:</comment>
  <info>resource</info>  Если запрос вызывает ошибку, возвращает <info>false</info>. В случае успешного выполнения и наличия
            (возможно, пустого) результирующего набора (например, с запросом SELECT) возвращает
            идентификатор результата. Если запрос был успешным и результатов не было, возвращает
            <info>true</info>.
            
            В PHP 5.0.0 и выше эта функция будет возвращать количество строк, затронутых запросом,
            для операторов INSERT, UPDATE и DELETE. Чтобы сохранить обратную совместимость, она
            будет возвращать <info>true</info> для этих операций, если запрос выполнен успешно без затрагивания
            каких-либо строк.

<comment>See Also:</comment>
   * <strong>ibase_errmsg()</strong>
   * <strong>ibase_fetch_row()</strong>
   * <strong>ibase_fetch_object()</strong>
   * <strong>ibase_free_result()</strong>


id: ibase_restore
type: function
doc:
<comment>Description:</comment>
  Запускает задачу восстановления в диспетчере служб и немедленно возвращается
  
  Эта функция передаёт аргументы (удалённому) серверу базы данных. Там она начинает новый процесс
  восстановления. Поэтому вы не получите никакого ответа.

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Ранее открытое соединение с сервером базы данных.
  <info>string</info>    <strong>$source_file</strong>     Абсолютный путь на сервере, где находится файл резервной копии.
  <info>string</info>    <strong>$dest_db</strong>         Путь для создания новой базы данных на сервере. Вы также можете
                             использовать псевдоним базы данных.
  <info>int</info>       <strong>$options</strong>         Дополнительные параметры для передачи на сервер базы данных для
                             восстановления. Параметр <strong>$options</strong> может быть комбинацией следующих
                             констант: <info>IBASE_RES_DEACTIVATE_IDX</info>, <info>IBASE_RES_NO_SHADOW</info>,
                             <info>IBASE_RES_NO_VALIDITY</info>, <info>IBASE_RES_ONE_AT_A_TIME</info>, <info>IBASE_RES_REPLACE</info>,
                             <info>IBASE_RES_CREATE</info>, <info>IBASE_RES_USE_ALL_SPACE</info>, <info>IBASE_PRP_PAGE_BUFFERS</info>,
                             <info>IBASE_PRP_SWEEP_INTERVAL</info>, <info>IBASE_RES_CREATE</info>. Читайте раздел о  для
                             получения дополнительной информации.
  <info>bool</info>      <strong>$verbose</strong>         Поскольку процесс восстановления выполняется на сервере базы данных, у
                             вас нет возможности получить вывод. Этот аргумент бесполезен.

<comment>Return:</comment>
  <info>mixed</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
         
         Поскольку процесс восстановления выполняется на (удалённом) сервере, эта функция просто
         передаёт ему аргументы. Если аргументы недействительны, то вернётся <info>false</info>.

<comment>See Also:</comment>
   * <strong>ibase_backup()</strong>


id: ibase_rollback
type: function
doc:
<comment>Description:</comment>
  Откатывает транзакцию
  
  Откатывает транзакцию.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_or_trans_identifier</strong>  Если вызывается без аргумента, эта функция откатывает
                                       транзакцию по умолчанию для ссылки по умолчанию. Если
                                       аргумент является идентификатором соединения, транзакция по
                                       умолчанию для соответствующего соединения будет отменена.
                                       Если аргумент является идентификатором транзакции,
                                       соответствующая транзакция будет отменена.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_rollback_ret
type: function
doc:
<comment>Description:</comment>
  Откатывает транзакцию, не закрывая её
  
  Откатывает транзакцию, не закрывая её.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link_or_trans_identifier</strong>  Если вызывается без аргумента, эта функция откатывает
                                       транзакцию по умолчанию для ссылки по умолчанию. Если
                                       аргумент является идентификатором соединения, транзакция по
                                       умолчанию для соответствующего соединения будет отменена.
                                       Если аргумент является идентификатором транзакции,
                                       соответствующая транзакция будет отменена. Контекст
                                       транзакции будет сохранён, поэтому выражения, выполняемые из
                                       этой транзакции, не будут признаны недействительными.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_server_info
type: function
doc:
<comment>Description:</comment>
  Запрашивает информацию о сервере базы данных

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Ранее созданное соединение с сервером базы данных.
  <info>int</info>       <strong>$action</strong>          Допустимая константа.

<comment>Return:</comment>
  <info>string</info>  Возвращает смешанные типы в зависимости от контекста.


id: ibase_service_attach
type: function
doc:
<comment>Description:</comment>
  Подключается к диспетчеру служб

<comment>Param:</comment>
  <info>string</info>  <strong>$host</strong>          Имя или IP-адрес хоста базы данных. Вы можете указать порт, добавив '/' и
                         номер порта. Если порт не указан, будет использоваться порт 3050.
  <info>string</info>  <strong>$dba_username</strong>  Имя любого действительного пользователя.
  <info>string</info>  <strong>$dba_password</strong>  Пароль пользователя.

<comment>Return:</comment>
  <info>resource|false</info>  Возвращает идентификатор ссылки Interbase / Firebird в случае успешного выполнения
                  или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>ibase_service_detach()</strong>


id: ibase_service_detach
type: function
doc:
<comment>Description:</comment>
  Отключается от диспетчера служб

<comment>Param:</comment>
  <info>resource</info>  <strong>$service_handle</strong>  Ранее созданное соединение с сервером базы данных.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: ibase_set_event_handler
type: function
doc:
<comment>Description:</comment>
  Регистрирует callback-функцию, которая будет вызываться при публикации событий
  
  Функция регистрирует пользовательскую функцию PHP в качестве обработчика событий для указанных
  событий.

<comment>Param:</comment>
  <info>callable</info>  <strong>$event_handler</strong>  Callback-функция вызывается с именем события и ресурсом ссылки в
                            качестве аргументов всякий раз, когда одно из указанных событий
                            публикуется базой данных.
                            
                            Callback-функция должна возвращать <info>false</info>, если обработчик события должен
                            быть отменён. Любое другое возвращаемое значение игнорируется. Функция
                            принимает до 15 аргументов события.
  <info>string</info>    <strong>$event_name</strong>     Наименование события.
  <info>string</info>    <strong>$event_names</strong>    Разрешено максимум 15 событий.

<comment>Return:</comment>
  <info>resource</info>  Возвращаемое значение является ресурсом события. Этот ресурс можно использовать для
            освобождения обработчика событий с помощью <strong>ibase_free_event_handler()</strong>.

<comment>See Also:</comment>
   * <strong>ibase_free_event_handler()</strong>
   * <strong>ibase_wait_event()</strong>


id: ibase_trans
type: function
doc:
<comment>Description:</comment>
  Начинает транзакцию
  
  Начинает транзакцию.
  
  Первый вызов <strong>ibase_trans()</strong> не вернёт транзакцию соединения по умолчанию. Все транзакции,
  запущенные с помощью <strong>ibase_trans()</strong>, будут отменены в конце скрипта, если они не были
  зафиксированы, или будут отменены с помощью <strong>ibase_commit()</strong> или <strong>ibase_rollback()</strong>.
  
  Эта функция принимает несколько аргументов <strong>$trans_args</strong> и <strong>$link_identifier</strong>. Это позволяет выполнять
  транзакции через несколько соединений с базой данных, которые фиксируются с использованием
  алгоритма двухэтапной фиксации. Это означает, что вы можете рассчитывать на то, что обновления
  будут успешными в каждой базе данных или завершатся ошибкой в каждой базе данных. Это НЕ означает,
  что вы можете использовать таблицы из разных баз данных в одном запросе!
  
  Если вы используете транзакции в нескольких базах данных, вам нужно будет указать как <strong>$link_id</strong>,
  так и <strong>$transaction_id</strong> в вызовах <strong>ibase_query()</strong> и <strong>ibase_prepare()</strong>.

<comment>Param:</comment>
  <info>int</info>       <strong>$trans_args</strong>       <strong>$trans_args</strong> может быть комбинацией <info>IBASE_READ</info>, <info>IBASE_WRITE</info>,
                              <info>IBASE_COMMITTED</info>, <info>IBASE_CONSISTENCY</info>, <info>IBASE_CONCURRENCY</info>,
                              <info>IBASE_REC_VERSION</info>, <info>IBASE_REC_NO_VERSION</info>, <info>IBASE_WAIT</info> и <info>IBASE_NOWAIT</info>.
  <info>resource</info>  <strong>$link_identifier</strong>  Идентификатор ссылки InterBase. Если не указан, предполагается
                              последняя открытая ссылка.

<comment>Return:</comment>
  <info>resource</info>  Возвращает дескриптор транзакции или <info>false</info> в случае возникновения ошибки.


id: ibase_wait_event
type: function
doc:
<comment>Description:</comment>
  Ждём, пока событие будет опубликовано в базе данных
  
  Функция приостанавливает выполнение сценария до тех пор, пока одно из указанных событий не будет
  опубликовано в базе данных. Имя события, которое было опубликовано, возвращается. Функция
  принимает до 15 аргументов события.

<comment>Param:</comment>
  <info>string</info>  <strong>$event_name</strong>   Название события.
  <info>string</info>  <strong>$event_names</strong>  

<comment>Return:</comment>
  <info>string</info>  Возвращает название события, которое было опубликовано.

<comment>See Also:</comment>
   * <strong>ibase_set_event_handler()</strong>
   * <strong>ibase_free_event_handler()</strong>


id: iconv
type: function
doc:
<comment>Description:</comment>
  Преобразует строку из одной кодировки символов в другую
  
  Преобразует строку <strong>$string</strong> из кодировки <strong>$from_encoding</strong> в <strong>$to_encoding</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$from_encoding</strong>  Текущая кодировка, используемая для интерпретации параметра <strong>$string</strong>.
  <info>string</info>  <strong>$to_encoding</strong>    Требуемая на выходе кодировка.
                          
                          Если к параметру <strong>$to_encoding</strong> добавлена строка <return>//TRANSLIT</return>, включается
                          режим транслитерации. Это значит, что в случае, если символ не может быть
                          представлен в требуемой кодировке, он может быть заменён одним или
                          несколькими похожими символами. Если добавлена строка <return>//IGNORE</return>, то
                          символы, которые не могут быть представлены в требуемой кодировке, будут
                          удалены. В случае отсутствия вышеуказанных параметров будет сгенерирована
                          ошибка уровня <info>E_NOTICE</info>, а функция вернёт <info>false</info>.
                          
                          Как будет работать <return>//TRANSLIT</return> и будет ли вообще, зависит от системной
                          реализации iconv() (<info>ICONV_IMPL</info>). Известны некоторые реализации, которые
                          просто игнорируют <return>//TRANSLIT</return>, так что конвертация для символов
                          некорректных для <strong>$to_encoding</strong> скорее всего закончится ошибкой.
  <info>string</info>  <strong>$string</strong>         Строка (<info>string</info>) для преобразования.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает преобразованную строку или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>mb_convert_encoding()</strong>
   * UConverter::transcode


id: iconv_get_encoding
type: function
doc:
<comment>Description:</comment>
  Получает текущее значение настроек преобразования кодировок
  
  Возвращает внутренние параметры конфигурации модуля iconv.

<comment>Param:</comment>
  <info>string</info>  <strong>$type</strong>  Возможные значения необязательного параметра <strong>$type</strong>:
                 allinput_encodingoutput_encodinginternal_encoding

<comment>Return:</comment>
  <info>array|string|false</info>  Возвращает текущее значение указанной переменной и <info>false</info> в случае
                      возникновения ошибки.
                      
                      Если <strong>$type</strong> не указан или равен "all", <strong>iconv_get_encoding()</strong> вернёт массив со
                      значениями всех переменных.

<comment>See Also:</comment>
   * <strong>iconv_set_encoding()</strong>
   * <strong>ob_iconv_handler()</strong>


id: iconv_mime_decode
type: function
doc:
<comment>Description:</comment>
  Декодирует поле MIME-заголовка
  
  Декодирует поле <return>MIME</return>-заголовка.

<comment>Param:</comment>
  <info>string</info>       <strong>$string</strong>    Закодированный заголовок в виде строки.
  <info>int</info>          <strong>$mode</strong>      <strong>$mode</strong> задаёт режим поведения функции в случае, когда <strong>iconv_mime_decode()</strong>
                          определит, что <return>MIME</return>-заголовок имеет недопустимую структуру. Режим задаётся
                          комбинацией следующих битовых масок. Битовые маски, применяемые в
                          <strong>iconv_mime_decode()</strong>ЗначениеКонстантаОписание1ICONV_MIME_DECODE_STRICT Если
                          задано, заголовок декодируется в полном соответствии со стандартом
                          RFC2047. Эта опция отключена по умолчанию, так как существует множество
                          почтовых программ, которые не следуют спецификации и формируют
                          некорректные с точки зрения стандарта <return>MIME</return>-заголовки.
                          2ICONV_MIME_DECODE_CONTINUE_ON_ERROR Если задано,
                          <strong>iconv_mime_decode_headers()</strong> будет пытаться пропускать грамматические
                          ошибки и продолжать обработку заголовка.
  <info>string|null</info>  <strong>$encoding</strong>  Необязательный аргумент <strong>$encoding</strong> задаёт набор символов, в котором будет
                          представлен результат. Если аргумент опущен, будет использоваться
                          iconv.internal_encoding.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает декодированный <return>MIME</return>-заголовок в случае успешного выполнения или <info>false</info> в
                случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>iconv_mime_decode_headers()</strong>
   * <strong>mb_decode_mimeheader()</strong>
   * <strong>imap_mime_header_decode()</strong>
   * <strong>imap_base64()</strong>
   * <strong>imap_qprint()</strong>


id: iconv_mime_decode_headers
type: function
doc:
<comment>Description:</comment>
  Декодирует несколько полей заголовка MIME
  
  Декодирует несколько полей заголовка <return>MIME</return> за один раз.

<comment>Param:</comment>
  <info>string</info>       <strong>$headers</strong>   Закодированные заголовки в виде строки.
  <info>int</info>          <strong>$mode</strong>      Параметр <strong>$mode</strong> определяет поведение, если <strong>iconv_mime_decode_headers()</strong>
                          обнаружит неправильное поле заголовка <return>MIME</return>. Можно указать любую комбинацию
                          следующих битовых масок. Битовые маски
                          <strong>iconv_mime_decode_headers()</strong>ЗначениеКонстантаОписание1ICONV_MIME_DECODE_STRICT
                          Строго следовать стандартам, определённым в RFC2047. Эта опция по
                          умолчанию отключена, так как много проприетарных программ электронной
                          почты не следуют стандартам и создают некорректные заголовки <return>MIME</return>.
                          2ICONV_MIME_DECODE_CONTINUE_ON_ERROR Если установлена,
                          <strong>iconv_mime_decode_headers()</strong> будет пытаться игнорировать любые ошибки и
                          продолжать обработку текущего заголовка.
  <info>string|null</info>  <strong>$encoding</strong>  Необязательный параметр <strong>$encoding</strong> указывает кодировку, в которой будет
                          представлен результат. Если опущен, будет использовано значение директивы
                          iconv.internal_encoding.

<comment>Return:</comment>
  <info>array|false</info>  В случае успешного выполнения возвращает ассоциативный массив с полями
               <return>MIME</return>-заголовков, указанных параметром <strong>$headers</strong>, или <info>false</info> в случае возникновения
               ошибки.
               
               Каждый ключ элемента возвращаемого массива представляет собой отдельное имя поля, а
               сам элемент - его значение. Если в заголовке существует несколько полей с одинаковым
               именем, <strong>iconv_mime_decode_headers()</strong> автоматически помещает их в подмассив с числовыми
               индексами в порядке их обработки. Обратите внимание, что имена заголовков не
               нечувствительны к регистру.

<comment>See Also:</comment>
   * <strong>iconv_mime_decode()</strong>
   * <strong>mb_decode_mimeheader()</strong>
   * <strong>imap_mime_header_decode()</strong>
   * <strong>imap_base64()</strong>
   * <strong>imap_qprint()</strong>


id: iconv_mime_encode
type: function
doc:
<comment>Description:</comment>
  Создаёт поле MIME-заголовка
  
  Создаёт и возвращает корректное поле <return>MIME</return>-заголовка в виде строки вида:  В примере выше "Subject"
  является именем поля, а часть строки, начиная с "=?ISO-8859-1?..." - его значение.

<comment>Param:</comment>
  <info>string</info>  <strong>$field_name</strong>   Имя поля.
  <info>string</info>  <strong>$field_value</strong>  Значение поля.
  <info>array</info>   <strong>$options</strong>      Есть возможность контролировать поведение функции <strong>iconv_mime_encode()</strong>
                        посредством передачи массива с настройками в качестве третьего аргумента
                        <strong>$options</strong>. Возможные значения этого массива, поддерживаемые функцией
                        <strong>iconv_mime_encode()</strong>, перечислены ниже. Обратите внимание, что имена
                        элементов чувствительны к регистру символов.  Настройки, поддерживаемые в
                        <strong>iconv_mime_encode()</strong> ЭлементТипОписаниеЗначение по
                        умолчаниюПримерscheme<info>string</info> Задаёт, каким образом закодировать значение
                        поля. Значением этого элемента может быть либо "B", либо "Q". "B" означает
                        схему кодирования <return>base64</return>, а "Q" - <return>quoted-printable</return>. BBinput-charset<info>string</info>
                        Задаёт, в какой кодировке представлены аргументы <strong>$field_name</strong> и <strong>$field_value</strong>.
                        Если не задан, <strong>iconv_mime_encode()</strong> предполагает, что набор символов указан в
                        ini-настройке iconv.internal_encoding.
                        iconv.internal_encodingISO-8859-1output-charset<info>string</info> Задаёт набор символов,
                        в котором будет представлен результирующий <return>MIME</return>-заголовок.
                        iconv.internal_encodingUTF-8line-length<info>int</info> Устанавливает максимальную длину
                        строк заголовка. Если результирующий заголовок окажется длиннее этой
                        величины, функция его разрежет на несколько строк в соответствии с Форматом
                        интернет сообщений - RFC2822. Если не задан, эта длина будет установлена 76
                        символов. 76996line-break-chars<info>string</info> Задаёт последовательность символов,
                        которые будут использоваться для завершения "разрезанных" строк заголовка,
                        если заголовок окажется длиннее одной строки. Если не задан, будут
                        использоваться символы "\r\n" (<return>CR</return> <return>LF</return>). Обратите внимание, что этот аргумент
                        всегда обрабатывается как строка ASCII вне зависимости от значения
                        <return>input-charset</return>. \r\n\n

<comment>Return:</comment>
  <info>string|false</info>  Возвращает закодированное <return>MIME</return>-поле в случае успешного выполнения или <info>false</info> в случае
                возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imap_binary()</strong>
   * <strong>mb_encode_mimeheader()</strong>
   * <strong>imap_8bit()</strong>
   * <strong>quoted_printable_encode()</strong>


id: iconv_set_encoding
type: function
doc:
<comment>Description:</comment>
  Устанавливает текущей настройки для преобразования символов кодировки
  
  Изменяет значение указанной параметром <strong>$type</strong> внутренней переменной конфигурации на <strong>$encoding</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$type</strong>      Значение <strong>$type</strong> может быть одним из приведённых ниже:
                     input_encodingoutput_encodinginternal_encoding
  <info>string</info>  <strong>$encoding</strong>  Набор символов.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>iconv_get_encoding()</strong>
   * <strong>ob_iconv_handler()</strong>


id: iconv_strlen
type: function
doc:
<comment>Description:</comment>
  Возвращает количество символов в строке
  
  В отличие от <strong>strlen()</strong>, <strong>iconv_strlen()</strong> учитывает кодировку строки. Длина <strong>$string</strong> не обязательно
  будет соответствовать количеству байт в ней, так как в различных кодировках различные символы
  кодируются различным количеством байт, например, юникод может быть и двух-, и четырёхбайтным.

<comment>Param:</comment>
  <info>string</info>       <strong>$string</strong>    Строка.
  <info>string|null</info>  <strong>$encoding</strong>  Если параметр <strong>$encoding</strong> опущен, предполагается, что кодировка строки
                          <strong>$string</strong> эквивалентна значению iconv.internal_encoding.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает количество символов в <strong>$string</strong> как целое число или <info>false</info> в случае
             возникновения ошибки при кодировании.

<comment>See Also:</comment>
   * <strong>grapheme_strlen()</strong>
   * <strong>mb_strlen()</strong>
   * <strong>strlen()</strong>


id: iconv_strpos
type: function
doc:
<comment>Description:</comment>
  Возвращает позицию первого вхождения подстроки
  
  Возвращает позицию первого вхождения подстроки <strong>$needle</strong> в строке <strong>$haystack</strong>.
  
  В отличие от <strong>strpos()</strong>, <strong>iconv_strpos()</strong> возвращает смещение перед искомой строкой в символах, а не в
  байтах. Количество символов трактуется в зависимости от указанной параметром <strong>$encoding</strong> кодировки.

<comment>Param:</comment>
  <info>string</info>       <strong>$haystack</strong>  Строка, в которой производится поиск.
  <info>string</info>       <strong>$needle</strong>    Искомая подстрока.
  <info>int</info>          <strong>$offset</strong>    Необязательный параметр <strong>$offset</strong> позволяет указать, с какого по счёту
                          символа строки начинать поиск. Если указано отрицательное значение, то
                          смещение будет отсчитываться с конца строки.
  <info>string|null</info>  <strong>$encoding</strong>  Если параметр <strong>$encoding</strong> не указан, то подразумевается, что <strong>$string</strong> имеет
                          кодировку iconv.internal_encoding.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает номер позиции первого вхождения строки <strong>$needle</strong> в <strong>$haystack</strong>.
             
             Если строка <strong>$needle</strong> не найдена, <strong>iconv_strpos()</strong> возвращает <info>false</info>.
             
             Эта функция может возвращать как логическое значение <info>false</info>, так и значение не типа
             boolean, которое приводится к <info>false</info>. За более подробной информацией обратитесь к
             разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой
             функцией.

<comment>See Also:</comment>
   * <strong>strpos()</strong>
   * <strong>iconv_strrpos()</strong>
   * <strong>mb_strpos()</strong>


id: iconv_strrpos
type: function
doc:
<comment>Description:</comment>
  Возвращает позицию последнего вхождения подстроки
  
  Находит последнюю позицию подстроки <strong>$needle</strong> в строке <strong>$haystack</strong>.
  
  В отличие от <strong>strrpos()</strong>, <strong>iconv_strrpos()</strong> возвращает смещение перед искомой строкой в символах, а не
  в байтах. Количество символов трактуется в зависимости от указанной параметром <strong>$encoding</strong>
  кодировки.

<comment>Param:</comment>
  <info>string</info>       <strong>$haystack</strong>  Строка, в которой производится поиск.
  <info>string</info>       <strong>$needle</strong>    Искомая подстрока.
  <info>string|null</info>  <strong>$encoding</strong>  Если параметр <strong>$encoding</strong> не указан, то подразумевается, что <strong>$string</strong> имеет
                          кодировку iconv.internal_encoding.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает номер позиции последнего вхождения строки <strong>$needle</strong> в <strong>$haystack</strong>.
             
             Если строка <strong>$needle</strong> не найдена, <strong>iconv_strrpos()</strong> возвращает <info>false</info>.
             
             Эта функция может возвращать как логическое значение <info>false</info>, так и значение не типа
             boolean, которое приводится к <info>false</info>. За более подробной информацией обратитесь к
             разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой
             функцией.

<comment>See Also:</comment>
   * <strong>strrpos()</strong>
   * <strong>iconv_strpos()</strong>
   * <strong>mb_strrpos()</strong>


id: iconv_substr
type: function
doc:
<comment>Description:</comment>
  Получение части строки
  
  Получает часть строки <strong>$string</strong>, определённую параметрами <strong>$offset</strong> и <strong>$length</strong>.

<comment>Param:</comment>
  <info>string</info>       <strong>$string</strong>    Изначальная строка.
  <info>int</info>          <strong>$offset</strong>    Если <strong>$offset</strong> неотрицателен, <strong>iconv_substr()</strong> получает часть строки <strong>$string</strong>
                          начиная с символа с порядковым номером <strong>$offset</strong> (нумерация начинается с
                          нуля).
                          
                          Если <strong>$offset</strong> отрицателен, <strong>iconv_substr()</strong> получает часть строки начиная с
                          позиции, отстоящую от конца строки <strong>$string</strong> на <strong>$offset</strong> символов.
  <info>int|null</info>     <strong>$length</strong>    Если <strong>$length</strong> задан и положителен, возвращаемое значение содержит не более
                          <strong>$length</strong> символов, начиная с <strong>$offset</strong> (зависит от длины строки <strong>$string</strong>).
                          
                          Если указан отрицательный <strong>$length</strong>, <strong>iconv_substr()</strong> получает часть строки
                          <strong>$string</strong>, начиная с <strong>$offset</strong> символа и до символа, отстоящего от конца
                          строки на <strong>$length</strong> символов. В случае, если <strong>$offset</strong> также отрицателен,
                          стартовая позиция вычисляется заранее в соответствии с вышеописанным
                          правилом.
  <info>string|null</info>  <strong>$encoding</strong>  Если параметр <strong>$encoding</strong> не указан, предполагается, что строка <strong>$string</strong>
                          имеет кодировку iconv.internal_encoding.
                          
                          Обратите внимание, что и <strong>$offset</strong>, и <strong>$length</strong> основываются на размере
                          символа, рассчитанного исходя из кодировки текста (<strong>$encoding</strong>), в то время
                          как схожая функция <strong>substr()</strong> всегда рассматривает их побайтовое смещение.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает часть строки <strong>$string</strong>, определённую параметрами <strong>$offset</strong> и <strong>$length</strong>.
                
                Если строка <strong>$string</strong> имеет меньшую длину, чем параметр <strong>$offset</strong>, будет возвращено
                <info>false</info>. Если <strong>$string</strong> имеет длину равную <strong>$offset</strong>, будет возвращена пустая строка.

<comment>See Also:</comment>
   * <strong>substr()</strong>
   * <strong>mb_substr()</strong>
   * <strong>mb_strcut()</strong>


id: idate
type: function
doc:
<comment>Description:</comment>
  Преобразует локальное время/дату в целое число
  
  Преобразует текущую дату и время в целое число в соответствии со строкой форматирования <strong>$format</strong>.
  Если аргумент <strong>$timestamp</strong> задан, расчёт будет произведён для этой временной метки, если нет - будет
  использовано локальное время. Другими словами, <strong>$timestamp</strong> - необязательный аргумент и по умолчанию
  равен значению <strong>time()</strong>.
  
  В отличие от функции <strong>date()</strong>, <strong>idate()</strong> принимает только один символ в аргументе <strong>$format</strong>.

<comment>Param:</comment>
  <info>string</info>    <strong>$format</strong>      Допустимые символы в строке аргумента <strong>$format</strong>символ в
                        <strong>$format</strong>Описание<return>B</return>Эталонное время/Время Интернета<return>d</return>День месяца<return>h</return>Час (12 часовой
                        формат)<return>H</return>Час (24 часовой формат)<return>i</return>Минуты<return>I</return> (i в верхнем регистре)возвращает <return>1</return>,
                        если активировано DST, или <return>0</return> в противном случае<return>L</return> (l в верхнем
                        регистре)возвращает <return>1</return> для високосного года, <return>0</return> в противном случае<return>m</return>Номер
                        месяца<return>N</return> День недели в ISO-8601 (с <return>1</return> для понедельника по <return>7</return> для воскресенья)
                        <return>o</return>Год в ISO-8601 (4 цифры)<return>s</return>Секунды<return>t</return>Количество дней в текущем месяце<return>U</return>Время в
                        секундах, от начала эпохи UNIX - 1 января 1970 00:00:00 UTC - то же, что
                        <strong>time()</strong><return>w</return>День недели (<return>0</return> - Воскресенье)<return>W</return>ISO-8601 - Номер недели года, неделя
                        начинается с понедельника<return>y</return>Год (1 или 2 цифры - смотрите примечание ниже)<return>Y</return>Год
                        (4 цифры)<return>z</return>День года<return>Z</return>Часовой пояс — смещение в секундах
  <info>int|null</info>  <strong>$timestamp</strong>  Необязательный параметр <strong>$timestamp</strong> представляет собой метку времени типа
                        <info>int</info>, по умолчанию равную текущему локальному времени, если <strong>$timestamp</strong> не
                        указан или <info>null</info>. Другими словами, значение по умолчанию равно результату
                        функции <strong>time()</strong>.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает целое число (<info>int</info>) в случае успешного выполнения или <info>false</info> в случае
             возникновения ошибки.
             
             <strong>idate()</strong> всегда возвращает тип <info>int</info> и не может начинаться с нуля, поэтому <strong>idate()</strong> может
             вернуть меньше цифр, чем вы ожидаете. Смотрите примеры ниже.

<comment>See Also:</comment>
   * DateTimeInterface::format
   * <strong>date()</strong>
   * <strong>getdate()</strong>
   * <strong>time()</strong>


id: idn_to_ascii
type: function
doc:
<comment>Description:</comment>
  Преобразовать доменное имя в формат IDNA ASCII
  
  Процедурный стиль
  
  Эта функция преобразует доменное имя из Unicode в IDNA ASCII.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain</strong>     Имя для преобразования, должно быть в кодировке UTF-8.
  <info>int</info>     <strong>$flags</strong>      Опции преобразования - комбинация констант IDNA_* (кроме констант
                      IDNA_ERROR_*).
  <info>int</info>     <strong>$variant</strong>    <info>INTL_IDNA_VARIANT_2003</info> (объявлена устаревшей начиная с PHP 7.2.0) для IDNA
                      2003 или <info>INTL_IDNA_VARIANT_UTS46</info> (доступна только с ICU 4.6) для UTS #46.
  <info>array</info>   <strong>$idna_info</strong>  Этот параметр используется только если используется <info>INTL_IDNA_VARIANT_UTS46</info> в
                      <strong>$variant</strong>. В этом случае он будет заполнен массивом с ключами <return>'result'</return>,
                      возможными ошибочными результатами преобразования, <return>'isTransitionalDifferent'</return>,
                      логическое выражение означает изменило или могло бы изменить результат при
                      использовании сквозного механизма UTS #46, и <return>'errors'</return>, содержащими
                      целочисленное представление битовой маски из констант IDNA_ERROR_*.

<comment>Return:</comment>
  <info>string|false</info>  Доменное имя в представлении ASCII или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>idn_to_utf8()</strong>


id: idn_to_utf8
type: function
doc:
<comment>Description:</comment>
  Преобразование доменного имени из IDNA ASCII в Unicode
  
  Процедурный стиль
  
  Эта функция преобразует доменные имена из формата IDNA ASCII в Unicode, в кодировке UTF-8.

<comment>Param:</comment>
  <info>string</info>  <strong>$domain</strong>     Доменное имя в формате IDNA ASCII.
  <info>int</info>     <strong>$flags</strong>      Опции преобразования - комбинация констант IDNA_* (кроме констант
                      IDNA_ERROR_*).
  <info>int</info>     <strong>$variant</strong>    <info>INTL_IDNA_VARIANT_2003</info> (объявлена устаревшей начиная с PHP 7.2.0) для IDNA
                      2003 или <info>INTL_IDNA_VARIANT_UTS46</info> (доступна только с ICU 4.6) для UTS #46.
  <info>array</info>   <strong>$idna_info</strong>  Этот параметр используется только если используется <info>INTL_IDNA_VARIANT_UTS46</info> в
                      <strong>$variant</strong>. В этом случае он будет заполнен массивом с ключами <return>'result'</return>,
                      возможными ошибочными результатами преобразования, <return>'isTransitionalDifferent'</return>,
                      логическое выражение означает изменило или могло бы изменить результат при
                      использовании сквозного механизма UTS #46, и <return>'errors'</return>, содержащими
                      целочисленное представление битовой маски из констант IDNA_ERROR_*.

<comment>Return:</comment>
  <info>string|false</info>  Доменное имя в Unicode, в кодировке UTF-8 или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>idn_to_ascii()</strong>


id: igbinary_serialize
type: function
doc:
<comment>Description:</comment>
  Создаёт компактное, сохраняемое двоичное представление значения
  
  Создаёт сохраняемое представление значения.
  
  Полезно для хранения или передачи значений PHP без потери их типа и структуры.
  
  Чтобы снова превратить сериализованную строку в значение PHP, можно использовать
  <strong>igbinary_unserialize()</strong>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  Значение, которое необходимо сериализовать. <strong>igbinary_serialize()</strong> обрабатывает все
                 типы, кроме ресурсов (<info>resource</info>) и некоторых объектов (<info>object</info>) (смотрите примечание
                 ниже). Даже массивы (<info>array</info>), содержащие ссылки на себя, могут быть сериализованы
                 функцией <strong>igbinary_serialize()</strong>. Циклические ссылки внутри сериализующихся массивов
                 (<info>array</info>) или объектов (<info>object</info>) также будут сохранены. Любая другая ссылка будет
                 потеряна.
                 
                 При сериализации объектов, igbinary будет пытаться вызвать функции __serialize()
                 или __sleep() перед сериализацией. Это позволит объекту выполнить любую очистку в
                 последнюю минуту и т.д. перед сериализацией. Аналогичным образом, когда объект
                 восстанавливается с помощью <strong>igbinary_unserialize()</strong>, вызывается функция
                 __unserialize() или __wakeup().
                 
                 Начало имён закрытых членов объекта (<info>object</info>) дополняются именем класса, а начало
                 имён защищённых членов символом <return>'*'</return>. Эти дополненные значения окружаются нулевым
                 байтом с обеих сторон.

<comment>Return:</comment>
  <info>string|false</info>  Возвращает строку, содержащую представление потока байтов <strong>$value</strong>, которое может быть
                сохранено где угодно.
                
                Обратите внимание, что это двоичная строка, которая может включать в себя любое
                байтовое значение и должна храниться и обрабатываться как таковая. Например, вывод
                функции <strong>igbinary_serialize()</strong> обычно должен храниться в поле базы данных <return>BLOB</return>, а не в
                поле <return>CHAR</return> или <return>TEXT</return>.

<comment>See Also:</comment>
   * <strong>serialize()</strong>
   * <strong>igbinary_unserialize()</strong>
   * <strong>var_export()</strong>
   * <strong>json_encode()</strong>
   * Сериализация объектов
   * __sleep()
   * __wakeup()
   * __serialize()
   * __unserialize()


id: igbinary_unserialize
type: function
doc:
<comment>Description:</comment>
  Создаёт значение PHP из сохранённого представления функцией igbinary_serialize
  
  <strong>igbinary_unserialize()</strong> берёт одну сериализованную переменную из <strong>igbinary_serialize()</strong> и преобразует
  её обратно в значение PHP.
  
  Ненадёжные пользовательские входные данные не должны передаваться в <strong>igbinary_unserialize()</strong>.
  Десериализация может привести к загрузке и выполнению кода из-за создания экземпляра объекта и
  автозагрузки, тогда злоумышленник может этим воспользоваться. Вместо этого следует использовать
  безопасный стандартный формат обмена данными, такой как JSON (с помощью функций <strong>json_decode()</strong> и
  <strong>json_encode()</strong>), если сериализованные данные необходимо передать клиенту.
  
  Если есть необходимость десериализовать сохранённые извне сериализованные данные, для проверки
  данных можно использовать функцию <strong>hash_hmac()</strong>. Важно убедиться, что данные никто не подделал.
  
  Формат сериализации igbinary не позволяет различать разные ссылочные группы для одного и того же
  значения. Все ссылки PHP на заданное значение при десериализации обрабатываются как часть одной и
  той же группы ссылок, даже если при сериализации они были частями разных групп ссылок.

<comment>Param:</comment>
  <info>string</info>  <strong>$str</strong>  Сериализованная функцией <strong>igbinary_serialize()</strong> строка.
                
                Если десериализуемое значение является объектом (<info>object</info>), после успешного
                восстановления объекта, igbinary автоматически попытается вызвать метод
                __unserialize() или __wakeup() (если таковой существует).
                
                unserialize_callback_func directive Можно установить callback-функцию, которая будет
                вызываться, если во время десериализации должен быть создан экземпляр
                неопределённого класса (чтобы предотвратить получение неполного объекта (<info>object</info>)
                <return>__PHP_Incomplete_Class</return>). Для определения unserialize_callback_func могут
                использоваться файлы php.ini, <strong>ini_set()</strong> или .htaccess. Каждый раз, когда необходимо
                создать экземпляр неопределённого класса, callback-функция будет вызываться. Чтобы
                отключить эту функцию, параметр следует очистить.
                
                Можно установить callback-функцию, которая будет вызываться, если во время
                десериализации должен быть создан экземпляр неопределённого класса (чтобы
                предотвратить получение неполного объекта (<info>object</info>) <return>__PHP_Incomplete_Class</return>). Для
                определения unserialize_callback_func могут использоваться файлы php.ini, <strong>ini_set()</strong>
                или .htaccess. Каждый раз, когда необходимо создать экземпляр неопределённого
                класса, callback-функция будет вызываться. Чтобы отключить эту функцию, параметр
                следует очистить.

<comment>Return:</comment>
  <info>mixed</info>  Возвращается преобразованное значение, которое может быть <info>bool</info>, <info>int</info>, <info>float</info>, <info>string</info>, <info>array</info>,
         <info>object</info> или <info>null</info>.
         
         Если переданная строка не может быть десериализована, возвращается <info>false</info> и выдаётся ошибка
         уровня <info>E_NOTICE</info> или <info>E_WARNING</info>.

<comment>See Also:</comment>
   * <strong>unserialize()</strong>
   * <strong>json_encode()</strong>
   * <strong>json_decode()</strong>
   * <strong>hash_hmac()</strong>
   * <strong>igbinary_serialize()</strong>
   * Автоматическая загрузка классов
   * unserialize_callback_func
   * __wakeup()
   * __serialize()
   * __unserialize()


id: ignore_user_abort
type: function
doc:
<comment>Description:</comment>
  Установить, должно ли отключение клиента прерывать выполнение скрипта
  
  Устанавливает, необходимо ли прерывать работу скрипта при отключении клиента.
  
  При работе с PHP-скриптом в командной строке, когда терминал скрипта отключается без прерывания
  работы скрипта, скрипт будет остановлен, если параметр <strong>$enable</strong> не равен <info>true</info>

<comment>Param:</comment>
  <info>bool|null</info>  <strong>$enable</strong>  Если параметр задан и не <info>null</info>, то эта функция устанавливает ini-настройку
                      ignore_user_abort, заданным значением параметра <strong>$enable</strong>. Если же параметр не
                      задан, функция вернёт предыдущее значение опции без его изменения.

<comment>Return:</comment>
  <info>int</info>  Возвращает предыдущее значение в виде целого числа.

<comment>See Also:</comment>
   * <strong>connection_aborted()</strong>
   * <strong>connection_status()</strong>
   * 
     Смотрите Управление Соединением
     для получения более детальной информации по управлению соединениями в PHP.
    


id: image2wbmp
type: function
doc:
<comment>Description:</comment>
  Выводит изображение в браузер или пишет в файл
  
  <strong>image2wbmp()</strong> выводит либо сохраняет WBMP версию заданного изображения <strong>$image</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$image</strong>       Ресурс изображения, возвращаемый одной из функций создания изображения,
                         например <strong>imagecreatetruecolor()</strong>.
  <info>string</info>    <strong>$filename</strong>    Путь для сохранения файла. Если не задан, исходные данные изображения будут
                         выведены напрямую в выходной поток.
  <info>int</info>       <strong>$foreground</strong>  Вы можете установить цвет переднего плана с помощью этого параметра,
                         установив идентификатор, полученный с помощью <strong>imagecolorallocate()</strong>. Цвет
                         переднего плана по умолчанию чёрный.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagewbmp()</strong>


id: image_type_to_extension
type: function
doc:
<comment>Description:</comment>
  Получение расширения файла для типа изображения
  
  Возвращает расширение файла для заданной <return>IMAGETYPE_XXX</return> константы.

<comment>Param:</comment>
  <info>int</info>   <strong>$image_type</strong>   Одна из констант <return>IMAGETYPE_XXX</return>.
  <info>bool</info>  <strong>$include_dot</strong>  Добавлять точку к расширению или нет. По умолчанию <info>true</info>.

<comment>Return:</comment>
  <info>string|false</info>  Строка с расширением файла, соответствующим типу изображения или <info>false</info> в случае
                возникновения ошибки.


id: image_type_to_mime_type
type: function
doc:
<comment>Description:</comment>
  Получение Mime-типа для типа изображения, возвращаемого
     функциями getimagesize, exif_read_data, exif_thumbnail, exif_imagetype
    
  
  Функция <strong>image_type_to_mime_type()</strong> определяет Mime-тип для константы IMAGETYPE.

<comment>Param:</comment>
  <info>int</info>  <strong>$image_type</strong>  Одна из констант <return>IMAGETYPE_XXX</return>.

<comment>Return:</comment>
  <info>string</info>  Возвращаемые значения приведены ниже Возвращаемые значения и
          Константы<strong>$image_type</strong>Возвращаемое
          значение<info>IMAGETYPE_GIF</info><return>image/gif</return><info>IMAGETYPE_JPEG</info><return>image/jpeg</return><info>IMAGETYPE_PNG</info><return>image/png</return><info>IMAGETYPE_SWF</info><return>application/x-shockwave-flash</return><info>IMAGETYPE_PSD</info><return>image/psd</return><info>IMAGETYPE_BMP</info><return>image/bmp</return><info>IMAGETYPE_TIFF_II</info>
          (порядок байт intel)<return>image/tiff</return><info>IMAGETYPE_TIFF_MM</info> (порядок байт motorola)
          <return>image/tiff</return><info>IMAGETYPE_JPC</info><return>application/octet-stream</return><info>IMAGETYPE_JP2</info><return>image/jp2</return><info>IMAGETYPE_JPX</info><return>application/octet-stream</return><info>IMAGETYPE_JB2</info><return>application/octet-stream</return><info>IMAGETYPE_SWC</info><return>application/x-shockwave-flash</return><info>IMAGETYPE_IFF</info><return>image/iff</return><info>IMAGETYPE_WBMP</info><return>image/vnd.wap.wbmp</return><info>IMAGETYPE_XBM</info><return>image/xbm</return><info>IMAGETYPE_ICO</info><return>image/vnd.microsoft.icon</return><info>IMAGETYPE_WEBP</info><return>image/webp</return><info>IMAGETYPE_AVIF</info><return>image/avif</return>

<comment>See Also:</comment>
   * <strong>getimagesize()</strong>
   * <strong>exif_imagetype()</strong>
   * <strong>exif_read_data()</strong>
   * <strong>exif_thumbnail()</strong>


id: imageaffine
type: function
doc:
<comment>Description:</comment>
  Вернуть изображение, содержащее аффинно-преобразованное изображение src, используя дополнительную
  область ограничения
  
  К настоящему времени эта функция ещё не была документирована; для ознакомления доступен только
  список аргументов.

<comment>Param:</comment>
  <info>GdImage</info>     <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                       например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>array</info>       <strong>$affine</strong>  Массив с ключами от 0 до 5.
  <info>array|null</info>  <strong>$clip</strong>    Массив с ключами "x", "y", "width" и "height"; или <info>null</info>.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект с аффинным изображением в случае успешного выполнения или <info>false</info> в
                 случае возникновения ошибки.


id: imageaffinematrixconcat
type: function
doc:
<comment>Description:</comment>
  Конкатенирует две аффинные матрицы преобразования
  
  Возвращает конкатенацию двух аффинных матриц преобразования, что полезно, если несколько
  преобразований должны быть применены к одному и тому же изображению за один раз.

<comment>Param:</comment>
  <info>array</info>  <strong>$matrix1</strong>  Аффинная матрица преобразования (массив с ключами от <return>0</return> до <return>5</return> и значениями с
                   плавающей точкой).
  <info>array</info>  <strong>$matrix2</strong>  Аффинная матрица преобразования (массив с ключами от <return>0</return> до <return>5</return> и значениями с
                   плавающей точкой).

<comment>Return:</comment>
  <info>array|false</info>  Аффинная матрица преобразования (массив с ключами от <return>0</return> до <return>5</return> и значениями с плавающей
               точкой) или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imageaffine()</strong>
   * <strong>imageaffinematrixget()</strong>


id: imageaffinematrixget
type: function
doc:
<comment>Description:</comment>
  Получает матрицу аффинного преобразования
  
  Возвращает матрицу аффинного преобразования.

<comment>Param:</comment>
  <info>int</info>          <strong>$type</strong>     Одна из констант <info>IMG_AFFINE_*</info>.
  <info>array|float</info>  <strong>$options</strong>  Если <strong>$type</strong> равен <info>IMG_AFFINE_TRANSLATE</info> или <info>IMG_AFFINE_SCALE</info>, <strong>$options</strong> должен
                         быть массивом (<info>array</info>) с ключами <return>x</return> и <return>y</return>, оба имеют значения типа <info>float</info>.
                         
                         Если <strong>$type</strong> равен <info>IMG_AFFINE_ROTATE</info>, <info>IMG_AFFINE_SHEAR_HORIZONTAL</info> или
                         <info>IMG_AFFINE_SHEAR_VERTICAL</info>, <strong>$options</strong> должен быть числом с плавающей точкой
                         (<info>float</info>), определяющим угол.

<comment>Return:</comment>
  <info>array|false</info>  Матрица аффинного преобразования (массив с ключами от <return>0</return> до <return>5</return> и значениями с плавающей
               точкой) или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imageaffine()</strong>
   * <strong>imageaffinematrixconcat()</strong>


id: imagealphablending
type: function
doc:
<comment>Description:</comment>
  Задание режима сопряжения цветов для изображения
    
  
  <strong>imagealphablending()</strong> позволяет использовать режим сопряжения цветов для truecolor-изображений при
  рисовании. В режиме сопряжения альфа компонент цвета, который передаётся всем функциям рисования,
  вроде <strong>imagesetpixel()</strong>, определяет то, насколько сильно цвет нижележащего слоя будет просачиваться
  через накладываемое изображение. В результате, gd автоматически сопрягает существующий цвет в
  каждой точке с цветом рисуемого поверх изображения и сохраняет результат сопряжения в изображении.
  Пикселы, подвергшиеся сопряжению, не обладают свойством прозрачности. В режиме без сопряжения цвет
  рисуемого поверх изображения пиксела буквально копируется вместе со своим альфа компонентом,
  заменяя пиксел в исходном изображении. Режим сопряжения недоступен при рисовании на палитровых
  изображениях.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>     <strong>$enable</strong>  Включить режим сопряжения или нет. Включён (<info>true</info>) по умолчанию для
                    truecolor-изображений, для всех остальных по умолчанию выключен (<info>false</info>).

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imageantialias
type: function
doc:
<comment>Description:</comment>
  Требуется ли применять функции сглаживания или нет
  
  Задействует механизмы сглаживания при рисовании линий и замкнутых многоугольников. Не поддерживает
  альфа компоненты. Использует операции прямого смешивания цветов. Работает только с
  truecolor-изображениями.
  
  Стили и толщина не поддерживаются.
  
  Использование сглаженных примитивов совместно с прозрачным фоном может дать неожиданный результат.
  Метод смешивания использует цвет фона наравне с любым другим цветом. Отсутствие поддержки альфа
  компонента не позволяет применять основанный на нем метод сглаживания.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>     <strong>$enable</strong>  Включить сглаживание или нет.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>


id: imagearc
type: function
doc:
<comment>Description:</comment>
  Рисование дуги
  
  <strong>imagearc()</strong> рисует дугу окружности с заданными координатами центра.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>        Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                         например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>     x-координата центра.
  <info>int</info>      <strong>$center_y</strong>     y-координата центра.
  <info>int</info>      <strong>$width</strong>        Ширина дуги.
  <info>int</info>      <strong>$height</strong>       Высота дуги.
  <info>int</info>      <strong>$start_angle</strong>  Угол начала дуги в градусах.
  <info>int</info>      <strong>$end_angle</strong>    Угол окончания дуги в градусах. 0° соответствует положению 3 часа, дуга
                         рисуется по часовой стрелке.
  <info>int</info>      <strong>$color</strong>        Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagefilledarc()</strong>
   * <strong>imageellipse()</strong>
   * <strong>imagefilledellipse()</strong>


id: imageavif
type: function
doc:
<comment>Description:</comment>
  Выводит изображение в браузер или пишет в файл
  
  Выводит или сохраняет растровое изображение AVIF из указанного параметра <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>    Объект <class>GdImage</class>, возвращаемый одной из функций создания
                                  изображений,
                                  например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>     Путь, или открытый потоковый ресурс (который автоматически
                                  закрывается после завершения функции), для сохранения файла. Если
                                  не установлен или равен <info>null</info>, изображение будет выведено в поток
                                  вывода в бинарном виде.
  <info>int</info>                   <strong>$quality</strong>  Необязательный параметр <strong>$quality</strong> варьируется от 0 (худшее
                                  качество, файл меньшего размера) до 100 (лучшее качество, файл
                                  большего размера). Если указывается <return>-1</return>, используется значение по
                                  умолчанию <return>30</return>.
  <info>int</info>                   <strong>$speed</strong>    Необязательный параметр <strong>$speed</strong> варьируется от 0 (медленнее, файл
                                  меньшего размера) до 10 (быстрее, файл большего размера). Если
                                  указывается <return>-1</return>, используется значение по умолчанию <return>6</return>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>


id: imagebmp
type: function
doc:
<comment>Description:</comment>
  Вывести BMP-изображение в браузер или файл
  
  Выводит или сохраняет BMP-версию заданного изображения (<strong>$image</strong>).

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>       Объект <class>GdImage</class>, возвращаемый одной из функций создания
                                     изображений,
                                     например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>        Путь, или открытый потоковый ресурс (который автоматически
                                     закрывается после завершения функции), для сохранения файла.
                                     Если не установлен или равен <info>null</info>, изображение будет выведено в
                                     поток вывода в бинарном виде.
                                     
                                     <info>null</info> недействителен, если аргумент <strong>$compressed</strong> не используется.
  <info>bool</info>                  <strong>$compressed</strong>  Должен ли BMP быть сжат с кодировкой длин серий (RLE), или нет.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.


id: imagechar
type: function
doc:
<comment>Description:</comment>
  Рисование символа по горизонтали
    
  
  <strong>imagechar()</strong> рисует первый символ аргумента <strong>$char</strong> на изображении с идентификатором <strong>$image</strong> на
  координатах <strong>$x</strong>,<strong>$y</strong> (координаты отсчитываются с левого верхнего угла) цветом <strong>$color</strong>.

<comment>Param:</comment>
  <info>GdImage</info>     <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                      например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>GdFont|int</info>  <strong>$font</strong>   Может принимать значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
                      latin2 (более высокое число соответствует большему шрифту) или экземпляр
                      <class>GdFont</class>,
                      возвращаемый функцией <strong>imageloadfont()</strong>..
  <info>int</info>         <strong>$x</strong>      x-координата начала рисования.
  <info>int</info>         <strong>$y</strong>      y-координата начала рисования.
  <info>string</info>      <strong>$char</strong>   Символ для рисования.
  <info>int</info>         <strong>$color</strong>  Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecharup()</strong>
   * <strong>imageloadfont()</strong>


id: imagecharup
type: function
doc:
<comment>Description:</comment>
  Рисование символа вертикально
    
  
  Рисует символ <strong>$char</strong> вертикально на заданных координатах изображения <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>     <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                      например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>GdFont|int</info>  <strong>$font</strong>   Может принимать значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
                      latin2 (более высокое число соответствует большему шрифту) или экземпляр
                      <class>GdFont</class>,
                      возвращаемый функцией <strong>imageloadfont()</strong>..
  <info>int</info>         <strong>$x</strong>      x-координата начала рисования.
  <info>int</info>         <strong>$y</strong>      y-координата начала рисования.
  <info>string</info>      <strong>$char</strong>   Символ для рисования.
  <info>int</info>         <strong>$color</strong>  Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagechar()</strong>
   * <strong>imageloadfont()</strong>


id: imagecolorallocate
type: function
doc:
<comment>Description:</comment>
  Создание цвета для изображения
    
  
  Возвращает идентификатор цвета в соответствии с заданными RGB компонентами.
  
  <strong>imagecolorallocate()</strong> должна вызываться для создания каждого цвета, который будет использоваться в
  изображении <strong>$image</strong>.
  
  Первый вызов <strong>imagecolorallocate()</strong> задаёт цвет фона в палитровых изображениях - изображениях,
  созданных функцией <strong>imagecreate()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.

<comment>Return:</comment>
  <info>int|false</info>  Идентификатор цвета, либо <info>false</info> в случае возникновения ошибки.
             
             Эта функция может возвращать как логическое значение <info>false</info>, так и значение не типа
             boolean, которое приводится к <info>false</info>. За более подробной информацией обратитесь к
             разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой
             функцией.

<comment>See Also:</comment>
   * <strong>imagecolorallocatealpha()</strong>
   * <strong>imagecolordeallocate()</strong>


id: imagecolorallocatealpha
type: function
doc:
<comment>Description:</comment>
  Создание цвета для изображения
  
  <strong>imagecolorallocatealpha()</strong> работает аналогично функции <strong>imagecolorallocate()</strong>, но ещё добавляет к
  цвету параметр <strong>$alpha</strong>, отвечающий за прозрачность.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.
  <info>int</info>      <strong>$alpha</strong>  Значение в диапазоне от <return>0</return> до <return>127</return>. <return>0</return> означает непрозрачный цвет, <return>127</return> означает
                   полную прозрачность.

<comment>Return:</comment>
  <info>int|false</info>  Идентификатор цвета или <info>false</info> в случае возникновении ошибки при создании цвета.
             
             Эта функция может возвращать как логическое значение <info>false</info>, так и значение не типа
             boolean, которое приводится к <info>false</info>. За более подробной информацией обратитесь к
             разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой
             функцией.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolordeallocate()</strong>


id: imagecolorat
type: function
doc:
<comment>Description:</comment>
  Получение индекса цвета пиксела
  
  Возвращает индекс цвета пиксела на заданных координатах на изображении <strong>$image</strong>.
  
  Если передаётся truecolor-изображение, функция возвращает целочисленное RGB значение для пиксела.
  Для выделения отдельных компонентов красного, зелёного или синего каналов используйте битовый
  сдвиг и маскирование:

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x</strong>      x-координата пиксела.
  <info>int</info>      <strong>$y</strong>      y-координата пиксела.

<comment>Return:</comment>
  <info>int|false</info>  Возвращает индекс цвета или <info>false</info> в случае возникновения ошибки.
             
             Эта функция может возвращать как логическое значение <info>false</info>, так и значение не типа
             boolean, которое приводится к <info>false</info>. За более подробной информацией обратитесь к
             разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой
             функцией.

<comment>See Also:</comment>
   * <strong>imagecolorset()</strong>
   * <strong>imagecolorsforindex()</strong>
   * <strong>imagesetpixel()</strong>


id: imagecolorclosest
type: function
doc:
<comment>Description:</comment>
  Получение индекса цвета ближайшего к заданному
    
  
  Возвращает индекс цвета в палитре изображения, "ближайшего" к заданному RGB значению.
  
  "Расстояние" между цветами в палитре рассчитывается геометрически, как если бы RGB значения были
  представлены в виде точек в трёхмерном пространстве.
  
  Если изображение было создано из файла, то будут распознаны только цвета, используемые в
  изображении. Цвета, которые используются только в палитре, распознаны не будут.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс цвета в палитре изображения, ближайшего к заданному.

<comment>See Also:</comment>
   * <strong>imagecolorexact()</strong>
   * <strong>imagecolorclosestalpha()</strong>
   * <strong>imagecolorclosesthwb()</strong>


id: imagecolorclosestalpha
type: function
doc:
<comment>Description:</comment>
  Получение индекса цвета ближайшего к заданному с учётом прозрачности
    
  
  Возвращает индекс цвета в палитре изображения, "ближайшего" к заданному RGB значению, а также
  <strong>$alpha</strong> уровню.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.
  <info>int</info>      <strong>$alpha</strong>  Значение в диапазоне от <return>0</return> до <return>127</return>. <return>0</return> означает непрозрачность, <return>127</return> означает
                   абсолютную прозрачность.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс цвета в палитре изображения, ближайшего к заданному.

<comment>See Also:</comment>
   * <strong>imagecolorexactalpha()</strong>
   * <strong>imagecolorclosest()</strong>
   * <strong>imagecolorclosesthwb()</strong>


id: imagecolorclosesthwb
type: function
doc:
<comment>Description:</comment>
  Получение индекса цвета, имеющего заданный тон, белизну и затемнение
    
  
  Получение индекса цвета, имеющего значения тона, белизны и затемнения наиболее близкие к заданному
  цвету.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.

<comment>Return:</comment>
  <info>int</info>  Возвращает целочисленный индекс цвета, имеющего значения тона, белизны и затемнения наиболее
       близкие к заданному цвету.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolordeallocate
type: function
doc:
<comment>Description:</comment>
  Разрыв ассоциации переменной с цветом для заданного изображения
  
  Разрывает ассоциацию переменной с цветом, которая ранее была создана функциями
  <strong>imagecolorallocate()</strong> или <strong>imagecolorallocatealpha()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$color</strong>  Идентификатор цвета.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolorallocatealpha()</strong>


id: imagecolorexact
type: function
doc:
<comment>Description:</comment>
  Получение индекса заданного цвета
    
  
  Возвращает индекс для заданного цвета в палитре изображения.
  
  Если изображение было создано из файла, то будут распознаны только цвета, используемые в
  изображении. Цвета, которые используются только в палитре, распознаны не будут.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс для заданного цвета в палитре изображения либо -1, если такого цвета в
       палитре нет.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolorexactalpha
type: function
doc:
<comment>Description:</comment>
  Получение индекса заданного цвета и альфа компонента
  
  Возвращает индекс для заданного цвета и альфа компонента в палитре изображения.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.
  <info>int</info>      <strong>$alpha</strong>  Значение в диапазоне от <return>0</return> до <return>127</return>. <return>0</return> означает непрозрачность, <return>127</return> означает
                   абсолютную прозрачность.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс для заданного цвета и альфа компонента в палитре изображения либо -1, если
       такого цвета в палитре нет.

<comment>See Also:</comment>
   * <strong>imagecolorclosestalpha()</strong>


id: imagecolormatch
type: function
doc:
<comment>Description:</comment>
  Делает цвета палитровой версии изображения более соответствующими
     truecolor версии
    
  
  Делает цвета палитровой версии изображения более соответствующими truecolor версии.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image1</strong>  Объект truecolor-изображения.
  <info>GdImage</info>  <strong>$image2</strong>  Объект палитрового изображения, имеющего тот же размер, что и <strong>$image1</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>


id: imagecolorresolve
type: function
doc:
<comment>Description:</comment>
  Получает идентификатор конкретного цвета или его ближайший аналог
  
  Эта функция обязательно вернёт идентификатор цвета для выбранного цвета, либо ближайшую возможную
  его альтернативу.
  
  Если изображение было создано из файла, то будут распознаны только цвета, используемые в
  изображении. Цвета, которые используются только в палитре, распознаны не будут.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.

<comment>Return:</comment>
  <info>int</info>  Возвращает цветовой идентификатор.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolorresolvealpha
type: function
doc:
<comment>Description:</comment>
  Получает идентификатор конкретного цвета и альфа компонента
    или его ближайший аналог
    
  
  Эта функция обязательно вернёт идентификатор цвета для выбранного цвета, либо ближайшую возможную
  его альтернативу.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.
  <info>int</info>      <strong>$alpha</strong>  Значение в диапазоне от <return>0</return> до <return>127</return>. <return>0</return> означает непрозрачность, <return>127</return> означает
                   абсолютную прозрачность.

<comment>Return:</comment>
  <info>int</info>  Возвращает индекс цвета.

<comment>See Also:</comment>
   * <strong>imagecolorclosestalpha()</strong>


id: imagecolorset
type: function
doc:
<comment>Description:</comment>
  Установка набора цветов для заданного индекса палитры
    
  
  Функция устанавливает соответствие индекса в палитре заданному цвету. Это полезно для создания
  эффекта подобного заливке цветом без осуществления заливки.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$color</strong>  Индекс в палитре.
  <info>int</info>      <strong>$red</strong>    Значение красного компонента цвета.
  <info>int</info>      <strong>$green</strong>  Значение зелёного компонента цвета.
  <info>int</info>      <strong>$blue</strong>   Значение синего компонента цвета.
  <info>int</info>      <strong>$alpha</strong>  Значение альфа компонента.

<comment>Return:</comment>
  <info>false|null</info>  Функция возвращает <info>null</info> в случае успешного выполнения или <info>false</info> в случае возникновения
              ошибки.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>


id: imagecolorsforindex
type: function
doc:
<comment>Description:</comment>
  Получение цветов, соответствующих индексу
    
  
  Получение цветов, соответствующих заданному индексу.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$color</strong>  Индекс цвета.

<comment>Return:</comment>
  <info>array</info>  Возвращает ассоциативный массив с красным, зелёным, синим и альфа ключами, содержащий
         соответствующие значения для заданного индекса цвета.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>
   * <strong>imagecolorexact()</strong>


id: imagecolorstotal
type: function
doc:
<comment>Description:</comment>
  Определение количества цветов в палитре изображения
    
  
  Возвращает количество цветов в палитре изображения.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Возвращает количество цветов в палитре изображения либо 0 для truecolor-изображений.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>
   * <strong>imagecolorsforindex()</strong>
   * <strong>imageistruecolor()</strong>


id: imagecolortransparent
type: function
doc:
<comment>Description:</comment>
  Определяет цвет как прозрачный
    
  
  Получает или устанавливает прозрачность цвета в заданном изображении <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>   <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int|null</info>  <strong>$color</strong>  Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>int</info>  Возвращает идентификатор нового (или текущего, если ничего не изменилось) цвета. Если
       аргумент <strong>$color</strong> задан как <info>null</info> и в изображении нет прозрачных цветов, функция вернёт <return>-1</return>.


id: imageconvolution
type: function
doc:
<comment>Description:</comment>
  Наложение искривляющей матрицы 3х3, используя коэффициент и смещение
    
  
  Накладывает искривляющую матрицу на изображение, используя заданный коэффициент и смещение.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>    Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                     например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$matrix</strong>   Матрица 3x3: массив из трёх массивов по 3 значения с плавающей точкой в каждом.
  <info>float</info>    <strong>$divisor</strong>  Делитель результата искривления, используется для нормализации.
  <info>float</info>    <strong>$offset</strong>   Смещение цвета.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagefilter()</strong>


id: imagecopy
type: function
doc:
<comment>Description:</comment>
  Копирование части изображения
  
  Копирует часть <strong>$src_image</strong> в <strong>$dst_image</strong>, начиная с координат x, y <strong>$src_x</strong>, <strong>$src_y </strong> с шириной
  <strong>$src_width</strong> и высотой <strong>$src_h</strong>. Скопированная часть помещается на координаты <strong>$dst_x</strong> и <strong>$dst_y</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ресурс целевого изображения.
  <info>GdImage</info>  <strong>$src_image</strong>   Ресурс исходного изображения.
  <info>int</info>      <strong>$dst_x</strong>       x-координата результирующего изображения.
  <info>int</info>      <strong>$dst_y</strong>       y-координата результирующего изображения.
  <info>int</info>      <strong>$src_x</strong>       x-координата исходного изображения.
  <info>int</info>      <strong>$src_y</strong>       y-координата исходного изображения.
  <info>int</info>      <strong>$src_width</strong>   Ширина исходного изображения.
  <info>int</info>      <strong>$src_height</strong>  Высота исходного изображения.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecrop()</strong>


id: imagecopymerge
type: function
doc:
<comment>Description:</comment>
  Копирует часть изображения с наложением
  
  Копирует часть <strong>$src_image</strong> и помещает скопированное на <strong>$dst_image</strong>, начиная с координат <strong>$src_x</strong>,
  <strong>$src_y </strong> с шириной <strong>$src_width</strong> и высотой <strong>$src_height</strong>. Скопированная часть помещается на координаты
  <strong>$dst_x</strong> и <strong>$dst_y</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ресурс целевого изображения.
  <info>GdImage</info>  <strong>$src_image</strong>   Ресурс исходного изображения.
  <info>int</info>      <strong>$dst_x</strong>       x-координата результирующего изображения.
  <info>int</info>      <strong>$dst_y</strong>       y-координата результирующего изображения.
  <info>int</info>      <strong>$src_x</strong>       x-координата исходного изображения.
  <info>int</info>      <strong>$src_y</strong>       y-координата исходного изображения.
  <info>int</info>      <strong>$src_width</strong>   Ширина исходного изображения.
  <info>int</info>      <strong>$src_height</strong>  Высота исходного изображения.
  <info>int</info>      <strong>$pct</strong>         Два изображения будут совмещаться в зависимости от параметра <strong>$pct</strong>, который
                        может варьироваться от 0 до 100. Когда <strong>$pct</strong> = 0, наложения не происходит. В
                        случае значения 100 эта функция ведёт себя аналогично функции <strong>imagecopy()</strong>
                        для палитровых изображений, несмотря на то что она поддерживает прозрачность
                        для truecolor-изображений.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagecopymergegray
type: function
doc:
<comment>Description:</comment>
  Копирует часть изображения с наложением в градациях серого
  
  Копирует часть <strong>$src_image</strong> и помещает скопированное на <strong>$dst_image</strong>, начиная с координат <strong>$src_x</strong>,
  <strong>$src_y </strong> с шириной <strong>$src_width</strong> и высотой <strong>$src_height</strong>. Скопированная часть помещается на координаты
  <strong>$dst_x</strong> и <strong>$dst_y</strong>.
  
  Функция работает аналогично <strong>imagecopymerge()</strong> за исключением того, что при наложении она сохраняет
  насыщенность цвета исходного изображения путём преобразования цветов пикселей конечного
  изображения в градации серого перед копированием.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ресурс целевого изображения.
  <info>GdImage</info>  <strong>$src_image</strong>   Ресурс исходного изображения.
  <info>int</info>      <strong>$dst_x</strong>       x-координата результирующего изображения.
  <info>int</info>      <strong>$dst_y</strong>       y-координата результирующего изображения.
  <info>int</info>      <strong>$src_x</strong>       x-координата исходного изображения.
  <info>int</info>      <strong>$src_y</strong>       y-координата исходного изображения.
  <info>int</info>      <strong>$src_width</strong>   Ширина исходного изображения.
  <info>int</info>      <strong>$src_height</strong>  Высота исходного изображения.
  <info>int</info>      <strong>$pct</strong>         Результирующее изображение <strong>$src_image</strong> будет преобразовано к изображению в
                        градациях серого в соответствии со значением параметра <strong>$pct</strong>. 0 означает
                        отсутствие цветов кроме серого, 100 - без изменений. Когда <strong>$pct</strong> = 100
                        поведение функции идентично <strong>imagecopy()</strong> для палитровых изображений, несмотря
                        на то что в этой функции реализована прозрачность для truecolor-изображений.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagecopyresampled
type: function
doc:
<comment>Description:</comment>
  Копирование и изменение размера изображения с ресемплированием
    
  
  <strong>imagecopyresampled()</strong> копирует прямоугольную часть одного изображения на другое изображение,
  интерполируя значения пикселов таким образом, чтобы уменьшение размера изображения не уменьшало
  его чёткости.
  
  Другими словами, <strong>imagecopyresampled()</strong> берет прямоугольный участок из <strong>$src_image</strong> с шириной
  <strong>$src_width</strong> и высотой <strong>$src_height</strong> на координатах <strong>$src_x</strong>,<strong>$src_y</strong> и помещает его в прямоугольный
  участок изображения <strong>$dst_image</strong> шириной <strong>$dst_width</strong> и высотой <strong>$dst_height</strong> на координатах
  <strong>$dst_x</strong>,<strong>$dst_y</strong>.
  
  Если координаты, ширина или высота исходного и конечного изображений различны, копируемый фрагмент
  будет растянут или сжат. Координаты отсчитываются от левого верхнего угла изображения. Функцию
  можно использовать для наложения участков на то же изображение, с которого они скопированы (если
  <strong>$dst_image</strong> имеет то же значение, что и <strong>$src_image</strong>), но если участки будут пересекаться, результат
  непредсказуем.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ресурс целевого изображения.
  <info>GdImage</info>  <strong>$src_image</strong>   Ресурс исходного изображения.
  <info>int</info>      <strong>$dst_x</strong>       x-координата результирующего изображения.
  <info>int</info>      <strong>$dst_y</strong>       y-координата результирующего изображения.
  <info>int</info>      <strong>$src_x</strong>       x-координата исходного изображения.
  <info>int</info>      <strong>$src_y</strong>       y-координата исходного изображения.
  <info>int</info>      <strong>$dst_width</strong>   Результирующая ширина.
  <info>int</info>      <strong>$dst_height</strong>  Результирующая высота.
  <info>int</info>      <strong>$src_width</strong>   Ширина исходного изображения.
  <info>int</info>      <strong>$src_height</strong>  Высота исходного изображения.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecopyresized()</strong>
   * <strong>imagescale()</strong>
   * <strong>imagecrop()</strong>


id: imagecopyresized
type: function
doc:
<comment>Description:</comment>
  Копирование и изменение размера части изображения
  
  <strong>imagecopyresized()</strong> копирует прямоугольный участок одного изображения на другое изображение.
  <strong>$dst_image</strong> - результирующее изображение, <strong>$src_image</strong> - идентификатор исходного изображения.
  
  Другими словами, <strong>imagecopyresized()</strong> берет прямоугольный участок из <strong>$src_image</strong> с шириной <strong>$src_width</strong>
  и высотой <strong>$src_height</strong> на координатах <strong>$src_x</strong>,<strong>$src_y</strong> и помещает его в прямоугольную область
  изображения <strong>$dst_image</strong> с шириной <strong>$dst_width</strong> и высотой <strong>$dst_height</strong> на координатах <strong>$dst_x</strong>,<strong>$dst_y</strong>.
  
  Если координаты, ширина или высота исходного и конечного изображений различны, копируемый фрагмент
  будет растянут или сжат. Координаты отсчитываются от левого верхнего угла изображения. Функцию
  можно использовать для наложения участков на то же изображение, с которого они скопированы (если
  <strong>$dst_image</strong> имеет то же значение, что и <strong>$src_image</strong>), но если участки будут пересекаться, результат
  непредсказуем.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ресурс целевого изображения.
  <info>GdImage</info>  <strong>$src_image</strong>   Ресурс исходного изображения.
  <info>int</info>      <strong>$dst_x</strong>       x-координата результирующего изображения.
  <info>int</info>      <strong>$dst_y</strong>       y-координата результирующего изображения.
  <info>int</info>      <strong>$src_x</strong>       x-координата исходного изображения.
  <info>int</info>      <strong>$src_y</strong>       y-координата исходного изображения.
  <info>int</info>      <strong>$dst_width</strong>   Результирующая ширина.
  <info>int</info>      <strong>$dst_height</strong>  Результирующая высота.
  <info>int</info>      <strong>$src_width</strong>   Ширина исходного изображения.
  <info>int</info>      <strong>$src_height</strong>  Высота исходного изображения.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecopyresampled()</strong>
   * <strong>imagescale()</strong>
   * <strong>imagecrop()</strong>


id: imagecreate
type: function
doc:
<comment>Description:</comment>
  Создание нового палитрового изображения
  
  <strong>imagecreate()</strong> возвращает идентификатор изображения, представляющего из себя пустое изображение
  заданного размера.
  
  Мы рекомендуем использовать функцию <strong>imagecreatetruecolor()</strong> вместо <strong>imagecreate()</strong>, так как она
  обрабатывает изображения с максимально возможным качеством. Если необходимо вывести палитру
  изображения, то <strong>imagetruecolortopalette()</strong> необходимо вызвать непосредственно перед сохранением
  изображения с помощью <strong>imagepng()</strong> или <strong>imagegif()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$width</strong>   Ширина изображения.
  <info>int</info>  <strong>$height</strong>  Высота изображения.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagedestroy()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagecreatefromavif
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromavif()</strong> возвращает объект изображения, представляющий изображение, полученное из
  данного имени файла.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь до растрового изображения AVIF.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefrombmp
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefrombmp()</strong> возвращает идентификатор изображения, представляющий изображение, полученное
  из переданного имени файла.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к BMP-изображению.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromgd
type: function
doc:
<comment>Description:</comment>
  Создание нового изображения на основе GD файла или URL
    
  
  Создание нового изображения на основе GD файла или URL.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к GD файлу.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromgd2
type: function
doc:
<comment>Description:</comment>
  Создание нового изображения на основе GD2 или URL
    
  
  Создание нового изображения на основе GD2 или URL.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к GD2 изображению.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromgd2part
type: function
doc:
<comment>Description:</comment>
  Создание нового изображения на основе части GD2 файла или URL
    
  
  Создание нового изображения на основе части GD2 файла или URL.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к GD2 изображению.
  <info>int</info>     <strong>$x</strong>         x-координата точки исходного изображения.
  <info>int</info>     <strong>$y</strong>         y-координата точки исходного изображения.
  <info>int</info>     <strong>$width</strong>     Ширина исходного изображения.
  <info>int</info>     <strong>$height</strong>    Высота исходного изображения.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromgif
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromgif()</strong> возвращает объект изображения, представляющего изображение полученное из
  файла с заданным именем.
  
  При чтении анимированных файлов GIF в память, возвращается указатель на ресурс изображения только
  для первого фрейма. Размер изображения не обязательно будет соответствует тому, что вернёт функция
  <strong>getimagesize()</strong>.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к GIF картинке.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromjpeg
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromjpeg()</strong> возвращает идентификатор изображения, представляющего изображение полученное
  из файла с заданным именем.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к JPEG картинке.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefrompng
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefrompng()</strong> возвращает идентификатор изображения, представляющего изображение полученное
  из файла с заданным именем.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к изображению PNG.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromstring
type: function
doc:
<comment>Description:</comment>
  Создание нового изображения из потока представленного строкой
    
  
  <strong>imagecreatefromstring()</strong> возвращает идентификатор изображения, представляющего изображение
  полученное из потока <strong>$data</strong>. Эти типы будут автоматически определяться, если сборка PHP их
  поддерживает: JPEG, PNG, GIF, BMP, WBMP, GD2 и WEBP.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  Строка содержащая данные изображения.

<comment>Return:</comment>
  <info>GdImage|false</info>  В случае успешного выполнения будет возвращён объект ресурс, <info>false</info>, если тип
                 изображения не поддерживается, данные не распознаются или данные нарушены и не
                 могут быть загружены.

<comment>See Also:</comment>
   * <strong>imagecreatefromjpeg()</strong>
   * <strong>imagecreatefrompng()</strong>
   * <strong>imagecreatefromgif()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagecreatefromtga
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromtga()</strong> возвращает объект изображения, представляющий изображение, полученное из
  данного имени файла.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к изображению Truevision TGA.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromwbmp
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromwbmp()</strong> возвращает идентификатор изображения, представляющего изображение полученное
  из файла с заданным именем.
  
  Изображения WBMP представляют собой Wireless Bitmaps, а не Windows Bitmaps. Последние могут быть
  загружены с помощью <strong>imagecreatefrombmp()</strong>.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к изображению WBMP.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromwebp
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromwebp()</strong> возвращает идентификатор изображения, представляющий изображение, полученное
  из переданного имени файла. Обратите внимание, что анимированные файлы WebP не читаются.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к WebP-изображению.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromxbm
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromxbm()</strong> возвращает идентификатор изображения, представляющего изображение полученное
  из файла с заданным именем.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к изображению XBM.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatefromxpm
type: function
doc:
<comment>Description:</comment>
  Создаёт новое изображение из файла или URL
  
  <strong>imagecreatefromxpm()</strong> возвращает идентификатор изображения, представляющего изображение полученное
  из файла с заданным именем.
  
  Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen
  wrappers. Смотрите более подробную информацию об определении имени файла в описании функции
  <strong>fopen()</strong>. Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по
  использованию и список предопределённых констант в разделе .

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Путь к изображению XPM.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.


id: imagecreatetruecolor
type: function
doc:
<comment>Description:</comment>
  Создание нового полноцветного изображения
  
  <strong>imagecreatetruecolor()</strong> возвращает объект, представляющий чёрное изображение заданного размера.

<comment>Param:</comment>
  <info>int</info>  <strong>$width</strong>   Ширина изображения.
  <info>int</info>  <strong>$height</strong>  Высота изображения.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения или <info>false</info> в случае
                 возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagedestroy()</strong>
   * <strong>imagecreate()</strong>


id: imagecrop
type: function
doc:
<comment>Description:</comment>
  Обрезать изображение до заданного прямоугольника
  
  Обрезает изображение до заданной прямоугольной области и возвращает полученное изображение.
  Заданный параметр <strong>$image</strong> не изменяется.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                       например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$rectangle</strong>  Обрезанный прямоугольник в виде массива (<info>array</info>) с ключами <return>x</return>, <return>y</return>, <return>width</return> и
                       <return>height</return>.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект обрезанного изображения в случае успешного выполнения или <info>false</info> в
                 случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecropauto()</strong>


id: imagecropauto
type: function
doc:
<comment>Description:</comment>
  Обрезает изображение автоматически, используя один из доступных режимов
  
  Автоматически обрезает изображение в соответствии с заданным <strong>$mode</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                       например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$mode</strong>       Одна из следующих констант:
                       
                       То же, что и <info>IMG_CROP_TRANSPARENT</info>. До PHP 7.4.0, связанный libgd использовал
                       <info>IMG_CROP_SIDES</info>, если изображение не имело прозрачного цвета.
                       
                       Обрезает прозрачный фон.
                       
                       Обрезает чёрный фон.
                       
                       Обрезает белый фон.
                       
                       Использует 4 угла изображения, чтобы попытаться обнаружить фон для обрезки.
                       
                       Обрезает изображение, используя заданные <strong>$threshold</strong> и <strong>$color</strong>.
  <info>float</info>    <strong>$threshold</strong>  Обрезает изображение, используя заданные <strong>$threshold</strong> и <strong>$color</strong>.
  <info>float</info>    <strong>$threshold</strong>  Определяет допуск в процентах, который будет использоваться при сравнении
                       цвета изображения и цвета обрезки. Метод, используемый для расчёта цветовой
                       разницы, основан на цветовом расстоянии в кубе RGB(a).
                       
                       Используется только в режиме <info>IMG_CROP_THRESHOLD</info>.
                       
                       До PHP 7.4.0 в комплекте libgd использовался несколько иной алгоритм, поэтому
                       один и тот же <strong>$threshold</strong> давал разные результаты для системного и связанного
                       libgd.
  <info>int</info>      <strong>$color</strong>      Либо значение цвета RGB, либо индекс палитры.
                       
                       Используется только в режиме <info>IMG_CROP_THRESHOLD</info>.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект обрезанного изображения в случае успешного выполнения или <info>false</info> в
                 случае возникновения ошибки. Если полное изображение было обрезано, <strong>imagecrop()</strong>
                 возвращает <info>false</info>.

<comment>See Also:</comment>
   * <strong>imagecrop()</strong>


id: imagedashedline
type: function
doc:
<comment>Description:</comment>
  Рисование пунктирной линии
  
  Функция устарела. Используйте сочетание функций <strong>imagesetstyle()</strong> и <strong>imageline()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     Верхняя левая x-координата.
  <info>int</info>      <strong>$y1</strong>     Верхняя левая y-координата. 0, 0 - верхний левый угол изображения.
  <info>int</info>      <strong>$x2</strong>     Нижняя правая х-координата.
  <info>int</info>      <strong>$y2</strong>     Нижняя правая у-координата.
  <info>int</info>      <strong>$color</strong>  Цвет линии. Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagesetstyle()</strong>
   * <strong>imageline()</strong>


id: imagedestroy
type: function
doc:
<comment>Description:</comment>
  Уничтожение изображения
  
  Использование функции больше не имеет смысла. До PHP 8.0.0 она использовалась для закрытия
  ресурса.
  
  До PHP 8.0.0, <strong>imagedestroy()</strong> освобождает память, занятую изображением <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imageellipse
type: function
doc:
<comment>Description:</comment>
  Рисование эллипса
  
  Рисует эллипс с центром в заданных координатах.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>     Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                      например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>  x-координата центра.
  <info>int</info>      <strong>$center_y</strong>  y-координата центра.
  <info>int</info>      <strong>$width</strong>     Ширина эллипса.
  <info>int</info>      <strong>$height</strong>    Высота эллипса.
  <info>int</info>      <strong>$color</strong>     Цвет эллипса. Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagefilledellipse()</strong>
   * <strong>imagearc()</strong>


id: imagefill
type: function
doc:
<comment>Description:</comment>
  Заливка
  
  Производит заливку, начиная с заданных координат (верхний левый угол имеет координаты 0, 0),
  цветом <strong>$color</strong> в изображении <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x</strong>      x-координата начала.
  <info>int</info>      <strong>$y</strong>      y-координата начала.
  <info>int</info>      <strong>$color</strong>  Цвет заливки. Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>


id: imagefilledarc
type: function
doc:
<comment>Description:</comment>
  Рисование и заливка дуги
  
  Рисует дугу с центром в заданных координатах изображения <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>        Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                         например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>     x-координата центра.
  <info>int</info>      <strong>$center_y</strong>     y-координата центра.
  <info>int</info>      <strong>$width</strong>        Ширина дуги.
  <info>int</info>      <strong>$height</strong>       Высота дуги.
  <info>int</info>      <strong>$start_angle</strong>  Угол начала дуги в градусах.
  <info>int</info>      <strong>$end_angle</strong>    Угол окончания дуги в градусах. 0° соответствует положению 3-часа. Дуга
                         рисуется по часовой стрелке.
  <info>int</info>      <strong>$color</strong>        Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.
  <info>int</info>      <strong>$style</strong>        Битовое или следующих констант:
                         <info>IMG_ARC_PIE</info><info>IMG_ARC_CHORD</info><info>IMG_ARC_NOFILL</info><info>IMG_ARC_EDGED</info> <info>IMG_ARC_PIE</info> и
                         <info>IMG_ARC_CHORD</info> взаимно исключающие; <info>IMG_ARC_CHORD</info> просто соединяет начало и
                         конец дуги прямой линией; <info>IMG_ARC_PIE</info> рисует между ними часть окружности.
                         <info>IMG_ARC_NOFILL</info> означает, что должны быть только границы, заливка не
                         требуется. <info>IMG_ARC_EDGED</info>, если используется вместе с <info>IMG_ARC_NOFILL</info>,
                         означает, что начало и конец дуги соединяются с центром - это хороший
                         способ (лучше чем заливка) получить сектор (кусок пирога).
                         
                         <info>IMG_ARC_PIE</info>
                         
                         <info>IMG_ARC_CHORD</info>
                         
                         <info>IMG_ARC_NOFILL</info>
                         
                         <info>IMG_ARC_EDGED</info>

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagefilledellipse
type: function
doc:
<comment>Description:</comment>
  Рисование закрашенного эллипса
  
  Рисует эллипс с центром в заданных координатах изображения <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>     Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                      например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>  x-координата центра.
  <info>int</info>      <strong>$center_y</strong>  y-координата центра.
  <info>int</info>      <strong>$width</strong>     Ширина эллипса.
  <info>int</info>      <strong>$height</strong>    Высота эллипса.
  <info>int</info>      <strong>$color</strong>     Цвет заливки. Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imageellipse()</strong>
   * <strong>imagefilledarc()</strong>


id: imagefilledpolygon
type: function
doc:
<comment>Description:</comment>
  Рисование закрашенного многоугольника
  
  Сигнатура, начиная с PHP 8.0.0 (не поддерживается с именованными аргументами)
  
  Альтернативный синтаксис (объявлен устаревшим с PHP 8.1.0)
  
  <strong>imagefilledpolygon()</strong> создаёт закрашенный многоугольник в заданном изображении <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                        например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$points</strong>      Массив, содержащий <return>x</return> и <return>y</return> координаты последовательных вершин многоугольника.
  <info>int</info>      <strong>$num_points</strong>  Общее число точек (вершин), должно быть не меньше 3.
                        
                        Если этот параметр опущен (смотрите альтернативный синтаксис), то массив
                        <strong>$points</strong> должен содержать чётное количество элементов и <strong>$num_points</strong> будет
                        вычислено как count($points)/2.
  <info>int</info>      <strong>$color</strong>       Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagepolygon()</strong>


id: imagefilledrectangle
type: function
doc:
<comment>Description:</comment>
  Рисование закрашенного прямоугольника
  
  Создаёт прямоугольник закрашенный цветом <strong>$color</strong> в заданном изображении <strong>$image</strong>. Начальная точка 1,
  конечная 2. 0,0 - левый верхний угол изображения.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     x-координата точки 1.
  <info>int</info>      <strong>$y1</strong>     y-координата точки 1.
  <info>int</info>      <strong>$x2</strong>     x-координата точки 2.
  <info>int</info>      <strong>$y2</strong>     y-координата точки 2.
  <info>int</info>      <strong>$color</strong>  Цвет заливки. Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagefilltoborder
type: function
doc:
<comment>Description:</comment>
  Заливка цветом
  
  <strong>imagefilltoborder()</strong> производит заливку области, ограниченной цветом <strong>$border_color</strong>. Начальная
  координата <strong>$x</strong>, <strong>$y</strong> (левый верхний угол имеет координаты 0, 0), а область закрашивается цветом
  <strong>$color</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>         Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                          например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x</strong>             x-координата начала.
  <info>int</info>      <strong>$y</strong>             y-координата начала.
  <info>int</info>      <strong>$border_color</strong>  Цвет границы заливки. Идентификатор цвета, созданный функцией
                          <strong>imagecolorallocate()</strong>.
  <info>int</info>      <strong>$color</strong>         Цвет заливки. Идентификатор цвета, созданный функцией
                          <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagefilter
type: function
doc:
<comment>Description:</comment>
  Применяет фильтр к изображению
  
  <strong>imagefilter()</strong> применяет заданный фильтр <strong>$filter</strong> к изображению <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                                 например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>                   <strong>$filter</strong>  <strong>$filter</strong> может быть одним из следующих: <info>IMG_FILTER_NEGATE</info>:
                                 Инвертирует все цвета изображения. <info>IMG_FILTER_GRAYSCALE</info>:
                                 Преобразует цвета изображения в градации серого путём
                                 преобразования компонент красного, зелёного и синего в их сумму с
                                 учётом весов, таких же как при вычислении яркости (Y') по REC.601.
                                 Альфа-канал сохраняется. Для изображений, использующих палитру,
                                 результат может отличаться в виду ограничений, накладываемых
                                 палитрой. <info>IMG_FILTER_BRIGHTNESS</info>: Изменяет яркость изображения.
                                 Используйте аргумент <strong>$args</strong> для задания уровня яркости. Диапазон
                                 яркостей от -255 до 255. <info>IMG_FILTER_CONTRAST</info>: Изменяет
                                 контрастность изображения. Используйте аргумент <strong>$args</strong> для задания
                                 уровня контрастности. <info>IMG_FILTER_COLORIZE</info>: То же, что и
                                 <info>IMG_FILTER_GRAYSCALE</info>, за исключением того, что можно задать цвет.
                                 Используйте аргументы <strong>$args</strong>, <strong>$arg2</strong> и <strong>$arg3</strong> для указания каналов
                                 <strong>$red</strong>, <strong>$green</strong>, <strong>$blue</strong>, а <strong>$arg4</strong> для <strong>$alpha</strong> канала. Диапазон для
                                 каждого канала цвета от 0 до 255. <info>IMG_FILTER_EDGEDETECT</info>: Использует
                                 определение границ для их подсветки. <info>IMG_FILTER_EMBOSS</info>: Добавляет
                                 рельеф. <info>IMG_FILTER_GAUSSIAN_BLUR</info>: Размывает изображение по методу
                                 Гаусса. <info>IMG_FILTER_SELECTIVE_BLUR</info>: Размывает изображение.
                                 <info>IMG_FILTER_MEAN_REMOVAL</info>: Использует усреднение для достижения
                                 эффекта "эскиза". <info>IMG_FILTER_SMOOTH</info>: Делает границы более плавными,
                                 а изображение менее чётким. Используйте аргумент <strong>$args</strong> для задания
                                 уровня гладкости. <info>IMG_FILTER_PIXELATE</info>: Применяет эффект
                                 пикселирования. Используйте аргумент <strong>$args</strong> для задания размера
                                 блока и аргумент <strong>$arg2</strong> для задания режима эффекта пикселирования.
                                 <info>IMG_FILTER_SCATTER</info>: Применяет эффект рассеивания к изображению,
                                 используйте <strong>$args</strong> и <strong>$arg2</strong> для определения силы эффекта и
                                 дополнительно <strong>$arg3</strong> для применения только к выбранным цветам
                                 пикселей.
                                 
                                 <info>IMG_FILTER_NEGATE</info>: Инвертирует все цвета изображения.
                                 
                                 <info>IMG_FILTER_GRAYSCALE</info>: Преобразует цвета изображения в градации
                                 серого путём преобразования компонент красного, зелёного и синего в
                                 их сумму с учётом весов, таких же как при вычислении яркости (Y')
                                 по REC.601. Альфа-канал сохраняется. Для изображений, использующих
                                 палитру, результат может отличаться в виду ограничений,
                                 накладываемых палитрой.
                                 
                                 <info>IMG_FILTER_BRIGHTNESS</info>: Изменяет яркость изображения. Используйте
                                 аргумент <strong>$args</strong> для задания уровня яркости. Диапазон яркостей от
                                 -255 до 255.
                                 
                                 <info>IMG_FILTER_CONTRAST</info>: Изменяет контрастность изображения.
                                 Используйте аргумент <strong>$args</strong> для задания уровня контрастности.
                                 
                                 <info>IMG_FILTER_COLORIZE</info>: То же, что и <info>IMG_FILTER_GRAYSCALE</info>, за
                                 исключением того, что можно задать цвет. Используйте аргументы
                                 <strong>$args</strong>, <strong>$arg2</strong> и <strong>$arg3</strong> для указания каналов <strong>$red</strong>, <strong>$green</strong>, <strong>$blue</strong>, а
                                 <strong>$arg4</strong> для <strong>$alpha</strong> канала. Диапазон для каждого канала цвета от 0 до
                                 255.
                                 
                                 <info>IMG_FILTER_EDGEDETECT</info>: Использует определение границ для их
                                 подсветки.
                                 
                                 <info>IMG_FILTER_EMBOSS</info>: Добавляет рельеф.
                                 
                                 <info>IMG_FILTER_GAUSSIAN_BLUR</info>: Размывает изображение по методу Гаусса.
                                 
                                 <info>IMG_FILTER_SELECTIVE_BLUR</info>: Размывает изображение.
                                 
                                 <info>IMG_FILTER_MEAN_REMOVAL</info>: Использует усреднение для достижения
                                 эффекта "эскиза".
                                 
                                 <info>IMG_FILTER_SMOOTH</info>: Делает границы более плавными, а изображение
                                 менее чётким. Используйте аргумент <strong>$args</strong> для задания уровня
                                 гладкости.
                                 
                                 <info>IMG_FILTER_PIXELATE</info>: Применяет эффект пикселирования. Используйте
                                 аргумент <strong>$args</strong> для задания размера блока и аргумент <strong>$arg2</strong> для
                                 задания режима эффекта пикселирования.
                                 
                                 <info>IMG_FILTER_SCATTER</info>: Применяет эффект рассеивания к изображению,
                                 используйте <strong>$args</strong> и <strong>$arg2</strong> для определения силы эффекта и
                                 дополнительно <strong>$arg3</strong> для применения только к выбранным цветам
                                 пикселей.
  <info>array|int|float|bool</info>  <strong>$args</strong>    <info>IMG_FILTER_BRIGHTNESS</info>: Уровень яркости. <info>IMG_FILTER_CONTRAST</info>:
                                 Уровень контрастности. <info>IMG_FILTER_COLORIZE</info>: Значение красного
                                 компонента цвета. <info>IMG_FILTER_SMOOTH</info>: Уровень сглаживания.
                                 <info>IMG_FILTER_PIXELATE</info>: Размер блока в пикселах. <info>IMG_FILTER_SCATTER</info>:
                                 Уровень уменьшения эффекта. Не должен быть больше или равен уровню
                                 добавления эффекта, установленному с помощью <strong>$arg2</strong>.
                                 
                                 <info>IMG_FILTER_BRIGHTNESS</info>: Уровень яркости.
                                 
                                 <info>IMG_FILTER_CONTRAST</info>: Уровень контрастности.
                                 
                                 <info>IMG_FILTER_COLORIZE</info>: Значение красного компонента цвета.
                                 
                                 <info>IMG_FILTER_SMOOTH</info>: Уровень сглаживания.
                                 
                                 <info>IMG_FILTER_PIXELATE</info>: Размер блока в пикселах.
                                 
                                 <info>IMG_FILTER_SCATTER</info>: Уровень уменьшения эффекта. Не должен быть
                                 больше или равен уровню добавления эффекта, установленному с
                                 помощью <strong>$arg2</strong>.
  <info></info>                      <strong>$arg2</strong>    <info>IMG_FILTER_COLORIZE</info>: Значение зелёного компонента цвета.
                                 <info>IMG_FILTER_PIXELATE</info>: Использовать усовершенствованный эффект
                                 пикселирования или нет (по умолчанию <info>false</info>). <info>IMG_FILTER_SCATTER</info>:
                                 Уровень добавления эффекта.
                                 
                                 <info>IMG_FILTER_COLORIZE</info>: Значение зелёного компонента цвета.
                                 
                                 <info>IMG_FILTER_PIXELATE</info>: Использовать усовершенствованный эффект
                                 пикселирования или нет (по умолчанию <info>false</info>).
                                 
                                 <info>IMG_FILTER_SCATTER</info>: Уровень добавления эффекта.
  <info></info>                      <strong>$arg3</strong>    <info>IMG_FILTER_COLORIZE</info>: Значение синего компонента цвета.
                                 <info>IMG_FILTER_SCATTER</info>: Необязательный массив значений индексации цвета
                                 для применения эффекта.
                                 
                                 <info>IMG_FILTER_COLORIZE</info>: Значение синего компонента цвета.
                                 
                                 <info>IMG_FILTER_SCATTER</info>: Необязательный массив значений индексации цвета
                                 для применения эффекта.
  <info></info>                      <strong>$arg4</strong>    <info>IMG_FILTER_COLORIZE</info>: Альфа канал, значение между 0 и 127. 0
                                 означает непрозрачность, 127 соответствует абсолютной прозрачности.
                                 
                                 <info>IMG_FILTER_COLORIZE</info>: Альфа канал, значение между 0 и 127. 0
                                 означает непрозрачность, 127 соответствует абсолютной прозрачности.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imageconvolution()</strong>


id: imageflip
type: function
doc:
<comment>Description:</comment>
  Переворачивает изображение, используя выбранный режим
  
  Переворачивает изображение <strong>$image</strong>, используя выбранный режим <strong>$mode</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$mode</strong>   Режим переворота - одна из констант <info>IMG_FLIP_*</info>:
                   
                   КонстантаОписание<info>IMG_FLIP_HORIZONTAL</info> Переворачивает изображение по горизонтали.
                   <info>IMG_FLIP_VERTICAL</info> Переворачивает изображение по вертикали. <info>IMG_FLIP_BOTH</info>
                   Переворачивает изображение и по горизонтали и по вертикали.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagefontheight
type: function
doc:
<comment>Description:</comment>
  Получение высоты шрифта
  
  Возвращает высоту в пикселах символа заданного шрифта.

<comment>Param:</comment>
  <info>GdFont|int</info>  <strong>$font</strong>  Может принимать значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
                     latin2 (более высокое число соответствует большему шрифту) или экземпляр
                     <class>GdFont</class>,
                     возвращаемый функцией <strong>imageloadfont()</strong>..

<comment>Return:</comment>
  <info>int</info>  Возвращает высоту в пикселах.

<comment>See Also:</comment>
   * <strong>imagefontwidth()</strong>
   * <strong>imageloadfont()</strong>


id: imagefontwidth
type: function
doc:
<comment>Description:</comment>
  Получение ширины шрифта
  
  Возвращает ширину символа шрифта.

<comment>Param:</comment>
  <info>GdFont|int</info>  <strong>$font</strong>  Может принимать значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
                     latin2 (более высокое число соответствует большему шрифту) или экземпляр
                     <class>GdFont</class>,
                     возвращаемый функцией <strong>imageloadfont()</strong>..

<comment>Return:</comment>
  <info>int</info>  Возвращает ширину в пикселах

<comment>See Also:</comment>
   * <strong>imagefontheight()</strong>
   * <strong>imageloadfont()</strong>


id: imageftbbox
type: function
doc:
<comment>Description:</comment>
  Определение границ текста выводимого шрифтом freetype2
    
  
  Эта функция рассчитывает и возвращает рамку (границы) FreeType текста.
  
  До PHP 8.0.0 <strong>imageftbbox()</strong> - это расширенный вариант <strong>imagettfbbox()</strong>, который дополнительно
  поддерживает <strong>$extrainfo</strong>. Начиная с 8.0.0, <strong>imagettfbbox()</strong> является псевдонимом <strong>imageftbbox()</strong>.

<comment>Param:</comment>
  <info>float</info>   <strong>$size</strong>           Размер шрифта в типографских пунктах.
  <info>float</info>   <strong>$angle</strong>          Угол в градусах в котором <strong>$string</strong> должен быть измерен.
  <info>string</info>  <strong>$font_filename</strong>  Имя файла TrueType шрифта (может быть URL). В зависимости от версии GD
                          библиотеки функция может попытаться найти файлы, не начинающиеся с '/'
                          путём добавления '.ttf' в конец имени файла и поиска по адресу заданному в
                          библиотеке.
  <info>string</info>  <strong>$string</strong>         Измеряемая строка.
  <info>array</info>   <strong>$options</strong>        Возможные ключи массива <strong>$options</strong>КлючТипЗначение<return>linespacing</return><info>float</info>Определяет
                          рисование подчёркиваний

<comment>Return:</comment>
  <info>array|false</info>  <strong>imageftbbox()</strong> возвращает массив из 8 элементов, представляющих четыре точки в углах
               рамки обрамляющей текст: 0нижний левый угол, X координата1нижний левый угол, Y
               координата2нижний правый угол, X координата3нижний правый угол, Y координата4верхний
               правый угол, X координата5верхний правый угол, Y координата6верхний левый угол, X
               координата7верхний левый угол, Y координата
               
               Точки расположены относительно текста text и не зависят от угла <strong>$angle</strong>, таким образом
               "верхний левый" означает верхняя левая точка текста, если расположить текст
               горизонтально.
               
               В случае возникновения ошибки возвращает <info>false</info>.

<comment>See Also:</comment>
   * <strong>imagefttext()</strong>
   * <strong>imagettfbbox()</strong>


id: imagefttext
type: function
doc:
<comment>Description:</comment>
  Нанесение текста на изображение, используя шрифты FreeType 2
    
  
  До PHP 8.0.0 <strong>imagefttext()</strong> - это расширенный вариант <strong>imagettftext()</strong>, который дополнительно
  поддерживает <strong>$extrainfo</strong>. Начиная с PHP 8.0.0, <strong>imagettftext()</strong> является псевдонимом <strong>imagefttext()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>          Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                           например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$size</strong>           Размер шрифта в пунктах.
  <info>float</info>    <strong>$angle</strong>          Угол в градусах, 0 градусов означает расположение текста слева направо.
                           Положительные значения означают поворот текста против часовой стрелки.
                           Например, текст повёрнутый на 90 градусов нужно будет читать снизу вверх.
  <info>int</info>      <strong>$x</strong>              Координаты <strong>$x</strong> и <strong>$y</strong> определяют отправную точку для первого символа текста
                           (конкретно, левый нижний угол символа). Здесь есть отличие от функции
                           <strong>imagestring()</strong>, в которой <strong>$x</strong> и <strong>$y</strong> определяют верхний левый угол первого
                           символа. Например, "верхний левый" имеет координаты 0,0.
  <info>int</info>      <strong>$y</strong>              y-координата. Это позиция базовой линии шрифта, в общем случае она не
                           совпадает с низшей точкой в символе.
  <info>int</info>      <strong>$color</strong>          Индекс требуемого цвета текста, смотрите <strong>imagecolorexact()</strong>.
  <info>string</info>   <strong>$font_filename</strong>  Путь к TrueType шрифту, который требуется использовать.
                           
                           В зависимости от версии GD библиотеки если <strong>$font_filename</strong> не начинается с
                           <return>/</return>, то в конец названия файла будет добавлено расширение <return>.ttf</return>, и
                           библиотека будет пытаться найти этот файл по адресу, определённому в
                           настройках библиотеки.
                           
                           В большинстве случаев размещение файлов шрифтов в директории скрипта
                           решает подобные проблемы включения файлов.
                           ]]>
  <info>string</info>   <strong>$text</strong>           Текст для вставки в изображение.
  <info>array</info>    <strong>$options</strong>         Возможные значения массива <strong>$options</strong> КлючТипЗначение<return>linespacing</return><info>float</info>
                           Определяет рисование нижнего подчёркивания

<comment>Return:</comment>
  <info>array|false</info>  Эта функция возвращает массив, определяющий четыре точки рамки текста. Текст внутри
               этих границ начинается с левого нижнего угла и поворачивается против часовой стрелки:
               0нижняя левая x-координата1нижняя левая y-координата2нижняя правая
               x-координата3нижняя правая y-координата4верхняя правая x-координата5верхняя правая
               y-координата6верхняя левая x-координата7верхняя левая y-координата
               
               В случае возникновения ошибки возвращает <info>false</info>.

<comment>See Also:</comment>
   * <strong>imageftbbox()</strong>
   * <strong>imagettftext()</strong>


id: imagegammacorrect
type: function
doc:
<comment>Description:</comment>
  Применение гамма коррекции к GD изображению
    
  
  Применяет гамма коррекцию к изображению <strong>$image</strong> согласно заданным входным и выходным настройкам.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>         Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                          например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$input_gamma</strong>   Входная настройка гаммы.
  <info>float</info>    <strong>$output_gamma</strong>  Выходная настройка гаммы.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagegd
type: function
doc:
<comment>Description:</comment>
  Вывод GD-изображения в браузер или в файл
  
  Вывод GD-изображения в <strong>$file</strong>.

<comment>Param:</comment>
  <info>GdImage</info>      <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                       например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>string|null</info>  <strong>$file</strong>   Путь, или открытый потоковый ресурс (который автоматически закрывается после
                       завершения функции), для сохранения файла. Если не установлен или равен <info>null</info>,
                       изображение будет выведено в поток вывода в бинарном виде.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegd2()</strong>


id: imagegd2
type: function
doc:
<comment>Description:</comment>
  Вывод GD2 изображения в браузер или файл
  
  Выводит GD2 изображение в заданный файл <strong>$file</strong>.

<comment>Param:</comment>
  <info>GdImage</info>      <strong>$image</strong>       Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                            например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>string|null</info>  <strong>$file</strong>        Путь, или открытый потоковый ресурс (который автоматически закрывается
                            после завершения функции), для сохранения файла. Если не установлен или
                            равен <info>null</info>, изображение будет выведено в поток вывода в бинарном виде.
  <info>int</info>          <strong>$chunk_size</strong>  Размер части изображения.
  <info>int</info>          <strong>$mode</strong>        Либо <info>IMG_GD2_RAW</info>, либо <info>IMG_GD2_COMPRESSED</info>. По умолчанию <info>IMG_GD2_RAW</info>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegd()</strong>


id: imagegetclip
type: function
doc:
<comment>Description:</comment>
  Получить отсекающий прямоугольник
  
  <strong>imagegetclip()</strong> возвращает текущий отсекающий прямоугольник, т.е. область, за пределами которой не
  будут отрисовываться пиксели.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>array</info>  Функция возвращает индексированный массив с координатами отсекающим прямоугольником,
         который имеет следующие записи: x-координата верхнего левого углаy-координата верхнего
         левого углаx-координата нижнего правого углаy-координата нижнего правого угла
         
         x-координата верхнего левого угла
         
         y-координата верхнего левого угла
         
         x-координата нижнего правого угла
         
         y-координата нижнего правого угла

<comment>See Also:</comment>
   * <strong>imagesetclip()</strong>


id: imagegetinterpolation
type: function
doc:
<comment>Description:</comment>
  Получает метод интерполяции
  
  Получает текущий установленный метод интерполяции <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Возвращает метод интерполяции.

<comment>See Also:</comment>
   * <strong>imagesetinterpolation()</strong>


id: imagegif
type: function
doc:
<comment>Description:</comment>
  Выводит изображение в браузер или пишет в файл
  
  <strong>imagegif()</strong> создаёт GIF файл <strong>$file</strong> из изображения <strong>$image</strong>. Аргумент <strong>$image</strong> возвращается функциями
  <strong>imagecreate()</strong> или <return>imagecreatefrom*</return>.
  
  Файл будет иметь формат GIF87a, если изображение не было сделано прозрачным функцией
  <strong>imagecolortransparent()</strong>. В этом случае форматом файла будет GIF89a.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                                например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>   Путь, или открытый потоковый ресурс (который автоматически
                                закрывается после завершения функции), для сохранения файла. Если не
                                установлен или равен <info>null</info>, изображение будет выведено в поток вывода
                                в бинарном виде.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>


id: imagegrabscreen
type: function
doc:
<comment>Description:</comment>
  Захватывает изображение с экрана
    
  
  Делает скриншот.
  
  Функция доступна только в Windows.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения, <info>false</info> в случае
                 возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagegrabwindow()</strong>


id: imagegrabwindow
type: function
doc:
<comment>Description:</comment>
  Захватывает изображение окна
  
  Делает снимок окна или его клиентской части, используя windows обработчик (свойство HWND COM
  объекта)
  
  Функция доступна только в Windows.

<comment>Param:</comment>
  <info>int</info>   <strong>$handle</strong>       ID окна HWND.
  <info>bool</info>  <strong>$client_area</strong>  Включает клиентскую часть окна приложения.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект изображения в случае успешного выполнения, <info>false</info> в случае
                 возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagegrabscreen()</strong>


id: imageinterlace
type: function
doc:
<comment>Description:</comment>
  Включение или выключение интерлейсинга
  
  <strong>imageinterlace()</strong> переключает состояние бита интерлейсинга.
  
  Если установить бит интерлейсинга, а изображение загрузить, как JPEG, это приведёт к созданию
  прогрессивного JPEG.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                       например, такой как <strong>imagecreatetruecolor()</strong>.
  <info></info>         <strong>$interlace</strong>  Если значение <info>true</info>, изображение будет разбито на чередующиеся строки, в
                       противном случае бит интерлейсинга будет установлен в <info>false</info>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если бит интерлейсинга установлен, <info>false</info> в противном случае.


id: imageistruecolor
type: function
doc:
<comment>Description:</comment>
  Определяет, является ли изображение полноцветным
    
  
  <strong>imageistruecolor()</strong> определяет, является ли изображение <strong>$image</strong> полноцветным.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если <strong>$image</strong> полноцветное, <info>false</info> в противном случае.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagepalettetotruecolor()</strong>


id: imagejpeg
type: function
doc:
<comment>Description:</comment>
  Выводит изображение в браузер или пишет в файл
  
  Функция <strong>imagejpeg()</strong> создаёт файл JPEG из изображения<strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>    Объект <class>GdImage</class>, возвращаемый одной из функций создания
                                  изображений,
                                  например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>     Путь, или открытый потоковый ресурс (который автоматически
                                  закрывается после завершения функции), для сохранения файла. Если
                                  не установлен или равен <info>null</info>, изображение будет выведено в поток
                                  вывода в бинарном виде.
  <info>int</info>                   <strong>$quality</strong>  Необязательный параметр, и может принимать значения в диапазоне от
                                  0 (низкое качество, маленький размер файла) до 100 (высокое
                                  качество, большой размер файла). По умолчанию (<return>-1</return>) используется
                                  качество IJG (около 75).

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagegif()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imageinterlace()</strong>
   * <strong>imagetypes()</strong>


id: imagelayereffect
type: function
doc:
<comment>Description:</comment>
  Установка флага альфа сопряжения для использования эффектов наложения изображений
    
  
  Установка флага альфа сопряжения для использования эффектов наложения изображений.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$effect</strong>  Одна из следующих констант: <info>IMG_EFFECT_REPLACE</info> Использовать замену пикселов
                    (аналогично передаче <info>true</info> в <strong>imagealphablending()</strong>) <info>IMG_EFFECT_ALPHABLEND</info>
                    Использовать обычное сопряжение цветов (аналогично передаче <info>false</info> в
                    <strong>imagealphablending()</strong>) <info>IMG_EFFECT_NORMAL</info> То же, что и <info>IMG_EFFECT_ALPHABLEND</info>.
                    <info>IMG_EFFECT_OVERLAY</info> В результате наложения картинки с этим эффектом чёрные и
                    белые пикселы фона изображения останутся так же чёрными и белыми, а серые
                    поменяют цвет на цвет пиксела накладываемого изображения. <info>IMG_EFFECT_MULTIPLY</info>
                    Оверлеи с множителем эффекта.
                    
                    Использовать замену пикселов (аналогично передаче <info>true</info> в <strong>imagealphablending()</strong>)
                    
                    Использовать обычное сопряжение цветов (аналогично передаче <info>false</info> в
                    <strong>imagealphablending()</strong>)
                    
                    То же, что и <info>IMG_EFFECT_ALPHABLEND</info>.
                    
                    В результате наложения картинки с этим эффектом чёрные и белые пикселы фона
                    изображения останутся так же чёрными и белыми, а серые поменяют цвет на цвет
                    пиксела накладываемого изображения.
                    
                    Оверлеи с множителем эффекта.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imageline
type: function
doc:
<comment>Description:</comment>
  Рисование линии
  
  Рисует линию соединяющую две точки.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     x-координата первой точки.
  <info>int</info>      <strong>$y1</strong>     y-координата первой точки.
  <info>int</info>      <strong>$x2</strong>     x-координата второй точки.
  <info>int</info>      <strong>$y2</strong>     y-координата второй точки.
  <info>int</info>      <strong>$color</strong>  Цвет линии. Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagecolorallocate()</strong>


id: imageloadfont
type: function
doc:
<comment>Description:</comment>
  Загрузка шрифта
  
  <strong>imageloadfont()</strong> загружает определённый пользователем шрифт и возвращает его идентификатор.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Формат файла шрифта двоичный и зависит от архитектуры системы. Это означает
                     необходимость генерировать файл шрифта на том же процессоре, на котором
                     работает PHP.
                     
                     Формат файла шрифтапозиция байтатип данных Cописаниебайты 0-3intколичество
                     символов в шрифтебайты 4-7int значение первого символа в шрифте (часто 32 -
                     пробел) байты 8-11intширина пиксела каждого символабайты 12-15intвысота пиксела
                     каждого символабайты 16-char массив с данными символов, один байт на пиксел в
                     каждом символе. Для всех кол-во*высота*ширина байт.

<comment>Return:</comment>
  <info>GdFont|false</info>  Возвращает экземпляр <class>GdFont</class> или <info>false</info> в случае возникновения ошибки.
                 Идентификатор шрифта, который всегда больше 5 для предотвращения конфликтов со
                встроенными шрифтами, либо <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagefontwidth()</strong>
   * <strong>imagefontheight()</strong>


id: imageopenpolygon
type: function
doc:
<comment>Description:</comment>
  Рисует открытый полигон
  
  Сигнатура, начиная с PHP 8.0.0 (не поддерживается с именованными аргументами)
  
  Альтернативный синтаксис (начиная с PHP 8.0.0)
  
  <strong>imageopenpolygon()</strong> рисует открытый полигон на заданном изображении (<strong>$image</strong>). В отличие от
  <strong>imagepolygon()</strong>, линия между последней и первой точкой не рисуется.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                        например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$points</strong>      Массив, содержащий вершины многоугольника, например: points[0]= x0points[1]=
                        y0points[2]= x1points[3]= y1
  <info>int</info>      <strong>$num_points</strong>  Общее число точек (вершин), должно быть не меньше 3.
                        
                        Если этот параметр опущен (смотрите альтернативный синтаксис), то массив
                        <strong>$points</strong> должен содержать чётное количество элементов и <strong>$num_points</strong> будет
                        вычислено как count($points)/2.
  <info>int</info>      <strong>$color</strong>       Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagepolygon()</strong>


id: imagepalettecopy
type: function
doc:
<comment>Description:</comment>
  Копирование палитры из одного изображения в другое
    
  
  <strong>imagepalettecopy()</strong> копирует палитру цветов из изображения <strong>$src</strong> в изображение <strong>$dst</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst</strong>  Объект результирующего изображения.
  <info>GdImage</info>  <strong>$src</strong>  Объект исходного изображения.

<comment>Return:</comment>
  <info>void</info>  Функция не возвращает значения после выполнения.


id: imagepalettetotruecolor
type: function
doc:
<comment>Description:</comment>
  Преобразует изображение на основе палитры в настоящий цвет
  
  Преобразует на основе палитры изображение, созданное функцией, такой как <strong>imagecreate()</strong> до
  настоящего (true) цвета изображения, как <strong>imagecreatetruecolor()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info>, если преобразование завершено, или если исходное изображение уже является
        изображением настоящего цвета, в противном случае возвращается <info>false</info>.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imageistruecolor()</strong>


id: imagepng
type: function
doc:
<comment>Description:</comment>
  Вывод PNG изображения в браузер или файл
    
  
  Выводит или сохраняет PNG изображение <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>    Объект <class>GdImage</class>, возвращаемый одной из функций создания
                                  изображений,
                                  например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>     Путь, или открытый потоковый ресурс (который автоматически
                                  закрывается после завершения функции), для сохранения файла. Если
                                  не установлен или равен <info>null</info>, изображение будет выведено в поток
                                  вывода в бинарном виде.
                                  
                                  Недопустимо передавать <info>null</info>, если не используются аргументы
                                  <strong>$quality</strong> и <strong>$filters</strong>.
  <info>int</info>                   <strong>$quality</strong>  Степень сжатия: от 0 (нет сжатия) до 9. По умолчанию (<return>-1</return>)
                                  используется значение по умолчанию сжатия zlib. Более подробно
                                  читайте в руководстве по zlib.
  <info>int</info>                   <strong>$filters</strong>  Позволяет уменьшить размер PNG файла. Это битовая маска, значением
                                  которой может быть комбинация констант <return>PNG_FILTER_XXX</return>. Для
                                  включения или выключения всех фильтров удобно воспользоваться
                                  константами <info>PNG_NO_FILTER</info> или <info>PNG_ALL_FILTERS</info> соответственно.
                                  Значение по умолчанию (<return>-1</return>) отключает фильтрацию.
                                  
                                  Параметр <strong>$filters</strong> игнорируется системной библиотекой libgd.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.
        
        Однако, если libgd не может вывести изображения, эта функция вернёт <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegif()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>
   * <strong>imagesavealpha()</strong>


id: imagepolygon
type: function
doc:
<comment>Description:</comment>
  Рисование многоугольника
  
  Сигнатура, начиная с PHP 8.0.0 (не поддерживается с именованными аргументами)
  
  Альтернативный синтаксис (объявлен устаревшим с PHP 8.1.0)
  
  <strong>imagepolygon()</strong> создаёт многоугольник в изображении <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                        например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$points</strong>      Массив вершин многоугольника: points[0]= x0points[1]= y0points[2]=
                        x1points[3]= y1
  <info>int</info>      <strong>$num_points</strong>  Общее число точек (вершин), должно быть не меньше 3.
                        
                        Если этот параметр опущен (смотрите альтернативный синтаксис), то массив
                        <strong>$points</strong> должен содержать чётное количество элементов и <strong>$num_points</strong> будет
                        вычислено как count($points)/2.
  <info>int</info>      <strong>$color</strong>       Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagefilledpolygon()</strong>
   * <strong>imageopenpolygon()</strong>
   * <strong>imagecreate()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagerectangle
type: function
doc:
<comment>Description:</comment>
  Рисование прямоугольника
  
  <strong>imagerectangle()</strong> рисует прямоугольник с заданными координатами углов.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     Верхняя левая x координата.
  <info>int</info>      <strong>$y1</strong>     Верхняя левая y координата 0, 0 - левый верхний угол изображения.
  <info>int</info>      <strong>$x2</strong>     Нижняя правая x координата.
  <info>int</info>      <strong>$y2</strong>     Нижняя правая y координата.
  <info>int</info>      <strong>$color</strong>  Идентификатор цвета, созданный функцией <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imageresolution
type: function
doc:
<comment>Description:</comment>
  Получить или установить разрешение изображения
  
  <strong>imageresolution()</strong> позволяет установить и получить разрешение изображения в DPI (точек на дюйм).
  Если необязательные параметры указаны как <info>null</info>, то будет возращено текущее разрешение в виде
  индексированного массива. Если только <strong>$resolution_x</strong> не является <info>null</info>, для горизонтального и
  вертикального разрешения будет установлено это значение. Если все необязательные параметры не
  являются <info>null</info>, для горизонтального и вертикального разрешения устанавливаются эти значения
  соответственно.
  
  Разрешение используется только как метаданные во время чтения или записи изображений в форматы,
  которые поддерживают этот вид данных (на данный момент это PNG и JPEG). Это никак не влияет на
  любые операции рисования. Разрешение по умолчанию для новых изображений — 96 DPI.

<comment>Param:</comment>
  <info>GdImage</info>   <strong>$image</strong>         Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                           например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int|null</info>  <strong>$resolution_x</strong>  Горизонтальное разрешение в DPI.
  <info>int|null</info>  <strong>$resolution_y</strong>  Вертикальное разрешение в DPI.

<comment>Return:</comment>
  <info>array|bool</info>  Когда используется для получения информации о разрешении изображения, в случае
              успешного выполнения возвращается индексированный массив с информацией о
              горизонтальном и вертикальном разрешении или <info>false</info> в случае возникновения ошибки.
              Когда используется для установки разрешения изображения, в случае успешного выполнения
              возвращается <info>true</info> или <info>false</info> в случае возникновения ошибки.


id: imagerotate
type: function
doc:
<comment>Description:</comment>
  Поворот изображения с заданным углом
  
  Поворот изображения <strong>$image</strong> на заданный угол <strong>$angle</strong> в градусах.
  
  Центром поворота является центр изображения. Поворачиваемое изображение может отличаться размером
  от оригинала.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>             Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                              например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$angle</strong>             Угол поворота в градусах против часовой стрелки.
  <info>int</info>      <strong>$background_color</strong>  Цвет фона свободной зоны после поворота.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект повёрнутого изображения в случае успешного выполнения или <info>false</info> в
                 случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagesetinterpolation()</strong>


id: imagesavealpha
type: function
doc:
<comment>Description:</comment>
  Сохранять ли полную информацию альфа-канала при сохранении изображений
  
  <strong>imagesavealpha()</strong> устанавливает флаг, определяющий, будет ли сохраняться полная информация
  альфа-канала (в противовес одноцветной прозрачности) и сохраняет изображение. Поддерживается
  только для форматов изображений, которые содержат полную информацию об альфа-канале, т.е. <return>PNG</return>,
  <return>WebP</return> и <return>AVIF</return>.  Функция <strong>imagesavealpha()</strong> имеет смысл только для изображений <return>PNG</return>, поскольку для <return>WebP</return>
  и <return>AVIF</return> всегда сохраняется полный альфа-канал. Не рекомендуется полагаться на это поведение, так
  как оно может измениться в будущем. Таким образом, функцию <strong>imagesavealpha()</strong> следует вызывать
  намеренно также для изображений <return>WebP</return> и <return>AVIF</return>.
  
  Функция <strong>imagesavealpha()</strong> имеет смысл только для изображений <return>PNG</return>, поскольку для <return>WebP</return> и <return>AVIF</return> всегда
  сохраняется полный альфа-канал. Не рекомендуется полагаться на это поведение, так как оно может
  измениться в будущем. Таким образом, функцию <strong>imagesavealpha()</strong> следует вызывать намеренно также для
  изображений <return>WebP</return> и <return>AVIF</return>.
  
  Альфа-смешивание должно быть отключено (imagealphablending($im, false)), чтобы альфа-канал
  сохранялся в первую очередь.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>     <strong>$enable</strong>  Требуется ли сохранять альфа канал или нет. По умолчанию <info>false</info>.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagealphablending()</strong>


id: imagescale
type: function
doc:
<comment>Description:</comment>
  Масштабировать изображение по заданной ширине и высоте
  
  <strong>imagescale()</strong> масштабирует изображение, используя заданный алгоритм интерполяции.
  
  В отличие от многих функций по работе с изображениями, <strong>imagescale()</strong> не изменяет переданный
  параметр <strong>$image</strong>; вместо него будет возвращено новое изображение.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$width</strong>   Ширина для масштабирования.
  <info>int</info>      <strong>$height</strong>  Высота для масштабирования изображения. Если этот параметр опущен или
                    отрицателен, соотношение сторон будет сохранено.
  <info>int</info>      <strong>$mode</strong>    Одна из констант <info>IMG_NEAREST_NEIGHBOUR</info>, <info>IMG_BILINEAR_FIXED</info>, <info>IMG_BICUBIC</info>,
                    <info>IMG_BICUBIC_FIXED</info> или что-либо ещё (будет использовано два прохода).
                    <info>IMG_WEIGHTED4</info> пока ещё не поддерживается.
                    
                    <info>IMG_WEIGHTED4</info> пока ещё не поддерживается.

<comment>Return:</comment>
  <info>GdImage|false</info>  Возвращает объект масштабированного изображения в случае успешного выполнения или
                 <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagecopyresized()</strong>
   * <strong>imagecopyresampled()</strong>


id: imagesetbrush
type: function
doc:
<comment>Description:</comment>
  Установка изображения (кисти), посредством которого будут рисоваться линии
    
  
  <strong>imagesetbrush()</strong> задаёт изображение, которое будет использоваться функциями для рисования линий
  (такими как <strong>imageline()</strong> и <strong>imagepolygon()</strong>) при использовании цветов <info>IMG_COLOR_BRUSHED</info> или
  <info>IMG_COLOR_STYLEDBRUSHED</info>.
  
  Дополнительных действий после завершения работы с кистью не требуется, однако если изображение
  кисти уничтожено, нельзя пользоваться цветами <info>IMG_COLOR_BRUSHED</info> или <info>IMG_COLOR_STYLEDBRUSHED</info>, пока
  не будет установлено новое изображение кисти!

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>GdImage</info>  <strong>$brush</strong>  Объект изображения.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.


id: imagesetclip
type: function
doc:
<comment>Description:</comment>
  Установите прямоугольник ограничения
  
  <strong>imagesetclip()</strong> задаёт текущий прямоугольник ограничения, т.е. область, за пределами которой не
  будут отрисовываться пиксели.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                   например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     Координата по x верхнего левого угла.
  <info>int</info>      <strong>$y1</strong>     Координата по y верхнего левого угла.
  <info>int</info>      <strong>$x2</strong>     Координата по x нижнего левого угла.
  <info>int</info>      <strong>$y2</strong>     Координата по y нижнего правого угла.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagegetclip()</strong>


id: imagesetinterpolation
type: function
doc:
<comment>Description:</comment>
  Устанавливает метод интерполяции
  
  Устанавливает метод интерполяции, установка метода интерполяции влияет на отображение различных
  функций в GD, таких как функция <strong>imagerotate()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Объект <class>GdImage</class>, возвращаемый одной из функций создания изображений,
                    например, такой как <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$method</strong>  Метод интерполяции, который может быть одним из следующих: <info>IMG_BELL</info>: Фильтр
                    Белла. <info>IMG_BESSEL</info>: Фильтр Бесселя. <info>IMG_BICUBIC</info>: Бикубическая интерполяция.
                    <info>IMG_BICUBIC_FIXED</info>: Фиксированная точка реализации бикубической интерполяции.
                    <info>IMG_BILINEAR_FIXED</info>: Реализация билинейной интерполяции с фиксированной запятой
                    (<return>по умолчанию (также при создании изображения)</return>). <info>IMG_BLACKMAN</info>: Оконная функция
                    Блэкмана. <info>IMG_BOX</info>: Фильтр Коробка размытия. <info>IMG_BSPLINE</info>: Сплайн-интерполяция.
                    <info>IMG_CATMULLROM</info>: Кубическая эрмитовая сплайн-интерполяция. <info>IMG_GAUSSIAN</info>: Гауссова
                    функция. <info>IMG_GENERALIZED_CUBIC</info>: Обобщённая кубическая сплайн-фрактальная
                    интерполяция. <info>IMG_HERMITE</info>: Интерполяция Эрмита. <info>IMG_HAMMING</info>: Фильтр Хэмминга.
                    <info>IMG_HANNING</info>: Фильтр Хеннинга. <info>IMG_MITCHELL</info>: Фильтр Митчелла. <info>IMG_POWER</info>:
                    Степенная интерполяция. <info>IMG_QUADRATIC</info>: Обратная квадратичная интерполяция.
                    <info>IMG_SINC</info>: Синк функция. <info>IMG_NEAREST_NEIGHBOUR</info>: Интерполяция ближайшего соседа.
                    <info>IMG_WEIGHTED4</info>: Весовой фильтр. <info>IMG_TRIANGLE</info>: Треугольная интерполяция.
                    
                    <info>IMG_BELL</info>: Фильтр Белла.
                    
                    <info>IMG_BESSEL</info>: Фильтр Бесселя.
                    
                    <info>IMG_BICUBIC</info>: Бикубическая интерполяция.
                    
                    <info>IMG_BICUBIC_FIXED</info>: Фиксированная точка реализации бикубической интерполяции.
                    
                    <info>IMG_BILINEAR_FIXED</info>: Реализация билинейной интерполяции с фиксированной запятой
                    (<return>по умолчанию (также при создании изображения)</return>).
                    
                    <info>IMG_BLACKMAN</info>: Оконная функция Блэкмана.
                    
                    <info>IMG_BOX</info>: Фильтр Коробка размытия.
                    
                    <info>IMG_BSPLINE</info>: Сплайн-интерполяция.
                    
                    <info>IMG_CATMULLROM</info>: Кубическая эрмитовая сплайн-интерполяция.
                    
                    <info>IMG_GAUSSIAN</info>: Гауссова функция.
                    
                    <info>IMG_GENERALIZED_CUBIC</info>: Обобщённая кубическая сплайн-фрактальная интерполяция.
                    
                    <info>IMG_HERMITE</info>: Интерполяция Эрмита.
                    
                    <info>IMG_HAMMING</info>: Фильтр Хэмминга.
                    
                    <info>IMG_HANNING</info>: Фильтр Хеннинга.
                    
                    <info>IMG_MITCHELL</info>: Фильтр Митчелла.
                    
                    <info>IMG_POWER</info>: Степенная интерполяция.
                    
                    <info>IMG_QUADRATIC</info>: Обратная квадратичная интерполяция.
                    
                    <info>IMG_SINC</info>: Синк функция.
                    
                    <info>IMG_NEAREST_NEIGHBOUR</info>: Интерполяция ближайшего соседа.
                    
                    <info>IMG_WEIGHTED4</info>: Весовой фильтр.
                    
                    <info>IMG_TRIANGLE</info>: Треугольная интерполяция.

<comment>Return:</comment>
  <info>bool</info>  Возвращает <info>true</info> в случае успешного выполнения или <info>false</info> в случае возникновения ошибки.

<comment>See Also:</comment>
   * <strong>imagegetinterpolation()</strong>


