يدوي:إعدادات الضبط

This page is a translated version of the page Manual:Configuration settings and the translation is 7% complete.
Outdated translations are marked like this.

هذا فهرس لجميع إعدادات التكوين المدعومة بناءً على ملف MainConfigSchema.php.

لا تقم أبدًا بتحرير MainConfigSchema.php؛ انسخ الأسطر المناسبة إلى LocalSettings.php بدلاً من ذلك وقم بتعديلها حسب الاقتضاء.

إذا لم تتمكن من العثور على إعداد التكوين هنا ، فتحقق مما إذا تم تعريفه في DefaultSettings.php. يجب أن يحتوي المتغير على بعض التوثيق هناك.

الإعدادات التي تمت إزالتها في إصدارات ميدياويكي السابقة لـ 1.35 لم تعد مدرجة هنا. الرجاء استخدام مربع البحث للعثور على صفحة الدليل ذات الصلة (مثل Manual:$wgAllowAnonymousMinor).
مدرج أبجديا | مدرجة حسب الوظيفة | تصنيف:إعدادات ضبط ميدياويكي

إعدادات عامة

Global Objects

  • $wgAutoloadLocalClasses – سلسلة تربط أسماء الفئات بأسماء الملفات، لأغراض التحميل الآلي.
  • $wgConf Create a site configuration object. Not used for much in a default install.

Server URLs and file paths

Files and file uploads

Uploads have to be specially set up to be secure.

Shared uploads

These settings are kept for backward compatibility, see $wgForeignFileRepos for the new setting, or $wgUseInstantCommons if you only need read access to images on Commons.

MIME types

  تحذير: This is not a configuration setting, but a global state variable. It should be used solely by thumb.php !

See also: Manual:MIME type detection


See also: Manual:Configuring file uploads



  • $wgShowEXIF Show EXIF data at the end of file description pages.
  • $wgUpdateCompatibleMetadata Whether to automatically update the img_metadata field if it is outdated but compatible with the current version.



Thumbnail settings


  • $wgAntivirus – الاسم المحلي للباحث عن الفيروسات.
  • $wgAntivirusRequired – يحدد ما إذا كان فحص عن الفيروسات سوف ينتج عنه رفض الملف أم لا.
  • $wgAntivirusSetup – تكوين خاص بعدد مختلف من فاحصات الفيروسات.

Email settings

See also User Access: $wgEmailConfirmToEdit

  • $wgAdditionalMailParams – متغيرات إضافية للبريد الإلكتروني، سوف تمرر في صفة حجة إلى خانة دالة بي إتش بي ‎mail().
  • $wgAllowHTMLEmail – تضبط قيمتها إلى true من أجل تفعيل رسائل البريد الإلكتروني باستخدام إتش تي إم إل.
  • $wgEmailAuthentication Set to true to enable email authentication (confirmation) for this wiki. Except for password reminder emails, email functions only work for authenticated email addresses.
  • $wgEmergencyContact Site admin email address
  • $wgEnableEmail Set to true to enable basic email features.
  • $wgEnableSpecialMute Set to true to enable the Special Mute page.
  • $wgEnableUserEmailBlacklist (رفع في 1.37)Set to true to enable user-to-user email blacklist.
  • $wgEnableUserEmailMuteList – حدد القيمة لتكون true كي تفعّل خاصية قائمة وقف رسائل البريد الإلكتروني بين المستخدمين.
  • $wgEnableUserEmail Set to true to enable user-to-user email.
  • $wgNewPasswordExpiry – الوقت، بالثواني، الذي تنتهي بعده كلمة المرور المؤقتة المرسلة عبر البريد الإلكتروني.
  • $wgNoReplyAddress Reply-to address for automatically generated emails.
  • $wgPasswordExpirationDays The number of days that a user's password is good for.
  • $wgPasswordExpireGrace The number of seconds after a user's password expires during which they can log in without a password change.
  • $wgPasswordReminderResendTime Minimum time, in hours, which must elapse between password reminder emails.
  • $wgPasswordSender Password reminder email address.
  • $wgSMTP For using a direct (authenticated) SMTP server connection.
  • $wgUserEmailConfirmationTokenExpiry The time, in seconds, after which a email address confirmation token expires.
  • $wgUserEmailUseReplyTo Set to true to put the sending user's email in a Reply-To header instead of From.

