README

一个简单的Laravel 5 Facade，可以轻松检索typeform响应并验证/注册/注销webhooks。

安装

要求

• php: >=7.0
• guzzlehttp/guzzle: ^6.3
• laravel/framework: ~5.4

Composer

composer require "yo1l/laravel-typeform"

服务提供者

Yo1L\LaravelTypeForm\TypeFormServiceProvider 默认自动发现和注册，但如果你想要自己注册它

在config/app.php中添加服务提供者

'providers' => [
    /*
     * Package Service Providers...
     */
    Yo1L\LaravelTypeForm\TypeFormServiceProvider::class,
]

外观

TypeForm 外观也默认自动发现，但如果你想要手动添加它

在config/app.php中添加外观

'aliases' => [
    ...
    'TypeForm' => Yo1L\LaravelTypeForm\TypeFormFacade::class,
]

配置

要发布配置，运行vendor publish命令

php artisan vendor:publish --provider="Yo1L\LaravelTypeForm\TypeFormServiceProvider"

config/typeform.php的示例

<?php
return [
    'debug' => false,
    'token' => env('TYPEFORM_TOKEN'),
    'headers' => [],
    'base_uri' => 'https://api.typeform.com/',
    'webhook' => [
        'base_uri' => env('TYPEFORM_WEBHOOK_BASE_URI', null), // if none app.url is used
        'uri' => env('TYPEFORM_WEBHOOK_URI', '/api/webhook/typeform'),
        'tag' => env('TYPEFORM_WEBHOOK_TAG', null),
        'secret' => env('TYPEFORM_WEBHOOK_SECRET', null),
        'verify_ssl' => env('TYPEFORM_WEBHOOK_VERIFY_SSL', true),
    ],
];

TYPEFORM_TOKEN 是必须的，以便检索所有数据。

入门

强烈建议使用外观，因为所有示例都将使用它。

use TypeForm;

表单

检索所有表单

$formChunks = TypeForm::getFormsByChunk();
foreach ($formChunks as $forms) {
    foreach ($forms['items'] as $form) {
        Log::info($form['id']);
    }
}

以下是所有请求参数的描述。

检索表单的问题

$jsonForm = TypeForm::getForm($this->formSlug);

foreach ($jsonForm['fields'] as $item) {
    // $item is a question / section
    Log::debug($item)

    if ($item['type'] == 'group') {
        foreach ($item['properties']['fields'] as $subItem) {
            Log::debug($subItem);
        }
    }
}

以下是所有请求参数的描述。

响应

检索表单的所有完成响应

$params = ['completed' => true];

foreach (TypeForm::getResponsesByChunk("MyFormId", $params) as $responses) {
    /**
        1 response = 1 submitted forms
        Each response contains all answers (unordered)
     */
    foreach ($responses['items'] as $jsonResponse) {
        $submitted_at = Carbon::parse($jsonResponse['submitted_at']);
        $id = $jsonResponse['token'];

        foreach ($jsonResponse['answers'] as $jsonAnswer) {
            /**
             Store your answers ?
             */
        }
    }
}

以下是JSON响应解释及其所有参数。

Webhooks

如果你在配置中指定了密钥（TYPEFORM_WEBHOOK_SECRET），则此包管理密钥。
以下是webhooks安全的描述。

为表单注册webhook

TypeForm::registerWebhook('MyFormId');

删除/注销表单的webhook

TypeForm::deleteWebhook('MyFormId');

在控制器中验证webhook调用

<?php

namespace App\Http\Controllers\API;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use TypeForm;

class TypeFormController extends Controller
{
    public function __invoke(Request $request)
    {
        TypeForm::validatePayload($request);
        
        $formId = $request->form_response['form_id'] ?? null;
        abort_if($formId == null, 403);

        /**
            Do your stuff here
        */

        return ['ok'];
    }
}