Download the PHP package abdal/phpian-render without Composer
On this page you can find all versions of the php package abdal/phpian-render. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download abdal/phpian-render
More information about abdal/phpian-render
Files in abdal/phpian-render
Download abdal/phpian-render
More information about abdal/phpian-render
Files in abdal/phpian-render
Vendor abdal
Package phpian-render
Short Description Abdal Phpian Render is a comprehensive PHP package for fixing and improving the display of Persian texts in graphical environments. This package solves common text display issues in libraries such as GD Library, FPDF, and TCPDF, providing full Right-to-Left (RTL) support.
License GPL-2.0-or-later
Package phpian-render
Short Description Abdal Phpian Render is a comprehensive PHP package for fixing and improving the display of Persian texts in graphical environments. This package solves common text display issues in libraries such as GD Library, FPDF, and TCPDF, providing full Right-to-Left (RTL) support.
License GPL-2.0-or-later
Please rate this library. Is it a good library?
Informations about the package phpian-render
📦 Abdal Phpian Render
فارسی

## 📖 درباره پروژه
پروژه **Abdal Phpian Render** یک پکیج جامع PHP برای اصلاح و بهبود نمایش متون فارسی در محیطهای گرافیکی است. این پکیج مشکلات رایج نمایش متن در کتابخانههایی مانند GD Library، FPDF و TCPDF را حل میکند و پشتیبانی کامل از راستبهچپ (RTL) را فراهم میآورد.
### 🎯 چرا این نرمافزار ساخته شد؟
هنگام کار با متون فارسی در محیطهای گرافیکی PHP، مشکلات متعددی وجود دارد:
- **مشکل نمایش حروف**: حروف فارسی به صورت جداگانه و بدون اتصال نمایش داده میشوند
- **مشکل ترتیب نمایش**: در متون ترکیبی (فارسی + انگلیسی) ترتیب کلمات به درستی نمایش داده نمیشود
- **مشکل اعداد**: اعداد انگلیسی در متن فارسی ظاهر میشوند
- **مشکل علائم نگارشی**: پرانتز، براکت و سایر علائم در جهت اشتباه نمایش داده میشوند
- **از دست رفتن اعراب**: اعراب فارسی در فرآیند پردازش از بین میروند
این پکیج تمام این مشکلات را حل میکند و یک راهحل کامل و استاندارد برای رندر متون RTL ارائه میدهد.
## ✨ ویژگیها و قابلیتها
### 🔤 الگوریتم Reshaping
- ✅ تبدیل حروف به اشکال چهارگانه (isolated, final, initial, medial)
- ✅ پشتیبانی کامل از حروف اختصاصی فارسی (پ، چ، گ، ژ)
- ✅ پشتیبانی از ترکیبات Lam-Alef فارسی (لا، لآ)
- ✅ حفظ اعراب در فرآیند reshaping
### 🔄 الگوریتم BiDi (Bidirectional)
- ✅ تشخیص خودکار ترتیب نمایش در متون ترکیبی (فارسی + انگلیسی)
- ✅ آینهسازی خودکار علائم نگارشی (پرانتز، براکت، آکولاد و...)
- ✅ مدیریت هوشمند علائم خنثی بر اساس context
### 🔢 تبدیل اعداد (Number Converter)
- ✅ تبدیل اعداد انگلیسی به فارسی
- ✅ تبدیل خودکار اعداد فارسی به انگلیسی (برای محاسبات)
### 🔣 مدیریت اعراب (Diacritics Handler)
- ✅ استخراج و حفظ اعراب (فَتحه، ضَمّه، کَسره، تنوین و...)
- ✅ اعمال مجدد اعراب پس از reshaping
- ✅ جلوگیری از از دست رفتن اعراب در فرآیند پردازش
### 🛠️ توابع کمکی (Helper Functions)
- ✅ `wordWrap()`: شکستن خط مخصوص متون RTL (جلوگیری از شکسته شدن ناقص کلمات)
- ✅ `isRTL()`: تشخیص خودکار زبان متن ورودی
- ✅ `reverse()`: معکوس کردن متن
- ✅ `clean()`: پاکسازی از کاراکترهای نامرئی و ناخواسته
### 📋 استانداردهای رعایت شده
- ✅ **PSR-12**: رعایت کامل استانداردهای کدنویسی PHP
- ✅ **Type Hinting**: استفاده کامل از type hints برای امنیت نوع داده
- ✅ **PHP 8.1+**: سازگاری کامل با نسخههای جدید PHP
- ✅ **Lightweight**: وابستگی سبک (فقط `symfony/polyfill-mbstring`)
- ✅ **Unit Tests**: تستهای کامل با PHPUnit
- ✅ **Clean Code**: کد تمیز و قابل نگهداری
🚀 نصب و راهاندازی
نصب از طریق Composer
یا اضافه کردن به composer.json:
📚 نحوه استفاده
استفاده پایه
پردازش کامل با گزینهها
استفاده از Reshaping به تنهایی
تبدیل اعداد
پردازش BiDi برای متون ترکیبی
شکستن خط (Word Wrap) برای RTL
تشخیص RTL
استفاده از Static Methods (بدون نیاز به ایجاد نمونه)
استفاده از کلاسهای مستقل
استفاده در GD Library
استفاده در FPDF/TCPDF
🧪 تستها
برای اجرای تستهای واحد:
📦 وابستگیها
- PHP >= 8.1
- symfony/polyfill-mbstring ^1.28
📄 مجوز
این پروژه تحت مجوز GPL-2.0-or-later منتشر شده است.
🐛 گزارش مشکلات
اگر با مشکلی مواجه شدید یا در پیکربندی مشکل دارید، لطفاً از طریق ایمیل [email protected] با ما در تماس باشید. همچنین میتوانید مشکلات را در GitLab یا GitHub گزارش دهید.
❤️ حمایت مالی
اگر این پروژه برای شما مفید بود و مایل به حمایت از توسعه بیشتر هستید، لطفاً در نظر داشته باشید که کمک مالی کنید:
🤵 برنامهنویس
ساخته شده با عشق توسط ابراهیم شفیعی (EbraSha)
- ایمیل: [email protected]
- تلگرام: @ProfShafiei
- GitHub: @ebrasha
- Twitter/X: @ProfShafiei
- LinkedIn: ProfShafiei
📜 مجوز
این پروژه تحت مجوز GPLv2 or later منتشر شده است.
All versions of phpian-render with dependencies
PHP Build Version
Package Version
The package abdal/phpian-render contains the following files
Loading the files please wait ...