عرض مصدر Rails/rails on rack

<noinclude>{{DISPLAYTITLE:ريلز مع Rack}}</noinclude>
يغطي هذا الدليل دمج ريلز مع Rack والتفاعل مع مكونات Rack الأخرى.

بعد قراءة هذا الدليل، ستتعلم:
* كيفية استخدام برمجيات Rack الوسيطة في تطبيقات ريلز الخاصة بك.
* حزمة البرمجيات الوسيطة الداخلية لـ [[Rails/action pack|Action Pack]].
* كيفية تعريف مكدس برنامج وسيط مخصص (custom Middleware stack).
'''تحذير''': يفترض هذا الدليل معرفة عملية ببروتوكول Rack وبمفاهيم Rack مثل البرمجيات الوسيطة (middlewares) وخرائط url و <code>Rack::Builder</code>.

== مقدمة إلى Rack ==
يوفر Rack واجهة دنيا، ومركبة من وحدات، وقابلة للتهيئة لتطوير تطبيقات الويب في روبي. من خلال تغليف طلبات واستجابات HTTP بأبسط طريقة ممكنة، فهو يوحد ويقسم واجهة برمجة التطبيقات لخوادم الويب وأطر الويب والبرامج في ما بين (ما يسمى بالبرامج الوسيطة) في استدعاء تابع واحد.

شرح كيف يعمل Rack ليس في نطاق هذا الدليل. في حال لم تكن على دراية بأساسيات Rack، يجب عليك مراجعة قسم الموارد أدناه.

== ريلز مع Rack ==

=== كائن Rack لتطبيق ريلز ===
<code>Rails.application</code> هو كائن تطبيق Rack الأساسي لتطبيق ريلز. يجب أن يكون أي خادم ويب متوافق مع Rack يستخدم الكائن <code>Rails.application</code> لخدمة تطبيق ريلز.

=== <code>rails server</code> ===
ينفِّذ <code>rails server</code> المهمة الأساسية لإنشاء كائن <code>Rack::Server</code> وبدء تشغيل خادم الويب.

فيما يلي كيفية إنشاء <code>rails server</code> نسخة من <code>Rack::Server</code>:<syntaxhighlight lang="rails">
Rails::Server.new.tap do |server|
  require APP_PATH
  Dir.chdir(Rails.application.root)
  server.start
end
</syntaxhighlight>يرث <code>Rails::Server</code> من <code>Rack::Server</code> و يستدعي التابع <code>Rack::Server.start</code> بهذه الطريقة:<syntaxhighlight lang="rails">
class Server < ::Rack::Server
  def start
    ...
    super
  end
end
</syntaxhighlight>

=== rackup ===
لاستخدام <code>rackup</code> بدلًا من <code>rails server</code> لريلز، يمكنك وضع الشيفرة التالية في config.ru في مجلد جذر تطبيق ريلز الخاص بك:<syntaxhighlight lang="rails">
# Rails.root/config.ru
require_relative 'config/environment'
run Rails.application
</syntaxhighlight>وشغل الخادم:<syntaxhighlight lang="shell">
$ rackup config.ru
</syntaxhighlight>لمعرفة المزيد حول خيارات <code>rackup</code> المختلفة، يمكنك تنفيذ الأمر:<syntaxhighlight lang="shell">
$ rackup --help
</syntaxhighlight>

=== التطوير وإعادة التحميل التلقائي ===
تُحمَّل البرمجيات الوسيطة مرةً واحدةً ولا تراقب التغييرات. سيكون عليك إعادة تشغيل الخادم حتى تنعكس التغييرات التي تجريها في التطبيق قيد التشغيل.

== حزمة البرمجيات الوسيطة في Action Dispatcher ==
تُنفَّذ العديد من المكونات الداخلية لـ Action Dispatcher كبرامج وسيطية لـ Rack.

<code>Rails::Application</code> يستخدم <code>ActionDispatch::MiddlewareStack</code> لدمج مختلف البرامج الوسيطة الداخلية والخارجية لتشكيل تطبيق ريلز  متكامل مع Rack.

'''ملاحظة''': <code>ActionDispatch::MiddlewareStack</code> هو مكافئ ريلز الذي يقابل <code>Rack::Builder</code>، ولكن صُمم لتوفير مرونة أفضل وميزات أكثر لتلبية متطلبات ريلز.

