本文详细指导如何正确配置 OrangeScrum 的 SMTP 邮件参数，重点解决因 app/Config/constants.php 缺失或配置错误导致的“invite user”功能报错问题，并提供路径定位、文件创建规范、关键常量定义及验证方法。
本文详细指导如何正确配置 orangescrum 的 smtp 邮件参数，重点解决因 `app/config/constants.php` 缺失或配置错误导致的“invite user”功能报错问题，并提供路径定位、文件创建规范、关键常量定义及验证方法。
OrangeScrum 依赖 app/Config/constants.php 文件中预定义的邮件常量（如 SMTP 凭据、发件人邮箱等）来触发用户邀请邮件。若该文件缺失、路径错误或关键常量未正确定义，系统将抛出明确提示：
"Make sure that you have done the below required changes in app/Config/constants.php"
"You have provided the details of SMTP email sending options..."
⚠️ 重要前提：app/Config/ 是 OrangeScrum 应用自身的配置目录，绝非 XAMPP 自带组件（如 phpMyAdmin）中的同名路径。您在 c:\xampp\phpMyAdmin\vendor\... 下找到的 constants.php 与 OrangeScrum 完全无关，修改它无效且可能破坏其他工具。
✅ 正确路径与文件创建方式
OrangeScrum 的标准安装结构中，app/Config/ 应位于 OrangeScrum 根目录下（例如 /var/www/html/orangescrum/ 或 C:\xampp\htdocs\orangescrum\）。请先确认您的 OrangeScrum 是否已完整解压并部署于此：
# Linux/macOS 示例（使用终端） ls -l /var/www/html/orangescrum/app/Config/ # 应看到 constants.php（若不存在则需手动创建） # Windows 示例（命令提示符或 PowerShell） dir C:\xampp\htdocs\orangescrum\app\Config\
若 app/Config/ 目录或 constants.php 文件确实不存在，请按以下结构创建：
- 确保目录层级为：orangescrum/app/Config/（注意大小写，Config 首字母大写）；
- 在该目录下新建 constants.php，内容必须以 <?php 开头，且仅包含 PHP 常量定义，不可有 HTML、空行或 BOM 头。
? constants.php 必备配置示例
以下是最小可用配置（请根据您的 SMTP 服务商实际参数修改）：
<?php
// --- SMTP 邮件服务配置 ---
define('SMTP_HOST', 'smtp.gmail.com'); // 如使用 Gmail；企业邮箱请替换为对应 SMTP 地址
define('SMTP_PORT', 587); // TLS 端口常用 587，SSL 可能为 465
define('SMTP_USERNAME', 'your_email@gmail.com');
define('SMTP_PASSWORD', 'your_app_password'); // ⚠️ Gmail 需使用「应用专用密码」，非登录密码
define('SMTP_ENCRYPTION', 'tls'); // 可选 'tls' 或 'ssl'
// --- 系统通知邮箱配置 ---
define('FROM_EMAIL_NOTIFY', 'no-reply@yourdomain.com'); // 邀请邮件的发件人地址
define('SUPPORT_EMAIL', 'support@yourdomain.com'); // 收件人联系支持的邮箱
// --- 其他可选（但推荐设置）---
define('EMAIL_CHARSET', 'utf-8');
define('EMAIL_FORMAT', 'html');? 关键注意事项：
- SMTP_PASSWORD：若使用 Gmail，务必开启两步验证并生成「应用专用密码」，直接填账号密码将失败；
- 路径敏感性：Linux 系统严格区分大小写，确保是 app/Config/（非 app/config/）；
- 文件权限（Linux）：确保 Web 服务器用户（如 www-data 或 apache）有读取权限：
sudo chmod 644 /var/www/html/orangescrum/app/Config/constants.php sudo chown :www-data /var/www/html/orangescrum/app/Config/constants.php
- Windows 用户：请确认 XAMPP 的 Apache 文档根目录是否指向 C:\xampp\htdocs\orangescrum\，并在浏览器中访问 http://localhost/orangescrum 测试基础环境。
✅ 验证配置是否生效
完成配置后，通过 OrangeScrum 内置的邮件测试接口验证：
http://localhost/orangescrum/cron/test_email/?to=your_test_email@example.com
✅ 成功响应应显示：Email sent successfully!
❌ 若仍报错 "Provide the details of SMTP email sending options..."，请立即检查：
- URL 中 orangescrum 路径是否与实际子目录名完全一致；
- constants.php 是否真实存在于 orangescrum/app/Config/ 下（而非其他位置）；
- 所有 define() 语句语法是否正确（无拼写错误、分号缺失、引号不匹配）。
配置完成后，“Invite User” 功能即可正常发送邀请邮件。建议首次使用后检查收件箱的「推广」或「垃圾邮件」文件夹——部分 SMTP 服务商（如 Gmail）可能因新域名或低发送频次进行临时拦截。
