<?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 => 'zh',
  ),
  'this' => 
  array (
    0 => 'book.ffi.php',
    1 => 'FFI',
    2 => '外部函数接口',
  ),
  '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' => 'zh',
    '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">外部函数接口</h1>
 

 <div id="intro.ffi" class="preface">
  <h1 class="title">简介</h1>
  <p class="simpara">
   此扩展允许在纯 PHP 中加载共享库（<var class="filename">.DLL</var> 或
   <var class="filename">.so</var>）、调用 C 函数、访问 C
   数据结构，而无需深入了解 Zend 扩展 API，也无需学习第三方“中间”语言。公共 API
   是使用包含几个静态方法（有几个可以动态调用）和对象重载方法（执行与 C 数据的实际交互）的 <span class="classname"><a href="class.ffi.php" class="classname">FFI</a></span> 类实现的。
  </p>
  <div class="caution"><strong class="caution">警告</strong>
   <p class="simpara">
    FFI 有危险，因为它允许在系统上进行底层交互。FFI 扩展应该仅供有 C 和使用 C API
    经验的开发者使用。为了最大限度降低风险，<a href="ffi.configuration.php#ini.ffi.enable" class="link">ffi.enable</a> <var class="filename">php.ini</var> 指令会限制 FFI API
    的使用。
   </p>
  </div>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    FFI 扩展不会提供讨厌的过时 PHP 扩展 API，它仅仅是提供了用于 C 函数和数据结构的特殊接口。
   </span>
  </p></blockquote>
  <div class="tip"><strong class="tip">小技巧</strong>
   <p class="simpara">
    目前，访问 FFI 数据结构比访问原生 PHP 数组和对象慢很多（大约 2 倍）。
    因此使用 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">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> — Creates an unmanaged pointer to C data</li><li><a href="ffi.alignof.php">FFI::alignof</a> — Gets the alignment</li><li><a href="ffi.arraytype.php">FFI::arrayType</a> — Dynamically constructs a new C array type</li><li><a href="ffi.cast.php">FFI::cast</a> — Performs a C type cast</li><li><a href="ffi.cdef.php">FFI::cdef</a> — Creates a new FFI object</li><li><a href="ffi.free.php">FFI::free</a> — Releases an unmanaged data structure</li><li><a href="ffi.isnull.php">FFI::isNull</a> — Checks whether a FFI\CData is a null pointer</li><li><a href="ffi.load.php">FFI::load</a> — Loads C declarations from a C header file</li><li><a href="ffi.memcmp.php">FFI::memcmp</a> — Compares memory areas</li><li><a href="ffi.memcpy.php">FFI::memcpy</a> — Copies one memory area to another</li><li><a href="ffi.memset.php">FFI::memset</a> — Fills a memory area</li><li><a href="ffi.new.php">FFI::new</a> — Creates a C data structure</li><li><a href="ffi.scope.php">FFI::scope</a> — Instantiates an FFI object with C declarations parsed during preloading</li><li><a href="ffi.sizeof.php">FFI::sizeof</a> — Gets the size of C data or types</li><li><a href="ffi.string.php">FFI::string</a> — Creates a PHP string from a memory area</li><li><a href="ffi.type.php">FFI::type</a> — Creates an FFI\CType object from a C declaration</li><li><a href="ffi.typeof.php">FFI::typeof</a> — Gets the FFI\CType of FFI\CData</li></ul></li><li><a href="class.ffi-cdata.php">FFI\CData</a> — C Data Handles</li><li><a href="class.ffi-ctype.php">FFI\CType</a> — C Type Handles<ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi-ctype.getalignment.php">FFI\CType::getAlignment</a> — Description</li><li><a href="ffi-ctype.getarrayelementtype.php">FFI\CType::getArrayElementType</a> — Description</li><li><a href="ffi-ctype.getarraylength.php">FFI\CType::getArrayLength</a> — Description</li><li><a href="ffi-ctype.getattributes.php">FFI\CType::getAttributes</a> — Description</li><li><a href="ffi-ctype.getenumkind.php">FFI\CType::getEnumKind</a> — Description</li><li><a href="ffi-ctype.getfuncabi.php">FFI\CType::getFuncABI</a> — Description</li><li><a href="ffi-ctype.getfuncparametercount.php">FFI\CType::getFuncParameterCount</a> — Retrieve the count of parameters of a function type</li><li><a href="ffi-ctype.getfuncparametertype.php">FFI\CType::getFuncParameterType</a> — Retrieve the type of a function parameter</li><li><a href="ffi-ctype.getfuncreturntype.php">FFI\CType::getFuncReturnType</a> — Description</li><li><a href="ffi-ctype.getkind.php">FFI\CType::getKind</a> — Description</li><li><a href="ffi-ctype.getname.php">FFI\CType::getName</a> — Description</li><li><a href="ffi-ctype.getpointertype.php">FFI\CType::getPointerType</a> — Description</li><li><a href="ffi-ctype.getsize.php">FFI\CType::getSize</a> — Description</li><li><a href="ffi-ctype.getstructfieldnames.php">FFI\CType::getStructFieldNames</a> — Description</li><li><a href="ffi-ctype.getstructfieldoffset.php">FFI\CType::getStructFieldOffset</a> — Description</li><li><a href="ffi-ctype.getstructfieldtype.php">FFI\CType::getStructFieldType</a> — Description</li></ul></li><li><a href="class.ffi-exception.php">FFI\Exception</a> — FFI Exceptions</li><li><a href="class.ffi-parserexception.php">FFI\ParserException</a> — FFI Parser Exceptions</li></ul></div><?php manual_footer($setup); ?>