=== فحص حزمة البرامج الوسيطة ===
لدى ريلز مهمة سهلة لفحص حزمة البرامج الوسيطة قيد الاستخدام:<syntaxhighlight lang="shell">
$ bin/rails middleware
</syntaxhighlight>بالنسبة لتطبيق ريلز أُنشِئ حديثًا، فقد ينتج عن هذا الأمر ما يلي:<syntaxhighlight lang="shell">
use Rack::Sendfile
use ActionDispatch::Static
use ActionDispatch::Executor
use ActiveSupport::Cache::Strategy::LocalCache::Middleware
use Rack::Runtime
use Rack::MethodOverride
use ActionDispatch::RequestId
use ActionDispatch::RemoteIp
use Sprockets::Rails::QuietAssets
use Rails::Rack::Logger
use ActionDispatch::ShowExceptions
use WebConsole::Middleware
use ActionDispatch::DebugExceptions
use ActionDispatch::Reloader
use ActionDispatch::Callbacks
use ActiveRecord::Migration::CheckPending
use ActionDispatch::Cookies
use ActionDispatch::Session::CookieStore
use ActionDispatch::Flash
use ActionDispatch::ContentSecurityPolicy::Middleware
use Rack::Head
use Rack::ConditionalGet
use Rack::ETag
use Rack::TempfileReaper
run MyApp::Application.routes
</syntaxhighlight>البرامج الوسيطية الافتراضية الموضحة هنا (وبعضها الآخر) في قسم البرامج الوسيطة الداخلية، أدناه.

=== ضبط حزمة البرامج الوسيطة ===
يوفر ريلز واجهة ضبط بسيطة <code>config.middleware</code> لإضافة أو إزالة وتعديل البرامج الوسيطة في حزمة البرامج الوسيطة عبر application.rb أو ملف الضبط الخاص بالبيئة <code>environments/<environment>.rb</code>.

==== إضافة برنامج وسيط ====
لإضافة برنامج وسيط جديد إلى حزمة البرامج الوسيطة، استخدم أي من التوابع التالية:
* <code>config.middleware.use(new_middleware, args)‎</code>- يضيف البرنامج الوسيط الجديد في أسفل حزمة البرامج الوسيطة.
* <code>config.middleware.insert_before(existing_middleware, new_middleware, args)‎</code> - يضيف البرنامج الوسيط الجديد قبل البرنامج الوسيط المحدد الموجود في حزمة البرامج الوسيطة.
* <code>config.middleware.insert_after(existing_middleware, new_middleware, args)‎</code> - يضيف البرنامج الوسيط الجديد بعد البرنامج الوسيط الحالي المحدد في حزمة البرامج الوسيطة.
<syntaxhighlight lang="rails">
# config/application.rb
 
# في الأسفل Rack::BounceFavicon إضافة
config.middleware.use Rack::BounceFavicon
 
# ActionDispatch::Executor بعد Lifo::Cache إضافة
# Lifo::Cache إلى { page_cache: false } تمرير الوسيط
config.middleware.insert_after ActionDispatch::Executor, Lifo::Cache, page_cache: false
</syntaxhighlight>

==== تبديل برنامج وسيط ====
يمكنك تبديل برنامج وسيط موجودة في حزمة البرامج الوسيطة باستخدام <code>config.middleware.swap</code>.<syntaxhighlight lang="rails">
# config/application.rb
 
# ActionDispatch::ShowExceptions مكان Lifo::ShowExceptions تبديل
config.middleware.swap ActionDispatch::ShowExceptions, Lifo::ShowExceptions
</syntaxhighlight>

==== حذف برنامج وسيط ====
أضف الأسطر التالية إلى ضبط التطبيق الخاص بك:<syntaxhighlight lang="rails">
# config/application.rb
config.middleware.delete Rack::Runtime
</syntaxhighlight>والآن، إذا فحصت حزمة البرامج الوسيطة، ستجد أن <code>Rack::Runtime</code> ليس جزءًا منها.<syntaxhighlight lang="shell">
$ bin/rails middleware
(in /Users/lifo/Rails/blog)
use ActionDispatch::Static
use #<ActiveSupport::Cache::Strategy::LocalCache::Middleware:0x00000001c304c8>
...
run Rails.application.routes

</syntaxhighlight>إذا كنت ترغب في إزالة البرامج الوسيطة ذات الصلة بالجلسة، قم بما يلي:<syntaxhighlight lang="rails">
# config/application.rb
config.middleware.delete ActionDispatch::Cookies
config.middleware.delete ActionDispatch::Session::CookieStore
config.middleware.delete ActionDispatch::Flash
</syntaxhighlight>و لإزالة البرامج الوسيطة ذات الصلة بالمتصفح:<syntaxhighlight lang="rails">
# config/application.rb
config.middleware.delete Rack::MethodOverride
</syntaxhighlight>

=== حزمة البرامج الوسيطة الداخلية ===
تُنفذ الكثير من وظائف وحدة التحكم كبرامج وسيطة. توضح القائمة التالية الغرض من كل منها:
* <code>Rack::Sendfile</code>: يُعين الترويسة <code>X-Sendfile</code> المخصصة بالخادم. اضبط هذا عبر الخيار <code>config.action_dispatch.x_sendfile_header</code>.

* <code>ActionDispatch::Static</code>: يُستخدَم لخدمة ملفات ثابتة من المجلد العام. يُعطَّل إذا كان <code>config.public_file_server.enabled</code> مضبوطًا إلى القيمة <code>false</code>.

