ارتقای PHP بدون شکستن سایت: راهنمای گام‌به‌گام برای مدیران وب

چرا ارتقای PHP ضروری است و چه خطراتی دارد؟

ارتقای PHP یکی از مهم‌ترین اقدامات برای حفظ امنیت و عملکرد سایت شماست. نسخه‌های قدیمی PHP مانند 5.6 یا 7.0 دیگر پشتیبانی امنیتی دریافت نمی‌کنند و هکرها به راحتی می‌توانند از آسیب‌پذیری‌های آن‌ها سوءاستفاده کنند. علاوه بر این، نسخه‌های جدید PHP مانند 8.1 و 8.2 تا ۳۰٪ سریع‌تر از نسخه‌های قبلی هستند و ویژگی‌های مدرنی مانند JIT (Just-In-Time Compilation) و typed properties را ارائه می‌دهند.

اما ارتقای PHP بدون برنامه‌ریزی می‌تواند سایت شما را از کار بیندازد. بسیاری از کدهای قدیمی، به‌ویژه در سیستم‌های مدیریت محتوا (CMS) مانند وردپرس، جوملا یا دروپال، از توابع منسوخ شده (deprecated) استفاده می‌کنند که در نسخه‌های جدید حذف شده‌اند. برای مثال، تابع mysql_connect() در PHP 7.0 حذف شد و جای خود را به mysqli_connect() یا PDO داد. اگر سایت شما هنوز از این تابع استفاده کند، با خطای مرگبار (Fatal Error) مواجه می‌شود.

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

مرحله ۱: بررسی سازگاری کد و افزونه‌ها

قبل از هر اقدامی، باید بدانید که کدهای شما با نسخه جدید PHP سازگار هستند یا خیر. این کار را می‌توانید با ابزارهای خودکار یا دستی انجام دهید.

استفاده از ابزارهای آنلاین و خط فرمان

ابزار PHP Compatibility Checker برای وردپرس یک پلاگین رایگان است که تمام فایل‌های قالب و افزونه‌ها را اسکن می‌کند و مشکلات سازگاری را گزارش می‌دهد. برای پروژه‌های سفارشی، می‌توانید از ابزار خط فرمان PHP_CodeSniffer با استاندارد PHPCompatibility استفاده کنید:

# نصب PHP_CodeSniffer و استاندارد PHPCompatibility
composer global require "squizlabs/php_codesniffer=*"
composer global require "phpcompatibility/php-compatibility"

# اجرای اسکن روی پوشه پروژه
phpcs --standard=PHPCompatibility --runtime-set testVersion 8.1 /path/to/your/project

این دستور تمام فایل‌های PHP را بررسی می‌کند و خطاهایی مانند استفاده از توابع حذف شده، نوع داده‌های ناسازگار، و تغییرات در رفتار توابع را نشان می‌دهد. برای مثال، اگر کدی از تابع each() استفاده کند (که در PHP 8.0 حذف شده)، هشدار دریافت می‌کنید.

بررسی افزونه‌ها و کتابخانه‌های شخص ثالث

اگر از CMS استفاده می‌کنید، حتماً افزونه‌ها و قالب‌های خود را به‌روزرسانی کنید. بسیاری از توسعه‌دهندگان نسخه‌های جدید را برای سازگاری با PHP 8.x منتشر کرده‌اند. برای مثال، وردپرس 6.0 به بعد با PHP 8.0 و 8.1 کاملاً سازگار است. اما افزونه‌های قدیمی ممکن است هنوز مشکل داشته باشند. لیست افزونه‌های ناسازگار را در پنل مدیریت وردپرس (Tools > Site Health) بررسی کنید.

اشتباه رایج: بسیاری از مدیران تصور می‌کنند که با به‌روزرسانی CMS، همه مشکلات حل می‌شود. اما افزونه‌های شخص ثالث ممکن است به‌روزرسانی نشده باشند. همیشه افزونه‌ها را جداگانه تست کنید.

مرحله ۲: ایجاد یک محیط تست ایزوله

هرگز ارتقای PHP را مستقیماً روی سایت اصلی (production) انجام ندهید. یک محیط تست (staging) ایجاد کنید که دقیقاً مشابه سایت اصلی باشد. این کار به شما امکان می‌دهد بدون نگرانی از خرابی، تغییرات را آزمایش کنید.

راه‌اندازی محیط تست با Docker

ساده‌ترین روش برای ایجاد محیط تست، استفاده از Docker است. یک فایل docker-compose.yml با نسخه جدید PHP ایجاد کنید:

