wp-settings.php چطور ۹۰٪ محیط وردپرس را قبل از هر کوئری می‌سازد؟ تحلیل خط‌به‌خط

فایل wp-settings.php به‌عنوان هسته bootstrap وردپرس، بخش عمده‌ای از محیط اجرایی را قبل از هر کوئری دیتابیس شکل می‌دهد.

این فایل با بارگذاری تنظیمات، ثابت‌ها، توابع و کلاس‌های اصلی، زیرساخت اجرای وردپرس را فراهم می‌کند.

درک خط‌به‌خط این فایل، برای توسعه‌دهندگانی که می‌خواهند رفتار وردپرس را عمیقاً بفهمند، ضروری است.

ترتیب بارگذاری، هوک‌ها و تعامل با wp-config.php، نکات کلیدی این تحلیل هستند.

این مقاله بر پایه بررسی کد منبع، مسیر اجرای وردپرس را از اولین خط تا آماده‌سازی کامل روشن می‌کند.

در پروژه‌های واقعی توسعه وردپرس، بارها دیده شده که توسعه‌دهندگان بدون درک عمیق از فایل wp-settings.php، با رفتارهای عجیب در هوک‌ها، بارگذاری افزونه‌ها یا ترتیب اجرا مواجه می‌شوند. این فایل، ستون فقرات bootstrap وردپرس است و بدون شناخت آن، دیباگ مسائل پیچیده تقریباً غیرممکن می‌شود. آنچه در ادامه می‌خوانید، نه یک ترجمه ساده از کد، بلکه تحلیلی از چرایی و ترتیب اجرای هر بخش است.

چرا wp-settings.php اهمیت دارد؟

فایل wp-settings.php در ریشه نصب وردپرس قرار دارد و توسط فایل‌های wp-load.php و wp-config.php فراخوانی می‌شود. این فایل مسئول بارگذاری تقریباً ۹۰٪ محیط اجرایی وردپرس قبل از هر کوئری دیتابیس است. اگر این فایل به‌درستی اجرا نشود، وردپرس نمی‌تواند راه‌اندازی شود و خطاهای بحرانی مانند "Error establishing a database connection" یا "White Screen of Death" رخ می‌دهد.

درک wp-settings.php به دلایل زیر حیاتی است:

• شناخت ترتیب بارگذاری توابع و کلاس‌ها.
• فهمیدن زمان اجرای هوک‌ها.
• تشخیص علت خطاهای bootstrap.
• امکان مداخله هدفمند در مراحل مختلف راه‌اندازی.
• بهینه‌سازی عملکرد با حذف بارگذاری‌های غیرضروری.

در تجربه کاری، دیده شده که بسیاری از خطاهای عجیب وردپرس، ریشه در ترتیب بارگذاری wp-settings.php دارند. برای مطالعه درباره ساختار هسته، ساختار هسته وردپرس چگونه کار می‌کند را ببینید.

wp-settings.php قلب تپنده bootstrap وردپرس است؛ بدون درک آن، دیباگ عمیق تقریباً غیرممکن می‌شود.

توالی bootstrap در وردپرس

قبل از ورود به جزئیات wp-settings.php، باید توالی کلی bootstrap وردپرس را بشناسیم:

1. مرورگر درخواست را به index.php ارسال می‌کند.
2. index.php فایل wp-blog-header.php را فراخوانی می‌کند.
3. wp-blog-header.php فایل wp-load.php را بارگذاری می‌کند.
4. wp-load.php فایل wp-config.php را پیدا و بارگذاری می‌کند.
5. wp-config.php فایل wp-settings.php را فراخوانی می‌کند.
6. wp-settings.php محیط اجرایی را آماده می‌کند.
7. سپس wp-blog-header.php فایل wp-includes/template-loader.php را اجرا می‌کند.