Email notification (Enotif) settings

Actual notifications for each user are defined in the options. You can change defaults with $wgDefaultUserOptions .

Database settings

LoadBalancer settings



  • $wgDBport Database port. Only used by PostgreSQL.


Shared DB settings

Extension fields

  • $wgExtPGNewFields (رفع في 1.36)Extension defined fields to be added to existing tables
  • $wgExtNewTables (رفع في 1.36)Extension Defined tables to be added on schema change
  • $wgExtNewFields (رفع في 1.36)Extension defined fields to be added to existing tables
  • $wgExtNewIndexes (رفع في 1.36)Extension defined indexes to be added to existing tables
  • $wgExtPGAlteredFields (رفع في 1.36)Extension defined columns to be altered in tables
  • $wgExtModifiedFields (رفع في 1.36)Extension defined fields to change existing tables

Content handlers and storage

Performance hacks and limits


الصفحة الرئيسية: Manual:Caching
See: Interwiki for Interwiki cache settings.

File Cache

Settings for Server side file caching.

Message Cache

Parser Cache

Memcached settings

Settings for configuring the Memcached memory-based object store (if you are using it) docs/memcached.md has more details.

WAN cache

HTTP proxy (CDN) settings

These settings configure MediaWiki when using a caching HTTP proxy server. They apply to caching using Varnish as well as Squid.

  • $wgCdnMatchParameterOrder Indicates if should take query parameters order on incoming requests into account for CDN caching
  • $wgCdnMaxageLagged Cache timeout for the CDN when DB replica lag is high
  • $wgCdnMaxageStale – مدة وقف التخزين المؤقت أثناء تسليم رد ParserCache بسبب تزاحم PoolCounter.
  • $wgCdnMaxageSubstitute Cache timeout for the CDN when a response is known to be wrong or incomplete (due to load)
  • $wgCdnMaxAge Cache TTL for the CDN sent as s-maxage (without ESI) or Surrogate-Control (with ESI).
  • $wgCdnReboundPurgeDelay Secondary delayed purges of URLs
  • $wgCdnServersNoPurge Same as $wgCdnServers , except no HTTP purges will be sent and CIDR ranges are accepted
  • $wgCdnServers An array of individual proxy servers to help MediaWiki detect if the request has been proxied.
    But also to send back to the proxy PURGE commands on changes.
  • $wgForcedRawSMaxage Default maximum age (in seconds) for raw CSS/JavaScript accesses.
  • $wgInternalServer Internal server name as known to Squid, if different than $wgServer .
  • $wgLoggedOutMaxAge (رفع في 1.38)Cache TTL for the user agent sent as max-age, for logged out users.
  • $wgSquidMaxage (رفع في 1.35)Cache timeout for the squid.
  • $wgSquidPurgeUseHostHeader (رفع في 1.42)Whether to use a Host header in purge requests sent to the proxy servers configured in $wgSquidServers.
  • $wgSquidServersNoPurge (رفع في 1.35)Same as $wgSquidServers , except that MW has no methods to send HTTP PURGE to an origin part of the configured ranges
  • $wgSquidServers (رفع في 1.35)An array of individual proxy servers to help MediaWiki detect if the request has been proxied.
    But also to send back to the proxy PURGE commands on changes.
  • $wgUseCdn Enable/disable page view caching.
  • $wgUseESI (متقادم في 1.33)If you run Squid3 with ESI support, enable this.
  • $wgUsePrivateIPs Whether private X-Forwarded-For IPs should be accepted
  • $wgUseSquid (رفع في 1.35)Enable/disable Squid.
  • $wgVaryOnXFP Whether to add X-Forwarded-Proto to the Vary header for API requests and RSS/Atom feeds.

HTCP multicast purging

Language, regional and character encoding settings

Timezone settings


  • $wgAmericanDates – استخدام الصيغة 'mdy' بدلا من 'dmy' لتكون صيغة التاريخ الافتراضية، على سبيل المثال 'May 12' بدلا من '12 May'.
  • $wgTranslateNumerals For Hindi, Arabic, and other languages with their own numeral systems, use local numerals instead of Western style (0-9) numerals in some areas of the interface.

Output format and skin settings




