FAQ

• x86 架构支持 OCR 功能吗？

  目前，OCR 仅支持 x64 架构。

• PHP FFI 未开启。

  请确保在 php.ini 中设置了 extension=ffi 和 ffi.enable=true，然后使用 php -m | grep -i ffi 验证。

• PHP 脚本直接使用 php 运行时崩溃。

  务必通过 samples/compdfphp（或 samples/run.sh）启动调用 SDK 的 PHP 脚本。启动器会在 PHP 启动前预加载原生依赖，避免由 FFI 懒加载引起的原生库加载顺序问题。

• License 无效。

  • 请确保 license.xml 存在于包根目录。
  • 请确保许可证平台与当前运行时平台匹配。
  • 将 XML 文件路径直接传给 LibraryManager::licenseVerify()。
  • 如果您的许可证需要设备 ID 或应用 ID，请将它们作为 LibraryManager::licenseVerify() 的第二和第三个参数传入。

• 找不到原生库目录。

  请确保 lib/linux/libcpdfconversionsdk.so、lib/linux/libDocumentAI.so.4.0.0、lib/linux/libonnxruntime.so.1.18.0、lib/linux/libopencv_world.so.410 和 lib/linux/libcompdf_php_shim.so 存在。如果它们存储在另一个目录中，请在运行示例前设置 COMPDFKIT_LIB_DIR。