CodeIgniter 本身不内置 Bitbucket 集成，所谓“在 CodeIgniter 中使用 Bitbucket”仅指将项目代码托管于 Bitbucket 并协作开发；Bitbucket 是 Git 托管平台，不参与框架运行时流程，调用其 API 需自行实现 HTTP 请求、认证及错误处理。
本身不内置 Bitbucket 集成，所谓“在 CodeIgniter 中使用 Bitbucket”实际是指：
把 CodeIgniter 项目代码托管到 Bitbucket，并在开发协作中配合使用
。Bitbucket 是 Git 托管平台，不是框架插件或运行时依赖——它不参与
的请求处理、路由或数据库操作。
为什么不能直接“在 CodeIgniter 里调用 Bitbucket API”？
Bitbucket 提供的是 REST API（如
），但
默认不封装这些接口。你若真需要从应用内触发仓库操作（比如自动创建 issue、获取 commit 列表），得自己发 HTTP 请求，且必须：
• 使用
或
等客户端
• 持有有效的
或
• 处理响应解析、错误重试、限流（Bitbucket 免费账户每小时约 1000 次调用）
• 注意：这类调用和
的 MVC 架构无关，放在任意
或
里都行，但别误以为是框架原生能力
本地开发时 push 到 Bitbucket 的关键命令
确保你的
项目根目录已初始化为 Git 仓库，并关联 Bitbucket 远程地址：
• 初始化：
• 添加远程：
（HTTPS 方式）或
（SSH 方式）
• 首次推送：
（注意：Bitbucket 新仓库默认分支名是
，不是
）
• 常见失败点：
– HTTPS 报
→ 改用 App Password 替代账号密码
– SSH 报
→ 检查
是否列出密钥，且公钥已粘贴进 Bitbucket 账户的
设置页
– 忽略
和
目录 → 这些必须写入
，否则会导致权限冲突或敏感路径泄露
团队协作中容易被忽略的 CodeIgniter 特定配置
多人共用一个 Bitbucket 仓库时，
的环境相关配置极易出错：
•
和
不应提交明文密码或密钥
• 推荐做法：
– 在 Bitbucket 仓库中保留
，由每个开发者复制后填入本地值
– 使用
读取环境变量（如
），再通过 Bitbucket Pipelines 的
注入生产密钥
•
中的
路径在不同系统（Linux/macOS/Windows）下可能不一致，别硬编码绝对路径
Bitbucket 对
来说只是个“放代码的地方”，真正影响开发体验的是你是否隔离了环境配置、是否规范了 .gitignore、以及是否理解 SSH/HTTPS 认证机制的实际差异——这些细节比选哪个平台重要得多。
CodeIgniterCodeIgniter/repositories/{workspace}/{repo_slug}CodeIgnitercurlGuzzleApp PasswordOAuth tokenCodeIgniterlibraryhelperCodeIgnitergit initgit remote add origin https://bitbucket.org/your-username/your-ci-project.gitgit remote add origin git@bitbucket.org:your-username/your-ci-project.gitgit push -u origin mainmainmasterfatal: Authentication failedPermission denied (publickey)ssh-add -lSSH keysapplication/cache/writable/.gitignoreCodeIgniterapp/Config/Database.phpapp/Config/Encryption.phpDatabase.php.examplegetenv()$db['default']['password'] = getenv('DB_PASSWORD') ?: '';Repository variablesapp/Config/Paths.phpwritableDirectoryCodeIgniter