<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'book.ffi.php',
    1 => 'FFI',
    2 => 'Interfaz de funci&oacute;n externa (Foreign Function Interface)',
  ),
  'up' => 
  array (
    0 => 'refs.basic.php.php',
    1 => 'Afecta el comportamiento de PHP',
  ),
  'prev' => 
  array (
    0 => 'function.user-error.php',
    1 => 'user_error',
  ),
  'next' => 
  array (
    0 => 'ffi.setup.php',
    1 => 'Instalaci&oacute;n/Configuraci&oacute;n',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    '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">Interfaz de función externa (Foreign Function Interface)</h1>
 

 <div id="intro.ffi" class="preface">
  <h1 class="title">Introducción</h1>
  <p class="simpara">
   Esta extensión permite cargar bibliotecas compartidas (<var class="filename">.DLL</var> o
   <var class="filename">.so</var>), llamar a funciones C y acceder a estructuras de datos C desde PHP, sin necesidad de conocer la API de extensión Zend, y sin tener que aprender un tercer lenguaje &quot;intermedio&quot;.
   La API pública se implementa en forma de una clase única <span class="classname"><a href="class.ffi.php" class="classname">FFI</a></span> con
   varios métodos estáticos (algunos de los cuales pueden ser llamados dinámicamente), y
   métodos de objeto sobrecargados, que realizan la interacción real con los datos C.
  </p>
  <div class="caution"><strong class="caution">Precaución</strong>
   <p class="simpara">
    La extensión FFI es peligrosa, ya que permite interfaces con el sistema a un nivel muy bajo.
    Solo debe ser utilizada por desarrolladores con conocimiento práctico del lenguaje C
    y de las API C utilizadas. Para minimizar los riesgos, el uso de la API FFI puede ser restringido
    con la directiva <var class="filename">php.ini</var> <a href="ffi.configuration.php#ini.ffi.enable" class="link">ffi.enable</a>.
   </p>
  </div>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    La extensión FFI no hace obsoleta la API de extensión clásica de PHP;
    simplemente se proporciona para la interfaz ad-hoc con funciones y estructuras de datos C.
   </span>
  </p></blockquote>
  <div class="tip"><strong class="tip">Sugerencia</strong>
   <p class="simpara">
    Actualmente, el acceso a las estructuras de datos FFI es significativamente (aproximadamente 2 veces) más lento
    que el acceso a los arrays y objetos nativos de PHP. Por lo tanto, no es útil utilizar
    la extensión FFI para la velocidad; sin embargo, puede ser aconsejable utilizarla para reducir
    el uso de memoria.
   </p>
  </div>
 </div>

 






 






 






 






 






 






 






<ul class="chunklist chunklist_book"><li><a href="ffi.setup.php">Instalaci&oacute;n/Configuraci&oacute;n</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.requirements.php">Requerimientos</a></li><li><a href="ffi.installation.php">Instalaci&oacute;n</a></li><li><a href="ffi.configuration.php">Configuraci&oacute;n en tiempo de ejecuci&oacute;n</a></li></ul></li><li><a href="ffi.examples.php">Ejemplos</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.examples-basic.php">Uso b&aacute;sico de FFI</a></li><li><a href="ffi.examples-callback.php">Funciones de retrollamada</a></li><li><a href="ffi.examples-complete.php">Un ejemplo completo de PHP/FFI/precarga</a></li></ul></li><li><a href="class.ffi.php">FFI</a> — Interfaz principal para el c&oacute;digo C y los datos<ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.addr.php">FFI::addr</a> — Crea un puntero no gestionado hacia datos C</li><li><a href="ffi.alignof.php">FFI::alignof</a> — Recupera el alineamiento</li><li><a href="ffi.arraytype.php">FFI::arrayType</a> — Construye din&aacute;micamente un nuevo tipo de array C</li><li><a href="ffi.cast.php">FFI::cast</a> — Realiza una conversi&oacute;n de tipo C</li><li><a href="ffi.cdef.php">FFI::cdef</a> — Crea un nuevo objeto FFI</li><li><a href="ffi.free.php">FFI::free</a> — Libera una estructura de datos no gestionada</li><li><a href="ffi.isnull.php">FFI::isNull</a> — Verifica si un objeto FFI\CData es un puntero nulo</li><li><a href="ffi.load.php">FFI::load</a> — Carga las declaraciones C desde un archivo de encabezado C</li><li><a href="ffi.memcmp.php">FFI::memcmp</a> — Comparaci&oacute;n de zonas de memoria</li><li><a href="ffi.memcpy.php">FFI::memcpy</a> — Copia de una zona de memoria en otra</li><li><a href="ffi.memset.php">FFI::memset</a> — Rellena una zona de memoria</li><li><a href="ffi.new.php">FFI::new</a> — Crea una estructura de datos C</li><li><a href="ffi.scope.php">FFI::scope</a> — Instancia un objeto FFI con las declaraciones C analizadas durante la precarga</li><li><a href="ffi.sizeof.php">FFI::sizeof</a> — Recupera el tama&ntilde;o de los datos o tipos C</li><li><a href="ffi.string.php">FFI::string</a> — Crea una string PHP a partir de una zona de memoria</li><li><a href="ffi.type.php">FFI::type</a> — Crea un objeto FFI\CType a partir de una declaraci&oacute;n C</li><li><a href="ffi.typeof.php">FFI::typeof</a> — Recupera el FFI\CType de FFI\CData</li></ul></li><li><a href="class.ffi-cdata.php">FFI\CData</a> — Gestor de datos C</li><li><a href="class.ffi-ctype.php">FFI\CType</a> — Gestor de tipo C<ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi-ctype.getalignment.php">FFI\CType::getAlignment</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getarrayelementtype.php">FFI\CType::getArrayElementType</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getarraylength.php">FFI\CType::getArrayLength</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getattributes.php">FFI\CType::getAttributes</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getenumkind.php">FFI\CType::getEnumKind</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getfuncabi.php">FFI\CType::getFuncABI</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getfuncparametercount.php">FFI\CType::getFuncParameterCount</a> — Recuperar el n&uacute;mero de argumentos de un tipo de funci&oacute;n</li><li><a href="ffi-ctype.getfuncparametertype.php">FFI\CType::getFuncParameterType</a> — Recuperar el tipo de un par&aacute;metro de funci&oacute;n</li><li><a href="ffi-ctype.getfuncreturntype.php">FFI\CType::getFuncReturnType</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getkind.php">FFI\CType::getKind</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getname.php">FFI\CType::getName</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getpointertype.php">FFI\CType::getPointerType</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getsize.php">FFI\CType::getSize</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getstructfieldnames.php">FFI\CType::getStructFieldNames</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getstructfieldoffset.php">FFI\CType::getStructFieldOffset</a> — Descripci&oacute;n</li><li><a href="ffi-ctype.getstructfieldtype.php">FFI\CType::getStructFieldType</a> — Descripci&oacute;n</li></ul></li><li><a href="class.ffi-exception.php">Excepciones FFI</a></li><li><a href="class.ffi-parserexception.php">FFI\ParserException</a> — Excepciones del analizador sint&aacute;ctico FFI</li></ul></div><?php manual_footer($setup); ?>