使用 CMIS PHP 将文件上传到 Alfresco 时如何进行文件版本控制

Posted 2023-02-25

【中文标题】使用 CMIS PHP 将文件上传到 Alfresco 时如何进行文件版本控制

【英文标题】：How to do file versioning when uploading files to Alfresco using CMIS PHP

【发布时间】：2016-04-19 11:26:12

【问题描述】：

我正在使用Apache Chemistry CMIS php client 通过 ATOM 将本地文件夹中的文档上传到 Alfresco Community Edition 5.1。这是我用来执行此操作的脚本：

require_once ('cmis_repository_wrapper.php');
require_once ('cmis_service.php');

$repo_url = "http://127.0.0.1:8080/alfresco/api/-default-/public/cmis/versions/1.1/atom";
$repo_username = "user";
$repo_password = "pass";

$client = new CMISService($repo_url, $repo_username, $repo_password);

$repo_folder = "/alfrescoFolder";
$source_folder = "localFolder/";
$source_files = array_diff(scandir("$source_folder", 1), array('..', '.'));
$myfolder = $client->getObjectByPath($repo_folder);

foreach($source_files as $file)

    try
    
        $upload = $client->createDocumentFromSource($myfolder->id, $file, "$source_folder/$file");
    
    catch(Exception $e)
    
        echo "Some error here.";
    

此脚本运行良好，并且文档上传没有问题，前提是该文档尚不存在于 Alfresco 存储库中。例如，假设我的 Alfresco 存储库中有一个名为 example.txt 的文档，因此，如果我尝试从本地文件夹中上传同名的文档，则会收到 CMIS 约束异常。我不知道如何上传现有文档的新版本。

这是我迄今为止尝试过的，但它不起作用：

$objs = $client->getChildren($myfolder->id);

foreach($source_files as $file)

    foreach($objs->objectList as $obj)
    
        if($obj->properties['cmis:name'] == $file)
        
            try
            
                $checkedout = $client->checkOut($obj->id);
                $client->checkIn($checkedout->id);
            
            catch(Exception $e)
            
                echo "Some error here.";
            
        
        else
        
            try
            
                $upload = $client->createDocumentFromSource($myfolder->id, $file, "$source_folder/$file", array('cmis:objectTypeId'=>'D:ex:document'));
            
            catch(Exception $e)
            
                echo "Some error here";
            
        
    

我收到此错误：

DEBUG: postEntry: myURL = http://127.0.0.1:8080/alfresco/api/-default-/public/cmis/versions/1.1/atom/checkedoutDEBUG: postEntry: entry_template = title SUMMARY CONTENT PROPERTIES DEBUG: postEntry: properties_xml = b549c715-9a9d-427c-bd4b-c6ea29d222cb;1.0 DEBUG: postEntry: hash_values = Array ( [PROPERTIES] => b549c715-9a9d-427c-bd4b-c6ea29d222cb;1.0 [SUMMARY] => summary ) DEBUG: postEntry: post_value = b549c715-9a9d-427c-bd4b-c6ea29d222cb;1.0

有趣的是，该文档实际上已被锁定以进行编辑，所以我真的不知道发生了什么。我也不知道签出然后签入文档是否是我应该对文档进行版本控制的方式。

TL;DR

我希望能够指定我正在上传的文档是现有文档的新版本。有谁知道我该怎么做？

【参考方案1】：

Apache Chemistry 网站上的function coverage page 列出了 CMIS PHP 客户端可以做什么和不能做什么。目前不支持签出、签入和取消签出。我知道他们会欢迎贡献。

当然，底层 CMIS 规范支持它，因此您可以更新库以支持签出/签入或使用原始绑定。

【参考方案2】：

我不是 CMIS 方面的专家，但我认为 this forum post 回答了这个问题。请参阅“jevon”的答案，该答案提供了一个示例和指向this page 的链接（请参阅“更新文档”部分）

【讨论】：

