d3strukt0r/fhnw-artworks-api-php

fhnw-artworks-api-php镜像

镜像概述

本镜像为FHNW学生开发的ArtWorks软件的核心PHP API组件，基于Laravel框架实现艺术作品管理相关的接口服务。需配合Nginx镜像（d3strukt0r/fhnw-artworks-api-nginx）及客户端镜像（d3strukt0r/fhnw-artworks-client）使用，支持Docker Compose一键部署完整系统，适用于开发、测试与生产环境。

核心功能

1. 提供艺术作品数据的增删改查API接口
2. 集成JWT认证机制保障接口安全
3. 支持数据库迁移与种子数据生成
4. 可配置PHP运行参数（内存限制、上传大小等）
5. 兼容Docker Compose多组件协同部署

使用场景

1. 本地开发：通过Docker Compose快速搭建包含数据库、API、Nginx及客户端的开发环境
2. 测试验证：部署测试版本，验证功能正确性与接口稳定性
3. 生产部署：配置稳定版本，提供线上艺术作品管理服务

配置说明

关键环境变量

• DB_HOST：数据库地址（默认：db）
• DB_USERNAME：数据库用户名（默认：root）
• DB_PASSWORD：数据库密码（需自定义）
• APP_KEY：Laravel应用密钥（需通过php artisan key:generate生成）
• JWT_SECRET：JWT认证密钥（需通过php artisan jwt:secret生成）
• PHP_MEMORY_LIMIT：PHP内存限制（默认：256M）
• PHP_UPLOAD_MAX_FILESIZE：文件上传大小限制（默认：100M）

容器运行示例

shell
docker run \
  -e DB_HOST="your-db-ip" \
  -e DB_USERNAME="artworks-user" \
  -e DB_PASSWORD="your-pass" \
  -e APP_KEY="base64:xxxxxx" \
  -e JWT_SECRET="xxxxxx" \
  docker.xuanyuan.run/d3strukt0r/fhnw-artworks-api-php

Docker Compose完整部署示例

yaml
version: "2"
services:
  db:
    image: mariadb
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
    volumes:
      - ./db-data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: root-pass
      MYSQL_DATABASE: artworks
  
  php:
    image: d3strukt0r/fhnw-artworks-api-php:latest
    depends_on: [db]
    environment:
      DB_HOST: db
      DB_USERNAME: root
      DB_PASSWORD: root-pass
      DB_DATABASE: artworks
      APP_KEY: your-app-key
      JWT_SECRET: your-jwt-secret
  
  api:
    image: d3strukt0r/fhnw-artworks-api-nginx:latest
    depends_on: [php]
    ports: [81:80]
  
  client:
    image: d3strukt0r/fhnw-artworks-client:latest
    ports: [80:80]