ffi/env

PHP FFI 环境

1.0.2 2024-08-14 16:05 UTC

This package is auto-updated.

Last update: 2024-09-14 16:24:18 UTC


README

PHP 8.1+ Latest Stable Version Latest Unstable Version Total Downloads License MIT

一套用于操作 FFI 环境的 API 方法。

要求

  • PHP >= 7.4

安装

库可以作为 composer 仓库使用,并在项目根目录中通过以下命令安装。

$ composer require ffi/env

使用方法

检索 FFI 状态

use FFI\Env\Runtime;

$status = Runtime::getStatus();

状态可以是以下之一

  • \FFI\Env\Status::NOT_AVAILABLE - 扩展不可用。
  • \FFI\Env\Status::DISABLED - 扩展已禁用。
  • \FFI\Env\Status::ENABLED - 扩展已启用,在任何环境中都可用。
  • \FFI\Env\Status::CLI_ENABLED - 扩展仅在 CLI SAPI 或使用预加载时可用。

检查可用性

use FFI\Env\Runtime;

$isAvailable = Runtime::isAvailable();

如果需要明确检查环境,可以使用 assertAvailable() 方法

use FFI\Env\Runtime;

Runtime::assertAvailable();
// Throws an \FFI\Env\Exception\EnvironmentException in case FFI is not available.

优化

为了检查环境,建议使用 assert 功能。

use FFI\Env\Runtime;
use FFI\Env\Exception\EnvironmentException;

assert(Runtime::assertAvailable());

// Or using your own assertion error message:
assert(Runtime::isAvailable(), EnvironmentException::getErrorMessageFromStatus());