谢谢，戴夫。您提到的链接围绕 Java API。不幸的是，我对 Java 的了解是不存在的。此外，据我了解，CMIS Java API 的功能比其 PHP 对应物丰富得多，所以我不知道 Java 示例对 PHP 的适用性如何。

啊，抱歉-我应该更多地关注你的问题。

我与一位更了解 CMIS 的同事进行了交谈，他已确认 PHP 客户端中未实现版本控制服务。在规格。您需要执行签出和签入操作的级别 - 但在撰写本文时，PHP 客户端不支持此功能。

很遗憾听到这个消息。我将不得不找到其他方法来实现这一点。感谢您的帮助。

【参考方案3】：

我最近发现了一个替代CMIS PHP library，它实现了版本控制服务，包括示例用法。我已经使用它成功解决了我在问题中发布的问题。

编辑：添加了附加信息。

因此，为了使版本控制正常工作，我使用了库中提供的示例代码。我使用的脚本可用于创建新文档以及更新和版本化现有文档。所以，这里是：

<?php

require_once(__DIR__ . '/../vendor/autoload.php');
if (!is_file(__DIR__ . '/conf/Configuration.php')) 
    die("Please add your connection credentials to the file \"" . __DIR__ . "/conf/Configuration.php\".\n");
 else 
    require_once(__DIR__ . '/conf/Configuration.php');


$major = (boolean) isset($argv[1]) ? $argv[1] : false;

$httpInvoker = new \GuzzleHttp\Client(
    array(
        'defaults' => array(
            'auth' => array(
                CMIS_BROWSER_USER,
                CMIS_BROWSER_PASSWORD
            )
        )
    )
);

$parameters = array(
    \Dkd\PhpCmis\SessionParameter::BINDING_TYPE => \Dkd\PhpCmis\Enum\BindingType::BROWSER,
    \Dkd\PhpCmis\SessionParameter::BROWSER_URL => CMIS_BROWSER_URL,
    \Dkd\PhpCmis\SessionParameter::BROWSER_SUCCINCT => false,
    \Dkd\PhpCmis\SessionParameter::HTTP_INVOKER_OBJECT => $httpInvoker,
);

$sessionFactory = new \Dkd\PhpCmis\SessionFactory();

// If no repository id is defined use the first repository
if (CMIS_REPOSITORY_ID === null) 
    $repositories = $sessionFactory->getRepositories($parameters);
    $repositoryId = $repositories[0]->getId();
 else 
    $repositoryId = CMIS_REPOSITORY_ID;


$parameters[\Dkd\PhpCmis\SessionParameter::REPOSITORY_ID] = $repositoryId;

$session = $sessionFactory->createSession($parameters);
$rootFolder = $session->getObject($session->createObjectId($session->getRootFolder()->getId()));

try 

    $document = null;
    $stream = \GuzzleHttp\Stream\Stream::factory(fopen($filePath, 'r'));
    foreach ($rootFolder->getChildren() as $child) 
        if ($child->getName() === $fileName) 
            $document = $child;
            break;
        
    

    if (!$document) 

        $properties = array(
            \Dkd\PhpCmis\PropertyIds::OBJECT_TYPE_ID => 'cmis:document',
            \Dkd\PhpCmis\PropertyIds::NAME => $fileName
        );

        $document = $session->createDocument($properties, $rootFolder, $stream);
        $document = $session->getObject($document);
    

    $checkedOutDocumentId = $document->getVersionSeriesCheckedOutId();
    if ($checkedOutDocumentId) 
        $checkedOutDocumentId = $session->createObjectId($checkedOutDocumentId);
     else 
        $checkedOutDocumentId = $document->checkOut();
    

    $checkedInDocumentId = $session->getObject($checkedOutDocumentId)->checkIn(
        $major,
        array(
            \Dkd\PhpCmis\PropertyIds::DESCRIPTION => 'New description'
        ),
        $stream,
        'Comments'
    );


 catch (\Dkd\PhpCmis\Exception\CmisVersioningException $e) 
    echo "********* ERROR **********\n";
    echo $e->getMessage() . "\n";
    echo "**************************\n";
    exit();