彩虹易支付搭建教程 - 配置指南

一、环境准备

在搭建彩虹易支付之前，请确保服务器满足以下运行环境要求。推荐使用Linux服务器（如CentOS 7+、Ubuntu 20.04+），搭配宝塔面板或LNMP一键安装包，可大幅降低部署难度。

PHP版本：7.2 及以上（推荐 PHP 7.4 / 8.0）
数据库：MySQL 5.6+ / MariaDB 10.2+
Web服务器：Nginx（推荐）/ Apache
PHP扩展：curl、openssl、mysqli、gd、mbstring、json、xml

二、源码下载与上传

获取彩虹易支付最新版本源码后，将程序文件上传至服务器网站根目录。建议将文件解压后上传至 /www/wwwroot/你的域名/ 目录下。上传后请确保以下目录拥有写入权限：

chmod -R 777 /www/wwwroot/你的域名/config/
chmod -R 777 /www/wwwroot/你的域名/cache/
chmod -R 777 /www/wwwroot/你的域名/uploads/

三、Nginx伪静态配置

彩虹易支付需要配置伪静态规则才能正常运行。以下为Nginx伪静态配置示例（宝塔面板可直接在网站设置→伪静态中粘贴）：

location / {
    if (!-e $request_filename) {
        rewrite ^/(.*)$ /index.php?/$1 last;
        break;
    }
}

如果使用的是Apache服务器，请确保已开启mod_rewrite模块，并在网站根目录下放置.htaccess文件，内容如下：

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?/$1 [L]
</IfModule>

四、数据库配置

在宝塔面板或phpMyAdmin中新建一个MySQL数据库，记录数据库名、用户名和密码。然后编辑配置文件 /config/database.php：

return [
    'hostname' => '127.0.0.1',
    'database' => '你的数据库名',
    'username' => '你的数据库用户名',
    'password' => '你的数据库密码',
    'hostport' => '3306',
    'prefix'   => 'pay_',
];

五、支付宝支付配置

登录彩虹易支付后台管理面板，进入「支付通道」→「支付宝」，填写以下参数：

APPID：在支付宝开放平台申请的应用ID
商户私钥：应用RSA2(SHA256)私钥
支付宝公钥：支付宝开放平台提供的公钥
异步通知地址：https://你的域名/notify/alipay/
同步跳转地址：https://你的域名/return/alipay/

六、微信支付配置

微信支付需要先申请微信商户号，然后在后台配置：

商户号(MCHID)：微信支付商户平台获取
API密钥(KEY)：商户平台API安全中设置
API V3密钥：适用于新版微信支付接口
商户证书：apiclient_cert.pem 和 apiclient_key.pem

七、QQ钱包配置

QQ钱包支付通道需要在QQ钱包商户平台申请，获取商户号和API密钥后，在后台「支付通道管理」中填写相关信息即可完成接入。

八、云闪付配置

云闪付目前支持扫码支付和H5支付两种模式。需在银联开放平台完成商户注册，获取商户代码和签名证书，然后在彩虹易支付后台完成配置。

九、SSL证书安装

为保障支付安全，强烈建议为网站配置SSL证书（HTTPS）。推荐使用免费的Let's Encrypt证书，宝塔面板可一键申请和续签。配置完成后，请将网站URL改为 https:// 开头。

十、模板自定义

彩虹易支付支持模板自定义。模板文件位于 /template/ 目录。您可以修改首页、支付页面、用户中心的HTML/CSS/JS文件来实现个性化风格。修改模板前建议先备份原始文件。

十一、常见问题排查

支付后订单状态未更新：检查异步通知URL是否正确，服务器是否能被外网访问
页面404错误：检查伪静态规则是否配置正确并生效
数据库连接失败：检查数据库配置文件的用户名、密码和主机地址
支付签名验证失败：核对商户密钥和证书是否正确

帮助中心