همه مقالات تخصصی

مهاجرت امن URL وردپرس با WP-CLI و داده Serialized

جایگزینی خام URL در SQL می‌تواند طول رشته‌های Serialized افزونه و قالب را خراب کند.

مهاجرت امن URL وردپرس با WP-CLI و داده Serialized

WP-CLI search-replace این ساختار را می‌شناسد و dry-run دارد. با بکاپ معتبر، محدوده مشخص و آزمون staging، آدرس سایت را بدون جایگزینی کور در همه جدول‌ها تغییر دهید.

دامنه و پیش‌نیازها

دستور را از مسیر نصب و با کاربر مجاز اجرا کنید؛ root لازم نیست. در Multisite، --network و دامنه‌های mapping دامنه تغییر را بزرگ‌تر می‌کنند؛ نمونه حاضر برای Single Site است. old/new را دقیق با scheme بنویسید. خروجی export ممکن است credential و داده شخصی داشته باشد؛ بیرون webroot با مجوز محدود نگه دارید.

۱. شواهد را جمع‌آوری کنید

home و siteurl و جدول‌های افزونه را inventory کنید. بکاپ دیتابیس همراه فایل‌ها و زمان سازگار آماده شود. dry-run گزارش تعداد تغییرها را می‌دهد؛ تعداد غیرمنتظره یا صفر نیاز به توقف و بررسی دارد. --all-tables ممکن است داده برنامه دیگری را تغییر دهد و نباید گزینه پیش‌فرض باشد.

wp option get home
wp option get siteurl
wp db tables
# Save outside webroot; set restrictive directory permissions first.
wp db export /srv/private-backups/before-url-migration.sql

۲. تغییر کنترل‌شده

GUID معمولاً شناسه محتواست و نباید به‌عنوان URL نمایشی مهاجرت کند؛ --skip-columns=guid را نگه دارید. همان دستور آزمایش‌شده را بدون --dry-run اجرا کنید. در دیتابیس پرترافیک، freeze کوتاه نوشتن یا طرح Cutover لازم است تا تغییرها با سفارش یا فرم هم‌زمان تداخل نکنند.

wp search-replace 'https://old.example.test' 'https://new.example.test' --skip-columns=guid --dry-run
# Only after review, backup and write coordination:
wp search-replace 'https://old.example.test' 'https://new.example.test' --skip-columns=guid

۳. نتیجه را آزمایش کنید

ورود مدیریت، فرم، خرید، فایل‌های media و لینک‌های داخلی را تست کنید. دستور را دوباره با dry-run اجرا کنید تا باقی‌مانده‌های داخل محدوده مشخص شود. Reverse Proxy، CDN، صفحه‌کش و تنظیمات hardcoded نیز ممکن است URL قدیمی داشته باشند. تغییر DNS و Redirect 301 را از تغییر دیتابیس جدا ولی هماهنگ انجام دهید.

wp search-replace 'https://old.example.test' 'https://new.example.test' --skip-columns=guid --dry-run
wp option get home
wp option get siteurl

بازگشت و پیشگیری

برای rollback به بکاپ سازگار و برنامه حفظ نوشتن‌های جدید نیاز دارید. جایگزینی معکوس همیشه rollback دقیق نیست، چون URL جدید ممکن است از قبل در محتوا بوده باشد. بکاپ را از مسیر عمومی خارج نگه دارید و cache را فقط با آگاهی از دامنه اثر invalidate کنید. تغییر موفق باید با آزمون عملکرد اثبات شود.

برای بررسی بخش‌های مرتبط این مسیر، راهنماهای رفع کد قدیمی پس از Deploy با تنظیم درست PHP OPcache و Split DNS با BIND؛ پاسخ داخلی و عمومی برای یک دامنه را نیز ببینید.

منابع فنی