DSM 7 安装 PEAR 教程：Synology NAS PHP 扩展仓库分步实操指南
在 Synology DSM 7 系统上开发或运行 PHP 应用（如自定义网站、企业内部系统）时，很多用户会遇到一个关键需求：依赖PEAR（PHP Extension and Application Repository） —— 这是 PHP 的官方扩展与应用仓库，包含大量成熟的 PHP 类库（如邮件发送类 Mail、数据验证类 Validate），是 PHP 开发的重要工具。但 DSM 7 系统默认未预装 PEAR，且安装流程需通过 SSH 命令行操作，对非技术用户有一定门槛。本文基于 Synology 官方技术文档，从 “安装前提准备” 切入，提供 “SSH 启用→Web Station 配置→PEAR 命令行安装→验证与维护” 的全流程分步指南，同时覆盖常见故障排查，帮你在 DSM 7 上高效完成 PEAR 安装，满足 PHP 应用的依赖需求。
一、DSM 7 安装 PEAR 的 4 项核心前提准备
在启动安装前，需先完成 DSM 7 系统的基础配置，确保后续操作无权限或依赖缺失问题。若前提不满足，可能导致 PEAR 安装失败（表格整理关键准备项，清晰易懂）：
准备类别 | 具体要求 | 关键说明 |
1. DSM 系统版本 | 需为 DSM 7.0 及以上版本（推荐 DSM 7.1/7.2 稳定版），不支持 DSM 6.x 及以下版本 | 可通过 DSM「控制面板→更新和还原→DSM 更新」查看当前版本，若版本过低，需先升级系统（升级前建议备份数据） |
2. 启用 SSH 功能 | 需在 DSM 中开启 SSH 服务，用于后续通过命令行执行安装命令 | SSH 是安装 PEAR 的唯一途径，DSM 7 默认禁用，需手动启用并配置端口（如 22） |
3. 安装 Web Station 与 PHP | 需安装「Web Station」套件（PHP 运行环境载体），并至少安装一个 DSM 7 支持的 PHP 版本（如 PHP 7.4、PHP 8.1） | PEAR 依赖 PHP 环境，且不同 PHP 版本对应 PEAR 安装路径不同，建议安装常用版本（如 PHP 8.1） |
4. 管理员账户权限 | 需使用 DSM 管理员账户（如 admin）或拥有 “管理员权限” 的自定义账户操作 | 普通账户无 SSH 登录权限，也无法执行 PEAR 安装所需的系统命令（如 wget、chmod） |
前提准备操作细节（关键步骤补充）：
- 启用 SSH 步骤：登录 DSM→「控制面板→终端机和 SNMP」→勾选 “启动 SSH 功能”→设置 SSH 端口（默认 22，若被占用可改为 2222）→点击「应用」，弹出 “安全提示” 后点击「确定」；
- 安装 Web Station 与 PHP 步骤：打开「套件中心」→搜索 “Web Station”→点击「安装」→安装完成后，打开「Web Station→PHP 设置」→点击「新增」→选择 PHP 版本（如 “PHP 8.1”）→保持默认配置→点击「确定」，完成 PHP 环境搭建。
二、DSM 7 安装 PEAR 的 6 步详细操作（命令行实操）
PEAR 安装需通过 SSH 连接 DSM，执行一系列命令行操作，每一步均需严格按顺序执行，且需注意 PHP 路径与命令拼写（以安装 PHP 8.1 对应的 PEAR 为例，其他版本可类比调整）：
步骤 1：通过 SSH 工具连接 DSM
- 选择 SSH 工具（Windows 推荐 PuTTY、Xshell；macOS/Linux 可直接使用终端），以 PuTTY 为例：
- 打开 PuTTY→在 “Host Name (or IP address)” 中输入 DSM 的 IP 地址（如 192.168.1.100）→“Port” 输入之前设置的 SSH 端口（如 22）→“Connection type” 选择 “SSH”→点击「Open」；
- 首次连接会弹出 “安全警告”，点击「Accept」→进入登录界面，输入 DSM 管理员账户（如 admin）和密码→按回车登录（输入密码时无字符显示，属正常现象，输完直接回车即可）；
- 登录成功后，终端显示类似 “admin@SynologyNAS:~$” 的提示符，说明已进入 DSM 命令行环境。
步骤 2：定位 PHP 可执行文件路径（关键！避免安装到错误版本）
DSM 7 中不同 PHP 版本的可执行文件路径不同，需先找到目标 PHP 版本的 “php” 命令路径，以 PHP 8.1 为例：
- 执行以下命令，查看系统中已安装的 PHP 版本路径：
- 终端会输出类似路径：/usr/local/bin/php81 /usr/local/bin/php81-cli（“php81” 对应 PHP 8.1，“php74” 对应 PHP 7.4，以此类推）；
- 确认目标 PHP 版本的 CLI 路径（CLI 版本用于命令行操作），PHP 8.1 的 CLI 路径为/usr/local/bin/php81-cli，记录该路径，后续步骤需使用。
步骤 3：下载 PEAR 安装脚本（官方推荐方式）
PEAR 官方提供专用安装脚本 “go-pear.phar”，需通过 wget 命令下载到 DSM 的临时目录（如 /tmp），步骤如下：
- 执行以下命令，切换到临时目录（避免占用系统关键路径）：
- 执行 wget 命令下载安装脚本（若提示 “wget: command not found”，需先安装 wget 工具，执行sudo apt-get install wget即可）：
wget https://pear.php.net/go-pear.phar
- 下载成功后，终端显示 “100%[======================================>]”，且 /tmp 目录下会新增 “go-pear.phar” 文件；
- 执行以下命令，验证脚本是否完整（若输出 “PHP Archive”，说明脚本正常）：
步骤 4：执行 PEAR 安装脚本（核心步骤）
使用目标 PHP 版本的 CLI 命令执行安装脚本，过程中需按提示配置 PEAR 安装路径，步骤如下：
- 执行以下命令，启动 PEAR 安装（将 “/usr/local/bin/php81-cli” 替换为步骤 2 记录的 PHP CLI 路径）：
sudo /usr/local/bin/php81-cli go-pear.phar
- 首次执行会提示 “Are you installing a system-wide PEAR or a local copy?”（是否安装为系统级 PEAR），输入 “system”→按回车；
- 接下来会显示 PEAR 各组件的安装路径配置（如 “PEAR directory”“PHP code directory”），建议保持默认路径（系统会自动适配 DSM 7 目录结构），直接按回车确认；
- 配置完成后，脚本开始自动安装 PEAR 核心组件，终端会输出 “install ok: channel://pear.php.net/PEAR-1.10.13”（版本号可能不同，属正常现象），说明核心安装完成。
步骤 5：配置 PEAR 环境变量（确保全局可调用）
安装完成后，需将 PEAR 的 “pear” 命令添加到 DSM 全局环境变量中，避免每次执行需输入完整路径，步骤如下：
- 执行以下命令，打开环境变量配置文件（使用 nano 编辑器，DSM 7 默认预装）：
- 在文件末尾添加以下内容（将 “/usr/local/pear/bin” 替换为步骤 4 中确认的 PEAR bin 目录，默认即为该路径）：
export PATH=$PATH:/usr/local/pear/bin
- 按 “Ctrl+O” 保存文件→按回车确认→按 “Ctrl+X” 退出 nano 编辑器；
- 执行以下命令，使环境变量立即生效（无需重启 DSM）：
步骤 6：验证 PEAR 安装成功（关键收尾）
执行以下命令，验证 PEAR 是否安装成功且可全局调用：
- 执行 “pear version” 命令，查看 PEAR 版本信息：
- 若输出类似 “PEAR Version: 1.10.13”“PHP Version: 8.1.23” 的信息，说明 PEAR 安装成功，且与目标 PHP 版本关联正确；
- 执行 “pear list” 命令，查看已安装的 PEAR 组件：
- 终端会显示 “Installed packages, channel pear.php.net” 及默认组件列表（如 PEAR、Structures_Graph、XML_Util），无报错即说明安装完整。
三、DSM 7 安装 PEAR 后的 2 个核心维护操作
安装 PEAR 后，需掌握基础的维护命令，用于后续安装 PHP 扩展、升级 PEAR 本身，确保满足 PHP 应用的依赖需求：
1. 使用 PEAR 安装 PHP 扩展（以安装 Mail 类为例）
PEAR 的核心作用是管理 PHP 扩展，安装扩展需通过 “pear install” 命令，步骤如下：
- 执行以下命令，搜索需要的扩展（如搜索 “Mail” 类）：
- 终端会显示匹配的扩展列表，找到 “Mail” 对应的 “Package” 名称（通常为 “Mail”）；
- 执行以下命令，安装 Mail 扩展：
- 验证扩展是否安装到 PHP 目录：执行ls /usr/local/lib/php81/PEAR/Mail（替换为目标 PHP 版本的 PEAR 目录），若显示 “Mail.php” 等文件，说明扩展安装成功。
2. 升级 PEAR 到最新版本
PEAR 会定期更新，需通过命令升级以修复漏洞、支持新功能，步骤如下：
- 执行以下命令，更新 PEAR 自身：
- 若当前已是最新版本，终端显示 “Nothing to upgrade”；若有更新，会自动下载并安装，完成后显示 “upgrade ok”；
- 执行以下命令，升级所有已安装的 PEAR 扩展：
- 该命令会批量升级所有过期的扩展，适合定期维护（建议每月执行一次）。
四、DSM 7 安装 PEAR 的 5 个常见问题与解决方案
Q1：执行 “pear version” 提示 “pear: command not found”，怎么办？
答：核心是环境变量未生效，解决方案：
- 重新执行环境变量生效命令：source /etc/profile；
- 若仍失败，检查步骤 5 中添加的环境变量路径是否正确（默认应为 “/usr/local/pear/bin”），可通过ls /usr/local/pear/bin/pear验证路径是否存在；
- 临时解决方案：直接使用完整路径执行 PEAR 命令，如/usr/local/pear/bin/pear version。
Q2：安装 PEAR 时提示 “Permission denied”（权限不足），如何处理？
答：需使用 sudo 获取管理员权限，解决方案：
- 所有安装命令前添加 “sudo”（如sudo /usr/local/bin/php81-cli go-pear.phar）；
- 若 sudo 提示 “admin is not in the sudoers file”，需先将 admin 账户添加到 sudoers：
- 执行su root（输入 root 密码，默认与 admin 密码相同）；
- 执行nano /etc/sudoers，在 “root ALL=(ALL) ALL” 下添加 “admin ALL=(ALL) ALL”；
- 保存后退出，重新登录 SSH 即可使用 sudo。
Q3：不同 PHP 版本（如 PHP 7.4 与 PHP 8.1）能否同时安装 PEAR？
答：可以，但需区分安装路径，避免冲突，操作要点：
- 安装 PHP 7.4 对应的 PEAR 时，使用 PHP 7.4 的 CLI 路径（/usr/local/bin/php74-cli）执行安装脚本；
- 配置环境变量时，需为不同版本的 PEAR 设置不同路径（如 PHP 7.4 的 PEAR 路径为 “/usr/local/pear74/bin”）；
- 使用时需通过完整路径调用对应版本的 PEAR（如/usr/local/pear74/bin/pear install），避免版本混淆。
Q4：安装 PEAR 扩展时提示 “no releases available for package”（无可用版本），怎么解决？
答：需更新 PEAR 频道列表，步骤如下：
- 执行以下命令，更新 PEAR 频道索引：
sudo pear channel-update pear.php.net
- 清除 PEAR 缓存：
- 重新执行扩展安装命令，通常可解决无可用版本的问题。
Q5：DSM 7 重启后，PEAR 命令无法使用，需重新配置环境变量，为什么？
答：DSM 7 默认不自动加载 “/etc/profile” 文件，解决方案：
- 将环境变量配置到 “~/.bashrc” 文件（用户登录时自动加载）：
- 添加环境变量：export PATH=$PATH:/usr/local/pear/bin；
- 保存后执行source ~/.bashrc，后续重启 DSM 登录 SSH，PEAR 命令可直接使用。
五、总结：DSM 7 安装 PEAR 的 3 个核心注意事项
- PHP 版本对应是关键：安装前务必确认目标 PHP 版本的 CLI 路径，避免将 PEAR 安装到错误版本（如用 PHP 7.4 的 CLI 安装，却在 PHP 8.1 应用中调用，导致扩展无法加载）；
- 权限操作要谨慎：所有涉及系统目录的命令（如修改 /etc/profile、安装扩展）需使用 sudo，避免因权限不足导致安装失败，同时不要使用 root 账户直接操作（存在安全风险）；
- 定期维护不可少：建议每月执行 “pear upgrade-all” 升级扩展，每季度检查 DSM 系统更新（避免系统版本与 PEAR 兼容性问题），确保 PEAR 环境稳定运行。
通过本文的分步操作，你可在 DSM 7 系统上顺利完成 PEAR 安装，满足 PHP 应用的扩展依赖需求。若操作中遇到官方文档未覆盖的特殊问题（如自定义 PHP 编译参数导致的路径异常），可联系 Synology 技术支持，提供 SSH 命令执行日志与错误截图，获取针对性帮助。