宝塔面板 · PHP 8.2 · 扩展安装

PIXPRO主题安装教程：XLoader PHP扩展的安装与配置

2026年5月26日

问题背景

在 WordPress 中使用 PIXPRO 主题时，可能会遇到以下报错： 

Fatal error: E104 in /www/wwwroot/xxx/wp-content/themes/pixpro/inc/mod/pix-admin.php on line 1

E104 是 XLoader（一款 PHP 代码加密扩展）的报错码，表示该 PHP 文件已被 XLoader 加密，但服务器未安装对应的解密扩展，导致文件无法执行。

PIXPRO 主题的核心文件使用了 XLoader 加密保护，因此要正常使用该主题，必须先在服务器上安装 XLoader PHP 扩展。

本文将详细介绍如何通过宝塔面板在 Linux 服务器上为 PHP 8.2 安装 XLoader 扩展。

准备工作

1. 确认 PHP 版本

在宝塔面板左侧菜单点击 「软件商店」→「已安装」，找到 PHP，确认版本号。本文以 PHP 8.2 为例。

注意：XLoader 扩展文件按 PHP 版本编译（5.6 / 7.0 / 7.1 / 7.2 / 7.3 / 7.4 / 8.0 / 8.1 / 8.2 / 8.3 / 8.4），请根据你实际使用的 PHP 版本选择对应的 .so 文件，否则安装后无法正常工作。

2. 获取 XLoader 扩展文件

确保已准备好 XLoader 扩展包，解压后得到一系列 .so 文件。本文使用： 

XLoader_Lin_php8.2_x64.so

该文件是专门为 Linux 64 位系统 + PHP 8.2 编译的。

3. 关键信息速查

安装步骤

1 上传 .so 文件到服务器

通过宝塔面板内置的文件管理器上传扩展文件：

  1. 点击宝塔面板左侧 「文件」
  2. 导航到扩展目录：/www/server/php/82/lib/php/extensions/
  3. 点击上传按钮，选择 XLoader_Lin_php8.2_x64.so
  4. 确认上传成功
说明：上传目录不限于上述路径，任何 PHP 可读取的目录均可。但放在 extensions 目录下便于统一管理。如果目录不存在，可手动创建。

2 在宝塔面板中配置 PHP

  1. 进入宝塔面板 → 「软件商店」→「已安装」
  2. 找到 PHP-8.2，点击右侧的 「设置」
  3. 点击 「配置文件」 标签页
  4. 滚动到文件最底部
  5. 添加以下一行配置：
extension=/www/server/php/82/lib/php/extensions/XLoader_Lin_php8.2_x64.so
重要：请确保此处的路径与你实际上传的路径完全一致。如果上传到了其他目录，请相应修改路径。

3 重启 PHP

配置修改后需要重启 PHP 才能生效：

  1. 在 PHP-8.2 设置页面，点击 「服务」 标签
  2. 点击 「重启」 按钮
  3. 等待提示重启成功

4 验证安装

重启后验证 XLoader 是否成功加载：

  1. 在 PHP-8.2 设置页面，点击 「phpinfo」 标签
  2. 使用浏览器搜索（Ctrl+F / Cmd+F）关键词 XLoader
  3. 如果看到 XLoader 相关配置信息，说明安装成功

或者创建一个 phpinfo.php 文件放到网站根目录：

<?php
phpinfo();
?>

通过浏览器访问该文件，搜索 XLoader 确认加载状态。

常见问题排查

Q1: 安装后刷新网站仍然报 E104 错误

原因一：扩展未真正加载。进入 phpinfo 页面，搜索 "XLoader"，确认是否存在。如果不存在，检查配置文件中 extension= 的路径是否正确，路径中的文件名是否一致。

原因二：PHP 版本不匹配。文件使用 XLoader for PHP 7.4 加密，但你安装的是 PHP 8.2 版本的 .so 文件。需要确认加密文件使用的 XLoader 版本，安装对应版本。

原因三：重启未生效。重新进入 PHP 设置 → 服务 → 重启，确保看到"重启成功"的提示。

Q2: 如何确认 PIXPRO 需要哪个版本的 XLoader？

查看 pix-admin.php 文件头部（用文本编辑器打开），XLoader 加密的文件通常会在文件开头包含版本标识。或者联系主题开发者获取准确信息。

Q3: 多个 PHP 版本如何同时安装？

如果你的服务器同时运行多个 PHP 版本（如 8.0、8.1 和 8.2），需要分别在每个 PHP 版本中重复上述步骤，使用对应的 .so 文件。 宝塔面板中每个 PHP 版本有独立的配置文件。

Q4: 安装 XLoader 后 wp-admin 进不去了？

这通常不是 XLoader 的问题，而是主题本身导致的。可以通过以下方式临时切换到默认主题：

  1. 宝塔面板 → 数据库 → phpMyAdmin → 选择 WordPress 数据库
  2. 执行 SQL（注意替换表前缀）：
UPDATE wp_options SET option_value = 'twentytwentyfive' WHERE option_name = 'template';
UPDATE wp_options SET option_value = 'twentytwentyfive' WHERE option_name = 'stylesheet';

刷新后即可进入后台。

总结

XLoader 是一款 PHP 代码加密/解密扩展，PIXPRO 等商业主题常用它来保护核心代码。安装流程归纳为四步：

  1. 上传 .so 文件到服务器的 PHP 扩展目录
  2. 配置 php.ini，添加 extension= 加载指令
  3. 重启 PHP 使配置生效
  4. 验证 通过 phpinfo 确认扩展已加载

关键在于：选择与 PHP 8.2 版本匹配的 .so 文件、确保路径正确、记得重启。

返回首页