array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'ffi.load.php', 1 => 'FFI::load', 2 => 'Carrega declarações C a partir de um arquivo de cabeçalho', ), 'up' => array ( 0 => 'class.ffi.php', 1 => 'FFI', ), 'prev' => array ( 0 => 'ffi.isnull.php', 1 => 'FFI::isNull', ), 'next' => array ( 0 => 'ffi.memcmp.php', 1 => 'FFI::memcmp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ffi/ffi/load.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

FFI::load

(PHP 7 >= 7.4.0, PHP 8)

FFI::load — Carrega 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