version: '3.8'
services:
  web:
    image: php:8.1-apache
    ports:
      - "8080:80"
    volumes:
      - ./your-site:/var/www/html
    environment:
      - MYSQL_HOST=db
      - MYSQL_USER=testuser
      - MYSQL_PASSWORD=testpass
  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=testdb
      - MYSQL_USER=testuser
      - MYSQL_PASSWORD=testpass

سپس با دستور docker-compose up -d محیط را راه‌اندازی کنید. فایل‌های سایت خود را در پوشه your-site قرار دهید و از طریق http://localhost:8080 به آن دسترسی داشته باشید.

استفاده از زیردامنه یا ساب‌دایرکتوری

اگر به Docker دسترسی ندارید، می‌توانید یک زیردامنه مانند test.yourdomain.com ایجاد کنید و نسخه جدید PHP را فقط برای آن فعال کنید. در هاست‌های اشتراکی، معمولاً می‌توانید از طریق cPanel یا DirectAdmin نسخه PHP را برای هر دامنه جداگانه تنظیم کنید. برای مثال، در cPanel به بخش "Select PHP Version" بروید و نسخه 8.1 را برای زیردامنه تست انتخاب کنید.

نکته مهم: حتماً یک کپی از دیتابیس اصلی را در محیط تست import کنید. از دستور mysqldump برای پشتیبان‌گیری و سپس mysql برای بازیابی استفاده کنید:

# پشتیبان‌گیری از دیتابیس اصلی
mysqldump -u username -p main_database > backup.sql

# بازیابی در دیتابیس تست
mysql -u testuser -p test_database < backup.sql

مرحله ۳: تست کامل عملکرد و رفع خطاها

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

تست دستی صفحات کلیدی

صفحات زیر را مرور کنید و مطمئن شوید که بدون خطا نمایش داده می‌شوند:

• صفحه اصلی و صفحات داخلی
• فرم‌های تماس، ثبت‌نام و ورود
• صفحات مدیریت (admin panel)
• فرآیند پرداخت و سبد خرید (در سایت‌های فروشگاهی)

همچنین، خطاهای PHP را در لاگ‌ها بررسی کنید. در محیط تست، نمایش خطاها را فعال کنید:

// در فایل php.ini یا در ابتدای اسکریپت
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

تست خودکار با PHPUnit

اگر پروژه شما تست‌های واحد (unit tests) دارد، آن‌ها را با نسخه جدید PHP اجرا کنید. برای مثال:

cd /path/to/your/project
phpunit --configuration phpunit.xml

این کار تضمین می‌کند که توابع اصلی بدون مشکل کار می‌کنند. اگر تستی fail شود، خطا را رفع کنید و دوباره تست را اجرا کنید.

رفع مشکلات رایج

برخی از رایج‌ترین مشکلات ارتقای PHP عبارتند از:

• استفاده از توابع حذف شده: مانند create_function() (حذف در PHP 7.2) یا each() (حذف در PHP 8.0). این توابع را با معادل‌های مدرن جایگزین کنید.
• تغییر در نوع داده‌ها: در PHP 8.0، نوع داده‌های پیش‌فرض سخت‌گیرانه‌تر شده‌اند. برای مثال، اگر تابعی انتظار int دارد و شما string ارسال کنید، خطای TypeError دریافت می‌کنید.
• مشکلات با پسوندهای PHP: برخی پسوندها مانند mcrypt در PHP 7.2 حذف شده‌اند. از openssl یا sodium به جای آن استفاده کنید.

اشتباه رایج: برخی مدیران فقط صفحه اصلی را تست می‌کنند و از بخش‌های دیگر غافل می‌شوند. حتماً تمام مسیرهای کاربری (user flows) را بررسی کنید.

مرحله ۴: پشتیبان‌گیری کامل و برنامه‌ریزی برای برگرداندن

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

پشتیبان‌گیری از فایل‌ها و دیتابیس

از دستورات زیر برای پشتیبان‌گیری استفاده کنید:

# پشتیبان‌گیری از فایل‌ها (با استفاده از tar)
tar -czf site-backup-$(date +%Y%m%d).tar.gz /path/to/your/site

# پشتیبان‌گیری از دیتابیس
mysqldump -u username -p --all-databases > db-backup-$(date +%Y%m%d).sql

این فایل‌ها را در یک مکان امن (مثلاً فضای ابری یا هارد دیسک جداگانه) ذخیره کنید.