See ResourceLoader for more information.

Page titles and redirects


Mobile support

Interwiki cache

See interwiki cache for more information.



  • $wgRawHtml Allow raw, unchecked HTML in ‎<html>...‎</html> sections.
  • $wgTidyConfig Configuration of the HTML postprocessing tool to use for fixing invalid HTML code.

Statistics and content analysis

  • $wgActiveUserDays – عدد الأيام التي يتعين على أي شخص قبل مضيها التعديل حتى يعتبر مستخدمًا «نشطًا»
  • $wgArticleCountMethod Method used to determine if a page in a content namespace should be counted as a valid content page (article).
  • $wgDisableCounters (رفع في 1.35)Disable page view counters.
  • $wgExperiencedUserEdits Determines the number of edits needed to qualify at the "Experienced user" level.
  • $wgExperiencedUserMemberSince Determines the number of days needed since account creation to qualify at the "Experienced user" level.
  • $wgLearnerEdits Determines the number of edits needed to qualify at the "Learner" experience level.
  • $wgLearnerMemberSince Determines the number of days needed since account creation to qualify at the "Learner" experience level.
  • $wgManualRevertSearchRadius Maximum number of revisions of a page that will be checked against every new edit made to determine whether the edit was a manual revert.
  • $wgRevertedTagMaxDepth – الحد الأقصى للعمق (عدد مرات المراجعة) لحالات التراجع التي سوف توسم تعديلاتها التي تم التراجع عنها بوسم التغيير mw-reverted.

User accounts, authentication


User rights, access control and monitoring


Blocking/banning, and some other related settings.

  • $wgAccountCreationThrottle – عدد الحسابات التي يجوز لكل عنوان آيبي إنشاءها، القيمة 0 تعني التعطيل.
  • $wgApplyIpBlocksToXff – فرض أعمال منع على عنوان الآيبي كذلك على المستخدمين الذين يوجد لديهم عنوان آيبي ممنوع في ترويسة XFF لديهم.
  • $wgAutoConfirmAge – عدد الثواني المطلوب من حساب ما أن تمضي قبل أن يمنح عضوية مجموعة «مؤكدون تلقائيًا» التي تمنح آليًا.
  • $wgAutoConfirmCount – عدد التعديلات التي يتطلبها الأمر من حساب ما قبل أن يحصل على حالة التأكيد التلقائي.
  • $wgAutopromoteOnceLogInRC – ما إذا كان يضع قيود سجل حقوق المستخدم لأغراض الترقية الآلية في أحدث التغييرات أم لا.
  • $wgAutopromoteOnce – يكيّف الترقية الآلية للمستخدمين إلى مجموعات محددة تجري مرة واحدة فقط.
  • $wgAutopromote Conditions of automatic promotion of user to specific groups
  • $wgAvailableRights – قائمة بالحقوق المتوفرة، بالإضافة إلى تلك المحددة في اللب البرمجي.
  • $wgBlockCIDRLimit Maximum CIDR range when blocking an IP range.
  • $wgBlockDisablesLogin – لو ضبطت القيمة لتكون «true»، لن يسمح للمستخدمين الممنوعين بتسجيل الدخول بعد الآن
  • $wgBlockTargetMigrationStage (أضيف في 1.42) (متقادم في 1.43)ipblocks table schema migration stage, for normalizing ipb_address field and adding the block_target table.
  • $wgBotPasswordsCluster (متقادم في 1.42) – اسم عنقود لجدول ‎bot_passwords
  • $wgBotPasswordsDatabase (متقادم في 1.42) – اسم قاعدة البيانات لجدول bot_passwords
  • $wgCascadingRestrictionLevels – مستويات تقييد يمكن استخدامها في أعمال الحماية التتابعية
  • $wgDeleteRevisionsLimit Integer of how many revisions a page must have before the bigdelete right is required to delete it.
  • $wgEnableBotPasswords Whether to enable bot passwords
  • $wgEnableMultiBlocks (أضيف في 1.42)If this is false, the number of blocks of a given target is limited to only 1.
  • $wgEnablePartialBlocks (رفع في 1.35)Allow partial blocks to be created
  • $wgEnablePartialActionBlocks Flag to enable partial blocks against performing certain actions.
  • $wgHideIdentifiableRedirects Protects user's privacy when doing redirects
  • $wgImplicitRights (أضيف في 1.41)A list of implicit rights, in addition to the ones defined by the core.
  • $wgNamespaceProtection Which namespaces can be edited by whom?
  • $wgNonincludableNamespaces Use this to deny inclusion of pages from specific namespaces.
  • $wgPutIPinRC Log IP addresses in the recentchanges table.
  • $wgQueryPageDefaultLimit Integer defining default number of entries to show on query pages
  • $wgRestrictionLevels Set of permission keys that can be selected on the "page protection" page.
  • $wgRestrictionTypes Actions that can be restricted
  • $wgSemiprotectedRestrictionLevels Restriction levels that are considered "semi-protected"
  • $wgSoftBlockRanges IP ranges that should be considered soft-blocked (anon-only, account creation allowed)
  • $wgSpamRegex A regular expression pattern which, if the page content matched it, stops a page from being saved.
  • $wgSummarySpamRegex Same as $wgSpamRegex except for edit summaries.
  • $wgSysopEmailBans (رفع في 1.35)Allow sysops to ban users from accessing Special:Emailuser.
  • $wgTempAccountCreationThrottle (أضيف في 1.42)Number of temporary accounts each IP address may create per specified period(s).
  • $wgTempAccountNameAcquisitionThrottle (أضيف في 1.42)Number of temporary accounts usernames each IP address may acquire per specified period(s).

