<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.basic.php.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'book.ffi.php',
    1 => 'FFI',
    2 => 'Интерфейс внешней функции (Foreign Function Interface)',
  ),
  'up' => 
  array (
    0 => 'refs.basic.php.php',
    1 => 'Изменение поведения PHP',
  ),
  'prev' => 
  array (
    0 => 'function.user-error.php',
    1 => 'user_error',
  ),
  'next' => 
  array (
    0 => 'ffi.setup.php',
    1 => 'Установка и настройка',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/ffi/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.ffi.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.ffi" class="book">
 
 <h1 class="title">Интерфейс внешней функции (Foreign Function Interface)</h1>
 

 <div id="intro.ffi" class="preface">
  <h1 class="title">Введение</h1>
  <p class="simpara">
   Модуль умеет загружать общие библиотеки (<var class="filename">.DLL</var>
   или <var class="filename">.so</var>), вызывать C-функции и получать
   доступ с структурам языка C из PHP без глубокого изучения
   API модулей Zend и стороннего «промежуточного» языка.
   Публичный API реализовали как единственный класс <span class="classname"><a href="class.ffi.php" class="classname">FFI</a></span>
   с набором статических методов (часть методов
   вызывается динамически) и переопределёнными методами
   объекта, которые фактически взаимодействуют с данными языка C.
  </p>
  <div class="caution"><strong class="caution">Предостережение</strong>
   <p class="simpara">
    Модуль FFI довольно опасен, поскольку разрешает
    взаимодействовать с системой на низком уровне.
    С модулем FFI должны работать только те разработчики,
    которые знакомы с языком С и умеют работать с API языка.
    Чтобы уменьшить риски, модуль запрещают
    директивой <a href="ffi.configuration.php#ini.ffi.enable" class="link">ffi.enable</a>
    в файле <var class="filename">php.ini</var>.
   </p>
  </div>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Модуль FFI не делает классический API модулей PHP устаревшим;
    модуль разработали для взаимодействия с функциями и структурами данных
    языка C.
   </span>
  </p></blockquote>
  <div class="tip"><strong class="tip">Подсказка</strong>
   <p class="simpara">
    Доступ к структурам данных модуля FFI примерно в 2 раза
    медленнее, чем доступ к объектам и массивам PHP. Поэтому
    нет повода использовать FFI для ускорения;
    однако с модулем работают, чтобы сократить потребление памяти.
   </p>
  </div>
 </div>

 





 





 





 





 





 





 





<ul class="chunklist chunklist_book"><li><a href="ffi.setup.php">Установка и настройка</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.requirements.php">Требования</a></li><li><a href="ffi.installation.php">Установка</a></li><li><a href="ffi.configuration.php">Настройка во время выполнения</a></li></ul></li><li><a href="ffi.examples.php">Примеры</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.examples-basic.php">Базовая работа с модулем FFI</a></li><li><a href="ffi.examples-callback.php">Callback-функции PHP</a></li><li><a href="ffi.examples-complete.php">Комплексный пример PHP/FFI/preloading</a></li></ul></li><li><a href="class.ffi.php">FFI</a> — Основной интерфейс к коду и данным языка C<ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.addr.php">FFI::addr</a> — Создаёт неуправляемый указатель на данные C</li><li><a href="ffi.alignof.php">FFI::alignof</a> — Возвращает величину выравнивания</li><li><a href="ffi.arraytype.php">FFI::arrayType</a> — Динамически конструирует новый тип С массива</li><li><a href="ffi.cast.php">FFI::cast</a> — Приводит тип C</li><li><a href="ffi.cdef.php">FFI::cdef</a> — Создаёт новый объект FFI</li><li><a href="ffi.free.php">FFI::free</a> — Высвобождает неуправляемую структуру данных</li><li><a href="ffi.isnull.php">FFI::isNull</a> — Проверяет, является ли FFI\CData нулевым указателем</li><li><a href="ffi.load.php">FFI::load</a> — Загружает декларации C из заголовочного файла</li><li><a href="ffi.memcmp.php">FFI::memcmp</a> — Сравнивает две области памяти</li><li><a href="ffi.memcpy.php">FFI::memcpy</a> — Копирует содержимое одной области памяти в другую</li><li><a href="ffi.memset.php">FFI::memset</a> — Заполнить область памяти</li><li><a href="ffi.new.php">FFI::new</a> — Создаёт структуру данных C</li><li><a href="ffi.scope.php">FFI::scope</a> — Инстанциирует объект FFI в соответствии с декларацией
   С, разобранной на этапе предзагрузки</li><li><a href="ffi.sizeof.php">FFI::sizeof</a> — Возвращает размер данных или типа C</li><li><a href="ffi.string.php">FFI::string</a> — Создаёт строку PHP из области памяти</li><li><a href="ffi.type.php">FFI::type</a> — Создаёт объект класса FFI\CType из объявления С</li><li><a href="ffi.typeof.php">FFI::typeof</a> — Получает FFI\CType для FFI\CData</li></ul></li><li><a href="class.ffi-cdata.php">FFI\CData</a> — Доступ к данным C</li><li><a href="class.ffi-ctype.php">FFI\CType</a> — Доступ к типам C<ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi-ctype.getalignment.php">FFI\CType::getAlignment</a> — Описание</li><li><a href="ffi-ctype.getarrayelementtype.php">FFI\CType::getArrayElementType</a> — Описание</li><li><a href="ffi-ctype.getarraylength.php">FFI\CType::getArrayLength</a> — Описание</li><li><a href="ffi-ctype.getattributes.php">FFI\CType::getAttributes</a> — Описание</li><li><a href="ffi-ctype.getenumkind.php">FFI\CType::getEnumKind</a> — Описание</li><li><a href="ffi-ctype.getfuncabi.php">FFI\CType::getFuncABI</a> — Описание</li><li><a href="ffi-ctype.getfuncparametercount.php">FFI\CType::getFuncParameterCount</a> — Извлекает количество параметров типа функции</li><li><a href="ffi-ctype.getfuncparametertype.php">FFI\CType::getFuncParameterType</a> — Получает тип параметра функции</li><li><a href="ffi-ctype.getfuncreturntype.php">FFI\CType::getFuncReturnType</a> — Описание</li><li><a href="ffi-ctype.getkind.php">FFI\CType::getKind</a> — Описание</li><li><a href="ffi-ctype.getname.php">FFI\CType::getName</a> — Описание</li><li><a href="ffi-ctype.getpointertype.php">FFI\CType::getPointerType</a> — Описание</li><li><a href="ffi-ctype.getsize.php">FFI\CType::getSize</a> — Описание</li><li><a href="ffi-ctype.getstructfieldnames.php">FFI\CType::getStructFieldNames</a> — Описание</li><li><a href="ffi-ctype.getstructfieldoffset.php">FFI\CType::getStructFieldOffset</a> — Описание</li><li><a href="ffi-ctype.getstructfieldtype.php">FFI\CType::getStructFieldType</a> — Описание</li></ul></li><li><a href="class.ffi-exception.php">FFI\Exception</a> — Исключения FFI</li><li><a href="class.ffi-parserexception.php">FFI\ParserException</a> — Исключения парсера FFI</li></ul></div><?php manual_footer($setup); ?>