تبدیل داده‌های خام JSON به یک صفحهٔ HTML صیقلی، نیاز مکرری برای برنامه‌های وب مدرن است. GroupDocs.Conversion Cloud SDK for PHP به شما امکان می‌دهد تا یک آموزش تبدیل JSON به HTML را در PHP با حداقل کد پیاده‌سازی کنید. در این راهنما، یک مثال کامل و عملی می‌بینید، یاد می‌گیرید چگونه API تبدیل را با cURL فراخوانی کنید، کتابخانه را تنظیم کنید و بهترین شیوه‌های عملکرد را بررسی کنید.

تبدیل JSON به HTML در PHP - مثال کامل کد

مثال زیر نشان می‌دهد که چگونه یک فایل JSON را بخوانید، یک رشته HTML تولید کنید و از کتابخانه GroupDocs.Conversion Cloud برای رندر نتیجه استفاده کنید.

<?php
require 'vendor/autoload.php';

use GroupDocs\Conversion\Api\ConversionApi;
use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

// Replace with your actual credentials
$clientId = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';

// Initialize the API client
$apiInstance = new ConversionApi($clientId, $clientSecret);

// Path to the source JSON file
$jsonPath = 'data/input.json';

// Load JSON and convert to associative array
$jsonData = json_decode(file_get_contents($jsonPath), true);
if (json_last_error() !== JSON_ERROR_NONE) {
    die('Invalid JSON: ' . json_last_error_msg());
}

// Build a simple HTML document from JSON data
$htmlContent = '<!DOCTYPE html><html><head><meta charset="UTF-8"><title>Report</title></head><body>';
$htmlContent .= '<h1>Data Report</h1><ul>';
foreach ($jsonData as $key => $value) {
    $htmlContent .= '<li><strong>' . htmlspecialchars($key) . ':</strong> ' .
                    htmlspecialchars($value) . '</li>';
}
$htmlContent .= '</ul></body></html>';

// Save the generated HTML to a temporary file
$tempHtmlPath = sys_get_temp_dir() . '/generated.html';
file_put_contents($tempHtmlPath, $htmlContent);

// Convert the HTML file to HTML output (no format change) to demonstrate SDK usage
$convertRequest = new ConvertDocumentRequest(
    $tempHtmlPath,
    'html',
    'output.html' // output file path
);

try {
    $apiInstance->convertDocument($convertRequest);
    echo "Conversion successful. Output saved to output.html\n";
} catch (Exception $e) {
    echo 'Conversion failed: ', $e->getMessage(), "\n";
}

// Clean up temporary file
unlink($tempHtmlPath);
?>

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (data/input.json, output.html, و غیره) را به مکان‌های واقعی خود به‌روز کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

ابزار تبدیل JSON به HTML در PHP از طریق REST API با استفاده از cURL

می‌توانید بدون نوشتن کد PHP، با فراخوانی مستقیم API REST سرویس GroupDocs.Conversion Cloud همان نتیجه را به دست آورید. مراحل زیر نشان می‌دهند چگونه یک توکن دسترسی دریافت کنید، یک فایل JSON بارگذاری کنید، درخواست تبدیل بدهید و HTML تولید شده را دانلود کنید.

# 1. Get an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'
# Response contains "access_token"

# 2. Upload the source JSON file
curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@data/input.json"

# 3. Request conversion from JSON to HTML
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/json/html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "file_path": "data/input.json",
           "output_path": "output/result.html"
         }'

# 4. Download the converted HTML file
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output/result.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o result.html

