Download the PHP package jerrybendy/coding-webhook-php without Composer
On this page you can find all versions of the php package jerrybendy/coding-webhook-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jerrybendy/coding-webhook-php
More information about jerrybendy/coding-webhook-php
Files in jerrybendy/coding-webhook-php
Package coding-webhook-php
Short Description A webhook client for coding.net with PHP
License MIT
Homepage https://github.com/jerrybendy/coding-webhook-php
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package coding-webhook-php
Coding.net 是目前中国用户量最大的 Git 代码托管平台，并为开发者提供了很多方便易用的功能。
这个项目主要用于通过 Coding 的 WebHook 功能实现自动化测试、自动化部署的功能，还可以使用 WebHook 提供的其它如 topic、document 等类型实现更多的定制化内容。
设置项目启用 WebHook 功能请参考官方帮助文档：https://coding.net/help/doc/git/webhook.html
安装方法
推荐使用 composer 方式安装，要求 PHP 版本不低于 v5.4：
使用方法
Coding-webhook-php 使用类似于 javascript 注册事件的方式，需要给监听的事件注册一个回调函数，并在回调函数内处理具体的动作（如 git pull）。
在上面的例子中，定义了一个 $webHook 对象，并使用 on 方法“监听”类型为 EVENT_TYPE_PUSH 的事件，并在接收到此类事件时执行 function（闭包）里面的内容。例子中是判断如果推送的分支是 master 就执行 git pull 的操作。
（更多示例代码请查看 example 目录）
APIs
Webhook 类除构造函数外共开放三个函数：
构造函数
构造函数接收可选的 token 为唯一参数，token 需在 coding 的 webhook 页面中设置，并保持一致即可。
on()
on(string|array $type, callable $callback)
on() 方法用于绑定一个或多个事件处理函数到具体的事件类型中。
一个事件可以绑定多个处理函数，同样也可以把多个事件绑定到同一个处理函数中。
on() 有两个参数，$type 为要绑定处理函数的类型，可以是字符串或者以 EVENT_TYPE_ 开头的一个预定义常量，也可以是包含多个类型常量的数组。当 $type 为数组时，将会对数组内的所有事件类型绑定相同的处理函数。
$callback 参数接收一个 callable 类型的回调函数（关于 callable 的更多信息可参见 PHP 官网文档）。也就是说 $callback 的值可以是一个表示函数名的字符串、包含对象和方法名的一维数组、使用双冒号语法表示的类 static 方法，或者是一个闭包（个人推荐使用闭包的方式）。
回调函数需要接收一个对象类型的参数，参数包含了和此次事件相关的所有信息。关于信息中可能包含的数据内容，请参考官方文档。
函数返回 Webhook 对象本身，可用于链式操作。
onFail()
onFail(callable $callback）
onFail() 方法用于处理一些常规的错误信息，如请求头错误、解析错误、token 不符等。
和 on() 方法一样， onFail() 也接收一个 callable 类型的回调函数作为参数。
回调函数需要接收两个参数。第一个为 \Exception 类型的参数，参数包含了和异常相关的一些信息。可以使用 instanceof 关键字来判断异常的类型。第二个参数包含了错误发生时当前的一些数据信息，如 header 错误或读取 post 原文出错时信息为空字符串，解析错误时为 post 原文的内容，token 错误时为已经解析后的 post 信息。（参考 02-exception.php）
函数返回 Webhook 对象本身，可用于链式操作。
run()
run()
在配置完所有需要的回调后必须调用一次 run() 方法以处理具体的事件。
常量定义
LICENSE
The MIT License (MIT)
Copyright (c) 2016 Jerry Bendy
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
