README

了解更多关于与 Bitbucket Cloud 集成的信息。

安装

1. 通过 composer 获取包: composer require docmeup/laravel-connector-bitbucket
2. 初始化默认配置和路由: artisan vendor:publish --tag docmeup-connector-bitbucket

确认路由

你应该在 ./routes/connector.php 中有一个新的路由文件，用于管理对 /connector 的请求

artisan route:list 应该返回

GET|HEAD | connector/bitbucket/atlassian-connect.json
POST     | connector/bitbucket/installed
POST     | connector/bitbucket/uninstalled

{提示} 你的 Bitbucket "describe URI" 应该是可访问的

https://{APP_URL}/connector/bitbucket/atlassian-connect.json

{提示} Bitbucket 将将它们的 app secret 发布到 installed 端点。你的应用应该存储此信息，以使用 JWT 验证来验证 Bitbucket 请求。

确认配置

在 ./config/gitconnector.php 中应该有一个新文件。

config('gitconnector.bitbucket.connector') 默认确定 connector/bitbucket/atlassian-connect.json 的输出。你可以在 ./routes/connector.php 中分配新的逻辑。

注意事项

X-Frame-Options

默认配置指示 Bitbucket 对你的 Laravel 网站进行跨源请求。需要相应地设置 X-Frame-Options 标头。在 connector/bitbucket 路由上设置 ALLOWALL 值将帮助您快速调试。

测试

1. 使用 Ngrok 或 LocalTunnel.me 等服务将项目公开到网络上
2. 将附加组件添加到您的账户
   • 在 https://bitbucket.org/account/user/{YOUR_USER}/applications 上点击 "创建应用"
   • 提供 describe URI: https://{NGROK_HOST}/connector/bitbucket/atlassian-connect.json
3. Bitbucket 将为您提供客户端 ID 和密钥。更新您的 .env

   • # NGROK or LocalTunnel.me host. Example: https://smooth-host-1234.localtunnel.me
     GITCONNECTOR_BITBUCKET_HOST=
     GITCONNECTOR_BITBUCKET_CLIENT_ID=
     GITCONNECTOR_BITBUCKET_CLIENT_SECRET=

4. 在 https://bitbucket.org/account/user/{YOUR_USER}/addon-management 上点击 "从 URL 安装应用"
5. 提供 describe URI: https://{NGROK_HOST}/connector/bitbucket/atlassian-connect.json

您在 Bitbucket 中应该看到的内容

• 访问您的其中一个仓库。在左侧导航菜单中可见 "示例页面 YAS" 和 "示例网络项"。
• 访问您的仓库源代码页面。您应该看到 "加载附加组件 Demo Laravel 附加组件"。