Вызов C функций из PHP: обёртки, расширения и встроенные средства

Расширенные примеры работы с C API PHP

Пример 1: Возврат массива из C расширения

Создание функции, которая возвращает массив чисел Фибоначчи до заданного предела.

// fibonacci.c (фрагмент)
PHP_FUNCTION(fibonacci) {
    zend_long limit;
    if (zend_parse_parameters(ZEND_NUM_ARGS(), "l", &limit) == FAILURE) {
        RETURN_THROWS();
    }
    
    array_init(return_value);
    zend_long a = 0, b = 1;
    while (a <= limit) {
        add_next_index_long(return_value, a);
        zend_long next = a + b;
        a = b;
        b = next;
    }
}

Результат в PHP:

$arr = fibonacci(50);
print_r($arr);
// Array ( [0] => 0 [1] => 1 [2] => 1 [3] => 2 [4] => 3 [5] => 5 [6] => 8 [7] => 13 [8] => 21 [9] => 34 )

Пример 2: Работа с пользовательскими структурами через FFI

Вызов библиотеки libcurl через FFI без расширения. Требуется только наличие libcurl.so.

$ffi = FFI::cdef(
    "
    void *curl_easy_init();
    int curl_easy_setopt(void *curl, int option, ...);
    int curl_easy_perform(void *curl);
    void curl_easy_cleanup(void *curl);
    ",
    "libcurl.so"
);

$curl = $ffi->curl_easy_init();
if ($curl === null) {
    echo "Ошибка инициализации curl";
    exit;
}

$ffi->curl_easy_setopt($curl, 10002, "https://example.com");  // CURLOPT_URL
$ffi->curl_easy_perform($curl);
$ffi->curl_easy_cleanup($curl);

Результат: на экран выводится содержимое страницы. Обратите внимание, что константы (CURLOPT_URL) нужно задавать численно.

Пример 3: Использование PHP-CPP для быстрого создания расширения

PHP-CPP позволяет писать расширения на C++ с более простым синтаксисом. Установка через Composer не требуется, нужны только исходники библиотеки.

// mymath.cpp
#include <phpcpp.h>

Php::Value multiply(Php::Parameters &params) {
    int a = params[0];
    int b = params[1];
    return a * b;
}

extern "C" {
    PHPCPP_EXPORT void *get_module() {
        static Php::Extension extension("mymath", "1.0");
        extension.add<multiply>("multiply", {
            Php::ByVal("a", Php::Type::Numeric),
            Php::ByVal("b", Php::Type::Numeric)
        });
        return extension;
    }
}

Компиляция: g++ -std=c++11 -fpic -c mymath.cpp -I/usr/include/phpcpp и последующая сборка в .so.

Результат в PHP:

echo multiply(5, 6); // 30

Пример 4: Обработка исключений в расширении

Генерация исключения PHP из C-кода с помощью zend_throw_exception().

PHP_FUNCTION(divide) {
    zend_long a, b;
    if (zend_parse_parameters(ZEND_NUM_ARGS(), "ll", &a, &b) == FAILURE) {
        RETURN_THROWS();
    }
    if (b == 0) {
        zend_throw_exception(zend_ce_exception, "Деление на ноль", 0);
        RETURN_THROWS();
    }
    RETURN_DOUBLE((double)a / b);
}

Поведение: при вызове divide(10,0) PHP выбросит исключение и завершит выполнение, если оно не перехвачено.

Пример 5: Работа с глобальными переменными PHP из C

Доступ к глобальной переменной $GLOBALS через хеш-таблицу EG(symbol_table).

PHP_FUNCTION(get_global_var) {
    zend_string *name;
    if (zend_parse_parameters(ZEND_NUM_ARGS(), "S", &name) == FAILURE) {
        RETURN_THROWS();
    }
    
    zval *value = zend_hash_find(&EG(symbol_table), name);
    if (value) {
        RETURN_ZVAL(value);
    } else {
        RETURN_NULL();
    }
}

Применение: позволяет получить доступ к любой глобальной переменной из C. Следует быть осторожным с изменением refcount.