codeigniter 不内置 stripe 支持,但可通过官方 stripe-php sdk 集成;需用 composer 加载、密钥存配置或环境变量、webhook 必须用原始 payload 验签且关闭 csrf。

直接说结论:CodeIgniter 本身不内置 Stripe 支持,但你不需要重写整个支付流程——用官方 stripe-php SDK + CodeIgniter 的加载机制就能稳稳跑通,关键在于别把密钥硬编码进控制器,也别跳过 webhook 签名验证。
怎么加载 stripe-php SDK 而不破坏 CI 自动加载
Stripe 官方 PHP SDK(stripe/stripe-php)是纯 Composer 包,而 CodeIgniter 3 默认不带 Composer 自动加载。强行 require 或 include 容易导致命名空间冲突或类找不到。
- 在项目根目录运行
composer require stripe/stripe-php,确保vendor/autoload.php存在 - 不要在控制器里写
require 'vendor/autoload.php'—— 改用 CI 的钩子(hooks)或自定义初始化逻辑 - 推荐做法:在
application/config/autoload.php中添加自定义钩子,或在application/core/MY_Loader.php里覆盖library()方法,对stripe库做特殊处理 - 更轻量的方案:在控制器构造函数开头加
require_once FCPATH . 'vendor/autoload.php';,仅限调试阶段;上线前必须移走
为什么 stripe_secret_key 绝不能写死在控制器里
常见错误是直接在 Payment_controller.php 里写 \Stripe\Stripe::setApiKey('sk_test_...');。这会导致密钥随代码提交、被日志意外打印、甚至被 PHP 错误页面暴露。
- 正确做法:把密钥存在
application/config/payment.php,通过$this->config->item('stripe_secret_key')获取 - 生产环境必须从环境变量读取,比如用
getenv('STRIPE_SECRET_KEY'),再配合 Apache/Nginx 的SetEnv或 Docker 的environment:配置 - 测试密钥(
sk_test_...)和生产密钥(sk_live_...)要严格隔离,CI 的ENVIRONMENT常量(development/production)应直接决定加载哪组配置
webhook 处理器里最容易漏掉的三件事
Stripe 发来的支付成功通知(payment_intent.succeeded)不是普通 POST 请求,它带签名头 Stripe-Signature,且 body 是原始 JSON 字符串 —— CI 的 $this->input->post() 会自动解析成数组并破坏原始体,导致验签失败。
- 必须用
file_get_contents('php://input')拿到原始 payload,再传给\Stripe\Webhook::constructEvent() - 验签密钥不是你的 secret key,而是 webhook endpoint 页面上单独生成的
whsec_...密钥(在 Stripe Dashboard → Developers → Webhooks 里配) - 控制器方法不能有 CSRF 验证(
$this->form_validation->run()会拦截),需在application/config/config.php中为该 URI 关闭 CSRF:$config['csrf_exclude_uris'] = ['stripe/webhook'];
真正卡住人的从来不是「怎么调用 PaymentIntent::create()」,而是密钥管理松散、webhook 验签失败却不报错、或者前端传来的 client_secret 没传到后端就直接用了——这些细节不抠清楚,上线后查日志能盯一整晚。











