archived-doc-ru/reference/image/setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9ba738103b63ee4f129dadf3f8585568609e63b7 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="image.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <!-- {{{ Requirements -->
 <section xml:id="image.requirements">
  &reftitle.required;
  <para>
   Через модуль <acronym>GD</acronym> (доступ к скачиванию даёт страница <link
   xlink:href="&url.gd;">&url.gd;</link>) создают и изменяют
   изображения.
  </para>
  <para>
   Форматы изображений, с которыми модуль <acronym>GD</acronym> будет работать,
   зависят от установленной версии модуля, а также от других модулей, которые
   потребуются <acronym>GD</acronym> для доступа к форматам этих модулей.
   <note>
    <simpara>
     Требуется libgd-2.1.0 или выше.
     Как альтернативой пользуются модулем <acronym>GD</acronym>, который входит в дистрибутив PHP.
    </simpara>
   </note>
   <note>
    <simpara>
     Для работы модуля <acronym>GD</acronym> требуется модуль zlib &gt;= 1.2.0.4.
    </simpara>
   </note>
  </para>
  <para>
   Иногда требуется усовершенствовать функции модуля <acronym>GD</acronym>
   для работы с бо́льшим количеством графических форматов.
   <table>
   <title>Форматы изображений, которые поддерживает модуль GD</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Формат изображения</entry>
       <entry>Необходимая библиотека</entry>
       <entry>Замечания</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>gif</literal></entry>
       <entry></entry>
       <entry></entry>
      </row>
      <row>
       <entry><literal>avif</literal></entry>
       <entry></entry>
       <entry></entry>
      </row>
      <row>
       <entry><literal>jpeg</literal></entry>
       <entry><link xlink:href="&url.jpeg;">&url.jpeg;</link></entry>
       <entry>
        При сборке библиотеки jpeg (перед сборкой PHP) необходимо использовать
        опцию <option role="configure">--enable-shared</option>
        на этапе конфигурирования. Если этого не сделать, на этапе конфигурирования
        PHP-сборки выдаётся ошибка <literal>libjpeg.(a|so) not found</literal>.
       </entry>
      </row>
      <row>
       <entry><literal>png</literal></entry>
       <entry><link xlink:href="&url.libpng;">&url.libpng;</link></entry>
       <entry>
       </entry>
      </row>
      <row>
       <entry><literal>xpm</literal></entry>
       <entry><link xlink:href="&url.libxpm;">&url.libxpm;</link></entry>
       <entry>
        Скорее всего, система уже содержит библиотеку, если раньше в систему
        установили окружение X-Environment.
       </entry>
      </row>
      <row>
       <entry><literal>webp</literal></entry>
       <entry></entry>
       <entry></entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <para>
   Иногда требуется усовершенствовать функции модуля <acronym>GD</acronym>
   для работы с бо́льшим набором шрифтов.
   PHP поддерживает библиотеку <link xlink:href="&url.freetype;">FreeType 2</link>.
  </para>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 &reference.image.configure;
 <!-- }}} -->

 <!-- {{{ Configuration -->
 &reference.image.ini;
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="image.resources">
  &reftitle.resources;
  <para>
   Модуль определяет следующие типы ресурсов:
   <table>
   <title>Список типов ресурсов в модуле GD</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Имя</entry>
       <entry>Описание</entry>
       <entry>Замечания</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>gd</literal></entry>
       <entry>
        Ресурс изображения, с которым работают функции наподобие <function>imagecreatefrompng</function>.
       </entry>
       <entry>
        До PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>gd font</literal></entry>
       <entry>
        Ресурс шрифта, который внутренне создаёт функция <function>imageloadfont</function>.
       </entry>
       <entry>
        До PHP 8.1.0.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </section>
 <!-- }}} -->

</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->