Add Arabic guide [skip ci]

docs/guide-ar/README.md

@@ -0,0 +1,205 @@
+ Yii 2.0 الدليل التقني الخاص ببيئة العمل
+===============================
+
+تم تحرير هذا الملف اعتمادا على [الشروط الخاصة بتوثيف ال Yii](http://www.yiiframework.com/doc/terms/).
+
+جميع الحقوق محفوظة
+
+2014 (c) Yii Software LLC.
+
+
+المقدمة
+------------
+
+* [عن بيئة العمل Yii](intro-yii.md)
+* [التحديث من الإصدار 1.1](../guide/intro-upgrade-from-v1.md)
+
+
+البداية من هنا
+---------------
+
+* [ماذا يجب أن تعرف عن بيئة العمل](start-prerequisites.md)
+* [تنصيب ال Yii](../guide/start-installation.md)
+* [تشغيل وتطبيق بيئة العمل](../guide/start-workflow.md)
+* [قل مرحبا - المشروع الأول](../guide/start-hello.md)
+* [العمل مع ال forms](../guide/start-forms.md)
+* [العمل مع قواعد البيانات](../guide/start-databases.md)
+* [إنشاء الشيفرة البرمجية من خلال ال gii](../guide/start-gii.md)
+* [ماذا الآن - الخطوة القادمة](../guide/start-looking-ahead.md)
+
+
+الهيكلية الخاصة بالتطبيق (Application Structure)
+---------------------
+
+* [نظرة عامة عن الهيكلية الخاصة بالتطبيق](../guide/structure-overview.md)
+* [Entry Scripts](../guide/structure-entry-scripts.md)
+* [التطبيقات](../guide/structure-applications.md)
+* [مكونات التطبيقات](../guide/structure-application-components.md)
+* [Controllers](../guide/structure-controllers.md)
+* [Models](../guide/structure-models.md)
+* [Views](../guide/structure-views.md)
+* [Modules](../guide/structure-modules.md)
+* [Filters](../guide/structure-filters.md)
+* [Widgets](../guide/structure-widgets.md)
+* [Assets](../guide/structure-assets.md)
+* [Extensions](../guide/structure-extensions.md)
+
+
+التعامل مع ال requests
+-----------------
+
+* [نظرة عامة عن التعامل مع ال requests](../guide/runtime-overview.md)
+* [Bootstrapping](../guide/runtime-bootstrapping.md)
+* [Routing and URL Creation](../guide/runtime-routing.md)
+* [Requests](../guide/runtime-requests.md)
+* [Responses](../guide/runtime-responses.md)
+* [Sessions and Cookies](../guide/runtime-sessions-cookies.md)
+* [Handling Errors - التحكم بالأخطاء](../guide/runtime-handling-errors.md)
+* [Logging - تسجيل الحركات](../guide/runtime-logging.md)
+
+
+المفاهيم الرئيسية (Key Concepts)
+------------
+
+* [Components](../guide/concept-components.md)
+* [Properties](../guide/concept-properties.md)
+* [Events](../guide/concept-events.md)
+* [Behaviors](../guide/concept-behaviors.md)
+* [Configurations](../guide/concept-configurations.md)
+* [Aliases](../guide/concept-aliases.md)
+* [Class Autoloading](../guide/concept-autoloading.md)
+* [Service Locator](../guide/concept-service-locator.md)
+* [Dependency Injection Container](../guide/concept-di-container.md)
+
+
+التعامل مع قواعد البيانات
+----------------------
+
+* [Database Access Objects](../guide/db-dao.md): Connecting to a database, basic queries, transactions, and schema manipulation
+* [Query Builder](../guide/db-query-builder.md): Querying the database using a simple abstraction layer
+* [Active Record](../guide/db-active-record.md): The Active Record ORM, retrieving and manipulating records, and defining relations
+* [Migrations](../guide/db-migrations.md): Apply version control to your databases in a team development environment
+* [Sphinx](https://www.yiiframework.com/extension/yiisoft/yii2-sphinx/doc/guide)
+* [Redis](https://www.yiiframework.com/extension/yiisoft/yii2-redis/doc/guide)
+* [MongoDB](https://www.yiiframework.com/extension/yiisoft/yii2-mongodb/doc/guide)
+* [ElasticSearch](https://www.yiiframework.com/extension/yiisoft/yii2-elasticsearch/doc/guide)
+
+
+الحصول على البيانات من خلال المستخدمين
+-----------------------
+
+* [Creating Forms](../guide/input-forms.md)
+* [Validating Input](../guide/input-validation.md)
+* [Uploading Files](../guide/input-file-upload.md)
+* [Collecting Tabular Input](../guide/input-tabular-input.md)
+* [Getting Data for Multiple Models](../guide/input-multiple-models.md)
+* [Extending ActiveForm on the Client Side](../guide/input-form-javascript.md)
+
+
+عرض البيانات
+---------------
+
+* [Data Formatting](../guide/output-formatting.md)
+* [Pagination](../guide/output-pagination.md)
+* [Sorting](../guide/output-sorting.md)
+* [Data Providers](../guide/output-data-providers.md)
+* [Data Widgets](../guide/output-data-widgets.md)
+* [Working with Client Scripts](../guide/output-client-scripts.md)
+* [Theming](../guide/output-theming.md)
+
+
+الامان والحماية
+--------
+
+* [Security Overview](../guide/security-overview.md)
+* [Authentication](../guide/security-authentication.md)
+* [Authorization](../guide/security-authorization.md)
+* [Working with Passwords](../guide/security-passwords.md)
+* [Cryptography](../guide/security-cryptography.md)
+* [Auth Clients](https://www.yiiframework.com/extension/yiisoft/yii2-authclient/doc/guide)
+* [Best Practices](../guide/security-best-practices.md)
+
+
+Caching التخزين المؤقت
+-------
+
+* [Caching Overview](../guide/caching-overview.md)
+* [Data Caching](../guide/caching-data.md)
+* [Fragment Caching](../guide/caching-fragment.md)
+* [Page Caching](../guide/caching-page.md)
+* [HTTP Caching](../guide/caching-http.md)
+
+
+RESTful Web Services
+--------------------
+
+* [Quick Start](../guide/rest-quick-start.md)
+* [Resources](../guide/rest-resources.md)
+* [Controllers](../guide/rest-controllers.md)
+* [Routing](../guide/rest-routing.md)
+* [Response Formatting](../guide/rest-response-formatting.md)
+* [Authentication](../guide/rest-authentication.md)
+* [Rate Limiting](../guide/rest-rate-limiting.md)
+* [Versioning](../guide/rest-versioning.md)
+* [Error Handling](../guide/rest-error-handling.md)
+
+
+الأدوات المساعدة أثناء تطوير التطبيقات
+-----------------
+
+* [Debug Toolbar and Debugger](https://www.yiiframework.com/extension/yiisoft/yii2-debug/doc/guide)
+* [Generating Code using Gii](https://www.yiiframework.com/extension/yiisoft/yii2-gii/doc/guide)
+* [Generating API Documentation](https://www.yiiframework.com/extension/yiisoft/yii2-apidoc)
+
+
+فحص واختبار التطبيقات
+-------
+
+* [Testing Overview](../guide/test-overview.md)
+* [Testing environment setup](../guide/test-environment-setup.md)
+* [Unit Tests](../guide/test-unit.md)
+* [Functional Tests](../guide/test-functional.md)
+* [Acceptance Tests](../guide/test-acceptance.md)
+* [Fixtures](../guide/test-fixtures.md)
+
+
+مواضيع وعناوين مميزة
+--------------
+
+* [Advanced Project Template](https://www.yiiframework.com/extension/yiisoft/yii2-app-advanced/doc/guide)
+* [Building Application from Scratch](../guide/tutorial-start-from-scratch.md)
+* [Console Commands](../guide/tutorial-console.md)
+* [Core Validators](../guide/tutorial-core-validators.md)
+* [Docker](../guide/tutorial-docker.md)
+* [Internationalization](../guide/tutorial-i18n.md)
+* [Mailing](../guide/tutorial-mailing.md)
+* [Performance Tuning](../guide/tutorial-performance-tuning.md)
+* [Shared Hosting Environment](../guide/tutorial-shared-hosting.md)
+* [Template Engines](../guide/tutorial-template-engines.md)
+* [Working with Third-Party Code](../guide/tutorial-yii-integration.md)
+* [Using Yii as a micro framework](../guide/tutorial-yii-as-micro-framework.md)
+
+
+Widgets
+-------
+
+* [GridView](https://www.yiiframework.com/doc-2.0/yii-grid-gridview.html)
+* [ListView](https://www.yiiframework.com/doc-2.0/yii-widgets-listview.html)
+* [DetailView](https://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html)
+* [ActiveForm](https://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform)
+* [Pjax](https://www.yiiframework.com/doc-2.0/yii-widgets-pjax.html)
+* [Menu](https://www.yiiframework.com/doc-2.0/yii-widgets-menu.html)
+* [LinkPager](https://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html)
+* [LinkSorter](https://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html)
+* [Bootstrap Widgets](https://www.yiiframework.com/extension/yiisoft/yii2-bootstrap/doc/guide)
+* [jQuery UI Widgets](https://www.yiiframework.com/extension/yiisoft/yii2-jui/doc/guide)
+
+
+Helpers
+-------
+
+* [Helpers Overview](../guide/helper-overview.md)
+* [ArrayHelper](../guide/helper-array.md)
+* [Html](../guide/helper-html.md)
+* [Url](../guide/helper-url.md)
+

docs/guide-ar/intro-yii.md

@@ -0,0 +1,57 @@
+# <div dir="rtl">ما هي بيئة العمل Yii</div>
+
+<p dir="rtl">Yii هو إطار PHP عالي الأداء يعتمد على المكونات لتطوير تطبيقات الويب الحديثة بسرعة.
+إن الاسم "Yii" (يُنطق بـ "يي" أو "[جي:]" يعني "بسيطًا وتطوريًا" باللغة الصينية. ومن الممكن ايضا
+    اعتباره اختصارًا لـ <b>Yes It Is</b>!</p>
+
+
+# <div dir="rtl">ما هي أفضل التطبيقات أو البرمجيات التي يمكن برمجتها وتتناسب مع ال Yii</div>
+
+<p dir="rtl">
+Yii هو إطار عام لبرمجة الويب ، مما يعني أنه يمكن استخدامه لتطوير كافة أنواع
+تطبيقات الويب باستخدام PHP. وذلك بسبب البنية القائمة على  البنية التركيبة لبيئة العمل وترابطها مع المكونات والتخزين المؤقت، وهو مناسب بشكل خاص لتطوير portals, forums, content management systems (CMS), e-commerce projects, RESTful Web services. وما إلى ذلك.
+</p>
+
+
+# <div dir="rtl">كيف يمكن مقارنة بيئة العمل الخاصة بال Yii مع الأطر أو بيئات العمل الأخرى؟</div>
+
+<p dir="rtl">
+    إذا كنت بالفعل على دراية بإطار العمل الأخرى ، فيمكنك معرفة كيف تتم مقارنة ال Yii:
+
+<ul  dir="rtl">
+    <li> مثل معظم أطر عمل ال PHP ، يطبق Yii النمط المعماري MVC (Model-View-Controller).</li>
+<li> ال Yii يتبنى الفلسفة التي تقول أن الشيفرة البرمجية يجب أن تكتب بأسهل طريقها وادقها، ولكنها بذات الوقت يجب أن تكون أنيقة الكتابة مظهرا ومضمونا (شكلا وتطيبقا).</li>
+<li> ال Yii هو إطار متكامل  (full stack) يوفر العديد من الميزات الجاهزة للإستخدام والمعدة مسبقا، مثل ال query builders وال ActiveRecord لقواعد البيانات العلاقئية (relational) وغير العلائقية (Nosql)، بالإضافة الى دعم وتجهيز ال RESTful API  والتخزين المؤقت (caching) وغيرها الكثير. </li> 
+<li> من مميزات ال Yii إمكانية التعديل (استبدال جزء معين أو تخيصيص وإضافة) جزء معين على أغلب ال Yii core code، وبالإضافة الى هذا، يمكنك بناء ملحقات برمجية اعتمادا على ال core code، ومن ثم نشر هذه الشيفرة وتوزيعها واستخدامها دون وجود أي مشاكل أو صعوبة تذكر.</li>
+<li> الأداء العالي هو الهدف الأساسي من ال Yii.</li>
+    </ul>
+</p>
+
+<p dir="rtl">
+ال Yii إطار عمل صمم من قبل فريق برمجي متكامل، فهو ليس مجرد عمل فردي ،  بل يتكون من فريق تطوير أساسي وقوي(http://www.yiiframework.com/team/) ، بالإضافة إلى منتدى كبير
+من المهنيين الذين يساهمون باستمرار في تطوير هذا الإطار. فريق المطورين الخاص بال Yii
+يراقب عن كثب أحدث اتجاهات تطوير الويب وأفضل الممارسات والمميزات التي
+وجدت في الأطر والمشاريع الأخرى. وتدرج بانتظام بإضافة أفضل الممارسات والميزات الى ال Yii عبر واجهات بسيطة وأنيقة.
+</p>
+
+
+
+# <div dir="rtl">الإصدارات الخاصة بال Yii</div>
+
+<p dir="rtl">
+    يتوفر لدى Yii حاليًا إصداران رئيسيان: 1.1 و 2.0. الإصدار 1.1 هو الجيل القديم وهو الآن في وضع الصيانة. الإصدار 2.0 هو إعادة كتابة وهيكلة كاملة لل Yii، تم  اعتماد أحدث التقنيات والبروتوكولات فيها مثل  including Composer, PSR, namespaces, traits والكثير من الأمور الأخرى، وفي هذه الإرشادات، سيكون الكلام كله موجها الى الإصدار الثاني من بيئة العمل ال Yii.
+</p>
+
+# <div dir="rtl">المتطلبات الأساسية للعمل على إطار ال Yii</div>
+
+<p dir="rtl">
+    <ul dir="rtl">
+        <li>الإصدار PHP 5.4.0 أو أكثر</li>
+        <li>المعرفة الأساسية بمفاهيم البرمجة كائنية التوجه OOP</li>
+        <li>المعرفة بآخر وأحدث التقنيات الموجودة بال php مثل ال namespaces, traits، الفهم لهذه المفاهيم سيسهل عليك العمل كثيرا</li>
+    </ul>
+</p>
+
+<p dir="rtl">
+    ملاحظة: يمكن التحقق من توافق المتطلبات الخاصة بك مع ال yii من خلال الدخول الى الصفحة requirement الموجودة بال yii
+    </p>

docs/guide-ar/start-prerequisites.md

@@ -0,0 +1,25 @@
+# <div dir="rtl">ماذا يجب أن تعرف قبل البدء بال Yii</div>
+
+<p dir="rtl">
+    منحنى التعلم الخاص بال Yii ليس حادًا مثل أطر PHP الأخرى، ولكن لا يزال هناك بعض الأشياء التي يجب أن تتعلمها قبل البدء بـال Yii.
+</p>
+
+## <div dir="rtl">PHP</div>
+
+<p dir="rtl">
+    ال Yii هو إطار عمل PHP، لذا تأكد من قراءة وفهم المرجع الرسمي الخاص باللغة (http://php.net/manual/en/langref.php). عند البدء بتطوير المشاريع أو التطبيقات باستخدام ال Yii ، ستكتب التعليمات البرمجية بطريقة كائنية التوجه OOP، لذا تأكد من أنك على دراية بـمفاهيم ال OOP (https://secure.php.net/manual/en/language.oop5.basic.php) وكذلك ال namespaces (https://secure.php.net/manual/en/language.namespaces.php).
+</p>
+
+## <div dir="rtl">البرمجة كائنية التوجه object oriented programming</div>
+
+<p dir="rtl">
+    كمبرمج أو مطور يرغب بالعمل على ال Yii، يجب عليك أن تمتلك المعرفة الأساسية للبرمجة كائنية التوجه OOP. إذا لم تكن على دراية بها ، فيمكنك تعلم ذلك من خلال واحدة من هذه الدورات المنتشرة مثل (https://code.tutsplus.com/tutorials/object-oriented-php-for-beginners--net-12762).<br />
+ملاحظة: كلما زاد تعقيد التطبيق أو المشروع الذي تعمل عليه، كلما احتجت الى مستوى أعلى وإحترافي أكثر من مفاهيم ال OOP لحل وإدارة التعقديات التي ستترب على مثل هذه المشاريع.
+</p>
+
+## <div dir="rtl">Command line and composer</div>
+
+<p dir="rtl">تستخدم ال Yii بشكل كبير de-facto standard PHP package manager، ال Composer (https://getcomposer.org/)، لذلك تأكد من قرائتك وفهمك لهذا الموضوع قبل أن تبدء. بالإضافة الى ذلك إذا لم تكن على دراية باستخدام سطر الأوامر (command line) ، فقد حان الوقت لبدء المحاولة. بمجرد تعلم الأساسيات ، لن ترغب في العمل بدون إستخدام سطر الأوامر.<br />
+ال composer: ويترجم حرفيا الى كلمة "الملحن"، وهي عبارة عن أداة لإدارة المشاريع البرمجية والتي تسمح لك بتحديث وتنزيل المكتبات البرمجية المطلوبة للمشروع الخاص بك.  
+</p>
+