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