این توالی نشان می‌دهد که wp-settings.php در وسط زنجیره قرار دارد و پل ارتباطی بین تنظیمات و اجرای قالب است. برای مطالعه درباره رفع خطاهای bootstrap، خطای اتصال به پایگاه داده وردپرس را ببینید.

نقش wp-config.php پیش از wp-settings.php

فایل wp-config.php قبل از wp-settings.php اجرا می‌شود و اطلاعات زیر را تعریف می‌کند:

• تنظیمات اتصال دیتابیس (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST).
• کلیدهای امنیتی (AUTH_KEY, SECURE_AUTH_KEY, ...).
• پیشوند جداول ($table_prefix).
• حالت دیباگ (WP_DEBUG).
• مسیر مطلق وردپرس (ABSPATH).
• مسیر پوشه محتوا (WP_CONTENT_DIR).
• مسیر پوشه افزونه‌ها (WP_PLUGIN_DIR).

در انتهای wp-config.php، خط زیر وجود دارد که wp-settings.php را فراخوانی می‌کند:

require_once ABSPATH . 'wp-settings.php';

این یعنی تمام ثابت‌های تعریف‌شده در wp-config.php قبل از ورود به wp-settings.php در دسترس هستند. برای مطالعه درباره امنیت wp-config، چگونه فایل wp-config را امن کنیم بدون شکستن سایت؟ را ببینید.

تعریف ثابت‌های اصلی

اولین بخش‌های wp-settings.php به تعریف ثابت‌های اصلی اختصاص دارد. این ثابت‌ها شامل نسخه وردپرس، مسیرها، و تنظیمات پیش‌فرض هستند. برخی از مهم‌ترین آن‌ها:

define( 'WPINC', 'wp-includes' );
define( 'WP_CONTENT_DIR', ABSPATH . 'wp-content' );
define( 'WP_PLUGIN_DIR', WP_CONTENT_DIR . '/plugins' );
define( 'WPMU_PLUGIN_DIR', WP_CONTENT_DIR . '/mu-plugins' );
define( 'TEMPLATEPATH', get_template_directory() );

این ثابت‌ها مسیرهای اصلی را تعریف می‌کنند و در سراسر وردپرس استفاده می‌شوند. اگر این ثابت‌ها به‌درستی تعریف نشوند، وردپرس نمی‌تواند فایل‌های موردنیاز را پیدا کند.

سپس ثابت‌های مربوط به نسخه وردپرس تعریف می‌شوند:

$wp_version = '6.x';
$required_php_version = '7.2.24';
$required_mysql_version = '5.5.5';

این متغیرها برای بررسی سازگاری سرور استفاده می‌شوند. اگر نسخه PHP یا MySQL کمتر از حداقل موردنیاز باشد، وردپرس خطا می‌دهد و اجرا متوقف می‌شود. برای مطالعه درباره نسخه PHP، PHP 8.3 یا PHP 8.4؛ کدام برای وردپرس و ووکامرس پایدارتر است؟ را ببینید.

بارگذاری توابع و کلاس‌های هسته

پس از تعریف ثابت‌ها، wp-settings.php شروع به بارگذاری فایل‌های اصلی توابع و کلاس‌ها می‌کند. این بارگذاری به ترتیب خاصی انجام می‌شود:

1. فایل‌های wp-includes/load.php و wp-includes/default-constants.php.
2. فایل‌های wp-includes/version.php و wp-includes/compat.php.
3. فایل‌های wp-includes/functions.php و wp-includes/class-wp.php.
4. فایل‌های wp-includes/plugin.php و wp-includes/formatting.php.
5. فایل‌های wp-includes/meta.php و wp-includes/user.php.
6. سایر فایل‌های ضروری مانند wp-includes/shortcodes.php و wp-includes/l10n.php.

