README

未来的开发已经转移到idrsolutions 客户端，它可以用于相同的目的。此包将不再接收更新。

BuildVu PHP 客户端

使用 BuildVu PHP 客户端通过 PHP 将 PDF 转换为 HTML5 或 SVG，与 IDRsolutions 的BuildVu 微服务示例交互。

BuildVu 微服务示例是一个开源项目，允许您通过将 BuildVu 作为在线服务运行来将 PDF 转换为 HTML5 或 SVG。

IDRsolutions 提供了运行 BuildVu 的免费试用服务，有关更多信息请参阅此处。

有关如何将 BuildVu 部署到应用程序服务器的教程，请访问文档。

安装

composer require idrsolutions/buildvu-php-client

使用方法

有关要添加到 parameters 的附加值的更多信息，请参阅API。

带有文件上传的示例转换脚本

<?php

require_once __DIR__ . "/PATH/TO/vendor/autoload.php";

use IDRsolutions\BuildVuPhpClient\Converter;

$endpoint = "https://:8080/buildvu-microservice/";

$conversion_results = Converter::convert(array(
    'endpoint' => $endpoint,
    'parameters' => array(
        'input' => Converter::INPUT_UPLOAD,
        'file' => __DIR__ . 'path/to/file.pdf'
    )
));

Converter::downloadOutput($conversion_results, __DIR__ . '/');

echo $conversion_results['downloadUrl'];

传递 URL 到服务器的示例转换脚本

<?php

require_once __DIR__ . "/PATH/TO/vendor/autoload.php";

use IDRsolutions\BuildVuPhpClient\Converter;

$endpoint = "https://:8080/buildvu-microservice/";

$conversion_results = Converter::convert(array(
    'endpoint' => $endpoint,
    'parameters' => array(
        'input' => Converter::INPUT_DOWNLOAD,
        'url' => 'http://path.to/file.pdf'
    )
));

Converter::downloadOutput($conversion_results, __DIR__ . '/');

echo $conversion_results['downloadUrl'];

命令行

myproject/
├── composer.json
├── composer.lock
├── conversion_location
│   ├── convert.php
│   ├── input_files
│   │   └── file.pdf
│   └── output
└── vendor
    ├── autoload.php
    ├── composer
    │   └── ...
    └── idrsolutions
        └── buildvu-php-client
            └── ...

适当的脚本更改

<?php

require_once __DIR__ . "/../vendor/autoload.php";

use IDRsolutions\BuildVuPhpClient\Converter;

$endpoint = "https://:8080/buildvu-microservice/";

$conversion_results = Converter::convert(array(
    'endpoint' => $endpoint,
    'parameters' => array(
        'input' => Converter::INPUT_UPLOAD,
        'file' => __DIR__ . 'input_files/file.pdf'
    )
));

Converter::downloadOutput($conversion_results, __DIR__ . '/output/');

echo $conversion_results['downloadUrl'];

执行

cd conversion_location
php convert.php

输出

{
    "state": "processing"
}
{
    "state": "processed",
    "previewUrl": "https://:8080/buildvu-microservice/output/c0096728-3490-4f5f-96a8-0f20a5a1244c/file/index.html",
    "downloadUrl": "https://:8080/buildvu-microservice/output/c0096728-3490-4f5f-96a8-0f20a5a1244c/file.zip"
}
https://:8080/buildvu-microservice/output/c0096728-3490-4f5f-96a8-0f20a5a1244c/file/index.html

托管脚本

此示例使用 XAMPP htdocs。

htdocs
├── buildvu
│   ├── composer.json
│   ├── composer.lock
│   ├── convert.php
│   └── vendor
│       ├── autoload.php
│       ├── composer
│       │   ├── ...
│       └── idrsolutions
│           └── buildvu-php-client
│               └── ...
└── conversion
    ├── input_files
    │   └── file.pdf
    └── output

适当的脚本更改

<?php

require_once __DIR__ . "/vendor/autoload.php";

use IDRsolutions\BuildVuPhpClient\Converter;

$endpoint = "https://:8080/buildvu-microservice/";

try {
    $conversion_results = Converter::convert(array(
        'endpoint' => $endpoint,
        'parameters' => array(
            'input' => Converter::INPUT_UPLOAD,
            'file' => __DIR__ . '/../conversion/input_files/file.pdf'
        )
    ));
    
    Converter::downloadOutput($conversion_results, __DIR__ . '/../conversion/output');
    
    echo $conversion_results['downloadUrl'];
    
} catch (Exception $e) {
    echo $e->getMessage();
    echo $e->getTrace();
    exit(1);
}

执行

在这种情况下，Apache 服务器部署在 localhost:80。要执行脚本，请访问

localhost:80/buildvu/convert.php

输出

网页将显示预览链接

https://:8080/buildvu-microservice/output/c0096728-3490-4f5f-96a8-0f20a5a1244c/file/index.html

下载的 zip 文件将可在 htdocs/conversion/output 中找到。

我该和谁联系？

发现了一个错误，或者有建议/改进？请通过问题页面告诉我们。

有问题吗？您可以通过这里联系我们。

版权所有 © 2018 IDRsolutions

本软件基于Apache License，版本2.0（以下简称“许可协议”）；除非您遵守许可协议，否则不得使用此文件。您可以在以下地址获取许可协议的副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或经书面同意，否则在许可协议下分发的软件按“原样”分发，不提供任何明示或暗示的保证或条件。有关许可协议下管理权限和限制的具体语言，请参阅许可协议。