Skip to content

إطلاق الإصدار 3.0.0

Khaled Al-Shamaa edited this page Sep 1, 2022 · 1 revision
لقد تم إطلاق الإصدار الثالث من مكتبة PHP واللغة العربية يوم الأحد 5 شباط/فبراير 2012 ليترافق ذلك مع الذكرى السنوية السادسة لبدء هذا المشروع، ولمن يرغب في إلقاء نظرة على ما كانت عليه الحال في الأيام الخوالي يمكنه زيارة هذا الرابط:

http://kshamaa.users.phpclasses.org/browse/author/189864.html

أما الذين لا يعرفون ما هي هذه المكتبة بعد، فأدعوهم إلى زيارة الموقع الرسمي لها على الشابكة (الإنترنت) وذلك على العنوان التالي:
https://github.com/khaled-alshamaa/ar-php

فيما يلي نظرة عامة على بعض مما تضمنه هذا الإصدار الجديد من مزايا وتعديلات:

جرى العمل على تغيير تنسيق مكنز الشيفرة المصدرية على موقع sourceforge.net من صيغة CVS إلى SVN، لمزيد من الإيضاح حول المقصود من برمجيات إدارة الشيفرة المصدرية يمكن العودة إلى كل من التدوينتين التاليتين:

نظام CVS لإدارة الشيفرات المصدرية

تنصيب و إعداد مخدم CVS لإدارة الشيفرة المصدرية

وقد تم هذا الانتقال بسبب الحاجة إلى إدارة الشيفرة المصدرية على مستوى تغيير أسماء الملفات والمجلدات وهو ما لا تدعمه تقنية CVS، وسبق عملية التحويل تلك عملية أرشفة كاملة والحصول على نسخة إحتياطية من المكنز القديم باستخدام برنامج rsync باستخدام الأمر التالي:

rsync -av http://ar-php.cvs.sourceforge.net::cvsroot/ar-php/* .

علما أن هذا البرنامج غير متوفر عادة في بيئة نظام ويندوز للتشغيل، لذا استخدمت برنامج Cygwin الذي يقدم مجموعة من أدوات اللينكس لتكون متاحة لمستخدمي الويندوز، لمزيد من المعلومات يمكنكم الإطلاع على المزيد من خلال هذا الرابط:
http://www.cygwin.com

أما للحصول على المعلومات الجديدة الخاصة بمكنز SVN الجديد فيمكنكم الإطلاع على الرابط التالي:
https://sourceforge.net/projects/ar-php

شخصيا استخدم برنامج Tortoises SVN لإدارة شيفرتي المصدرية على طرف الحاسب لدي، يمكنك الحصول على هذا البرنامج من خلال الرابط التالي:
http://tortoisesvn.net

هناك أيضا بعض التعديلات التي فرضتها الوقائع والتغيرات في عالمنا العربي خلال عام 2011 المنصرم ومنها العلم الليبي الجديد، إضافة إلى تعديل سجلات قاعدة بيانات المدن والمحافظات للسودان الشقيق عقب إنفصال جنوبه عنه.

تم استخدام خوارزمية جديدة أكثر دقة لحساب مواقيت الصلاة بالإضافة إلى تصحيح الشائبة الموجودة في طريقة حساب إتجاه القبلة.

تم تغيير معمارية المكتبة بشكل جذري لتتوافق مع معايير مكتبة PEAR وهيكليتها، فيما يلي مثال على طريقة استعمال برنامج phpcs لفحص مطابقة تلك المعايير:

phpcs -n –standard=PEAR I18N_Arabic

لمزيد من المعلومات حول هذا البرنامج يمكنكم الإطلاع على الرابط التالي:
http://pear.php.net/package/PHP_CodeSniffer

تم إضافة نسخة محسنة من التوثيق تركز على حاجات المطور وتختصر التفاصيل الغير مفيدة، فيما يلي مثال على طريقة استعمال برنامج phpDocumentor لتوليد ملفات ذلك التوثيق آليا:

phpdoc -q -p on -s on -o HTML:Smarty:PHP -ric Install,Changes,GPL,LGPL -d PEAR -t Docs -ti Ar-PHP.org

لمزيد من الإيضاح حول آلية التوثيق وطريقته يمكنكم الرجوع إلى تدوينة سابقة لي بهذا الخصوص وهي:

اختبار وتوثيق برامج PHP

من جهة أخرى فقد تم تجهيز المكتبة بصيغة ملف Phar وحيد، وذلك باستخدام مجموعة التعليمات التالية:

<?php
$p = new Phar('ArPHP.phar', 0, 'ArPHP.phar');
$p->startBuffering();
$p->buildFromDirectory('D:\xampp\htdocs\I18N_Arabic\Phar\I18N');
$p->stopBuffering();
?>

لمن ليس على إطلاع حول هذه الصيغة، يمكنه الحصول على مزيد من المعلومات والتفاصيل من خلال هذا الرابط:
http://www.php.net/manual/en/intro.phar.php

لمزيد من التفاصيل يمكنك الإطلاع على السجل الكامل بالتعديلات والموجود على الرابط التالي:
https://github.com/khaled-alshamaa/ar-php/blob/master/CHANGELOG.md#whats-new-in-arphp-300-release-date-feb-5-2012

في الختام أرجو من كل الأصدقاء والمطورين العرب المهتمين أن يشاركونا إختبار هذا الإصدار وتجريبه، ومن ثم إهداؤنا أي أخطاء أو تصويبات أو نصائح يرونها مناسبة وتخدم هذا العمل، مع أطيب الأماني ولا تنسونا من الدعاء.