هر یک از این فایل‌ها توابع و کلاس‌های خاصی را تعریف می‌کنند که در ادامه اجرا موردنیاز هستند. ترتیب بارگذاری حیاتی است، زیرا برخی توابع به توابع تعریف‌شده در فایل‌های قبلی وابسته هستند. برای مطالعه درباره توابع وردپرس، توابع پرکاربرد WordPress کدامند و چگونه از آن‌ها استفاده کنیم؟ را ببینید.

در تجربه کاری، دیده شده که خطاهای "Call to undefined function" معمولاً به‌دلیل بارگذاری نادرست این فایل‌ها رخ می‌دهند. برای مطالعه درباره رفع خطاهای PHP، چگونه خطای Call to undefined function در PHP را رفع کنیم؟ را ببینید.

اتصال به دیتابیس و بارگذاری اولیه

پس از بارگذاری توابع پایه، wp-settings.php به دیتابیس متصل می‌شود. این کار از طریق فایل wp-includes/wp-db.php انجام می‌شود که کلاس wpdb را تعریف می‌کند. شیء $wpdb به‌عنوان یک متغیر global در دسترس قرار می‌گیرد:

require_wp_db();
$GLOBALS['wpdb'] = $wpdb;

سپس وردپرس شروع به بارگذاری داده‌های اولیه از دیتابیس می‌کند: گزینه‌ها (Options)، افزونه‌های فعال، و تنظیمات سایت. این بارگذاری از طریق توابع wp_load_alloptions() و wp_get_active_and_valid_plugins() انجام می‌شود.

نکته مهم این است که این کوئری‌ها اولین کوئری‌های دیتابیس در چرخه bootstrap هستند. اگر اتصال دیتابیس برقرار نشود، وردپرس در همین مرحله متوقف می‌شود و خطای "Error establishing a database connection" نمایش داده می‌شود. برای مطالعه درباره بهینه‌سازی دیتابیس، بهینه‌سازی دیتابیس وردپرس بدون حذف اطلاعات مهم را ببینید.

بارگذاری افزونه‌ها و هوک‌ها

یکی از مهم‌ترین بخش‌های wp-settings.php، بارگذاری افزونه‌هاست. وردپرس ابتدا افزونه‌های Must-Use (mu-plugins) را بارگذاری می‌کند، سپس افزونه‌های شبکه‌ای (در Multisite)، و در نهایت افزونه‌های معمولی.

foreach ( wp_get_active_and_valid_plugins() as $plugin ) {
    wp_register_plugin_realpath( $plugin );
    include_once( $plugin );
    do_action( 'plugin_loaded', $plugin );
}

هر افزونه پس از بارگذاری، هوک plugin_loaded را اجرا می‌کند. این هوک به توسعه‌دهندگان اجازه می‌دهد پس از بارگذاری افزونه‌ها، اقدامات خاصی انجام دهند.

پس از بارگذاری همه افزونه‌ها، هوک plugins_loaded اجرا می‌شود:

do_action( 'plugins_loaded' );

این هوک یکی از مهم‌ترین هوک‌های bootstrap است، زیرا در این مرحله همه افزونه‌ها بارگذاری شده‌اند و می‌توانند با یکدیگر تعامل داشته باشند. برای مطالعه درباره هوک‌ها، نحوه استفاده صحیح از هوک‌های وردپرس را ببینید.

در تجربه کاری، دیده شده که بسیاری از مشکلات تداخل افزونه‌ها، ریشه در همین مرحله دارند. برای مطالعه درباره رفع تداخل، روش پیدا کردن افزونه یا قالب مشکل‌ساز را ببینید.

آماده‌سازی قالب و محیط

پس از بارگذاری افزونه‌ها، wp-settings.php قالب فعال را آماده می‌کند. این کار از طریق فایل wp-includes/theme.php انجام می‌شود. تابع get_template_directory() مسیر قالب را تعیین می‌کند و فایل functions.php قالب بارگذاری می‌شود:

