Docker环境下安装Source Guardian (SG) 扩展的详细指南

在Docker容器化环境中部署PHP应用时，如果您的应用使用了Source Guardian加密，那么为PHP环境安装SG扩展是必不可少的步骤。主题铺为您整理了一份详尽的Docker环境下安装Source Guardian (SG) 扩展的详细指南，涵盖了不同Linux基础镜像的安装方法以及通用的手动安装流程，确保您能顺利完成配置。

安装前须知：

• SG扩展与PHP版本严格对应：每个PHP版本都需要对应的SG Loader文件。
• SG扩展与操作系统架构对应：Loader文件通常分为Linux x86_64、ARM等，请确保下载正确版本。

步骤一：进入Docker容器内部

首先，您需要进入到运行PHP服务的Docker容器内部命令行界面。

docker exec -it <容器名/容器ID> bash

• 将<容器名/容器ID>替换为您实际的容器名称或ID。

步骤二：检查PHP版本和容器基础镜像

在容器内部，我们需要确认当前PHP的版本以及容器所基于的Linux发行版，以便选择最合适的安装方法。

• 查看PHP版本： php -v 记下PHP版本号（例如：PHP 8.1.x）。
• 查看Linux发行版：
  cat /etc/os-release
# 或者尝试：
lsb_release -a
  根据输出判断是Debian/Ubuntu、Alpine还是CentOS/RHEL等。

步骤三：根据容器基础镜像选择安装方法

不同的Linux发行版使用不同的包管理器，因此安装PHP开发工具的方法也有所不同。

A. Debian/Ubuntu基础镜像（最常见）

例如：php:8.1-fpm、wordpress:latest等。

1. 更新包列表：
   apt-get update
2. 安装PHP扩展工具： apt-get install -y php-dev php-pear wget unzip
   • php-dev提供了编译PHP扩展所需的头文件和开发工具。
   • php-pear是PHP扩展和应用仓库。
   • wget和unzip用于下载和解压SG Loader。
3. 检查是否有php-sg16包（直接安装SG扩展）： apt-cache search php-sg16
   • 如果搜索到php-sg16包，说明您的发行版仓库可能直接提供了SG Loader。
   • 如果有，直接安装：
     apt-get install -y php-sg16
     安装完成后，通常会自动配置好，您可以跳到步骤五验证。
   • 如果没有，则需要进行手动安装（请跳到步骤四）。

B. Alpine基础镜像

例如：php:8.1-fpm-alpine等。

1. 更新包列表：
   apk update
2. 安装PHP扩展工具：
   apk add php-dev php-pear wget unzip
3. 检查是否有php-sg16包： apk search php-sg16
   • 通常Alpine官方仓库不会直接提供SG Loader。
   • 如果没有，需要进行手动安装（请跳到步骤四）。

C. CentOS/RHEL基础镜像

例如：centos/php-fpm等。

1. 更新包列表：
   yum update
# 或使用dnf（较新版本RHEL/CentOS）
dnf update
2. 安装PHP扩展工具：
   yum install -y php-devel php-pear wget unzip
# 或使用dnf
dnf install -y php-devel php-pear wget unzip
   • php-devel提供了编译PHP扩展所需的开发工具。
3. 通常需要手动安装（请跳到步骤四）。

步骤四：手动安装Source Guardian（通用方法）

如果您的基础镜像没有直接提供SG Loader包，或者您想确保安装最新版本，请使用此通用方法。

1. 下载对应版本的Source Guardian Loader：
   • 访问官网：在容器外部，通过浏览器访问Source Guardian官网下载页面：https://www.sourceguardian.com/loaders/download。
     • 根据您在步骤二中查到的PHP版本和Linux系统架构（通常是Linux x86_64）下载对应的loaders.linux-x86_64.tar.gz压缩包。
     • 将下载好的文件通过docker cp命令复制到容器内部，例如：
       docker cp loaders.linux-x86_64.tar.gz <容器名/容器ID>:/tmp/
       然后进入容器内部进行后续操作。
   • 直接在容器内使用wget下载（替换为对应PHP版本的URL，这里的URL是通用压缩包）：
     wget https://www.sourceguardian.com/loaders/download/loaders.linux-x86_64.tar.gz -O /tmp/loaders.tar.gz
     主题铺提示：确保下载链接是最新的且与您的PHP版本和系统架构匹配。
2. 解压文件：
   cd /tmp
tar -zxvf loaders.tar.gz
   解压后会得到一个名为loaders的目录，里面包含不同PHP版本的loader文件（例如ixed.8.1.lin、ixed.8.2.lin等）。
3. 查看PHP扩展目录： php -i | grep extension_dir 输出会显示PHP的扩展目录路径，例如/usr/lib/php/20210902/（这个路径根据PHP版本和发行版可能不同）。
4. 复制对应PHP版本的loader文件到扩展目录：
   根据您在步骤二查到的PHP版本（例如PHP 8.1），将对应的loader文件复制到上一步查到的扩展目录。
   # 示例：PHP 8.1
cp /tmp/loaders/ixed.8.1.lin /usr/lib/php/20210902/
   • 请务必替换ixed.8.1.lin为您的实际PHP版本对应的loader文件名，替换/usr/lib/php/20210902/为您的实际扩展目录。
5. 查看php.ini文件位置： php --ini 输出会列出PHP配置文件的路径，通常是/etc/php/8.1/fpm/php.ini或/etc/php8/php.ini等。
6. 编辑php.ini文件，在末尾添加SG扩展配置：
   使用vi或nano等编辑器打开php.ini文件。
   # 示例：使用vi编辑器
vi /etc/php/8.1/fpm/php.ini
   在文件末尾添加以下行：
   ; Source Guardian Loader
extension=ixed.8.1.lin
   • 请将ixed.8.1.lin替换为您复制到扩展目录的实际loader文件名。
   • 保存并退出编辑器。

步骤五：重启PHP服务或Docker容器

为了使SG扩展生效，您需要重启PHP服务或整个Docker容器。

• 如果容器内有PHP服务管理工具（如systemd或php-fpm服务）：
  # 示例：重启PHP 8.1 FPM服务
service php8.1-fpm restart
# 或
/etc/init.d/php8.1-fpm restart
  • 请替换php8.1-fpm为您的实际PHP服务名称。
• 或者，直接重启Docker容器（推荐，更彻底）：
  在宿主机命令行执行：
  docker restart <容器名/容器ID>

步骤六：验证安装

重启后，重新进入Docker容器内部，执行以下命令验证SG扩展是否已成功加载：

php -m | grep -i source

如果输出中包含SourceGuardian或ixed等字样，则表示SG扩展已成功安装并加载。

通过以上详细步骤，主题铺相信您可以在Docker环境中为您的PHP应用顺利安装Source Guardian扩展，确保加密代码的正常运行。