ComPDF
Contact Sales
DemoFAQ
、
New Release

Open-Source PDF SDK & AI Document Processing

Get the full self-hosted SDK and AI document processing on GitHub. One-click deploy to quickly build your document workflows.

Self-hosted SDKComPDF AI

FAQ ​

  • Does OCR work on x86 architecture?

    Currently, the OCR only works on x64 architecture.

  • PHP FFI is not enabled.

    Make sure extension=ffi and ffi.enable=true are set in php.ini, then verify with php -m | grep -i ffi.

  • PHP script crashes when run directly with php.

    Always start PHP scripts that call the SDK through samples/compdfphp (or samples/run.sh). The launcher preloads the native dependencies before PHP starts, avoiding native loading-order issues caused by lazy FFI loading.

  • License invalid.

    • Make sure license.xml exists in the package root.
    • Make sure the license platform matches the current runtime platform.
    • Pass the XML file path directly to LibraryManager::licenseVerify().
    • If your license requires a device ID or application ID, pass them as the second and third parameters of LibraryManager::licenseVerify().

  • Native library directory is not found.

    Make sure lib/linux/libcpdfconversionsdk.so, lib/linux/libDocumentAI.so.4.0.0, lib/linux/libonnxruntime.so.1.18.0, lib/linux/libopencv_world.so.410, and lib/linux/libcompdf_php_shim.so are present. If they are stored in another directory, set COMPDFKIT_LIB_DIR before running the sample.