if ( ! defined( 'WP_INSTALLING' ) || 'wp-activate.php' === $pagenow ) {
    if ( TEMPLATEPATH !== STYLESHEETPATH ) {
        include STYLESHEETPATH . '/functions.php';
    }
    include TEMPLATEPATH . '/functions.php';
}

این بخش نشان می‌دهد که در قالب فرزند، ابتدا functions.php قالب فرزند و سپس functions.php قالب والد بارگذاری می‌شود. برای مطالعه درباره قالب فرزند، قالب وردپرس چایلد چیست و چه زمانی به آن نیاز داریم؟ را ببینید.

پس از بارگذاری قالب، هوک after_setup_theme اجرا می‌شود که به قالب اجازه می‌دهد قابلیت‌های خود را ثبت کند. سپس هوک init اجرا می‌شود که برای ثبت نوع نوشته سفارشی، تاکسونومی، و سایر قابلیت‌ها استفاده می‌شود. برای مطالعه درباره نوع نوشته سفارشی، ساخت نوع نوشته سفارشی در وردپرس را ببینید.

ترتیب اجرای هوک‌ها در bootstrap

یکی از مهم‌ترین جنبه‌های wp-settings.php، ترتیب اجرای هوک‌هاست. این ترتیب به شرح زیر است:

1. muplugins_loaded: پس از بارگذاری mu-plugins.
2. plugin_loaded: برای هر افزونه پس از بارگذاری.
3. plugins_loaded: پس از بارگذاری همه افزونه‌ها.
4. sanitize_comment_cookies: برای پاک‌سازی کوکی‌های دیدگاه.
5. setup_theme: قبل از بارگذاری قالب.
6. after_setup_theme: پس از بارگذاری قالب.
7. init: برای مقداردهی اولیه.
8. wp_loaded: پس از کامل شدن bootstrap.

هر یک از این هوک‌ها در نقطه خاصی از bootstrap اجرا می‌شوند و درک ترتیب آن‌ها برای توسعه‌دهندگان حیاتی است. برای مطالعه درباره هوک‌ها، مهم‌ترین هوک‌های WordPress کدامند و چه کاربردهایی دارند؟ را ببینید.

در تجربه کاری، دیده شده که بسیاری از خطاهای "هوک اجرا نشد" به‌دلیل استفاده نادرست از هوک در ترتیب اشتباه رخ می‌دهند. برای مطالعه درباره دیباگ هوک‌ها، دیباگ کردن Action و Filter در وردپرس را ببینید.

تفاوت‌ها در Multisite

در نصب‌های Multisite، wp-settings.php رفتار متفاوتی دارد. وردپرس ابتدا بررسی می‌کند که آیا Multisite فعال است و سپس افزونه‌های شبکه‌ای را بارگذاری می‌کند:

if ( is_multisite() ) {
    if ( ! defined( 'WP_INSTALLING' ) || 'wp-activate.php' === $pagenow ) {
        foreach ( wp_get_active_network_plugins() as $plugin ) {
            wp_register_plugin_realpath( $plugin );
            include_once( $plugin );
            do_action( 'network_plugin_loaded', $plugin );
        }
        do_action( 'muplugins_loaded' );
    }
}

این ساختار نشان می‌دهد که در Multisite، ابتدا افزونه‌های شبکه‌ای بارگذاری می‌شوند و سپس هوک muplugins_loaded اجرا می‌شود. برای مطالعه درباره Multisite، آموزش کار با وردپرس مولتی‌سایت را ببینید.

دیباگ و نقاط مداخله

wp-settings.php نقاط مداخله متعددی برای توسعه‌دهندگان فراهم می‌کند. مهم‌ترین این نقاط عبارتند از:

• هوک muplugins_loaded برای اجرای کد قبل از افزونه‌های معمولی.
• هوک plugins_loaded برای اجرای کد پس از بارگذاری افزونه‌ها.
• هوک setup_theme برای اجرای کد قبل از بارگذاری قالب.
• هوک after_setup_theme برای اجرای کد پس از بارگذاری قالب.
• هوک init برای مقداردهی اولیه.

