README

此软件包不再维护。

Livedocxs 服务将于2017年9月30日关闭。

请使用 https://github.com/TextControl/txtextcontrol-reportingcloud-php。

Livedocx

使用Livedocx webservice在PHP中生成PDF和其他文档类型。

现在您可以查看 完整文档

为什么这个软件包？

您可能已经知道一个 Livedocx软件包 已经存在，那么我为什么要重写轮子呢？

现有的Livedocx软件包紧密绑定到Zend框架组件，需要许多依赖。仅使用单个库就需要近半个框架，我觉得这纯粹是过度设计。

我开发这个Livedocx客户端有两个要点

• 仅必需的依赖项
• 面向对象API

希望您会认为它很有用。

此软件包使用 Atoum 进行单元测试

先决条件

此软件包需要

• PHP 5.4+
• ext-soap
• ext-openssl *

*(Livedocx不受 Heartbleed安全漏洞 影响)

安装

要使用 Composer 安装此软件包，只需将其添加到您的 composer.json 文件中

 "require" : {
    "awakenweb/livedocx" : "dev-master"
 }

可用的框架集成软件包

• Laravel 4: awakenweb/Livedocx4Laravel

此软件包覆盖了Livedocx API的哪些部分？

此软件包提供以下API的支持

• 文档合并
• 重复块合并
• 图像合并
• 位图导出
• 元文件
• 子模板

由于关于共享文档功能的相关文档非常少，因此我现在没有添加支持。我可能在找到一些有关如何正确使用它的文档后添加它。

使用

首先，需要一个 Livedocx 账户。可以是任何类型的账户：免费、高级或完全授权。

完整文档正在制作中，将很快到达。目前，这里有一个简单的使用示例。更多详情，请查看代码。

<?php

use Awakenweb\Livedocx\Soap\Client;
use Awakenweb\Livedocx\Livedocx;
use Awakenweb\Livedocx\Container;

// for free accounts:
$wsdl = 'https://api.livedocx.com/2.1/mailmerge.asmx?wsdl';
// for premium:
$wsdl = "https://premium01.livedocx.com/REPLACE_THIS_BY_YOUR_USERNAME/mailmerge.asmx?WSDL"
// for fully licensed: only you may know

$soap = new Client(new \SoapClient($wsdl));
$soap->connect(USERNAME, PASSWORD);
$Livedocx = new Livedocx($soap, new Container();

$livedocx->assign(array(
    'somefieldname'  => 'some value',
    'someOtherField' => 'another value'
    )
);

$remoteTemplate = $livedocx->createRemoteTemplate();
$remoteTemplate->setName('myTemplate.docx')
               ->setAsActive();

$document = $livedocx->prepare();
$document->setPassword('$3CR3T');
$document->create();

file_put_contents('myPdfFile.pdf', $document->retrieve('pdf'));

常见问题解答（F.A.Q）

• 我正确设置了字段，但最终文档中没有显示任何内容：请注意，Livedocx Web服务对字段名称是区分大小写的。请仔细检查您的模板和代码中的字段名称，看看它们的大小写是否匹配。

杂项

免责声明：本包仅为Livedocx API的客户端。我直接不提供Livedocx API的支持，因为我与Text Control GmbH无关联、无合作、无授权、无赞助，也没有任何形式的官方联系。