kayvan/contact-form

简单PHP联系表单镜像

镜像概述

本镜像基于Alpine系统构建，封装了Simple PHP Contact Form工具，支持HTML5原生表单验证（浏览器不支持时自动启用JavaScript fallback），并集成ssmtp组件用于配置邮件发送功能，可快速部署到网站中接收用户反馈。

核心功能

1. 表单验证：支持HTML5原生验证及JS降级方案，确保输入数据合规；
2. 邮件发送：通过ssmtp配置实现邮件投递，可自定义收件人、发件人等参数；
3. 自定义配置：支持修改表单字段名称、提示信息等；
4. 跨浏览器兼容：兼容IE9+及主流现代浏览器（Chrome、Firefox、Opera、Safari）。

使用场景

• 个人/企业网站添加联系表单，接收用户咨询或反馈；
• 小型项目快速集成表单功能，无需手动搭建PHP环境。

配置说明

1. 修改配置文件：编辑config.php文件，填写收件人***、发件人***等参数：

php
<?php
return [
    'subject' => ['prefix' => '[Contact Form]'],
    'emails' => [
        'to'   => 'your-receive@example.com', // 收件人邮箱
        'from' => 'contact@your-domain.com'  // 发件人邮箱（需与部署域名一致）
    ],
    'messages' => [
        'error'   => '发送失败，请稍后重试。',
        'success' => '消息已成功发送！'
    ],
    'fields' => [
        'name'     => '姓名',
        'email'    => '邮箱',
        'phone'    => '电话',
        'subject'  => '主题',
        'message'  => '留言',
        'btn-send' => '发送'
    ]
];

2. ssmtp配置：在容器内/etc/ssmtp/目录下配置SMTP服务器信息（如***服务商的SMTP地址、端口、认证信息）。

部署示例

Docker Run命令

bash
docker run -d -p 8080:80 \
  -v /host/path/to/config:/var/www/html/contact-form/config \
  docker.xuanyuan.run/kayvan/contact-form

访问http://localhost:8080/contact-form即可使用联系表单。

Docker Compose示例

yaml
version: '3'
services:
  contact-form:
    image: docker.xuanyuan.run/kayvan/contact-form
    ports:
      - "8080:80"
    volumes:
      - ./config:/var/www/html/contact-form/config
    restart: always

许可证

本镜像基于https://github.com/pinceladasdaweb/Simple-PHP-Contact-Form/blob/master/LICENSE%E5%BC%80%E6%BA%90%E3%80%82