عرض مصدر PHP/get html translation table

<noinclude>{{DISPLAYTITLE:الدالة get_html_translation_table() في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تُعيد الدالة <code>get_html_translation_table()‎</code> جدول التحويل المستخدم بواسطة الدالتين <code>[[PHP/htmlspecialchars|htmlspecialchars()‎]]</code> و <code>[[PHP/htmlentities|htmlentities()‎]]</code>.

== الوصف ==
<syntaxhighlight lang="php">
array get_html_translation_table ([ int $table = HTML_SPECIALCHARS [, int $flags ENT_COMPAT | ENT_HTML401 [, string $encoding = "UTF-8" ]]] )
</syntaxhighlight>تُعيد الدالة <code>get_html_translation_table()‎</code> جدول التحويل المستخدم داخليًا للدالتين  <code>[[PHP/htmlspecialchars|htmlspecialchars()‎]]</code> و <code>[[PHP/htmlentities|htmlentities()‎]]</code>.

ملاحظة: تُرَّمز المحارف الخاصة بطرائق متعددة. مثل يُمكن ترميز الحرف <code>"</code> إلى ‎ <code>&amp;quot;</code>‎أو <code>‎&#x22</code>. تعيد الدالة <code>get_html_translation_table()‎</code> الرموز المستعملة بواسطة الدالتين <code>[[PHP/htmlspecialchars|htmlspecialchars()‎]]</code> و <code>[[PHP/htmlentities|htmlentities()‎]]</code> فقط.

== المعاملات ==

=== table ===
نوع الجدول المُعاد إما <code>HTML_ENTITIES</code> أو  <code>HTML_SPECIALCHARS</code>.

=== flags ===
قناع bitmask يتكون من واحدة أو أكثر من الرايات المبينة في الجدول التالي. تُحدد هذه الرايات نوع الاقتباسات بالجدول مع نوع المستند الموجه له الجدول. قيمة القناع الإفتراضي هي <code>ENT_COMPAT | ENT_HTML401</code>.

==== ثوابت الرايات المُتاحة ====
{| class="wikitable"
!الثابت
!الوصف
|-
|<code>ENT_COMPAT</code>
|يحتوي الجدول مدخلات لعلامات الاقتباس المزدوجة دون علامات الاقتباس المفردة
|-
|<code>ENT_QUOTES</code>
|يحتوي الجدول مدخلات لعلامات الاقتباس المزدوجة وعلامات الاقتباس المفردة
|-
|<code>ENT_NOQUOTES</code>
|لا يحتوي الجدول على علامات إقتباس، مزدوجةً كانت أو مفردة.
|-
|<code>ENT_HTML401</code>
|جدول لمعيار HTML 4.01.
|-
|<code>ENT_XML1</code>
|جدول لمعيار XML1.
|-
|<code>ENT_XHTML</code>
|جدول لمعيار XHTML.
|-
|<code>ENT_HTML5</code>
|جدول لمعيار HTML5.
|}

=== encoding ===
يحوي الترميز المستعمل. في حالة عدم ضبط قيمة لهذا الوسيط فستَستَعمِل النُسَخ قبل PHP 5.4.0 الترميز ISO-8859-1 أما النسخة PHP 5.4.0 وما بعدها فتستعمل الترميز UTF-8. تُدعَم أصناف المحارف التالية:

==== ترميزات المحارف المدعومة ====
{| class="wikitable"
!ترميز المحارف
!التسمية
!الوصف
|-
|<code>ISO8859-1</code>
|ISO8859-1
|دول أوروبا الغربية، Latin-1.
|-
|<code>ISO8859-5</code>
|ISO8859-5
|المحارف السيريلية قليلة الاستخدام (اللاتينية أو السيريلية).
|-
|<code>ISO8859-15</code>
|ISO8859-15
|أوروبا الغربية، Latin-9.

أُضيفت علامة اليورو، والحروف الفرنسية والفنلندية غير الموجودة في ترميز Latin-1 (أي ISO-8859-1).
|-
|<code>UTF-8</code>
|
|ترميز ASCII المتوافق مع يونيكود (multi-byte 8-bit Unicode).
|-
|<code>cp866</code>
|ibm866, 866
|المحارف السيريلية الخاصة بنظام التشغيل دوس (DOS).
|-
|<code>cp1251</code>
|Windows-1251, win-1251, 1251
|المحارف السيريلية الخاصة بـنظام التشغيل ويندوز.
|-
|<code>cp1252</code>
|Windows-1252, 1252
|المحارف الخاصة بـنظام التشغيل ويندوز لدول أوروبا الغربية.
|-
|<code>KOI8-R</code>
|koi8-ru, koi8r
|الروسية.
|-
|<code>BIG5</code>
|950
|الصينية التقليدية، تستخدم أساسا في تايوان.
|-
|<code>GB2312</code>
|936
|الصينية المبسطة، مجموعة المحارف الوطنية القياسية.
|-
|<code>BIG5-HKSCS</code>
|
|مجموعة محارف Big5 مع إضافات هونغ كونغ، الصينية التقليدية.
|-
|<code>SHIFT_JIS</code>
|SJIS، SJIS-win، cp932، 932
|اليابانية
|-
|<code>EUC-JP</code>
|‎EUCJP, eucJP-win
|اليابانية
|-
|<code>MacRoman</code>
|
|مجموعة المحارف التي يستخدمها نظام التشغيل Mac OS.
|-
|<code><nowiki>''''</nowiki></code>
|
|سلسلة نصية فارغة تُشَغِل الكشف عن الترميز من ترميز المحارف المستعمل في ملف السكربت (وذلك عبر Zend multibyte)، أو من قيمة ‎،<code>default_charset</code> أو المحلية الحالية (راجع <code>[[PHP/nl langinfo|nl_langinfo()‎]]</code> و <code>[[PHP/setlocale|setlocale()‎]]</code>) بهذا الترتيب، لا يُنصح باستخدام هذه القيمة.
|}
ملاحظة: لا تُعرَف أي ترميزات محارف أخرى من غير المذكورة أعلاه، يُستخدم الترميز الافتراضي في هذه الحالة مع إرسال تحذير.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.4.0
|أصبحت قيمة المعامل <code>encoding</code> الافتراضية هي UTF-8.
|-
|5.4.0
|اُضيفت الثوابت <code>ENT_HTML401</code> و <code>ENT_XML1</code> و <code>ENT_XHTML</code> و <code>ENT_HTML5</code>.
|-
|5.4.3
|أُضيف المعامل <code>encoding</code> للدالة <code>get_html_translation_table()</code>‎.
|}

== أمثلة ==
المثال 1: مثال عن جدول التحويل<syntaxhighlight lang="php">
‎<?php
var_dump(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES | ENT_HTML5));
?>
</syntaxhighlight>يُظهِر المثال السابق ما يلي :  <syntaxhighlight lang="text">
array(1510) {
  ["
"]=>
  string(9) "&NewLine;"
  ["!"]=>
  string(6) "&excl;"
  ["""]=>
  string(6) "&quot;"
  ["#"]=>
  string(5) "&num;"
  ["$"]=>
  string(8) "&dollar;"
  ["%"]=>
  string(8) "&percnt;"
  ["&"]=>
  string(5) "&amp;"
  ["'"]=>
  string(6) "&apos;"
  // ...
}
</syntaxhighlight>

== انظر أيضًا ==
* <code>[[PHP/htmlspecialchars|htmlspecialchars()‎]]</code>: تحويل المحارف الخاصة إلى مدخلات HTML.
* <code>[[PHP/htmlentities|htmlentities()‎]]</code>: تحويل المحارف إلى مدخلات HTML.
* <code>[[PHP/html entity decode|html_entity_decode()‎]]</code>: تحويل جميع مدخلات HTML إلى محارفها الموافقة.

== مصادر ==
* [http://php.net/manual/en/function.get-html-translation-table.php صفحة الدالة get_html_translation_table في توثيق PHP الرسمي].