Interface de fonction étrangère (Foreign Function Interface)

Introduction

Cette extension permet de charger des bibliothèques partagées (.DLL ou .so), l'appel à des fonctions C et l'accès à des structures de données C à partir de PHP, sans avoir à connaître l'API d'extension Zend, et sans avoir à apprendre un troisième langage "intermédiaire". L'API publique est implémentée sous la forme d'une classe unique FFI avec plusieurs méthodes statiques (certaines d'entre elles peuvent être appelées dynamiquement), et des méthodes d'objet surchargées, qui effectuent l'interaction réelle avec les données C.

Attention

L'extension FFI est dangereuse, car elle permet de s'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'utilisation de l'API FFI peut être restreinte avec la directive php.ini ffi.enable.

Note: L'extension FFI ne rend pas obsolète l'API d'extension classique de PHP; elle est simplement fournie pour l'interfaçage ad-hoc avec des fonctions et des structures de données C.

Astuce

Actuellement, l'accès aux structures de données FFI est significativement (environ 2 fois) plus lent que l'accès aux tableaux et objets natifs de PHP. Par conséquent, il n'est pas utile d'utiliser l'extension FFI pour la vitesse; cependant, il peut être judicieux de l'utiliser pour réduire la mémoire.

Installation/Configuration
Exemples
FFI — Interface principale vers le code C et les données
- FFI::addr — Crée un pointeur non géré vers des données C
- FFI::alignof — Récupère l'alignement
- FFI::arrayType — Construit dynamiquement un nouveau type de tableau C
- FFI::cast — Effectue une conversion de type C
- FFI::cdef — Crée un nouvel objet FFI
- FFI::free — Libère une structure de données non gérée
- FFI::isNull — Vérifie si un objet FFI\CData est un pointeur null
- FFI::load — Charge les déclarations C à partir d'un fichier d'en-tête C
- FFI::memcmp — Comparaison des zones de mémoire
- FFI::memcpy — Copie d'une zone de mémoire dans une autre
- FFI::memset — Remplit une zone de mémoire
- FFI::new — Crée une structure de données C
- FFI::scope — Instancie un objet FFI avec les déclarations C analysées lors du préchargement
- FFI::sizeof — Récupère la taille des données ou des types C
- FFI::string — Crée une chaîne PHP à partir d'une zone de mémoire
- FFI::type — Crée un objet FFI\CType à partir d'une déclaration C
- FFI::typeof — Récupère le FFI\CType de FFI\CData
FFI\CData — Gestionnaire de données C
FFI\CType — Gestionnaire de type C
- FFI\CType::getAlignment — Description
- FFI\CType::getArrayElementType — Description
- FFI\CType::getArrayLength — Description
- FFI\CType::getAttributes — Description
- FFI\CType::getEnumKind — Description
- FFI\CType::getFuncABI — Description
- FFI\CType::getFuncParameterCount — Récupérer le nombre de paramètres d'un type de fonction
- FFI\CType::getFuncParameterType — Récupérer le type d’un paramètre de fonction
- FFI\CType::getFuncReturnType — Description
- FFI\CType::getKind — Description
- FFI\CType::getName — Description
- FFI\CType::getPointerType — Description
- FFI\CType::getSize — Description
- FFI\CType::getStructFieldNames — Description
- FFI\CType::getStructFieldOffset — Description
- FFI\CType::getStructFieldType — Description
FFI\Exception — Exceptions FFI
FFI\ParserException — Exceptions de l'analyseur syntaxique FFI

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

Nathaniel Sabanski ¶

3 years ago

Quickstart from Rasmus Lerdorf's 25 years of PHP talk. 

<?php
$ffi = FFI::cdef(
    "int printf(const char *format, ...);",
    "libc.so.6");
$ffi->printf("Hello %s!\n", "world");
?>

Requires ffi.enable=1

＋add a note