FFI::load

(PHP 7 >= 7.4.0, PHP 8)

FFI::load — Загружает декларации C из заголовочного файла

Описание

public static FFI::load(string $filename): ?FFI

Метод загружает декларации C из заголовочного файла. Общие библиотеки, которые требуется загрузить, указывают в определениях переменной FFI_LIB в загруженном заголовочном файле C.

Список параметров

filename

Имя заголовочного файла C.

Директивы сопроцессора С не поддерживаются. То есть директивы #include, #define и макросы CPP работать не будут, за исключением особых случаев, которые перечислим ниже.

Заголовочный файл должен содержать инструкцию #define для переменной FFI_SCOPE, например, #define FFI_SCOPE "MYLIB". Подробне об этом рассказывает раздел «Введение в FFI».

Заголовочный файл может содержать оператор #define для переменной FFI_LIB, чтобы указать библиотеку, которую он раскрывает. Если это системная библиотека, требуется только имя файла, например: #define FFI_LIB "libc.so.6". Если это пользовательская библиотека, требуется относительный путь, например: #define FFI_LIB "./mylib.so".

Возвращаемые значения

Метод возвращает новый объект FFI или null, если возникла ошибка.

Список изменений

Версия Описание
8.3.0 Метод FFI::load() теперь разрешён в скриптах предзагрузки, когда текущий пользователь системы совпадает с пользователем, определённым в директиве конфигурации opcache.preload_user.

Смотрите также

  • FFI::scope() - Инстанциирует объект FFI в соответствии с декларацией С, разобранной на этапе предзагрузки