roundcube/google-spell-pspell

PHP Google拼写检查XML API替代镜像

镜像概述

该Docker镜像提供了一个PHP环境下的pspell替代品，专门用于实现与Google拼写检查XML API兼容的功能。它旨在为无法使用pspell扩展或需要兼容Google拼写检查接口的PHP应用提供轻量级解决方案。

核心功能与特性

• pspell替代方案：无需依赖系统pspell库，提供独立的拼写检查能力
• API兼容性：完全兼容Google拼写检查XML API接口规范，可直接替换现有集成
• 轻量级设计：基于精简PHP环境构建，镜像体积小，部署快速
• 多语言支持：支持多种语言的拼写检查（具体语言取决于内置词典）
• 易于集成：提供简单的HTTP接口，可直接通过XML请求进行拼写检查

使用场景与适用范围

• PHP应用中需要拼写检查功能但无法安装pspell扩展的环境
• 需兼容Google拼写检查XML API的遗留系统升级或迁移
• 开发和测试环境中的拼写检查功能验证与调试
• 轻量级Web应用的用户输入文本拼写纠错功能实现
• 内容管理系统(CMS)的文本编辑组件拼写检查支持

使用方法与配置说明

基本部署

通过以下命令快速启动容器：

bash
docker run -d -p 8080:80 --name php-spell-check [镜像名称]

环境变量配置

支持以下环境变量进行自定义配置：

• PORT: 服务监听端口，默认值为80
• SUPPORTED_LANGUAGES: 支持的语言列表，逗号分隔，如"en,fr,es"
• MAX_TEXT_LENGTH: 最大检查文本长度，默认值为1000字符
• LOG_LEVEL: 日志级别，可选值：debug, info, warn, error，默认info

示例配置：

bash
docker run -d -p 8080:80 --name php-spell-check \
  -e SUPPORTED_LANGUAGES="en,zh" \
  -e MAX_TEXT_LENGTH=2000 \
  -e LOG_LEVEL=debug \
  [镜像名称]

API使用示例

通过HTTP POST请求调用拼写检查API，请求体为符合Google拼写检查XML格式的内容：

bash
curl -X POST http://localhost:8080/check \
  -H "Content-Type: application/xml" \
  -d '<?xml version="1.0"?><spellrequest text="teh quick brown fox jump over teh lazy dog"/>'

响应示例（XML格式）：

xml
<?xml version="1.0"?>
<spellresult error="0" clipped="0" charschecked="39">
  <c o="0" l="3" s="1">the teh</c>
  <c o="25" l="3" s="1">jumps jump</c>
  <c o="32" l="3" s="1">the teh</c>
</spellresult>

Docker Compose配置

yaml
version: '3'
services:
  spell-check-service:
    image: docker.xuanyuan.run/[镜像名称]
    ports:
      - "8080:80"
    environment:
      - SUPPORTED_LANGUAGES=en,zh,fr
      - MAX_TEXT_LENGTH=3000
      - LOG_LEVEL=info
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost/health"]
      interval: 30s
      timeout: 10s
      retries: 3

注意事项

• 首次启动时会加载语言词典，可能需要几秒钟时间
• 对于大量并发请求，建议适当调整容器资源限制
• 不支持Google拼写检查API的高级特性（如个性化词典）
• 语言支持取决于镜像内置的词典文件，如需额外语言需自定义构建镜像