خطای ZipArchive چیست و چه زمانی رخ می دهد؟
خطای Class ZipArchive not found یک خطای مرگبار در PHP است. این خطا زمانی نمایش داده می شود که سرور لوکال هاست شما نمی تواند فایل های فشرده را باز کند.
این مشکل معمولا هنگام نصب بسته نصبی دابلکیتور روی XAMPP دیده می شود. اسکریپت installer.php برای استخراج فایل archive.zip به ماژول ZipArchive نیاز دارد. اگر این ماژول فعال نباشد، فرآیند نصب متوقف می شود.
فرض کنید یک قالب آماده و حرفه ای مانند قالب فروشگاهی دیجی کالا یا هر قالب وردپرسی دیگر را با افزونه duplicator pro تهیه کرده اید. حالا می خواهید این بسته نصبی را روی لوکال هاست XAMPP نصب کنید. ناگهان با خطای مرگبار Class ZipArchive not found مواجه می شوید. این خطا یعنی سرور لوکال هاست شما نمی تواند فایل فشرده قالب را باز کند و فرآیند نصب متوقف می شود.
علت اصلی بروز این خطا چیست؟
دلیل اصلی این خطا بسیار ساده است. ماژول ZipArchive در فایل تنظیمات PHP غیرفعال می باشد.
در نسخه های جدید XAMPP مانند نگارش 8.2 و بالاتر، این ماژول به طور پیش فرض غیرفعال است. اما در نسخه های قدیمی تر مانند XAMPP 7.4، این ماژول فعال بوده و کاربران با این خطا مواجه نمی شدند.
روش فعال سازی ZipArchive در XAMPP
برای رفع این خطا، کافیست مراحل زیر را به ترتیب انجام دهید. کل فرآیند کمتر از پنج دقیقه زمان می برد.
گام اول: باز کردن فایل php.ini
ابتدا نرم افزار XAMPP را دانلود کرده و سپس کنترل پنل آنرا اجرا کنید. روی دکمه Config در کنار سرویس Apache کلیک کنید. از منوی باز شده، گزینه PHP (php.ini) را انتخاب کنید.
در صورتی که این روش جواب نداد، به مسیر زیر بروید:
C:\xampp\php\php.iniفایل را با نرم افزار Notepad++ باز کنید.
گام دوم: پیدا کردن خط مورد نظر
در فایل باز شده، کلیدهای Ctrl+F را همزمان فشار دهید. عبارت زیر را جستجو کنید:
;extension=zipاین خط معمولا در بخش تنظیمات ماژول های PHP قرار دارد.
گام سوم: فعال کردن ماژول
خط پیدا شده به شکل زیر است:
;extension=zipنقطه ویرگول ابتدای خط را حذف کنید. نتیجه نهایی باید به این شکل باشد:
extension=zipدر نسخه های قدیمی تر ممکن است خط به صورت زیر باشد:
;extension=php_zip.dllدر آن حالت نیز نقطه ویرگول را حذف کنید.
گام چهارم: ذخیره و ریستارت
فایل php.ini را ذخیره کنید. به کنترل پنل XAMPP برگردید. روی دکمه Stop در کنار Apache کلیک کنید. چند ثانیه صبر کنید. سپس روی دکمه Start کلیک کنید.
توجه کنید که بستن پنجره XAMPP کافی نیست. حتما باید سرویس Apache متوقف و دوباره راه اندازی شود.
گام پنجم: بررسی موفقیت فعال سازی
یک فایل تست درست کنید. به مسیر C:\xampp\htdocs\ بروید. فایل جدیدی به نام info.php بسازید. کد زیر را در آن وارد کنید:
<?php phpinfo(); ?>مرورگر خود را باز کنید. آدرس زیر را وارد کنید:
http://localhost/info.phpدر صفحه باز شده، کلمه Zip را جستجو کنید. اگر اطلاعات مربوط به ZipArchive نمایش داده شد، فعال سازی با موفقیت انجام شده است.
روش جایگزین برای مواقع ضروری
اگر به هر دلیلی نتوانستید ماژول ZipArchive را فعال کنید، این روش جایگزین را امتحان کنید.
فایل archive.zip را با نرم افزار 7-Zip یا WinRAR باز کنید. تمام محتویات را در پوشه پروژه خود استخراج کنید. مطمئن شوید فایل installer.php نیز در همان پوشه قرار دارد. حالا مرورگر را باز کرده و installer.php را اجرا کنید.
در صفحه نصب دابلکیتور، گزینه Manual Package Extraction را پیدا کنید. این گزینه را فعال کنید. سپس مراحل نصب را مانند حالت عادی ادامه دهید.
چرا انتخاب نسخه مناسب XAMPP مهم است؟
نسخه XAMPP تاثیر مستقیمی بر بروز این خطا دارد. در نسخه 7.4 و پایین تر، ماژول Zip به طور پیش فرض فعال است. در نسخه 8.0 و بالاتر، این ماژول غیرفعال می باشد.
توصیه متخصصان به کاربران مبتدی این است که از نسخه XAMPP 7.4 استفاده کنند. این نسخه پایدارتر است. همچنین با اکثر قالب ها و افزونه های وردپرس سازگاری کامل دارد. اگر از نسخه 8.2 یا بالاتر استفاده می کنید، حتما پس از نصب، ماژول Zip را به صورت دستی فعال کنید.
نکات پیشگیرانه برای پروژه های آینده
برای اینکه دیگر با این خطا مواجه نشوید، این نکات ساده را رعایت کنید.
پس از هر بار نصب مجدد XAMPP، اولین کاری که انجام دهید فعال کردن ماژول Zip است. قبل از شروع هر پروژه جدید، یک فایل phpinfo ایجاد کنید و وضعیت ماژول Zip را بررسی کنید. همیشه آخرین نسخه افزونه دابلکیتور را دانلود و استفاده کنید. اگر از نسخه جدید XAMPP استفاده می کنید، لیست ماژول های فعال را یادداشت کنید.
سوالات پرتکرار کاربران درباره خطای ZipArchive
آیا این خطا فقط مربوط به دابلکیتور است؟
خیر. هر افزونه یا سیستمی که نیاز به باز کردن فایل ZIP داشته باشد، به این ماژول نیاز دارد. برای مثال آپدیت برخی قالب ها یا نصب خودکار افزونه ها نیز ممکن است با این خطا مواجه شوند.
آیا این خطا در هاست های آنلاین هم دیده می شود؟
بله، در برخی هاست های اشتراکی ارزان قیمت ممکن است این ماژول غیرفعال باشد. در آن صورت باید از پشتیبانی هاست بخواهید آن را فعال کنند.
آیا امکان دارد مشکل از فایل archive.zip باشد؟
بله، در موارد نادر ممکن است فایل archive.zip خراب یا ناقص دانلود شده باشد. قبل از هر کاری، از سالم بودن فایل فشرده اطمینان حاصل کنید.
جمع بندی نهایی
خطای Class ZipArchive not found یکی از شایع ترین خطاهای نصب دابلکیتور روی لوکال هاست XAMPP است. این مشکل با حذف یک نقطه ویرگول در فایل php.ini حل می شود.
در این مقاله یاد گرفتید که چگونه ماژول ZipArchive را در XAMPP فعال کنید. همچنین با روش جایگزین استخراج دستی فایل ها آشنا شدید. با رعایت نکات پیشگیرانه، دیگر هرگز با این خطا مواجه نخواهید شد.
اگر پس از انجام تمام مراحل، مشکل همچنان پابرجا بود، تنظیمات php.ini را مجددا بررسی کنید. از ذخیره شدن تغییرات و ریستارت صحیح XAMPP اطمینان حاصل کنید.