برای دیباگ bootstrap، می‌توان از ثابت WP_DEBUG و WP_DEBUG_LOG استفاده کرد:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

این تنظیمات باعث می‌شوند خطاها در فایل wp-content/debug.log ثبت شوند. برای مطالعه درباره دیباگ، فعال‌سازی حالت Debug وردپرس و پیدا کردن خطاها را ببینید.

در تجربه کاری، دیده شده که بسیاری از خطاهای bootstrap با فعال‌سازی WP_DEBUG و بررسی لاگ‌ها قابل شناسایی هستند. برای مطالعه درباره رفع خطای صفحه سفید، چگونه خطای سفید صفحه مرگ در وردپرس را برطرف کنیم؟ را ببینید.

پرسش‌های پرتکرار

آیا می‌توان wp-settings.php را ویرایش کرد؟

خیر، ویرایش این فایل توصیه نمی‌شود، زیرا با هر به‌روزرسانی وردپرس بازنویسی می‌شود. برای مداخله، از هوک‌ها و فایل‌های سفارشی استفاده کنید.

چرا وردپرس در wp-settings.php خطا می‌دهد؟

معمولاً به‌دلیل مشکل در wp-config.php، عدم دسترسی به دیتابیس، یا تداخل افزونه‌ها. با فعال‌سازی WP_DEBUG می‌توان علت را شناسایی کرد.

تفاوت mu-plugins و plugins معمولی چیست؟

mu-plugins (Must-Use Plugins) قبل از افزونه‌های معمولی بارگذاری می‌شوند و نمی‌توان آن‌ها را از پنل مدیریت غیرفعال کرد.

آیا می‌توان ترتیب بارگذاری افزونه‌ها را تغییر داد؟

خیر، ترتیب بارگذاری افزونه‌ها بر اساس حروف الفبا و نوع آن‌ها (mu-plugins، network، معمولی) تعیین می‌شود. اما می‌توان با هوک‌ها ترتیب اجرای کد را کنترل کرد.

چرا هوک init در برخی پروژه‌ها دیر اجرا می‌شود؟

هوک init پس از بارگذاری کامل افزونه‌ها و قالب اجرا می‌شود. اگر افزونه‌ای در این مرحله کد سنگینی اجرا کند، ممکن است init با تأخیر اجرا شود.

جدول ترتیب بارگذاری

توصیه بر اساس سناریو

اگر یک توسعه‌دهنده افزونه هستید، باید هوک plugins_loaded و init را به‌خوبی بشناسید. اگر یک توسعه‌دهنده قالب هستید، هوک after_setup_theme نقطه شروع شماست. اگر با خطاهای bootstrap مواجه هستید، ابتدا WP_DEBUG را فعال کنید و لاگ‌ها را بررسی کنید. اگر می‌خواهید عملکرد سایت را بهینه کنید، بارگذاری‌های غیرضروری را در mu-plugins حذف کنید.

در نهایت، درک wp-settings.php یک سرمایه‌گذاری بلندمدت است که دیباگ و توسعه وردپرس را بسیار آسان‌تر می‌کند. برای مطالعه بیشتر درباره ساختار وردپرس، ساختار هسته وردپرس چگونه کار می‌کند را ببینید.

برای اطلاعات بیشتر درباره bootstrap وردپرس، می‌توانید به ویکی‌پدیا مراجعه کنید.

تجربه خود را به اشتراک بگذارید

اگر در پروژه‌های وردپرس با مسائل bootstrap مواجه شده‌اید، برای ما جالب است بدانید کدام بخش بیشترین چالش را داشته است. تجربه خودتان را در دیدگاه‌ها بنویسید؛ به‌خصوص اگر راه‌حل خلاقانه‌ای پیدا کرده‌اید که می‌تواند برای خواننده بعدی مفید باشد.