For more details on request parameters, see the [official API documentation](https://docs.groupdocs.cloud/conversion/).

## درک آموزش تبدیل JSON به HTML در کد PHP

در ادامه تجزیه و تحلیل گام به گام مثال کامل کد آورده شده است.

1. **راه‌اندازی کلاینت API** – `new ConversionApi($clientId, $clientSecret)` یک کلاینت ایجاد می‌کند که تمام فراخوانی‌های بعدی را احراز هویت می‌کند.  
2. **خواندن و تجزیه JSON** – `json_decode(file_get_contents($jsonPath), true)` محتوای فایل را به یک آرایه انجمنی تبدیل می‌کند و خطاها را با `json_last_error()` مدیریت می‌کند.  
3. **تولید HTML** – یک قالب ساده HTML با پیمایش آرایه ساخته می‌شود و مقادیر با `htmlspecialchars()` برای جلوگیری از XSS اسکیپ می‌شوند.  
4. **ذخیره موقت HTML** – `file_put_contents($tempHtmlPath, $htmlContent)` HTML را در موقعیتی موقت می‌نویسد که توسط SDK مورد نیاز است.  
5. **تبدیل با استفاده از SDK** – `ConvertDocumentRequest` به API می‌گوید فایل موقت را پردازش کرده و `output.html` را تولید کند. فراخوانی تبدیل در یک بلوک try‑catch برای گرفتن هر گونه خطای API بسته‌بندی شده است.  
6. **پاک‌سازی** – `unlink($tempHtmlPath)` فایل موقت را حذف می‌کند تا سرور تمیز بماند.

### عملکرد تبدیل JSON به HTML در PHP

این مثال فایل JSON را به صورت جریان می‌خواند و رشته HTML را در حافظه می‌سازد که برای بارهای معمولی سریع است. برای مجموعه‌های داده بسیار بزرگ، می‌توانید پردازش JSON را به تکه‌های کوچکتر تقسیم کنید و مستقیماً به فایل خروجی بنویسید تا مصرف حافظه کاهش یابد.

### تبدیل دسته‌ای JSON به HTML در PHP

منطق تبدیل را داخل یک حلقه `foreach` بپیچید و همان `$apiInstance` را مجدداً استفاده کنید. این کار هزینه احراز هویت را به حداقل می‌رساند و توان پردازشی را هنگام تبدیل تعداد زیادی فایل JSON افزایش می‌دهد.

### بهترین شیوه‌های تبدیل JSON به HTML در PHP

* قبل از پردازش، JSON را اعتبارسنجی کنید.  
* تمام محتوای پویا را با `htmlspecialchars()` اسکیپ کنید تا از XSS جلوگیری شود.  
* برای تبدیل‌های متعدد، کلاینت API را مجدداً استفاده کنید.  
* فایل‌های موقت را در یک دایرکتوری با دسترسی نوشتن محدود ذخیره کنید.

## آماده‌سازی محیط برای GroupDocs.Conversion در PHP

1. **نصب SDK از طریق Composer**

```bash
   composer require groupdocs-conversion-cloud

  1. دانلود آخرین بسته (اختیاری) از صفحه انتشار رسمی: Download URL.

  2. پیش‌نیازها

    • PHP 7.4 یا بالاتر.
    • یک حساب GroupDocs Cloud با شناسه کلاینت و کلید محرمانه معتبر.
    • دسترسی به اینترنت برای فراخوانی‌های API.

  3. پیکربندی اعتبارها - YOUR_CLIENT_ID و YOUR_CLIENT_SECRET را در یک فایل پیکربندی امن یا متغیرهای محیطی ذخیره کنید.

  4. تأیید نصب - دستور php -r "echo phpversion();" را اجرا کنید تا نسخه PHP را تأیید کنید و composer show groupdocs-conversion-cloud را برای اطمینان از نصب بسته اجرا کنید.

نتیجه‌گیری

در این آموزش نشان دادیم چگونه داده‌های JSON را به یک صفحه HTML تمیز تبدیل کنیم با استفاده از GroupDocs.Conversion Cloud SDK for PHP. شما یک مثال کامل کد را مشاهده کردید، نحوه انجام همان کار با cURL را آموختید و نکات عملی برای عملکرد، پردازش دسته‌ای و مدیریت خطا دریافت کردید. برای استفاده در محیط تولید نیاز به اشتراک پولی دارید؛ می‌توانید با استفاده از صفحه مجوز موقت در هنگام ارزیابی کتابخانه، یک مجوز موقت دریافت کنید. پس از نصب SDK و پیکربندی اعتبارها، آماده‌اید تا تبدیل JSON به HTML را در هر جریان کاری مبتنی بر PHP یکپارچه کنید.

سؤالات متداول

چگونه می‌توان سرعت تبدیل JSON به HTML در PHP را بهبود داد؟
از تکنیک‌های جریان برای خواندن فایل JSON به صورت قطعه‌قطعه استفاده کنید و خروجی HTML را به‌صورت تدریجی بنویسید. کلاینت سبک SDK همچنین همان اتصال HTTP را برای چندین فراخوانی مجدداً استفاده می‌کند که تأخیر را کاهش می‌دهد.

آیا می‌توان مجموعه‌ای از فایل‌های JSON را در یک عملیات به HTML تبدیل کرد؟
بله. کد تبدیل را داخل یک حلقه قرار دهید و همان نمونه ConversionApi را مجدداً استفاده کنید. این روش در بخش «تبدیل دسته‌ای JSON به HTML در PHP» توضیح داده شده است.

SDK چه روش‌هایی برای مدیریت خطاهای JSON خراب ارائه می‌دهد؟
مثال پس از تجزیه json_last_error() را بررسی می‌کند. اگر خطایی شناسایی شود، اسکریپت با پیام واضح متوقف می‌شود. خود SDK نیز پاسخ خطای جزئیاتی برمی‌گرداند که می‌توانید در بلوک catch آن را دریافت کنید.

منابع بیشتری برای استفاده از GroupDocs.Conversion با PHP کجا می‌توان یافت؟
به مستندات رسمی مراجعه کنید، مرجع API را بررسی کنید و در انجمن پشتیبانی برای مثال‌ها و راهنمایی‌های بیشتر شرکت کنید.

مطالب بیشتر