dainst/cilantro-ojs3

ojs3-docker镜像说明

概述

本镜像提供PKP Open Journal Systems（OJS3）的完整Docker化版本，附带DAI特定插件。仓库通过Shell脚本简化Docker操作，默认数据存储于Docker卷中，支持多容器实例共享数据。首次启动需数分钟，后续使用已准备的卷启动仅需几秒。

核心功能

• 基于官方php:7.3-apache镜像构建
• 集成最新MariaDB数据库容器（通过docker-compose定义）
• 数据卷存储，支持多实例共享数据
• 内置XDebug调试配置，适配VSCode等IDE
• 包含DAI特定插件，扩展OJS3功能
• 通过docker-compose实现容器生命周期管理

使用场景

• 学术期刊系统的容器化部署与管理
• OJS3开发环境的快速搭建与调试
• 多环境（开发/测试/生产）的一致部署

配置说明

Git子模块初始化

运行命令初始化子模块：

bash
git submodule update --init --recursive

.env文件配置

复制模板并自定义内容：

bash
cp .env-default .env

OJS SQL dump准备

将SQL dump放入mariadb_data目录，确保docker-compose.yml正确挂载该文件到MariaDB容器。

Docker容器管理

使用docker-compose命令：

• 构建镜像：docker-compose build
• 启动容器：docker-compose up
• 停止容器：docker-compose stop（或Ctrl+C终止）
• 销毁容器及数据卷：docker-compose down -v

XDebug配置（VSCode）

1. 生成自动配置：点击Debug -> Start debugging，选择PHP。
2. 修改launch.json添加路径映射：

json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www/html": "/path/to/workspace/ojs"
            }
        }
    ]
}

3. 点击Debug标签页的运行按钮启动调试。

许可证

基于GPL-3.0许可证，详情见LICENSE文件。