کار کردن با کدگذاری Base64 یک نیاز رایج هنگام تبادل فایلها در میان APIها، جاسازی اسناد در JSON یا XML یا اطمینان از اینکه دادههای باینری به طور ایمن در محیطهای فقط متنی منتقل میشوند، است. PDFها هم از این قاعده مستثنی نیستند. در این پست بلاگ، شما یاد خواهید گرفت که چگونه یک فایل PDF را به یک رشته Base64 تبدیل کرده و آن را به PDF برگردانید در Python.
ما هر دو سمت را پوشش خواهیم داد:
- تبدیل PDF به Base64
- Base64 را به PDF تبدیل کنید
بیایید با مثالهای کامل کد و توضیحات مرحله به مرحله غرق شویم.
چرا PDF را به Base64 تبدیل کنیم؟
Base64 encoding دادههای باینری (مانند فایل PDF) را به فرمت رشته ASCII تبدیل میکند. این موضوع بهخصوص زمانی مفید است که:
- م embedding کردن PDF ها به طور مستقیم در JSON، XML یا HTML.
- ارسال دادههای PDF از طریق API هایی که فقط از متن پشتیبانی میکنند.
- ذخیره PDFها در سیستمهای ذخیرهسازی مبتنی بر متن مانند پایگاههای داده.
- اجتناب از فساد دادهها در حین حمل و نقل.
Aspose.PDF برای پایتون از طریق .NET این فرایند را ساده، قابل اعتماد و سریع میکند.
چرا از Aspose.PDF برای پایتون برای تبدیل PDF به Base64 استفاده کنیم؟
Aspose.PDF for Python via .NET یک کتابخانه پردازش PDF قدرتمند است که به توسعهدهندگان اجازه میدهد تا به صورت برنامهنویسی اسناد PDF را ایجاد، ویرایش، تبدیل و امن کنند. این کتابخانه فراتر از تجزیه ساده میرود و ویژگیهای سطح سازمانی مانند
- تبدیل PDF: تبدیل PDF به Base64، تصاویر، HTML، DOCX و بیشتر.
- ویرایش سند: اضافه، حذف یا تغییر صفحات و محتوا.
- استخراج داده: متن، جدولها، تصاویر و فراداده را با دقت استخراج کنید.
- ویژگیهای امنیتی: اعمال رمزنگاری، واترمارکها و امضاهای دیجیتال.
- عملکرد چندسکویی: به طور قابل اعتمادی در ویندوز، لینوکس و macOS کار میکند.
برخلاف کتابخانههای اصلی پایتون، Aspose.PDF به Adobe Acrobat یا هر ابزار خارجی دیگری نیاز ندارد. این یک راهحل مستقل است که برای برنامههای با عملکرد بالا طراحی شده است و آن را برای زمانی که نیاز دارید PDF را به Base64 تبدیل کنید یا از Base64 به PDF برگردانید، در پروژههای دنیای واقعی ایدهآل میکند.
شما میتوانید Aspose.PDF را از نسخهها دانلود کنید یا آن را با استفاده از pip نصب کنید:
pip install aspose-pdf
تبدیل PDF به Base64 در پایتون
شما میتوانید به راحتی یک سند PDF موجود را بارگذاری کنید، به صورت اختیاری یک صفحه اضافه کنید و آن را به رشته Base64 با Aspose.PDF برای پایتون کدگذاری کنید.
لطفاً مراحل زیر را برای تبدیل یک فایل PDF به یک رشته Base64 دنبال کنید:
- یک فایل PDF را با استفاده از کلاس
Document
بارگذاری کنید. - فایل را با استفاده از
io.BytesIO
در یک جریان حافظه ذخیره کنید. - تبدیل جریان حافظه به آرایه بایت.
- آرایه بایت را با استفاده از روش داخلی
base64.b64encode()
در یک رشته Base64 رمزگذاری کنید. - Base64 رشته را چاپ کنید یا به API/پایگاه داده خود ارسال کنید.
کد نمونه زیر نشان میدهد که چگونه یک PDF را با استفاده از Python به یک رشته Base64 تبدیل کنید:
import aspose.pdf as ap
import base64
import io
# Load PDF document
document = ap.Document("document.pdf")
# ذخیره PDF در حافظه جریانی
memory_stream = io.BytesIO()
document.save(memory_stream)
# تبدیل جریان حافظه به آرایه بایت
byte_array = memory_stream.getvalue()
# به رشته Base64 تبدیل کنید
base64_result = base64.b64encode(byte_array).decode("utf-8")
# نتیجه Base64 را چاپ کنید
print(base64_result)
یک PDF جدید ایجاد کنید و آن را در پایتون به Base64 تبدیل کنید
علاوه بر بارگذاری فایلهای موجود، Aspose.PDF for Python به شما این امکان را میدهد که اسناد PDF جدیدی از ابتدا ایجاد کنید. پس از تولید PDF، میتوانید به راحتی آن را به یک رشته Base64 تبدیل کنید. این کار زمانی مفید است که نیاز به تولید دینامیک اسناد (مانند فاکتورها، گزارشها یا رسیدها) داشته باشید و سپس آنها را از طریق APIها ارسال کنید یا در سیستمهای مبتنی بر متن ذخیره کنید.
دنبال مراحل زیر باشید:
- یک سند PDF جدید با استفاده از کلاس
Document
ایجاد کنید. - صفحه جدیدی اضافه کنید
- متن را با
TextFragment
وارد کنید. - PDF را به یک جریان حافظه ذخیره کنید.
- به بایتها تبدیل کنید و سپس به یک رشته Base64 کدگذاری کنید.
- نمایش یا استفاده از رشته Base64 به صورت مورد نیاز.
import aspose.pdf as ap
import base64
import io
# مرحله 1: یک سند PDF جدید ایجاد کنید
document = ap.Document()
page = document.pages.add()
# مرحله 2: متن محتوا را اضافه کنید
text_fragment = ap.text.TextFragment("Hello, this is a newly created PDF document.")
page.paragraphs.add(text_fragment)
# مرحله ۳: PDF را در یک جریان حافظه ذخیره کنید
memory_stream = io.BytesIO()
document.save(memory_stream)
# مرحله ۴: تبدیل بایتهای PDF به Base64
byte_array = memory_stream.getvalue()
base64_result = base64.b64encode(byte_array).decode("utf-8")
# مرحله ۵: نتیجه Base64 را چاپ کنید یا استفاده کنید
print(base64_result)
این روش به ویژه زمانی قدرتمند است که شما فایلهای PDF را به صورت برنامهنویسی تولید کنید و نیاز داشته باشید که بلافاصله آنها را به عنوان Base64 بدون ذخیرهسازی در دیسک منتقل کنید.
تبدیل Base64 به PDF در پایتون
یک بار که شما یک رشته Base64 دارید، ممکن است بخواهید آن را به یک فایل PDF بازگردانی کنید. Aspose.PDF انجام رمزگشایی را به همین اندازه آسان میکند.
لطفاً مراحل زیر را برای تبدیل یک رشته Base64 به یک سند PDF دنبال کنید:
- رشته کدگذاری شده را بارگذاری کنید (به عنوان مثال، از یک فایل یا API).
- Convert the string into raw PDF bytes.
- یک سند PDF با استفاده از شیء
Document
و با بایت های رمزگشایی شده ایجاد کنید. - فایل سند را به عنوان یک فایل استاندارد
.pdf
صادر کنید.
کد نمونه زیر نشان میدهد که چگونه میتوان یک رشته Base64 را با استفاده از پایتون به یک سند PDF تبدیل کرد:
import aspose.pdf as ap
import base64
import io
# از یک فایل متنی رشته Base64 را بخوانید
with open("sample-base64.txt", "r", encoding="utf-8") as f:
base64_string = f.read()
# بازیابی Base64 به بایتها
pdf_bytes = base64.b64decode(base64_string)
# بارگذاری PDF از حافظه
memory_stream = io.BytesIO(pdf_bytes)
document = ap.Document(memory_stream)
# فایل را دوباره به صورت PDF ذخیره کنید
document.save("Restored.pdf")
مجوز رایگان بگیرید
شما میتوانید تمامی ویژگیهای Aspose.PDF را برای Python از طریق .NET بدون محدودیت با اعمال یک مجوز موقت رایگان امتحان کنید. به صفحه temporary license page مراجعه کرده و یکی از آنها را دریافت کنید و پتانسیل کامل API را آزاد کنید.
PDF را به صورت آنلاین و رایگان به Base64 تبدیل کنید
اگر میخواهید یک فایل PDF را به سرعت به Base64 تبدیل کنید بدون اینکه کدی بنویسید، میتوانید از free online PDF to Base64 converter استفاده کنید. این ابزار به طور مستقیم در مرورگر شما اجرا میشود، بنابراین نیازی به نصب هیچ نرمافزار یا کتابخانهای ندارید.

منابع اضافی
از این منابع استفاده کنید تا دانش خود را عمیقتر کنید و سناریوهای واقعی را با Aspose.PDF بررسی کنید:
نتیجه گیری
در این مقاله، شما یاد گرفتید که چگونه یک فایل PDF را به یک رشته Base64 در پایتون تبدیل کرده و سپس رشته Base64 را دوباره به یک فایل PDF رمزگشایی کنید. با استفاده از Aspose.PDF برای پایتون از طریق .NET، شما یک API قابل اعتماد و قدرتمند دارید که کار با کدگذاری و رمزگشایی اسناد PDF را در برنامههای پایتون آسان میکند. چه نیاز به گنجاندن PDF ها در API ها داشته باشید، چه آنها را به عنوان متن در پایگاه دادهها ذخیره کنید، یا بهطور ایمن آنها را در پلتفرمها منتقل کنید، این کتابخانه به شما کنترل کاملی بر روی این فرآیند میدهد.
اگر سوالی دارید یا به کمک نیاز دارید، به Aspose.PDF free support forum ما مراجعه کنید که تیم ما همیشه آماده است تا به شما کمک کند.