See Manual:Preventing access for more methods and settings concerning access. See also Manual:User rights for more information about $wgGroupPermissions, $wgAddGroups, $wgRemoveGroups, etc.

See User Access for User Access settings.


  • $wgAllowCrossOrigin – السماح بعمل طلبات مجهولة المصدر تتخطى المنشأ.
  • $wgAllowUserCssPrefs – يسمح بتنفيذ تفضيلات المستخدم باستخدام أوراق الأنماط المتتالية.
  • $wgAllowUserCss – يسمح بوجود صفحات الطرز المتراصة (CSS) الخاصة بالمستخدم
  • $wgAllowUserJs – يسمح بوجود صفحات جافا سكريبت للمستخدمين
  • $wgApiFrameOptions – يتحكم في إطار صفحات واجهة برمجة التطبيقات.
  • $wgBreakFrames – انشقاق من مجموعات الأطر. يمكن استخدام هذا الأمر في منع المواقع الخارجية من وضع إطار على موقعك مستخدمين إعلانات.
  • $wgCSPFalsePositiveUrls Controls what URLs to ignore in upcoming Content-Security-Policy feature's reporting.
  • $wgCSPHeader Controls Content-Security-Policy header [Experimental]
  • $wgCSPReportOnlyHeader Controls Content-Security-Policy-Report-Only header [Experimental]
  • $wgEditPageFrameOptions Control framing of wiki pages globally.
  • $wgHKDFAlgorithm Algorithm for HMAC-based key derivation function (fast, cryptographically secure random numbers).
  • $wgHKDFSecret Secret for HMAC-based key derivation function (fast, cryptographically secure random numbers).
  • $wgRestAllowCrossOriginCookieAuth – يسمح بعمل طلبات مصدقة مختلفة المنشأ في REST API باستخدام ملفات تعريف ارتباط الجلسة.
  • $wgSecretKey This should always be customized to a secret, unique string in LocalSettings.php .
  • $wgSessionInsecureSecrets (رفع في 1.43)Allows MediaWiki to work at the cost of storing sensitive session data insecurely.
  • $wgSessionSecret Secret for session storage.
  • $wgUseSiteCss Use the site's Cascading Style Sheets (CSS)
  • $wgUseSiteJs Use the site's JavaScript page


Profiling, testing and debugging


See also: Manual:How to debug


Edit user interface

Maintenance Scripts setting

Recent changes, new pages, watchlist and history


  • $wgFeed Toggle syndication feeds (RSS, Atom e.g. Recentchanges, Newpages) on and off.
  • $wgAdvertisedFeedTypes – أنواع التلقيمات التي يجب تقديمها بصفة افتراضية.
  • $wgFeedCacheTimeout Minimum timeout for cached Recentchanges feed, in seconds.
  • $wgFeedClasses Available feeds objects.
  • $wgFeedDiffCutoff When generating Recentchanges RSS/Atom feed, diffs will not be generated for pages larger than this size.
  • $wgFeedLimit Set maximum number of results to return in syndication feeds (RSS, Atom) for e.g. Recentchanges, Newpages.
  • $wgOverrideSiteFeed Override the site's default rss/atom feed that appears on every page.





