microparts/static-server-php

microparts/static-server-php 镜像文档

镜像概述

microparts/static-server-php是一个专为现代JavaScript单页应用（SPA）设计的静态服务器镜像，基于nginx封装，支持企业级配置标准，提供安全、高效的静态资源服务能力。镜像已迁移至https://github.com/spacetab-io/static-server-php%E3%80%82

核心功能

• SPA优化：针对Vue、React、Angular等SPA应用优化，支持前端配置注入。
• 安全增强：默认添加安全响应头（如CSP、XSS保护、HSTS等），获得securityheaders.com A+评级。
• 高效压缩：默认启用Brotli压缩（Gzip作为老旧浏览器 fallback）。
• 热重载：支持无需重启主进程的配置与文件重载。
• 爬虫控制：默认屏蔽所有robots.txt访问。
• 配置灵活：支持通过YAML文件自定义服务器配置、CSP头、Link头等。

使用场景

• 部署Vue、React、Angular等SPA应用。
• 需要安全合规的静态资源服务场景。
• 需灵活配置服务器参数的企业级应用部署。

配置说明

环境变量

镜像支持以下环境变量配置：

• CONFIG_PATH：服务器及前端配置文件路径（默认：/app/configuration）。
• STAGE：运行环境（如prod/dev/local，默认：local）。
• VCS_SHA1：构建 commit SHA1（用于调试）。

默认文件结构

镜像默认根目录为/app，包含以下文件：

• favicon.ico：透明图标（避免日志错误）。
• index.html：默认欢迎页面。
• robots.txt：默认屏蔽所有爬虫。
• /.well-known/security.txt：安全联系信息配置。

自定义配置

通过YAML文件（如configuration/dev/server.yaml）可自定义：

• CSP头：配置内容安全策略，示例：

  yaml
  dev:
    server:
      headers:
        csp:
          - default-src 'self' *.example.com
          - script-src 'self'
  

• Link头：配置资源预加载，示例：

  yaml
  dev:
    server:
      headers:
        link:
          - value: </app/style.css>; rel=preload; as=style
  

部署示例

Dockerfile 用法

dockerfile
FROM microparts/static-server-php:2.0.3

ARG VCS_SHA1
ARG STAGE

# 复制前端资源及配置
COPY dist/ /app
COPY ./configuration /app/configuration

Docker Run 示例

bash
docker run -d \
  -p 8080:8080 \
  -v ./dist:/app/dist \
  -v ./configuration:/app/configuration \
  -e STAGE=prod \
  microparts/static-server-php:2.0.3

CLI 用法

镜像提供以下CLI命令：

1. 启动服务器：

   bash
   server run
   

2. 重载配置：

   bash
   server reload
   

3. 导出配置：

   bash
   server dump
   

测试

镜像支持PHPUnit测试，开发环境下可执行：

bash
vendor/bin/phpunit

许可证

本镜像基于GNU GPL v3许可证开源。