phatdev/docs

Khắc phục lỗi Dependency Checks

Scanner báo thiếu PHP extension hoặc function.

scannerdependencies

Dependency Checks Failed

Scanner phát hiện server thiếu PHP extension hoặc function cần thiết → block build/restore.

Required PHP extensions

  • ZipArchive — đóng gói archive
  • openssl — encryption tokens
  • mbstring — string encoding
  • json — config files
  • curl — kết nối storage cloud
  • pdo_mysql hoặc mysqli — database
  • fileinfo — detect MIME type

Kiểm tra extension đã cài

Tạo file info.php trong web root:

<?php phpinfo(); ?>

Truy cập https://example.com/info.php → tìm tên extension. Xóa file sau khi check xong (lộ thông tin server).

Cài extension thiếu

Cách cài tùy hosting:

  • Shared hosting: thường đã có sẵn các extension phổ biến. Nếu thiếu, liên hệ support yêu cầu cài.
  • VPS Ubuntu/Debian: apt install php-zip php-curl php-mbstring php-mysql php-xml
  • VPS CentOS/RHEL: yum install php-zip php-curl php-mbstring php-mysqlnd php-xml
  • cPanel: WHM → PHP Extensions Manager
  • Plesk: Tools & Settings → PHP Settings

Sau khi cài extension, restart PHP-FPM (VPS) hoặc đợi vài phút (shared hosting).

Required PHP functions

Scanner cũng kiểm tra một số function:

  • exec() — cho Shell Exec engine
  • shell_exec()
  • escapeshellarg()
  • set_time_limit()
  • ini_set()

Một số host disable các function này qua disable_functions trong php.ini. Nếu exec bị disable, không dùng được Shell Exec engine — chuyển sang DupArchive.

ionCube / Suhosin

Một số hosting có ionCube Loader hoặc Suhosin patch — có thể block một số operation của plugin.

Nếu build fail và phát hiện có Suhosin → liên hệ hosting yêu cầu whitelist các function plugin cần.

WordPress version

Plugin yêu cầu WordPress >= 4.9 (khuyến nghị 6.0+). Update WordPress trong wp-admin nếu version cũ.

Tham khảo