برنامه برگرداندن سریع (Rollback Plan)

اگر پس از ارتقای PHP سایت شما خراب شد، باید بتوانید در کمتر از ۵ دقیقه به نسخه قبلی برگردید. مراحل زیر را از قبل آماده کنید:

1. نسخه قبلی PHP را در سرور نگه دارید (مثلاً PHP 7.4 و PHP 8.1 هر دو نصب باشند).
2. یک اسکریپت ساده برای تغییر نسخه PHP بنویسید. برای مثال، در سرورهای Nginx با PHP-FPM:

# تغییر از PHP 8.1 به PHP 7.4
sudo update-alternatives --set php /usr/bin/php7.4
sudo systemctl restart php7.4-fpm
sudo systemctl restart nginx

همچنین، اگر از هاست اشتراکی استفاده می‌کنید، معمولاً در پنل مدیریت گزینه‌ای برای تغییر نسخه PHP وجود دارد. این گزینه را از قبل شناسایی کنید.

نکته مهم: اگر سایت شما از Redis یا Memcached استفاده می‌کند، پس از برگرداندن، کش را پاک کنید تا از تداخل داده‌های قدیمی جلوگیری شود.

مرحله ۵: اجرای ارتقای PHP روی سایت اصلی

پس از اطمینان از سازگاری در محیط تست، نوبت به اجرای ارتقای PHP روی سایت اصلی می‌رسد. این کار را در زمان کم‌ترافیک (مثلاً نیمه‌شب) انجام دهید.

اعمال تغییرات گام‌به‌گام

ابتدا سایت را در حالت maintenance قرار دهید تا کاربران با خطا مواجه نشوند. در وردپرس، می‌توانید از پلاگین‌هایی مانند "WP Maintenance Mode" استفاده کنید. سپس نسخه PHP را تغییر دهید:

• در سرورهای مجازی (VPS): از دستور update-alternatives یا تغییر فایل .htaccess (برای Apache) استفاده کنید.
• در هاست اشتراکی: از پنل مدیریت (cPanel یا DirectAdmin) نسخه PHP را برای دامنه اصلی تغییر دهید.

پس از تغییر، سایت را از حالت maintenance خارج کنید و سریعاً عملکرد آن را بررسی کنید. اگر همه چیز خوب بود، کار تمام است.

بررسی لاگ‌ها و رفع مشکلات پس از ارتقا

حتی پس از تست کامل، ممکن است خطاهای کوچکی ظاهر شوند. لاگ‌های خطای PHP را بررسی کنید:

tail -f /var/log/php_errors.log

اگر خطایی مشاهده کردید، آن را رفع کنید. برای مثال، اگر افزونه‌ای از تابع strftime() استفاده کند (که در PHP 8.1 منسوخ شده)، می‌توانید آن را با date() جایگزین کنید.

اشتباه رایج: برخی مدیران پس از ارتقا، سایت را رها می‌کنند. حداقل تا ۲۴ ساعت لاگ‌ها را زیر نظر داشته باشید.

نتیجه‌گیری: ارتقای PHP با اطمینان

ارتقای PHP یک فرآیند حساس است، اما با رعایت مراحل بالا می‌توانید آن را بدون شکستن سایت انجام دهید. خلاصه مراحل:

1. سازگاری کد و افزونه‌ها را با ابزارهایی مانند PHP_CodeSniffer بررسی کنید.
2. یک محیط تست ایزوله (با Docker یا زیردامنه) ایجاد کنید.
3. تمام بخش‌های سایت را تست کنید و خطاها را رفع کنید.
4. پشتیبان‌گیری کامل تهیه کنید و برنامه برگرداندن سریع داشته باشید.
5. ارتقا را در زمان کم‌ترافیک انجام دهید و لاگ‌ها را زیر نظر بگیرید.

اگر به دنبال یک راه‌حل حرفه‌ای برای مدیریت سرور خود هستید، سرورنت (ServerNet) خدمات میزبانی وب با پشتیبانی از نسخه‌های مختلف PHP را ارائه می‌دهد که می‌تواند فرآیند ارتقای PHP را برای شما ساده‌تر کند. با این حال، مهم‌ترین نکته این است که همیشه قبل از هر تغییری، پشتیبان‌گیری کنید و محیط تست داشته باشید. با این روش، ارتقای PHP نه تنها خطرناک نیست، بلکه باعث بهبود امنیت و عملکرد سایت شما می‌شود.