* <code>Rack::Lock</code>: يضبط الراية <code>["env["rack.multithread</code> إلى القيمة <code>false</code> ويغلف التطبيق داخل كائن <code>[[Ruby/Mutex|Mutex]]</code>.

* <code>ActionDispatch::Executor</code>: يُستخدَم لتحميل [[Ruby/Thread|الخيط]] الشيفرة بشكل آمن أثناء التطوير.

* <code>ActiveSupport::Cache::Strategy::LocalCache::Middleware</code>: يُستخدَم للتخزين المؤقت للذاكرة. ذاكرة التخزين المؤقت هذه ليست آمنة [[Ruby/Thread|للخيوط]].

* <code>Rack::Runtime</code>: يُعيِّن الترويسة <code>X-Runtime</code> التي تحتوي على الوقت (بالثواني) المستغرق لتنفيذ الطلب.

* <code>Rack::MethodOverride</code>: يسمح باستبدال تابع محدَّد إذا جرى تعيين <code>params[:_method]‎</code>. هذه هي البرامج الوسيطة التي تدعم أنواع التوابع PUT و DELETE لطلبيات HTTP.

* <code>ActionDispatch::RequestId</code>: يجعل الترويسة <code>X-Request-Id</code> الفريدة متاحةً للاستجابة ويفعِّل التابع <code>ActionDispatch::Request.request_id</code>.

* <code>ActionDispatch::RemoteIp</code>: يتحقق من هجمات انتحال IP.

* <code>Sprockets::Rails::QuietAssets</code>: يخفي مخرجات المسجل المتعلقة بطلبات الأصول.

* <code>Rails::Rack::Logger</code>: إعلام السجلات التي بدأت الطلب. بعد اكتمال الطلب، تمسح جميع السجلات.

* <code>ActionDispatch::ShowExceptions</code>: يُنقذ أي استثناء أعيد من قبل التطبيق ويستدعي تطبيق الاستثناءات الذي سيغلفه بتنسيق يمكن عرضه على المستخدم النهائي.

* <code>ActionDispatch::DebugExceptions</code>: مسؤول عن تسجيل الاستثناءات وعرض صفحة تنقيح الأخطاء في حالة الطلب المحلي.

* <code>ActionDispatch::Reloader</code>: يوفر الاستعدادات وعمليات المسح، التي تهدف إلى المساعدة في إعادة تحميل التعليمات البرمجية أثناء التطوير.

* <code>ActionDispatch::Callbacks</code>: يوفر الاستدعاءات لتُنفَّذ قبل وبعد إرسال الطلب.

* <code>ActiveRecord::Migration::CheckPending</code>: يتحقق من عمليات التهجير المعلقة ويرفع الاستثناء <code>ActiveRecord::PendingMigrationError</code> في حالة وجود أي عمليات تهجير معلقة.

* <code>ActionDispatch::Cookies</code>: يعين ملفات تعريف الارتباط للطلب.

* <code>ActionDispatch::Session::CookieStore</code>: مسؤول عن تخزين الجلسة في ملفات تعريف الارتباط.

* <code>ActionDispatch::Flash</code>: يضبط مفاتيح الوصول اللحظي (flash keys). متاح فقط في حالة تعيين <code>config.action_controller.session_store</code> إلى أي قيمة.

* <code>ActionDispatch::ContentSecurityPolicy::Middleware</code>: يوفر لضبط الترويسة <code>Content-Security-Policy</code>.

* <code>Rack::Head</code>: يحول طلبات HEAD إلى طلبات GET ويخدمهم على هذا النحو.

* <code>Rack::ConditionalGet</code>: إضافة دعم لـ "طلبيات GET الشرطية" حتى لا يرد الخادم بشيء إذا لم تتغير الصفحة.

* <code>Rack::ETag</code>: يضيف الترويسة <code>ETag</code> على جميع جسم السلسلة النصية. تُستخدَم ترويسات <code>ETag</code> للتحقق من صحة ذاكرة التخزين المؤقت

* <code>Rack::TempfileReaper</code>: يمسح الملفات المؤقتة المستخدم لتخفيف طلبات متعددة الأجزاء.
'''تنبيه''': من الممكن استخدام أي من البرامج الوسيطة المذكورة أعلاه في حزمة Rack المخصصة بك.

== مراجع ==

=== تعلم Rack ===
* [https://rack.github.io/ موقع Rack الرسمي].
* [http://chneukirchen.org/blog/archive/2007/02/introducing-rack.html مقدمة إلى Rack].

=== فهم البرامج الوسيطة ===
* [http://railscasts.com/episodes/151-rack-middleware Railscast على البرامج الوسيطة لـ Rack].

== مصادر ==
* [https://guides.rubyonrails.org/rails_on_rack.html صفحة Rails on Rack في توثيق Ruby On Rails الرسمي.]
[[تصنيف:Rails]]
[[تصنيف:Rails Extending]]