织梦采集侠安装失败怎么办？

第一步：检查服务器环境（最常见的原因）

织梦采集侠是一个需要在服务器上运行的插件，对服务器环境有一定要求,请先确认以下几点：

PHP 版本

织梦采集侠对 PHP 版本有要求，通常不支持 PHP 7.4 及以上版本，尤其是 PHP 8.x，高版本的 PHP 移除了一些不安全的函数,导致采集侠无法运行。

• 如何检查：
  • 在您的网站根目录创建一个名为 info.php 的文件，内容为 <?php phpinfo(); ?>。
  • 在浏览器中访问这个文件（www.yourdomain.com/info.php）。
  • 查看页面顶部的 "PHP Version"。
• 解决方案：
  • 如果您的 PHP 版本是 7.4 或更高，您需要联系您的主机服务商，将网站的 PHP 版本降级到 5.6 或 7.0 - 7.3 之间,这是最关键的一步。

PHP 扩展（重要）

采集侠依赖一些 PHP 扩展来运行，如果没开启,安装时会直接失败。

• 需要开启的扩展：
  • curl：用于远程获取网页内容。
  • openssl：用于支持 HTTPS 网站。
  • gd 或 imagick：用于处理图片。
  • mbstring：用于处理多字节字符（中文）。
• 如何检查：
  • 同样在 info.php 页面，搜索 "Loaded Modules" 或 "Configure Command",查看这些扩展是否已列出。
• 解决方案：

  如果缺少扩展，同样需要联系主机服务商，让他们为您开启这些 PHP 扩展。

文件和目录权限

织梦系统需要写入权限来完成安装。

• 需要设置可写权限的目录：
  • /data 目录（存放缓存和配置文件）
  • /dede 目录（后台管理目录）
  • /include 目录
  • /uploads 目录
  • 以及 /templets 目录下的相关模板文件。
• 如何设置：
  • 通过 FTP 或文件管理器，右键点击这些目录，选择“权限”或“属性”。
  • 将权限值设置为 755 (目录) 或 644 (文件)。
  • 如果您使用的是 Linux 服务器，可以通过 SSH 命令设置：

    chmod -R 755 /path/to/your/dede
    chmod -R 755 /path/to/your/data
    # ... 其他目录同理

第二步：检查安装过程和文件完整性

下载正确的安装包

确保您下载的是与您的织梦CMS版本匹配的织梦采集侠,不要用高版本的采集侠去安装低版本的织梦。

• 下载地址： 请务必从织梦官方或可信的渠道下载。

上传文件到正确位置

采集侠的安装包通常是一个 .zip 压缩文件，里面包含一个 DedeCaiJiXia 文件夹。

• 正确的上传位置： 将 DedeCaiJiXia 文件夹完整地上传到您网站的 /include 目录下。
• 错误示范： 不要只解压里面的文件，直接上传到 /include,也不要上传到根目录。

执行安装程序

上传完成后,访问安装地址。

• 安装地址格式： http://您的域名/include/DedeCaiJiXia/install/
• 如果访问后出现 404 或其他错误：
  • 检查 /include/DedeCaiJiXia 文件夹是否存在。
  • 检查 install 文件夹里的文件是否都上传完整了。
  • 确认服务器的伪静态规则是否正确（有时会影响访问）。

第三步：解决安装过程中的常见错误信息

在安装向导页面,根据具体的错误提示来解决问题：

错误1：“采集侠核心文件不存在或无法写入”

• 原因： 通常是 /include/DedeCaiJiXia 文件夹权限不够,或者里面的文件没有上传全。
• 解决： 重新检查文件上传是否完整，并将该文件夹及其内部所有文件的权限设置为 755。

错误2：“PHP版本不兼容”

• 原因： 如第一步所述，您的 PHP 版本太高。
• 解决： 联系主机服务商，强制降级 PHP 版本到 5.6 或 7.0-7.3,这是最有效的解决方法。

错误3：“无法连接到数据库”

• 原因： 安装时填写的数据库信息（主机名、用户名、密码、数据库名）不正确。
• 解决：
  1. 登录您的网站主机控制面板（如 cPanel、Plesk 等）。
  2. 找到“数据库”管理功能。
  3. 确认数据库名、数据库用户名和密码。
  4. 如果您不确定主机名，通常是 localhost，但也有可能是 0.0.1 或主机服务商提供的其他地址。

错误4：“GD库未开启”

• 原因： PHP 缺少 gd 扩展。
• 解决： 联系主机服务商，为您开启 gd 扩展。

第四步：安装后的配置和验证

1. 删除安装目录： 安装成功后，务必删除 /include/DedeCaiJiXia/install/ 目录,以防止安全风险。
2. 登录后台： 登录织梦后台，在“采集侠”菜单下找到“授权码管理”,输入您的授权码。
3. 测试运行： 创建一个简单的采集任务，尝试运行，看是否能正常获取到内容,这是验证安装是否成功的最终方法。

总结与最终建议

如果以上所有步骤都检查过，问题依然存在，那么最可能的原因是服务器环境问题，特别是 PHP 版本过高。

最后的解决方案：

1. 联系主机服务商： 直接告诉他们您要安装“织梦采集侠”，这个插件需要 PHP 5.6 或 7.0-7.3 版本，并且需要开启 curl 和 openssl 扩展,请他们协助您配置。
2. 更换服务器/主机： 如果服务商无法提供兼容的 PHP 版本，您可能需要考虑更换一个对老版本 PHP 支持更好的主机服务商。

希望这个详细的指南能帮助您成功安装织梦采集侠！祝您使用愉快！