How to Enable and Use PHP FFI: Step-by-Step Guide for Calling C Libraries

PHP Foreign Function Interface (FFI)

PHP FFI, added in PHP 7.4, lets PHP code call functions from C libraries directly, eliminating the need to write custom extensions and enabling access to system APIs, cryptographic routines, and other high‑performance libraries.

Main Use Cases

Calling system‑level libraries : Access libc or other OS libraries for low‑level operations such as memory management and file handling.

Using high‑performance libraries : Leverage C/C++ libraries for image processing, encryption, databases, etc., to boost PHP application performance.

Avoiding extension development : Replace the traditional workflow of writing and maintaining a PHP extension with a simple FFI call.

Two Ways to Enable FFI

Compile PHP from source with the --with-ffi option.

Install the FFI extension on an already‑installed PHP binary.

Compiling PHP with FFI

./configure --prefix=/usr/local/php-8.3.1 --with-ffi

Building the Extension Separately

Download the source:

wget https://www.php.net/distributions/php-8.3.1.tar.gz

Extract and navigate to the FFI extension directory:

tar -zxvf php-8.3.1.tar.gz
cd php-8.3.1/ext/ffi/

Prepare the build configuration:

/usr/local/php-8.3.1/bin/phpize
./configure --with-php-config=/usr/local/php-8.3.1/bin/php-config

Compile and install:

sudo make -j4
sudo make install

Enable the extension in php.ini:

extension=ffi
ffi.enable=true

Verify the installation:

/usr/local/php-8.3.1/bin/php -m | grep FFI
# Expected output: FFI

Basic Usage Example

<?php
/**
 * @desc Basic FFI usage example
 */
declare(strict_types=1);

// Load the C standard library and the printf function
$ffi = FFI::cdef(
    "int printf(const char *format, ...);",
    "libc.so.6"
);

// Call C's printf
$ffi->printf("Hello %s!
", "world");
?>

Running the script prints:

Hello world!