Special pages


  • $wgActions Array of allowed values for the "action" parameter for normal pages.

Robot policies

Ajax, Action API and REST API


  • $wgAjaxEditStash (رفع في 1.37) – تحديد ما إذا كانت التعديلات يجب أن تجهّز باستخدام أجاكس بينما يكتب المستخدمين موجز التعديل أم لا.
  • $wgAjaxExportList (رفع في 1.38) – قائمة بالدوال في ‎AjaxFunctions.php يمكن استدعائها مستخدمًا ‎action=ajax
  • $wgAjaxLicensePreview – يستخدم أجاكس في استعراض التراخيص أثناء رفع الملفات.
  • $wgAjaxUploadDestCheck (رفع في 1.41) – تمكين أجاكس من التحقق من الكتابة فوق الملف، قبل الرفع.
  • $wgRestAPIAdditionalRouteFiles – ملفات REST API Route إضافية.
  • $wgUseAjax (رفع في 1.38)Enable AJAX support.


  • $wgAllowedCorsHeaders – سرد قائمة بالعناوين المسموح بها في أغراض طلبات واجهة برمجة التطبيقات مختلطة المنشأ.
  • $wgAPICacheHelpTimeout – ضبط وقت وقف الحفظ المؤقت لنص مساعدة واجهة برمجة التطبيقات. اضبطه ليكون «0» كي تعطّل الحفظ المؤقت لنص مساعدة واجهة برمجة التطبيقات.
  • $wgAPIFormatModules – امتدادات وحدة الصياغة البرمجية لواجهة برمجة التطبيقات.
  • $wgAPIListModules – امتدادات وحدة السرد البرمجية لواجهة برمجة التطبيقات.
  • $wgAPIMaxDBRows – العدد الأقصى للصفوف المطلوب مسحها في أعمال الاستفسار في قواعد بيانات واجهة برمجة التطبيقات.
  • $wgAPIMaxLagThreshold – المقدار الأقصى لتأخر قاعدة البيانات على أغلب قواعد البيانات المنسوخة من قاعدة البيانات الذي نقبله قبل إرغام البوتات على محاولة أي طلبات كتابة مرة أخرى مستخدمين أخطاء واجهة برمجة التطبيقات.
  • $wgAPIMaxResultSize – الحجم الأقصى (بالبايت) في أي من نتائج واجهة برمجة التطبيقات.
  • $wgAPIMaxUncachedDiffs – العدد الأقصى للاختلافات التي لم تحفظ في الحفظ المؤقت التي يمكن استردادها في طلب واجهة برمجة تطبيقات واحد.
  • $wgAPIMetaModules – امتدادات وحدة ميتا البرمجية لواجهة برمجة التطبيقات.
  • $wgAPIModules API module extensions.
  • $wgAPIPropModules – امتدادات وحدة prop البرمجية لواجهة برمجة التطبيقات.
  • $wgAPIRequestLog – ملف سجل أو معرف مواقع موحد (TCP أو UDP) من أجل قيد طلبات واجهة برمجة التطبيقات فيه.
  • $wgAPIUselessQueryPages – يجب أن تتخطى الوحدة البرمجية ‎ApiQueryQueryPages الصفحات التي تمثل تكرارًا لا داعي له في استفسارات واجهة برمجة التطبيقات.
  • $wgCrossSiteAJAXdomainExceptions Domains that should not be allowed to make AJAX requests, even if they match one of the domains allowed by $wgCrossSiteAJAXdomains .
  • $wgCrossSiteAJAXdomains Domains that may make cross-site Ajax requests to the MediaWiki API.
  • $wgDebugAPI Loosens API security to allow for easier debugging
  • $wgEnableRestAPI (رفع في 1.36) – تنشيط واجهة برمجة التطبيقات لتطبيق REST على برمجيات ميدياويكي.

Shell and process control

HTTP client


Wiki farm

Miscellaneous settings

See also