<?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 => 'fr',
  ),
  'this' => 
  array (
    0 => 'book.ffi.php',
    1 => 'FFI',
    2 => 'Interface de fonction &eacute;trang&egrave;re (Foreign Function Interface)',
  ),
  'up' => 
  array (
    0 => 'refs.basic.php.php',
    1 => 'Affecte le comportement de PHP',
  ),
  'prev' => 
  array (
    0 => 'function.user-error.php',
    1 => 'user_error',
  ),
  'next' => 
  array (
    0 => 'ffi.setup.php',
    1 => 'Installation/Configuration',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    '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">Interface de fonction étrangère (Foreign Function Interface)</h1>
 

 <div id="intro.ffi" class="preface">
  <h1 class="title">Introduction</h1>
  <p class="simpara">
   Cette extension permet de charger des bibliothèques partagées (<var class="filename">.DLL</var> ou
   <var class="filename">.so</var>), l&#039;appel à des fonctions C et l&#039;accès à des structures de données C
   à partir de PHP, sans avoir à connaître l&#039;API d&#039;extension Zend, et sans avoir à apprendre
   un troisième langage &quot;intermédiaire&quot;.
   L&#039;API publique est implémentée sous la forme d&#039;une classe unique <span class="classname"><a href="class.ffi.php" class="classname">FFI</a></span> avec
   plusieurs méthodes statiques (certaines d&#039;entre elles peuvent être appelées dynamiquement), et
   des méthodes d&#039;objet surchargées, qui effectuent l&#039;interaction réelle avec les données C.
  </p>
  <div class="caution"><strong class="caution">Attention</strong>
   <p class="simpara">
    L&#039;extension FFI est dangereuse, car elle permet de s&#039;interfacer avec le système à un niveau très bas.
    Elle ne doit être utilisée que par des développeurs ayant une connaissance pratique du langage C
    et des API C utilisées. Pour minimiser les risques, l&#039;utilisation de l&#039;API FFI peut être restreinte
    avec la directive <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">Note</strong>: 
   <span class="simpara">
    L&#039;extension FFI ne rend pas obsolète l&#039;API d&#039;extension classique de PHP;
    elle est simplement fournie pour l&#039;interfaçage ad-hoc avec des fonctions et des structures de données C.
   </span>
  </p></blockquote>
  <div class="tip"><strong class="tip">Astuce</strong>
   <p class="simpara">
    Actuellement, l&#039;accès aux structures de données FFI est significativement (environ 2 fois) plus lent
    que l&#039;accès aux tableaux et objets natifs de PHP. Par conséquent, il n&#039;est pas utile d&#039;utiliser
    l&#039;extension FFI pour la vitesse; cependant, il peut être judicieux de l&#039;utiliser pour réduire la
    mémoire.
   </p>
  </div>
 </div>

 






 






 






 






 






 






 






<ul class="chunklist chunklist_book"><li><a href="ffi.setup.php">Installation/Configuration</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.requirements.php">Pr&eacute;-requis</a></li><li><a href="ffi.installation.php">Installation</a></li><li><a href="ffi.configuration.php">Configuration &agrave; l'ex&eacute;cution</a></li></ul></li><li><a href="ffi.examples.php">Exemples</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.examples-basic.php">Utilisation basique de FFI</a></li><li><a href="ffi.examples-callback.php">Fonctions de rappels</a></li><li><a href="ffi.examples-complete.php">Un exemple complet de PHP/FFI/preloading</a></li></ul></li><li><a href="class.ffi.php">FFI</a> — Interface principale vers le code C et les donn&eacute;es<ul class="chunklist chunklist_book chunklist_children"><li><a href="ffi.addr.php">FFI::addr</a> — Cr&eacute;e un pointeur non g&eacute;r&eacute; vers des donn&eacute;es C</li><li><a href="ffi.alignof.php">FFI::alignof</a> — R&eacute;cup&egrave;re l'alignement</li><li><a href="ffi.arraytype.php">FFI::arrayType</a> — Construit dynamiquement un nouveau type de tableau C</li><li><a href="ffi.cast.php">FFI::cast</a> — Effectue une conversion de type C</li><li><a href="ffi.cdef.php">FFI::cdef</a> — Cr&eacute;e un nouvel objet FFI</li><li><a href="ffi.free.php">FFI::free</a> — Lib&egrave;re une structure de donn&eacute;es non g&eacute;r&eacute;e</li><li><a href="ffi.isnull.php">FFI::isNull</a> — V&eacute;rifie si un objet FFI\CData est un pointeur null</li><li><a href="ffi.load.php">FFI::load</a> — Charge les d&eacute;clarations C &agrave; partir d'un fichier d'en-t&ecirc;te C</li><li><a href="ffi.memcmp.php">FFI::memcmp</a> — Comparaison des zones de m&eacute;moire</li><li><a href="ffi.memcpy.php">FFI::memcpy</a> — Copie d'une zone de m&eacute;moire dans une autre</li><li><a href="ffi.memset.php">FFI::memset</a> — Remplit une zone de m&eacute;moire</li><li><a href="ffi.new.php">FFI::new</a> — Cr&eacute;e une structure de donn&eacute;es C</li><li><a href="ffi.scope.php">FFI::scope</a> — Instancie un objet FFI avec les d&eacute;clarations C analys&eacute;es lors du pr&eacute;chargement</li><li><a href="ffi.sizeof.php">FFI::sizeof</a> — R&eacute;cup&egrave;re la taille des donn&eacute;es ou des types C</li><li><a href="ffi.string.php">FFI::string</a> — Cr&eacute;e une cha&icirc;ne PHP &agrave; partir d'une zone de m&eacute;moire</li><li><a href="ffi.type.php">FFI::type</a> — Cr&eacute;e un objet FFI\CType &agrave; partir d'une d&eacute;claration C</li><li><a href="ffi.typeof.php">FFI::typeof</a> — R&eacute;cup&egrave;re le FFI\CType de FFI\CData</li></ul></li><li><a href="class.ffi-cdata.php">FFI\CData</a> — Gestionnaire de donn&eacute;es C</li><li><a href="class.ffi-ctype.php">FFI\CType</a> — Gestionnaire de type C<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> — R&eacute;cup&eacute;rer le nombre de param&egrave;tres d'un type de fonction</li><li><a href="ffi-ctype.getfuncparametertype.php">FFI\CType::getFuncParameterType</a> — R&eacute;cup&eacute;rer le type d&rsquo;un param&egrave;tre de fonction</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">Exceptions FFI</a></li><li><a href="class.ffi-parserexception.php">FFI\ParserException</a> — Exceptions de l'analyseur syntaxique FFI</li></ul></div><?php manual_footer($setup); ?>