update to 25.6

README.md

@@ -29,8 +29,8 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 25.5
-- Add a method for comparing pdf files.
+## Enhancements in Version 25.6
+- Develop Rotate Document Pages method.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
 ## Requirements

UsesCases/Compares/comparePdfDocuments.php

@@ -0,0 +1,44 @@
+<?php
+
+require_once __DIR__ . '\comparesHelper.php';
+
+$configParams = [
+    'LOCAL_FOLDER'   => "C:\\Samples\\",
+    'REMOTE_FOLDER'  => "Your_Temp_Pdf_Cloud",
+    'PDF_DOCUMENT_1' => "sample_compare_1.pdf",
+    'PDF_DOCUMENT_2' => "sample_compare_2.pdf",
+    'PDF_OUTPUT'     => "output_compare.pdf"
+];
+
+$helper = new PdfComparesHelper($pdfApi);
+
+class PdfCompares
+{
+    private $helper;
+    private $api;
+    private $config;
+
+    public function __construct($helper, $api, $config)
+    {
+        $this->helper = $helper;
+        $this->api = $api;
+        $this->config = $config;
+    }
+
+    public function comparePdfDocuments($document1, $document2, $outputDocument)
+    {
+        $this->helper->uploadFile($document1, $this->config['LOCAL_FOLDER'], $this->config['REMOTE_FOLDER']);
+        $this->helper->uploadFile($document2, $this->config['LOCAL_FOLDER'], $this->config['REMOTE_FOLDER']);
+
+        $remotePdf1 = $this->helper->joinPath($this->config['REMOTE_FOLDER'], $document1);
+        $remotePdf2 = $this->helper->joinPath($this->config['REMOTE_FOLDER'], $document2);
+        $remotePdfOut = $this->helper->joinPath($this->config['REMOTE_FOLDER'], $outputDocument);
+
+        $response = $this->api->postComparePdf($remotePdf1, $remotePdf2, $remotePdfOut);
+
+        if ($response->getCode() == 200) {
+            echo "Compare was successfully finished in '{$outputDocument}' file.\n";
+            $this->helper->downloadResult($outputDocument, $this->config['LOCAL_FOLDER'], $this->config['REMOTE_FOLDER']);
+        }
+    }
+}

UsesCases/Compares/comparesHelper.php

@@ -0,0 +1,46 @@
+<?php
+
+use Aspose\PDF\Api\PdfApi;
+
+$credentials = json_decode(file_get_contents(__DIR__ . '/../../../Credentials/credentials.json'), true);
+
+$pdfApi = new PdfApi($credentials['id'], $credentials['key']);
+
+class PdfComparesHelper
+{
+    private $pdfApi;
+
+    public function __construct($pdfApi)
+    {
+        $this->pdfApi = $pdfApi;
+    }
+
+    public function uploadFile($fileName, $localFolder, $remoteFolder)
+    {
+        $localFilePath = rtrim($localFolder, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $fileName;
+        $remoteFilePath = rtrim($remoteFolder, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $fileName;
+
+        $fileData = file_get_contents($localFilePath);
+        $this->pdfApi->uploadFile($remoteFilePath, $fileData);
+
+        echo "Uploaded: $fileName\n";
+    }
+
+    public function downloadResult($fileName, $localFolder, $remoteFolder)
+    {
+        $remoteFilePath = rtrim($remoteFolder, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $fileName;
+        $response = $this->pdfApi->downloadFile($remoteFilePath);
+
+        $localFilePath = rtrim($localFolder, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $fileName;
+        file_put_contents($localFilePath, $response['body']);
+
+        echo "Downloaded: $localFilePath\n";
+    }
+
+    public function joinPath(...$segments)
+    {
+        return join(DIRECTORY_SEPARATOR, array_map(function($s) {
+            return trim($s, DIRECTORY_SEPARATOR);
+        }, $segments));
+    }
+}

UsesCases/Compares/comparesLaunch.php

@@ -0,0 +1,14 @@
+<?php
+
+require_once __DIR__ . '\comparePdfDocuments.php';
+
+try {
+    $comparer = new PdfCompares($helper, $pdfApi, $configParams);
+    $comparer->comparePdfDocuments(
+        $configParams['PDF_DOCUMENT_1'],
+        $configParams['PDF_DOCUMENT_2'],
+        $configParams['PDF_OUTPUT']
+    );
+} catch (Exception $e) {
+    echo "Error: " . $e->getMessage() . "\n";
+}

docs/PdfApi.md

@@ -212,6 +212,7 @@ Method | HTTP request | Description
 *PdfApi* | [**postDocumentImageStamps**](PdfApi.md#postDocumentImageStamps) | **POST** /pdf/\{name}/stamps/image | Add document pages image stamps.
 *PdfApi* | [**postDocumentImageStampsPageSpecified**](PdfApi.md#postDocumentImageStampsPageSpecified) | **POST** /pdf/\{name}/stamps/image/pagespecified | Add document image stamps to specified pages.
 *PdfApi* | [**postDocumentPageNumberStamps**](PdfApi.md#postDocumentPageNumberStamps) | **POST** /pdf/\{name}/stamps/pagenumber | Add document page number stamps.
+*PdfApi* | [**postDocumentPagesRotate**](PdfApi.md#postDocumentPagesRotate) | **POST** /pdf/\{name}/rotate | Rotate PDF document.
 *PdfApi* | [**postDocumentTextFooter**](PdfApi.md#postDocumentTextFooter) | **POST** /pdf/\{name}/footer/text | Add document text footer.
 *PdfApi* | [**postDocumentTextHeader**](PdfApi.md#postDocumentTextHeader) | **POST** /pdf/\{name}/header/text | Add document text header.
 *PdfApi* | [**postDocumentTextReplace**](PdfApi.md#postDocumentTextReplace) | **POST** /pdf/\{name}/text/replace | Document's replace text method.
@@ -5237,6 +5238,31 @@ Name | Type | Description  | Notes
 
 [**\Aspose\PDF\Model\AsposeResponse**](AsposeResponse.md)
 
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+<a name="postDocumentPagesRotate"></a>
+## **postDocumentPagesRotate**
+> \Aspose\PDF\Model\AsposeResponse postDocumentPagesRotate($name, $rotation_angle, $pages, $storage, $folder, $password)
+
+Rotate PDF document.
+
+### Parameters
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**$name** | **string** | The document name. | 
+**$rotation_angle** | [**\Aspose\PDF\Model\Rotation**](Rotation.md) | Rotation Angle (CKW). Can be 90, 180, 270. | 
+**$pages** | **string** | Comma separated list of pages and page ranges. (Example: 1,3-5,8) | 
+**$storage** | **string** | The document storage. | [optional]
+**$folder** | **string** | The document folder. | [optional]
+**$password** | **string** | Base64 encoded password. | [optional]
+
+### Return type
+
+[**\Aspose\PDF\Model\AsposeResponse**](AsposeResponse.md)
+
 ### HTTP request headers
 
  - **Content-Type**: application/json