phpday 2025 - Call For Papers

FFI::load

(PHP 7 >= 7.4.0, PHP 8)

FFI::loadCarrega declarações C a partir de um arquivo de cabeçalho

Descrição

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

Carrega declarações C a partir de um arquivo de cabeçalho. É possível especificar bibliotecas compartilhadas que devem ser carregadas, usando definições especiais FFI_LIB no arquivo de cabeçalho carregado.

Parâmetros

filename

O nome de um arquivo de cabeçalho C.

Diretivas de pré-processamento C não são suportadas, ou seja, #include, #define e macros CPP não funcionam, exceto para casos especiais listados abaixo.

O arquivo de cabeçalho deveria conter uma declaração #define para a variável FFI_SCOPE, ex.: #define FFI_SCOPE "MYLIB". Refira à introdução desta classe para detalhes.

O arquivo de cabeçalho pode conter uma declaração #define para a variável FFI_LIB para especificar a biblioteca que a ser exposta. Se for uma biblioteca de sistema, apenas o nome é necessário, ex.: #define FFI_LIB "libc.so.6". Se for uma biblioteca customizada, um caminho relativo é necessário, ex.: #define FFI_LIB "./mylib.so".

Valor Retornado

Retorna o objeto FFI recém criado ou null em caso de falha.

Registro de Alterações

Versão Descrição
8.3.0 FFI::load() agora é permitido em scripts de pré-carregamento quando o usuário de sistema atual é o mesmo que foi definido na diretiva de configuração opcache.preload_user.

Veja Também

  • FFI::scope() - Instancia um objeto FFI com declarações C analisadas durante o pré-carregamento

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
10
jungmann0 at gmail dot com
4 years ago
Since #include's and #define's other than FFI_LIB and FFI_SCOPE are not supported in the header, you may want to use the C preprocessor to pre-process your headers in order to resolve all #include's and macros.

I use -D"__attribute__(ARGS)=" to remove function attributes as well, which are not supported by FFI either.

This is my script:

echo '#define FFI_SCOPE "YOUR_SCOPE"' > header-ffi.h
echo '#define FFI_LIB "/path/to/your_lib.so"' >> header-ffi.h
cpp -P -C -D"__attribute__(ARGS)=" header_original >> header-ffi.h
up
2
ojrask at gmail dot com
4 years ago
Regarding the `FFI_LIB` constant:

The path given can be either relative, or absolute, or then refer to a library that is in your global libraries path (i.e. where libc.so.6 and friends are).

The absolute path and global lib path work as expected. The relative path does not work from the header file path, but the current working directory instead. So when you create header files for FFI usage, remember that the PHP script can be called anywhere and this means any relative paths in `FFI_LIB` will most probably fail.

Not sure if there is some possibility to make it use paths relative to the script being called, or relative to the header file being loaded. That would make more sense to me at least.

Right now `FFI_LIB` is quite unusable when it comes to making FFI-powered PHP packages that can be installed literally anywhere on a system. `FFI::cdef` works just as well, but `FFI::scope` also seems to rely on `FFI_LIB` meaning it will fail with relative paths as well.

I guess this comes from the C function `dlopen` as is.
To Top