ssp-base

simpleSAMLphp的基础镜像

Docker镜像：silintl/ssp-base

镜像概述和主要用途

ssp-base是专为simpleSAMLphp打造的基础镜像，提供运行simpleSAMLphp所需的底层环境，支持本地测试、开发调试及基础部署场景，简化基于simpleSAMLphp的身份认证服务搭建过程。

核心功能和特性

• 提供simpleSAMLphp运行的基础依赖环境
• 支持通过环境变量配置关键参数
• 兼容Docker Compose部署流程
• 集成调试支持，可配合PhpStorm进行远程调试

适用场景

适用于需要快速搭建simpleSAMLphp开发或测试环境的场景，尤其适合开发人员进行本地功能验证、调试配置及基础服务部署测试。

前提软件

部署和使用前需安装以下软件：

• Docker
• docker-compose

可选工具（简化操作）：

• Make（用于简化构建命令）

Windows用户额外依赖：

• Vagrant

本地测试部署步骤

基础配置与启动

1. 在项目根目录执行以下命令复制环境配置模板并调整：

   bash
   cp local.env.dist local.env
   

2. 编辑local.env文件，将GitHub token添加至COMPOSER_AUTH变量（用于依赖拉取）。
3. 启动服务（二选一）：
   • 使用Make简化命令：

     bash
     make
     

   • 直接使用docker-compose：

     bash
     docker-compose up -d
     

4. 访问http://localhost即可查看运行中的simpleSAMLphp服务。

PhpStorm远程调试配置

前提条件

确保PhpStorm版本为2016.3或更高。

配置步骤

1. 配置Docker服务器：
   打开偏好设置（Windows为设置）→ 构建、执行、部署，点击+添加服务器，参数如下：

   • 名称：Docker
   • API URL：tcp://localhost:2375
   • 证书文件夹：留空
   • Docker Compose可执行文件：填写docker-compose脚本的完整路径
     点击应用保存。

2. 配置PHP CLI解释器：
   在偏好设置→ 语言与框架→ PHP中，点击CLI解释器旁的...，再点击+添加远程解释器，参数如下：

   • 名称：Remote PHP7
   • 远程类型：Docker
   • 服务器：选择步骤1中添加的Docker服务器
   • 调试器扩展路径：/usr/lib/php/20151012/xdebug.so
     点击应用→ 确定。

3. 配置路径映射：
   在PHP设置页面，编辑路径映射，将本地项目根目录映射到容器内的/data目录，点击应用→ 确定。

4. 配置调试运行项：
   点击运行→ 编辑配置，点击+选择PHP Web应用，参数如下：

   • 名称：Debug via Docker
   • 服务器配置：点击...→ +添加服务器，设置：
     • 名称：Localhost
     • 主机：localhost
     • 端口：80
     • 调试器：Xdebug
     • 勾选使用路径映射，添加映射：本地项目根目录 → /data
       点击应用→ 确定。

5. 启动调试：
   点击运行→ 调试'Debug via Docker'开始远程调试。

注：sildisco的LogUser模块为可选功能，可通过authproc配置触发使用。