array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'class.ffi.php', 1 => 'FFI', 2 => 'C のコードやデータへの主要インターフェース', ), 'up' => array ( 0 => 'book.ffi.php', 1 => 'FFI', ), 'prev' => array ( 0 => 'ffi.examples-complete.php', 1 => 'PHP/FFI/事前ロードの完全な例', ), 'next' => array ( 0 => 'ffi.addr.php', 1 => 'FFI::addr', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/ffi/ffi.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.ffi.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

C のコードやデータへの主要インターフェース

(PHP 7 >= 7.4.0, PHP 8)

はじめに

このクラスのオブジェクトは、ファクトリーメソッドである FFI::cdef() や FFI::load()、FFI::scope() によって作成されます。 定義された C の変数は FFI インスタンスのプロパティとして利用可能となり、 定義された C の関数は FFI インスタンスのメソッドとして利用可能となります。 宣言された C の型は、FFI::new() や FFI::type() を使って 新しい C のデータ構造を作成するのに使用できます。

FFI 定義のパースや共有ライブラリの読み込みには長い時間がかかることがあります。 Web 環境において、各 HTTP リクエストでこれを行うのは不便です。 しかし、FFI 定義やライブラリを PHP の起動時に事前ロードし、FFI オブジェクトを必要なときにインスタンス化することが可能です。 ヘッダーファイルは特殊な define である FFI_SCOPE によって拡張することができ (例: #define FFI_SCOPE "foo"。デフォルトのスコープは "C" です)、 事前ロード中に FFI::load() によって読み込むことができます。 これによって、永続的なバインディングが作成されます。 こうして作られたバインディングは、FFI::scope() を通じて後続する全リクエストで利用可能となります。 詳しくは PHP/FFI/事前ロードの完全な例 を参照してください。

複数の C のヘッダーファイルを同一のスコープへと事前ロードできます。

クラス概要

final class FFI {
/* 定数 */
public const int __BIGGEST_ALIGNMENT__;
/* メソッド */
public static addr(FFI\CData &$ptr): FFI\CData
public static alignof(FFI\CData|FFI\CType &$ptr): int
public static arrayType(FFI\CType $type, array $dimensions): FFI\CType
public cast(FFI\CType|string $type, FFI\CData|int|float|bool|null &$ptr): ?FFI\CData
public static cdef(string $code = "", ?string $lib = null): FFI
public static free(FFI\CData &$ptr): void
public static isNull(FFI\CData &$ptr): bool
public static load(string $filename): ?FFI
public static memcmp(string|FFI\CData &$ptr1, string|FFI\CData &$ptr2, int $size): int
public static memcpy(FFI\CData &$to, FFI\CData|string &$from, int $size): void
public static memset(FFI\CData &$ptr, int $value, int $size): void
public new(FFI\CType|string $type, bool $owned = true, bool $persistent = false): ?FFI\CData
public static scope(string $name): FFI
public static sizeof(FFI\CData|FFI\CType &$ptr): int
public static string(FFI\CData &$ptr, ?int $size = null): string
public type(string $type): ?FFI\CType
public static typeof(FFI\CData &$ptr): FFI\CType
}

定義済み定数

FFI::__BIGGEST_ALIGNMENT__

目次